Installer Firefox OS sur un téléphone mobile

Une fois que vous avez compilé Boot to Gecko pour un téléphone mobile supporté, vous pouvez l'installer. Cet article va vous guider dans cette procédure.

Note : La première fois que vous flashez votre téléphone, il doit posséder la version 4 d'Android (Ice Cream Sandwich). Autrement, le processus ne se déroulera pas correctement. À partir du moment où vous avez effectué votre première installation de B2G, vous pourrez effectuer les mises à jours dessus.

Installer ADB

Sur OSX

Si vous avez homebrew sur OS X, effectuez :

brew install android-platform-tools

Sinon, téléchargez les Android Developer Tools et ajoutez les binaires à votre PATH.

Sur Ubuntu

sudo apt-get install android-tools-adb

Flasher votre téléphone

Pour flasher entièrement votre téléphone, connectez-le à votre ordinateur puis entrez simplement :

./flash.sh

C'est tout. Le B2G que vous aviez compilé va alors être flashé sur votre téléphone.

Attention : si vous mettez à jour avec une version comprenant d'importantes modification de Gaia, vous pouvez également avoir besoin de lancer les commandes suivantes:

cd gaia
make reset-gaia

Cela effacera les données enregistrées dans Gaia, mais surtout les configurations et préférences obsolètes - ainsi vous lancerez une Gaia « propre ». En théorie, ./flash.sh devrait effectuer ces commandes, mais sur certains terminaux (par exemple Hamachi), ./flash.sh ne met à jour qu'un sous-ensemble des modules (./flash.sh -f forcera alors la mise à jour intégrale).

Configurer les règles udev pour votre appareil

Sous Linux, si vous obtenez ceci :

< waiting for device >

Cela signifie probablement que vous n'avez pas entré de règle udev spécifique au montage rapide (fastboot) de votre appareil, qui est différent de celui de adb. Vous pouvez obtenir le USB vendor ID en lançant lsusb , mais il s'agit habituellement de celui de Google : 18d1, aussi ajouter cette ligne dans votre fichier /etc/udev/rules.d/51-android.rules devrait suffire :

SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev"

De façon plus générale, voir le paragraphe sur la configuration des règles udev dans l'article sur les prérequis.

Note : Sous Linux, si vous obtenez une erreur libusb "-3", cela signifie que vous devez être root pour accéder au périphérique USB. Relancez le script à nouveau en utilisant sudo.

Note 2: Si vous avez un téléphone Unagi ou un Geeksphone Keon; vous aurez besoin de deux lignes - une pour l'ID du vendeur de téléphone, et une pour l'ID de Google.

Notes destinées aux possesseurs de terminaux Hamachi, Heix et Leo

Si votre téléphone est un terminal Hamachi, Helix ou Leo, par défaut le script ./flash.sh ne copiera que Gecko et Gaia. Il est recommander de flasher tout d'abord l'OEM comme base afin de disposer du firmware et des couches Gonk, puis de flasher Gecko et Gaia par dessus. Si vous désirez flasher en utilisant directement les images, vous pouvez outrepasser le comportement par défaut avec

./flash.sh -f

Notes destinées aux possesseurs de Samsung Galaxy 2

Si votre téléphone est un Galaxy S2 et que vous utilisez Heimdall 1.3.2 (la dernière version ; utilisez heimdall version pour connaître la version que vous utilisez), vous pouvez apercevoir une erreur inquiétante "FACTORYFS upload failed!" accompagnée d'informations complémentaires. Il s'agit en fait d'un message indiquant la réussite de l'opération, que vous pouvez ignorer.

Pour vous débarasser de ce comportement étrange, récupérer une copie de la source d'Heimdall, en downgradant vers la version 1.3.1 (git checkout fbbed42c1e5719cc7a4dceeba098981f19f37c06 ), puis compilez-la en suivant les informations du fichier README. L'installation de cette version devrait faire disparaître cette erreur. Cette étape, bien qu'utile pour retirer ce message étrange, n'est pas nécessaire.

Aucune version de Heimdall ne peut flasher une image système de plus de 100 Mo. Vous pouvez vérifier si votre image n'est pas trop grosse en utilisant la commande :

ls -l ./out/target/product/galaxys2/system.img

Si elle est trop volumineuse, demandez conseil sur IRC (#b2g) ; il existe des solutions pour effectuer le flashage en deux fois.

Étape supplémentaire pour le Samsung Galaxy S2

Si vous flashez votre Galaxy S2, il vous faudra suivre cette étape supplémentaire. Gaia n'est pas flashée automatiquement par le script flash.sh ; vous aurez également besoin de lancer la commande

./flash.sh gaia

Flasher des partitions spécifiques vers un téléphone avec fastboot

Vous pouvez flasher des partitions spécifiques vers des téléphone avec fastboot (c'est à dire, autre qu'un Galaxy S 2). Par exemple :

./flash.sh system
./flash.sh boot
./flash.sh user

Attention : Flasher la partition user peut entraîner la pertes des informations spécifiques à l'utilisateur comme les contacts et autres !

Mettre à jour des modules spécifiques

Vous pouvez mettre à jour des modules spécifiques en spécifiant leur nom lors de l'opération de flashage. Par exemple :

./flash.sh gaia
./flash.sh gecko

Pour mettre à jour uniquement une application donnée, vous pouvez utiliser la variable d'environnement BUILD_APP_NAME :

BUILD_APP_NAME=calendar ./flash.sh gaia

Si vous n'utilisez pas votre téléphone pour développer (vous n'êtes pas intéressé(e) par les applications de tests et les éventuelles optimisations), vous pouvez mettre à jour Gaia grâce à la commande suivante :

VARIANT=user ./flash.sh gaia

Étapes suivantes

Si vous êtes arrivés jusqu'ici, votre téléphone devrait exécuter Boot to Gecko ! C'est le moment d'expérimenter, d'écrire un peu de code, des tests, ou de faire une bonne session de débogage !

Note : Un petit conseil : si l'écran de verouillage de votre B2G nouvellement compilé demande un code de déverrouillage, le code par défaut est 0000.

En cas de problème...

Voici quelques manipulations à effectuer si votre terminal ne fonctionne plus après l'installation de B2G, ou après une mise à jour.

Si l'interface graphique ne se lance pas

Si vous mettez à jour votre téléphone et que l'interface utilisateur ne se lance pas, vous pouvez effectuer une remise à zéro pour effacer les informations de configurations périmées. Cela peut permettre de corriger le problème (attention : cela peut également supprimer les informations spécifiques à l'utilisateur comme les contacts et autres !)

Voici comment faire :

cd gaia
make reset-gaia

Si vous souhaitez passer d'une version de développement à une version de production

cd gaia
make reset-gaia PRODUCTION=1

Attention : reset-gaia peut supprimer des informations spécifiques à l'utilisateur comme les contacts et autres !

Message d'erreur "image is too large" au lancement de ./flash.sh

Cela peut vouloir dire que vous devez rooter votre téléphone avant de le flasher, car B2G a besoin d'être installé sur la partition root.