Différentes façons d'exécuter Gaia

Vous pouvez exécuter Gaia dans un simulateur via WebIDE, dans Firefox Mulet (une version spéciale de Firefox pour ordinateur destinée au développement Gaia), dans un émulateur ou sur un appareil mobile compatible. Cet article fournit un résumé pour réaliser chacun de ces cas, avec des liens vers des informations complémentaires.

Note : Pour faire tourner Gaia sur ordinateur, la méthode actuellement recommandée consiste à utiliser Mulet (voir Utiliser Gaia dans Firefox Mulet, ci-dessous.)

Note : Parfois, vous serez confronté à des problèmes dûŝ à certaines de vos modifications qui nécessitent des paramètres de préférences actualisés etc. Si vous rencontrez ce genre de cas, essayez de regénérer votre profil pour voir si cela corrige le problème (lancez de nouveau la commande make).

À quel point cela est-il proche de la réalité ?

Certaines des solutions détaillées dans cet article pour exécuter Gaia sont plus proches que d'autres de l'expérience rencontrée avec un appareil réel. Dans l'ordre de facilité d'exécution :

Gaia dans un Simulateur via WebIDE
Gaia dans Firefox Mulet
Gaia dans un Émulateur
Gaia flashé sur un téléphone
Gaia+Gecko flashés sur un téléphone

L'ordre de “À quel point cela est-il proche du produit commercialisé” est exactement l'opposé de cette liste. Selon la fonctionnalité sur laquelle vous travaillez, vous devrez trouver l'ennvironnement qui répond à la problématique posée.

Explication des options de make

Dans les sections ci-dessous sur WebIDE et Mulet, il vous est demandé de construire votre propre profil Gaia en utilisant la commande suivante :

DEBUG=1 DESKTOP=0 make

La partie DEBUG=1 crée une version debug qui fait tourner Gaia en tant qu'applications hébergées sur un serveur web embarqué plutôt qu'avec les applications par défaut empaquetées qui doivent être ré-empaquetées à chaque modification. Ainsi, pour voir les changements, vous devez juste recharger l'application, ce qui est beaucoup plus efficace pour le débogage.
La partie DESKTOP=0 doit être inclue parce que l'option DEBUG=1 est accompagnée par défaut de l'option DESKTOP=1 qui est cassée et doit donc être supprimée. Vous ne devriez plus avoir besoin de le faire à l'avenir.

Cela va construire votre profil dans un répertoire nommé profile-debug.

Si vous souhaitez faire un test avec une version de production de Gaia pour davantage de réalisme, lancez seulement make pour construire votre profil. Celui-ci sera créé dans un répertoire nommé profile.

Note : Il existe tout un tas d'options make disponibles pour Gaia — voir la référence des options make de Gaia pour beaucoup plus de détails.

Utiliser Gaia dans un Simulateur via WebIDE

La méthode la plus rapide pour essayer Gaia est d'utiliser WebIDE, un outil développeur disponible dans Firefox pour ordinateur. Il apporte un certain nombre d'outils utiles pour vous aider à tester, déployer et déboguer des applications web HTML5 sur les téléphones Firefox OS et dans le Simulateur Firefox OS, directement à partir de votre navigateur.

Dans le navigateur pour ordinateur Firefox 34+, ouvrez WebIDE via le menu Outils > Développement web > WebIDE. Ouvrez le menu Environnement en haut à droite pour installer et démarrer un Simulateur.

Pour faire tourner votre propre profil Gaia personnalisé, le processus est un petit peu plus complexe, mais cela reste relativement simple :

