Variable de référence pour les builds B2G

Cet article fournit une référence pour toutes les variables des builds B2G, les builds Gaia et les builds Gecko et les commandes dont vous pouvez avoir besoin durant des opérations relative à la compilation de Firefox OS.

B2G build

Variables

Example
xxx

Commandes

./repo sync
xxx
./config.sh
xxx

Gaia build

Variables

Voir le Gaia MakeFile pour la définition de toutes ces variables.

ADB
xxx
APP
Certaines commandes peuvent agir sur tout gaia ou seulement sur une seule application. Cette variable d'environnement défini si l'on veut qu'une commande agisse sur une app seulement, et si c'est le cas, sur laquelle.
GAIA_DIR
xxx
PROFILE_DIR
xxx
PROFILE_FOLDER
Cela défini le dossier où le profil sera généré. Par défaut il est défini à gaia/profile pour les profils normaux et gaia/profile-debug pour les profils DEBUG=1 profils (voir plus loin.)
COREWEBAPPS_DIR
xxx
SCHEME
xxx
GAIA_DOMAIN
xxx
DEBUG
Lorsque la valeur est à 1, les profils généreés peuvent être utilisés avec Firefox desktop ou le simulator Firefox OS (B2G Desktop): DEBUG=1 DESKTOP=0 make.
Il inclut l'extension httpd.js et les préférences de configurations pour accèder aux applications en utilisant app://<appname>.gaiamobile.org/. Quelques applications sont connues pour fonctionner ainsi, notamment l'application SMS.
LOCAL_DOMAINS
xxx
DESKTOP
Cela inclus un set d'extensions dans le profil DEBUG pour permettre aux applications systèmes de Gaia d'être chargées dans Firefox. Cela ne fonctionne plus bien et est obsolète en faveur de Mulet. La valeur par defaut est mise à 1 lorsque DEBUG=1 est utilisé, mais vous pouvez vouloir le désactiver du fait de son non fonctionnement.
Prenez des précautions car cela ne fonctionne pas aussi avec le Simulator Firefox OS (B2G Desktop).
DEVICE_DEBUG
Active une expérience plus developer-friendly : active le debuggage adb avec les devtools, désactive le lock screen et active les préférences pour permettre de debugger les applications certifiées.
NO_LOCK_SCREEN
xxx
SCREEN_TIMEOUT
Lorsque la valeur est à 0, cette préférence désactive le timeout de l'écran.
SYSTEM
xxx
GAIA_PORT
xxx
GAIA_LOCALES_PATH
xxx
GAIA_INSTALL_PARENT
xxx
LOCALES_FILE
xxx
GAIA_KEYBOARD_LAYOUTS
xxx
GAIA_KEYBOARD_DOWNLOADABLE_LAYOUTS
xxx
GAIA_KEYBOARD_ENABLE_USER_DICT
xxx
LOCALE_BASEDIR
xxx
BUILD_APP_NAME
Essentiellement un alias pour APP (voir plus haut).
PRODUCTION
Crée des builds productions (à la place d'une build ingénieur); L'id de l'app Facebook et d'autres id d'applications productions sont utilisées dedans. Sinon make production fonctionnera
GAIA_OPTIMIZE
Lorsque la valeur est mise à 1 cela active les étapes d'optimisations lorsqu'on compile Gaia comme la minification du code JS. Toutes les applications gaia ne sont pas affectées par cela, tant que la fonction est opt-in.
GAIA_DEVICE_TYPE
xxx
GAIA_DEV_PIXELS_PER_PX
Définis la densité de pixels pour l'appareil visé. Cela affecte les images et/ou les vidéos qui sont copiées dans la build. La valeur par défaut est à 1, mais les appareils avec des spécifications plus haute - par exemple le  Flame doivent utiliser une valeur de 1.5. C'est aliasé comme GAIA_DPPX.
DOGFOOD
Active les build Dogfood gaia.
MOZILLA_OFFICIAL
Lorsque la valeur n'est pas à 0, une build Mozilla-branded sera produite. La valeur par défaut est à 0.
GAIA_DEFAULT_LOCALE
xxx
GAIA_PRETRANSLATE
xxx
GAIA_CONCAT_LOCALES
xxx
GAIA_DISTRIBUTION_DIR
Utilisez cela pour spéficier une Gaia customisée; voir le Market customizations guide pour plus détails.
GAIA_APPDIRS
xxx
GAIA_ALLAPPDIRS
xxx
GAIA_MEMORY_PROFILE
xxx
NOFTU
Lorsque la valeur est à 1, cela met la préférence pour déactiver le FTU.
REMOTE_DEBUGGER
xxx
TARGET_BUILD_VARIANT
xxx
SETTINGS_PATH
xxx
FTU_PING_URL
xxx
KEYBOARD_LAYOUTS_PATH
xxx
CONTACTS_IMPORT_SERVICES_PATH
xxx
EMAIL_SERVICES_PATH
xxx
STAGE_DIR
xxx
GAIA_APP_TARGET
xxx
BUILD_DEBUG
xxx
VARIANT_PATH
xxx
REBUILD
xxx
P
xxx
VERBOSE
xxx
RAPTOR
Active les marques de performances en mesurant et sortant les meta-données dans le logcat. Utilisation : RAPTOR=1 make reset-gaia
SHARE_PERF_USAGE
xxx
DEFAULT_KEYBOAD_SYMBOLS_FONT
xxx
DEFAULT_GAIA_ICONS_FONT
xxx
MOZ_APPROX_LOCATION
Utilisez cela pour activer le panneau vie privée, par défaut la valeur est à off sauf dans les build ingénieur.

Commandes

La suite est une liste d'abreviations des commandes les plus utilisées dont vous aurez besoin. Une liste plus détaillée peut être trouvée dans Gaia make options reference.

make
Construit uniquement le profil.
make reset-gaia
Supprime le profil précédent et installe un nouveau profil Gaia.
make install-gaia
Install Gaia par dessus sans rien supprimer.
make production
Fait la même chose que PRODUCTION=1 make reset-gaia.
make clean
Supprime le profil généré.
make really-clean
Supprime le profil généré et le dossier de xul-runner; vous devez utiliser cela seulement quand tout est cassé.

Gecko build

Variables

B2G_DEBUG
xxx
VARIANT
Spéficie les variantes de gecko que vous voulez compiler. Les types valides sont listés ci-dessous:
eng

Ceci est le flag par défaut. Un make est la même chose que make eng.

  • Installe les modules tagger avec: eng, debug, user, et/ou development.
  • Installe les modules non-APK qui n'ont pas de tags spéficiés.
  • Installe les APK selon les fichiers de définition du produit, en plus des tagger APK.
  • ro.secure=0
  • ro.debuggable=1
  • ro.kernel.android.checkjni=1
  • adb est activé par defaut.
  • marionette est activé
  • Ne possède pas les notifications de mise à jour par défaut ( B2G_UPDATER=1 est activé )
user

Ceci est le flag attendu pour une release final.

  • Installe les modules tagger avec user.
  • Installe les modules non-APK qui n'ont pas de tags spéficiés.
  • Installe les APK selon les fichiers de définition du produit, les tags sont ignorés pour les modules APK.
  • ro.secure=1
  • ro.debuggable=0
  • adb est désactivé par défaut.
  • Optimise par défaut
userdebug make userdebug

La même chose que user, excepté:

  • Installe aussi les modules tagger avec debug.
  • ro.debuggable=1
  • adb est activé par défaut.
  • marionette est activé

Note: Cette table est inspirée par la table Android Build Variants .

Commandse

./build.sh buildsymbols
Crée une build symbols pour debugger; voir Uploading symbols to Mozilla's symbol server.
./build.sh gecko-update-full
Crée un fichier mar OTA; voir Firefox OS update packages.
./build.sh gecko-update-fota
Crée un mar/zip FOTA basé sur des fichiers qui contiennent seulement un sous-ensemble de fichiers et de dossiers; see Firefox OS update packages.
./build.sh gecko-update-fota-full
Crée un mar/zip FOTA basé sur les fichiers; voir Firefox OS update packages.
./build.sh gecko-update-fota-fullimg
Crée un mar/zip FOTA basé sur les partitions; voir Firefox OS update packages.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : jwhitlock, Hell_Carlito, dattaz
 Dernière mise à jour par : jwhitlock,