Fin février 2014, le Simulateur Firefox OS a été doté d'une fonctionnalité pour lui permettre d'exécuter un binaire B2G personnalisé et/ou un profil Gaia de votre choix. Cet article montre comment configurer votre jeu d'outils pour faire cela, exécuter le Simulateur via WebIDE.
Prérequis
Tout d'abord, réunissons les outils dont nous avons besoin pour exécuter nos versions personnalisées dans le Simulateur.
- Installez Firefox, et vérifiez que WebIDE soit disponible (Outils > Développement web > WebIDE.)
- Installez le simulateur B2G Desktop le plus récent, ou construisez le vôtre.
- Installez l'extension Firefox OS Simulator la plus récente, version 7.0pre7.20140113 ou plus.
- Construisez un profil Gaia avec le flag
SIMULATOR=1
. Par exemple, vous pouvez lancer la commandemake SIMULATOR=1 PROFILE_FOLDER=profile-b2g profile-b2g
depuis votre répertoire Gaia pour réaliser cette opération (voir Développer pour Gaia pour plus de détails.)
Configuration de votre simulateur
Vous devez à présent effectuer certains paramétrages afin que le simulateur puisse trouver vos Bureau B2G et Gaia personnalisés.
Avant Firefox 42
- Ouvrez l'onglet de gestion des modules (Outils > Modules complémentaires, ou saisir
about:addons
dans la barre d'URL.) - Sur la liste d'onglets, cliquez sur Extensions pour lister vos extensions installées.
- Cherchez la nouvelle extension Firefox OS simulator dans la liste. Elle devrait s'appeler quelque chose comme Firefox OS 1.3 Simulator 7.0pre.7.20140113.
- Cliquez sur le bouton Préférences situé dans l'entrée de la liste correspondant à l'extension du simulateur.
- Vous pourrez décider d'utiliser un exécutable personnalisé — la dernière version de B2G Desktop — pour faire tourner Firefox OS dans WebIDE. Cliquez sur le bouton Parcourir... juste après l'étiquette Select a custom runtime executable puis sélectionner votre exécutable B2G Desktop dans le sélecteur de fichiers. Alors que cela sera évident sous Windows/Linux, sur Mac, il faudra le rechercher dans
/Applications/B2G.app/Contents/MacOS/b2g
, à condition que vous l'ayez installé dans le répertoireApplications
. Reportez-vous à Construire votre binaire b2g personnalisé si vous souhaitez tester des patchs sur mozilla-central. - Vous pouvez également lancer votre profil Gaia personnalisé dans WebIDE : Cliquez sur le bouton Parcourir... après l'étiquette Select a custom Gaia profile directory et sélectionnez le répertoire de votre profil personnalisé (cela devrait être gaia/profile-b2g.)
- Si vous avez besoin de revenir au simulateur non personnalisé, vous devrez réinitialiser une valeur de configuration. Le fait de simplement supprimer et réinstaller l'extension du simulateur ne fonctionnera pas. Ouvrez un nouvel onglet et tapez "about:config" dans la barre d'adresse. Dans le champ Rechercher de cette page, entrez "fxos" ou "simulator" et cherchez quelque chose qui ressemble à "[email protected]" ou "[email protected]". Faites un clic droit et choisissez "Réinitialiser". Redémarrer à présent le simulateur et vous devriez avoir récupéré la version non personnalisée.
À partir de Firefox 42
Depuis Firefox 42, vous pouvez configurer le binaire B2G et le profil avec l'écran "Options du Simulateur" dans WebIDE.
Utilisation de votre simulateur configuré
Enfin, allons-y et utilisons notre simulateur personnalisé.
- Ouvrez WebIDE (Outils > Développemet web > WebIDE) ; vous pouvez également presser Shift-F8.
- Ouvrez le menu Environnement en cliquant sur le bouton en haut à droite.
- Cliquez sur le bouton Firefox OS 1.3 (ou toute autre dernière version que vous avez installée). Cela devrait être la bonne option, même si vos versions de B2G desktop/Gaia sont plus récentes.
- Le simulateur va maintenant démarrer ; B2G Desktop devrait se charger et exécuter vos versions B2G nocturne et Gaia personnalisées !
Construire un binaire b2g personnalisé
Il s'agit d'une étape facultative, utile si vous devez tester un patch à appliquer sur le codebase de mozilla-central.
Note : s'il vous est possible de soumettre des Try builds, elles généreront des extensions simulateur dans les répertoires de compilation de chaque plate-forme de B2G Desktop ; cela peut donc constituer un moyen plus simple de créer un simulateur qui utilise une plate-forme personnalisée ou des modifications de Gaia dans certains cas d'utilisation.
- Faites un checkout de mozilla-central.
- Appliquez le(s) patch(s) que vous voulez tester.
- Vérifiez la présence des lignes suivantes dans votre mozconfig :
ac_add_options --enable-application=b2g
FXOS_SIMULATOR=1
GAIADIR=/home/alex/gaia # Mandatory to set FXOS_SIMULATOR flag, it will ensure having a working xpi file
MOZTTDIR=/path/to/moztt # Optional, to get the device fonts -
Exécutez
./mach build && ./mach package
-
Si vous avez indiqué GAIADIR, vous obtiendrez une extension xpi du simulateur dans votre obdir, à l'intérieur du dossier
dist
.