Avant d'essayer de faire ça, il faut construire vous-même un profil d'appareil Gaia de debug — allez dans votre clone de dépôt Gaia puis lancez DEBUG=1 DESKTOP=0 make. Cela va générer dans votre répertoire gaia un dossier appelé profile-debug, contenant votre profil. Avec ce type de profil, vous serez en mesure de déboguer les applications internes de Gaia dans WebIDE sans avoir à configurer autre chose, et vous n'aurez pas à accepter la boîte de dialogue pour confirmer le débogage distant dans le simulateur à chaque fois que vous le lancerez. Si vous voulez faire des tests avec une version de production plus réaliste, lancez la construction avec uniquement la commande make.
Ouvrez Firefox (Nightly est recommandé.)
Ouvrez WebIDE depuis Outils > Développement web > WebIDE.
Installez un Simulateur Firefox OS en allant dans Choisir un environnement > Installer un Simulateur dans WebIDE et en choisissant une option. Assurez-vous d'utiliser les mêmes versions de simulateur et du Gaia que vous faites tourner (ainsi par exemple, si votre branche Gaia est la 2.1, vous devrez utiliser le Simulateur Firefox OS 2.1.)
Dans le menu de droite, vous pouvez voir votre simulateur dans la liste. Cliquez sur le bouton options (engrenage) qui est juste à côté pour accéder à l' écran des Options du Simulateur.
Choisissez Profil > Personnaliser profil Gaia..., puis sélectionner le dossier de votre profil Gaia dans le sélecteur de fichiers.
Ouvrez ce simulateur dans WebIDE, et il devrait alors s'ouvrir avec votre profil Gaia en cours d'exécution.

Note : Si la commande ne fonctionne pas (il est possible d'avoir un message affichant "A copy of B2G is already open. Only one copy of B2G can be open at a time." — alors qu'il n'est pas déjà ouvert), vérifiez alors que le répertoire de votre profil dispose bien des permissions de lecture/écriture, par exemple avec chmod.

Note : Si vous souhaitez réinitialiser votre simulateur pour qu'il ne fasse plus tourner de profil Gaia personnalisé, vous aurez besoin d'aller dans Firefox sur about:config ; cherchez la préférence [email protected] (2_2 peut être différent en fonction de la version du simulateur que vous avez personnalisée), double-cliquez dessus, supprimez la valeur dans la boîte de dialogue qui s'affiche puis cliquez sur OK.

Utiliser Gaia dans Firefox Mulet

Il est également possible d'exécuter Gaia dans une version spéciale de Firefox appelée Firefox Mulet. Cela donne l'avantage d'avoir un cycle de développement rapide, ainsi que des outils de développement web standards et des débogueurs pour travailler avec.

Tout d'abord, vous devez avoir cloné le dépôt Gaia sur votre machine (voir Lancer votre compilation de Gaia pour voir la meilleure façon de le faire si vous voulez contribuer au projet.) Mulet ne fonctionnant que sur Gaia 2.2 et au-dessus, il est une bonne idée d'utiliser la branche master.
Ensuite, placez-vous dans le dépôt Gaia avec cd et construisez votre propre profil (voir référence des options make pour les différents types disponibles) avec DEBUG=1 DESKTOP=0 make. Si vous voulez faire des tests en utilisant une version de production plus réaliste, utilisez seulement la commande make.
Vous pouvez à présent installer la dernière version de mulet dans gaia/firefox grâce à la commande make mulet. Il s'agit de la méthode la plus rapide pour l'installer.
1. Si vous voulez avoir plus de contrôle sur l'endroit où installer mulet, vous devrez le télécharger vous-même — trouvez les builds Windows et Mac sur Mozilla Central, et regardez ici pour Linux. Les builds Mulet sont les paquets dont les noms commencent par firefox-*, par exemple firefox-36.0a1.en-US.mac64.dmg. Les builds Linux sont nommés target.linux-x86_64.tar.bz2 — choisissez la version appropriée à votre machine de développement.
2. Une fois le build Mulet téléchargé, installez-le en lieu sûr afin de ne pas écraser votre version de Firefox Nightly normale. Par exemple, sur Mac OS X, créez un nouveau dossier dans Applications appelé "mulet", et faîtes-le glisser dedans.
Lancez maintenant le build Mulet à partir de la ligne de commande, en lui passant votre profil Gaia comme profil à utiliser lors de l'ouverture (spécifié par l'option -profile.) Par exemple, vous pouvez lancer quelque chose de ce genre depuis l'intérieur de votre dossier Applications sur Mac OS X si vous l'avez installé là :
```
./firefox/Contents/MacOS/firefox-bin -no-remote -profile /Users/my-home-folder/git/gaia/profile-debug/
```

Le build Mulet résultant devrait apparaître, comme ceci :

Note : Si la commande ne fonctionne pas (il est possible d'obtenir un message disant "A copy of Firefox is already open. Only one copy of Firefox can be open at a time." — alors qu'il n'est pas déjà ouvert), alors vérifiez que vous avez le droit de lancer l'exécutable firefox comme ça — vous pouvez lancer la commande ci-dessus en plaçant sudo devant, bien qu'une meilleure solution, plus sûre,consiste à faire un chmod sur votre dossier d'installation.

Note : Les nouvelles versions de Gaia ont parfois besoin d'une version de mulet plus récente ; pour faire la mise à jour vers la dernière version de mulet, vous pouvez lancer la commande rm -rf firefox && make mulet dans le répertoire gaia/.

Sur cet affichage, vous avez de disponible la boîte à outils standard de Firefox afin de déboguer vos applications Gaia, plus un émulateur Firefox OS fonctionnant dans la partie gauche, ainsi qu'un certain nombre d'autres outils utiles à l'environnement Gaia. Les contrôles au-dessus de l'émulateur vous permettent de :

Choisir différentes tailles d'écran pour l'émulateur (il s'agit en fait d'une vue adaptative).
Faire pivoter l'écran de l'émulateur.
Activer ou désactiver la simulation des évenements tactiles (si désactivée, vous ne pouvez pas utiliser la souris pour faire glisser l'UI et les applications ouvertes.)
Prendre des captures d'écran.

Flasher Gaia sur un véritable appareil

Important : Si vous tentez de flasher Gaia sur un appareil doté de peu de mémoire, comme un Tarako ou un Spice Fire One, vous devez le flasher avec une branche de Gaia spéciale optimisée pour les faibles quantités de mémoire, comme la branche 1.3t. Essayer de flasher un tel appareil avec la branche principale de Gaia va probablement avoir pour résultat de rendre le téléphone inopérant.

Pour flasher une nouvelle version de Gaia sur un vrai appareil :

Assurez-vous d'abord d'avoir cloné le dépôt Gaia sur votre ordinateur et d'avoir installé ADB.
Vérifiez d'avoir activé le Débogage via USB.
Branchez votre appareil sur votre ordinateur en USB.
S'il y a un appareil détecté, vous pouvez procéder aux commandes suivantes. Sinon, vous (utilisateur de Windows ou de distribution Linux) pouvez avoir à vérifier la page des Pilotes OEM USB pour correctement configurer le pilote USB de votre ordinateur.
Pour de véritables appareils, lancez adb en tant qu'utilisateur root en utilisant la commande suivante :
```
$ adb root
```
Lancez la commande suivante à l'intérieur du dépôt Gaia pour réinitialiser votre téléphone et mettre à jour votre code source de Gaia :
```
$ make reset-gaia
```
Pour tester des applications non-systèmes, vous pouvez les installer sans redémarrer l'appareil grâce à la commande suivante :
```
$ make install-gaia
```
Si vous souhaitez installer une application spécifique unique, vous pouvez la passer via la variable APP comme ceci :
```
$ make install-gaia APP=browser
```

Note : Envoyer Gaia sur votre appareil en utilisant make install-gaia / make reset-gaia construit Gaia avec une définition de résolution 1x par défaut. Pour spécifier une résolution supérieure, vous devez utiliser les options de make GAIA_DEV_PIXELS_PER_PX ou GAIA_DPPX (voir Ressources images en haute résolution pour davantage d'informations sur ces options.) Lors de l'envoi de Gaia sur votre appareil de cette façon, vous devez indiquer les options de make correspondantes au facteur d'échelle de votre appareil ; donc par exemple make install-gaia GAIA_DEV_PIXELS_PER_PX=1.5 pour un appareil Flame (ou 2, ou 2.5, etc ; voir les valeurs de facteur d'échelle du tableau situé dans 512 icônes pour l'affichage.)

Pour vérifier que votre appareil est correctement branché en USB, vous pouvez taper :

$ adb devices

Vous devriez obtenir un résultat de ce genre :

List of devices attached
emulator-5554  device

Construire Gecko et Gaia et les utiliser dans un émulateur ou sur un véritable appareil

Si vous disposez d'un appareil mobile compatible, vous pouvez construire et installer votre propre version de Firefox OS et ensuite l'exécuter sur un Émulateur ou la placer sur votre appareil.