Skip to content

Instantly share code, notes, and snippets.

@bingoooo
Last active April 27, 2016 19:07
Show Gist options
  • Save bingoooo/b9915a3d2329924b4cce346ec67b96ad to your computer and use it in GitHub Desktop.
Save bingoooo/b9915a3d2329924b4cce346ec67b96ad to your computer and use it in GitHub Desktop.
Tutoriel de Configuration de Cordova

Tutoriel Installation de Cordova

Ce tutoriel suppose que vous avez installé node et npm au préalable.
Cordova ne supporte Android qu'à partir de la version 3.5, les versions antérieures ne peuvent pas être utilisées.

Installer cordova

Une seule commande installera Cordova en global pour pouvoir exécuter la commande cordova

npm install -g cordova  

Par la suite, la commande cordova sera disponible pour créer et gérer des projets créés sous Cordova

Créer un projet

Dans le dossier courant du terminal, cette commande créra un dossier au nom spécifié :

cordova create myapp com.mycompany.myteam.myapp MyApp  

ou

cordova create MyApp  

Cela créra un dossier MyApp là où vous avez tapé la commande avec les fichiers initiaux pour démarrer un projet Cordova.

Ajouter une plateforme de déploiement

À l'intérieur de votre projet (dans l'exemple cd MyApp) taper dans la console :

cordava platform add browser  

Cela configurera l'application afin qu'elle puisse se lancer dans un navigateur dépouillé (il est nécessaire d'installer chrome et non chromium)
Installer Google Chrome sur Ubuntu

Si vous comptez utiliser une plateforme Android tapez dans la console :

cordova platform add android	

Cela configurera l'application afin qu'elle puisse se lancer vers un appareil ou un émulateur Android, mais d'autres installations sont alors nécessaires.

Lancer l'application cordava

cordova run browser		pour lancer dans un navigateur
cordava run android		pour lancer vers un appareil ou un émulateur Android, mais dans ce cas, poursuivez l'installation  

Installer un environnement pour le développement sous Android

Télécharger le JDK 8
Décompresser le dossier (dans mon exemple, dans le dossier utilisateur /home/benjamin)

Télécharger Android Studio ou Uniquement le SDK en bas de la page
Décompresser le dossier (dans mon exemple, dans le dossier utilisateur /home/benjamin)

Sur Ubuntu, il faut installer certaines librairies 32bits pour compiler le code

sudo apt-get install lib32z1 lib32ncurses5 lib32bz2-1.0 lib32stdc++6

Création du .bash_profile

L'installation a besoin d'avoir certains chemins enregistrés, pour cela, il faut créer un fichier qui sera exécuté par bash:

.bash_profile

export JAVA_HOME=/home/benjamin/jdk1.8.0_91
export PATH=${PATH}:$HOME/bin:$HOME/.composer/vendor/bin:/home/benjamin/jdk1.8.0_91/bin
export ANDROID_HOME=/home/benjamin/Android/Sdk
export PATH=${PATH}:/home/benjamin/Android/Sdk/platform-tools:/home/benjamin/Android/Sdk/tools

En option, il est possible de créer un alias vers Android Studio si vous l'avez installé

alias astudio='sh /home/benjamin/android-studio/bin/studio.sh'  

Par la suite, il faut sourcer le fichier en tapant dans la ligne de commande, là où vous avez créé le fichier :

source .bash_profile

Les deux SDK sont alors enregistrés dans la console active.
Si vous ouvrez une autre fenêtre console il faudra resourcer le fichier .bash pour qu'il soit repris en compte dans la nouvelle fenêtre console.
Cela évite que l'on se retrouve avec un terminal bloqué dans le cas où l'on aurait mal configuré le fichier .bash.

Mais dans le cas où vous voudriez installer de manière permanente, il vous faudra alors modifier le fichier .bashrc qui se trouve dans le dossier /home/[votre-nom-utilisateur].
Ajoutez les lignes du .bash_profile ci-dessus, puis rentrer la commande :

. ~/.bashrc

Installer les Composants du SDK

Ouvrez l'assistant d'installation du SDK Android en exécutant en ligne de commande :

android

Sélectionnez les Paquets 23.0.3 en plus des versions les plus récentes les verions 24.0.0 rc3 n'étant pas stables et produisant des erreurs.
Il n'est pas obligatoire de sélectionner les paquets correspondant au niveau de build du téléphone cible, sauf si des problèmes de compatibilité surviennent :

SDK Tools et SDK Build Tools sont les paquets indispensables à la compilation et à l'émulation Android.

optionnel, lancer Android Studio :

sh /home/benjamin/android-studio/bin/studio.sh  

Dans mon exemple, android studio est installé dans le dossier utilisateur 'benjamin'

Configurer un émulateur

Créer un émulateur avec Android SDK Tools

Tapez dans la console :

android  

Cela fera apparaître l'utilitaire de configuration Android SDK Manager.
Dans la barre de menu (la barre tout en haut là où il y a l'heure aussi :) sélectionner Tools -> Manage AVDs...
La fenêtre Android Virtual Device (AVD) Manager devrait s'ouvrir.
Dans l'onglet Andriod Virtual Devices, cliquez sur Create, une fenêtre s'ouvre.
Donnez un nom à votre émulateur et choisissez ses options.
Ex :

AVD Name : Test  
Device : Nexus S (4.0", 480 x 800: hdpi)  
Target : Android 6.0-API Level 23  
CPU/ABI : Google APIs Atom (x86_64)  
Keybord : v Hardware keyboard present  
Skin : Skin with dynamic hardware controls  
Front Camera : Emulated  
Back Camera : Emulated  

Laisser les autres champs tels quels pour tester, sinon, pensez à augmenter la taille de la mémoire et du stockage pour des applications de grande taille.

L'appareil virtuel est alors affiché dans le tableau.
Fermez AVD Manager et SDK Manager.

En ligne de commande pour afficher les appareils virtuels disponibles tapez :

emulator -list-avds

Pour démarrer un appareil virtuel, tapez :

emulator @[nom]

Créer un émulateur à l'aide du terminal

Obtenir la liste des configurations disponibles en tapant en ligne de commande

android list targets  

Repérez l'id au niveau d'API souhaité, puis créez l'appareil virtuel en tapant la commande :

android create avd -n [nom] -t [APIid]  

Dans le cas où il existerait plusieurs images de processeurs possibles, il faut le spécifier comme indiqué dans la liste des ABI (repérez la ligne qui commence par Tag/ABIs :

android create avd -n [nom] -t [APIid] --abi [default/x86... ou autre]

Pour lancer l'émulateur, entrez la commande :

emulator @[nom]  

Lancer l'application sur l'émulateur

Par défaut, Cordova lance l'application sur un device connecté, sinon, il choisi un émulateur en cours d'exécution, donc en tapant la commande : cordova run android, l'application s'exècutera vers l'émulateur si aucun device n'est branché.

Conclusion

Il vous est maintenant possible de créer des applications sur mobile juste avec des connaissances HTML, CSS et JS !!!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment