Mettre à jour votre Flame

Guide rapide pour mettre à jour Firefox OS sur le Flame

Il y a beaucoup d'informations dans cet article, alors nous avons décidé de vous fournir un guide qui vous permet de maintenir votre Flame à jour. Vous trouverez ci-dessous les informations nécessaires.

Flashage vers la dernière image (2.5)

Les étapes suivantes doivent être validées avant toute autre chose.

1. Télécharger la dernière image —Base image v18D_nightly_v4 — sur votre PC ou Mac.
2. Sur votre Flame, activer le "remote debugging" dans le menu Settings > Developer et activer le Debugging via USB dans le menu Developer.
3. Connecter votre Flame à votre PC / Mac via un cable USB.
4. Vérifier la bonne connexion en tapant la commande :

   adb devices  

Vous devriez avoir une réponse comme celle-ci:

List of devices attached
94f7ce4c    device

• Si vous ne voyez pas votre Flame (si la ligne n°2 n'apparaît pas), alors débranchez et rebranchez le câble USB et vérifiez que l'option Debugging via USB soit bien activée comme expliqué ci-dessus. Si vous avez un message qui dit que  adb n'est pas disponible, alors revenez au prérequis ci-dessus et assurez-vous de bien installer adb et fastboot.
• Extraire l'image zippée et aller dans le répertoire où elle se trouve en tapant par exemple :

  cd v18D_nightly_v4

• Lancer le script qui permet de flasher votre Flame en entrant la commande qui correspond à votre système d'exploitation :

  # Windows
  flash.bat
  
  # Linux / OSX
  ./flash.sh

1. Notes : Si le script ne parvient pas à voir votre Flame, vérifiez que vous avez correctement configuré les règles udev. Si le script flash.sh n'existe pas, vous pouvez renommer le fichier flash.bat en flash.sh et l'exécuter.

Checksum: SHA512(v18D_nightly_v4.zip)= 9105e29fd39da1ae487b01da4431a803d619d31482147b4383002b8a10268905fd444b108a438395a78d289cfe4e8fba10c3fb6b0d187f3535f027bf90c2391a Build id: 20150527010201

A cet instant, vous devez être en présence d'un Flame avec la version 2.5 de Firefox OS et recevoir les mises à jour OTA (Over The Air).

Bug de reset de l'Update channel

Comme notifié dans le bug 1217490, plusieurs testeurs de Firefox OS essayant Firefox OS 2.5 latest OTA updates (sur Flame, mais aussi sur d'autres smartphones) ont constaté que quand ils font une MAJ OTA, leur update channel est réinitialisé à nightly, ce qui implique qu'ils ne vont plus recevoir des MAJ OTA par la suite. Pour éviter le problème, il est conseillé de mettre votre update channel à nightly-latest en utilisant WebIDE. Pour cela :

1. Brancher votre Flame au PC/Mac via USB (assurez-vous que Debugging via USB est réglé sur ADB and DevTools dans le Developer Settings)
2. Ouvrir le navigateur Firefox sur votre PC/mac et lancer WebIDE.
3. Connecter WebIDE à votre Flame en le sélectionnant dans le menu USB Devices. Accepter la connexion sur le Flame pour l'activer.
4. Dans le Menu Sélection de l'environnement en haut à droite de WebIDE UI, sélectionner Paramètres de l'appareil.
5. Chercher app.update.channel dans la liste et changer la valeur dans la textbox pour nightly-latest.
6. Chercher app.update.channel.backup et changer la valeur pour  nightly-latest si vous voulez restez en Nightly après les MAJ.

Mettre à jour la partie logicielle du Flame (Firefox OS 2.0, pour plus récent voir plus haut)

Il existe deux canaux de diffusion pour les mises à jour de Firefox OS pour le Flame:

• Le premier diffuse les versions officielles. Le Flame est livré avec ce système et reçoit des notifications à chaque mise à jour majeure. Par exemple, le Flame sera mis à jour de la version 1.3 à la version 2.0, de celle-ci à la version 2.1, etc.
• Le second canal est celui que l'on appelle nightly. Le Flame peut être installé avec une version depuis ce canal et, après installation initiale, recevra quotidiennement des mises à jours en OTA (over the air). Ce canal est plutôt destiné aux développeurs du fait de l'instabilité de cette version.

Images d'installation

Vous trouverez les images et outils d'installation aux adresses suivantes :

Dernières versions :

• Stable et production : Image v18D.zip : la plus récente archive stable contenant l'image de base de Firefox OS 2.0.
• Nightly et développement : Image v18D_nightly : la plus récente image du canal nightly contenant l'image de base de Firefox OS 2.5.

Versions précédentes :

Ces versions sont listées ici seulement pour information, vous ne devriez pas les utiliser.

• Image v188.zip: Une ancienne archive contenant l'image de base de Firefox OS 2.0 pour le Flame.
• Image v180.zip: Une ancienne archive contenant également l'image de base de Firefox OS 2.0.
• Image v123.zip: Une image obsolète basée sur Jellybean d'Android; vous ne devriez pas utiliser celle-ci.

Installation d'une image de base

Pour installer une image de base sur votre périphérique:

1. Assurez-vous que le débogage à distance soit activé en utilisant la fonction Remote debugging/Debugging via USB dans les menus de développement (cette option peut avoir un nom différent suivant la version de Firefox OS que vous utilisez actuellement).
2. Connectez votre téléphone via un câble USB à votre ordinateur. Vérifiez que votre téléphone est reconnu correctement en exécutant la commande adb devices depuis un terminal.
3. Téléchargez une archive zip référencée ci-dessus et dézippez-la dans un répertoire.
4. Allez dans le répertoire où vous avez extrait les fichiers et exécutez les commandes suivantes :
   • Sous Windows, placez-vous dans le répertoire depuis la ligne de commande et exécutez le script flash.bat (vous pouvez aussi double-cliquer sur le fichier depuis l'explorateur Windows).
     Notes : Si le script flash.bat n'existe pas, vous pouvez renommer le fichier flash.sh en flash.bat et l'exécuter. Vérifiez bien que les outils adb et fastboot sont installés et ajoutés à votre variable d'environnement PATH.
   • Sous Linux / OSX, placez-vous dans le répertoire depuis la ligne de commande et exécutez le script flash.sh.
     Attention : il est déconseillé d'exécuter la commande avec sudo car cela est très dangereux de l'utiliser avec des exécutables téléchargés depuis internet.
     Notes : Si le script ne parvient pas à voir votre Flame, vérifiez que vous avez correctement configuré les règles udev. Si le script flash.sh n'existe pas, vous pouvez renommer le fichier flash.bat en flash.sh et l'exécuter

Régler les problèmes de font

Après avoir mis à jour Gecko et Gaia vers le canal nightly avec l'image v180, vous rencontrerez des problèmes car Gecko et Gaïa attendront des fonts qui ne sont pas dans l'image (ce bug a été corrigé avec la version v188). Pour résoudre ce problème, téléchargez notre outil de mise à jour des fonts, dézippez-le et exécutez le script flash.sh fourni.

Mettre à jour votre Flame avec une image du canal nightly

1. Avant de penser à installer une version Nightly, vous devriez installer la dernière image du canal stable sur votre téléphone afin d'être sûr que tous les prérequis systèmes soient remplis.
2. Parce que vous allez installer une image complète du système, vous devez activer le débogage à distance depuis votre Flame depuis les paramètres pour développeurs sur Firefox OS.
3. Sélectionnez l'image que vous voulez installer (en la sélectionnant depuis https://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/). Vous pouvez aussi utiliser une des images suivantes :
   • Images de « production » (comprenant l'ensemble des langues)
     • Dernière image de la version master (2.5)
     • Dernière image de la version 2.2
     • Dernière image de la version 2.1
     • Dernière image de la version 2.0
   • Versions de développement (comprenant des applications de test et seulement un jeu de pseudo-langues)
     • Dernière image de la version master (2.5)
     • Dernière image de la version 2.2
     • Dernière image de la version 2.1
     • Dernière image de la version 2.0
4. Sélectionnez une version et téléchargez les deux fichiers suivant b2g-XX.XX.en-US.android-arm.tar.gz et gaia.zip. Sauvegardez-les dans un dossier nommé, par exemple, fxos.
5. Téléchargez le script d'installation shallow flash et sauvegardez-le dans le même dossier que les deux fichiers précédents. Pour cela, suivez le lien shallow flash, cliquez sur le bouton Raw et utilisez la fonctionnalité "enregistrer sous" de votre navigateur pour sauvegarder le fichier en le nommant shallow_flash.sh.
6. Pour les utilisateur Windows: Téléchargez le script shallow_flash.bat et installez l'outil Cygwin qui fournit une ligne de commande typée Linux sur votre environnement Windows. Pour cela, téléchargez le fichier d'installation setup*.exe  et déposez-le dans le même répertoire que le script shallow_flash.bat . Celui-ci se chargera d'installer correctement Cygwin pour vous.

7. Depuis le Terminal, placez-vous dans le répertoire où vous avez sauvegardé vos fichiers et exécutez les commandes suivantes :

   Linux:

   ./shallow_flash.sh --gaia=gaia.zip --gecko=b2g-XX.XX.en-US.android-arm.tar.gz
   

   Mac:

   ./shallow_flash.sh --gaia gaia.zip --gecko b2g-XX.XX.en-US.android-arm.tar.gz

   Windows:

   Double-cliquez sur shallow_flash.bat ou exécutez-le depuis la ligne de commande Windows. Cela aura pour effet de flasher votre téléphone avec gaia.zip et un fichier  b2g-XX.XX.en-US.android-arm.tar.gz .

Après installation, votre téléphone devrait redémarrer et vous proposer les étapes de paramétrage spécifiques à une nouvelle installation.

Passer sur le canal d'installation nightly

Depuis la version 2.2, vous pouvez directement sélectionner le canal de mise à jour depuis les paramètres pour développeurs sur Firefox OS.

Si ce paramétrage n'est pas disponible, vous pouvez utiliser la "vieille" méthode.

1. Assurez-vous que le débogage distant par USB soit activé depuis les paramètres pour développeurs sur Firefox OS.
2. Téléchargez le script suivant. Pour cela, suivez le lien, cliquez sur le boutton Raw et utilisez la fonctionnalité "enregistrer sous" de votre navigateur pour sauvegarder le fichier en le nommant change_channel.sh.
3. Depuis la ligne de commande et le répertoire où vous avez enregistré le script, vous pouvez changer le canal de mise à jour en exécutant la commande suivante :
    

   ./change_channel.sh -v nightly

4. Après redémarrage du téléphone, vous pouvez contrôler la présence d'une mise à jour OTA en vous rendant dans les menus Paramètres > Informations > Mises à jour logicielles > check for updates.

Mode Fastboot

Si l'installation d'une image échoue sur votre téléphone, votre téléphone peut ne plus fonctionner correctement et démarrer seulement en mode Fastboot. Ce mode de récupération propose peu d'options (Reboot, Update from adb, Wipe data, Wipe cache, and Update from sdcard). Malheureusement, sélectionner l'option Update from adb charge un mode spécifique de l'outil ADB (adb sideload) ne permettant pas d'exécuter les scripts nécessaires à l'installation d'une image correcte.

Pour forcer un démarrage en mode fastboot utilisable, vous pouvez exécuter les commandes suivantes :

1. Éteignez votre téléphone (si vous ne pouvez pas l'éteindre, retirez la batterie et remettez-la en place).

2. Branchez le téléphone à votre ordinateur via un câble USB.
3. Démarrez votre téléphone en maintenant les boutons d'allumage et "descendre le volume".

Votre téléphone devrait s'allumer et afficher le texte "FASTBOOT" : cela signifie qu'il attend d'être connecté par USB. Si vous exécutez la commande fastboot devices vous devriez voir votre téléphone. Remarquez que la commande habituelle adb ne verra pas votre téléphone. Depuis ce mode, vous pouvez utiliser les scripts pour installer une image de base comme expliqué plus haut. Comme les scripts utilisent des commandes adb et fastboot, vous devriez voir des messages d'erreur et / ou d'avertissement apparaître mais cela n'empêchera pas l'installation de se dérouler complètement.

Outil de récupération d'urgence

Si la mise à jour échoue, que votre téléphone est inutilisable et que vous ne pouvez entrer en mode fastboot, vous pouvez utiliser l'outil de récupération d'urgence. Le câble fourni avec le téléphone qui comporte une étiquette rouge “Recovery Cable” et l'outil de récupération "Emergency Download Tool", sont nécessaires à cette opération. Contactez le fabriquant (flameservice [at] thundersoft.com) pour tout support technique.

Mode Recovery

Vous pouvez entrer dans le mode recovery pour effacer les données de votre téléphone ou installer manuellement un nouveau firmware. Pour rentrer dans ce mode, vous avez deux solutions :

• Si l'outil ADB est disponible, assurez-vous d'avoir activé le débogage distant depuis les paramètres pour développeurs sur Firefox OS, connectez votre téléphone à votre ordinateur et entrez la commande suivante dans un terminal adb reboot recovery.
• Si votre téléphone est éteint, allumez-le en maintenant les boutons d'allumage et monter le volume.

Depuis le mode recovery, vous pouvez naviguer dans les menus via les boutons monter / baisser le volume et sélectionner les options via le bouton d'allumage. Assurez vous d'avoir sauvegardé votre profil avec vos données personnelles avant d'effacer les données ou d'effectuer une mise à jour.

Sauvegarder et restaurer les données de votre Flame

Lorsque vous utilisez votre téléphone Flame couramment, vous ne voulez peut-être pas perdre vos données personnelles comme vos contacts, vos paramétrages ou vos applications en mettant à jour votre téléphone avec les images listés ci-dessus. Pour sauvegarder et restaurer votre profil, vous pouvez utiliser notre outil livré dans le dépôt Git B2G-flash-tool.

1. Ouvrez votre ligne de commande.
2. Clonez le dépôt suivant (vous devez avoir Git installé sur votre système). (Si vous ne possédez pas Git ou ne pouvez l'installer, un bouton "download as Zip" vous permet de télécharger le dépôt complet).

   git clone https://github.com/Mozilla-TWQA/B2G-flash-tool

3. L'outil se présente sous la forme d'un script python : backup_restore_profile.py. Pour l'utiliser, vous devez avoir l'outil Python d'installé sur votre ordinateur (la version 2.7.x devrait suffire). Les systèmes Linux et Mac les installent habituellement par défaut.
4. Rendez-vous dans le dossier où vous avez cloné le dépôt avec un terminal de ligne de commande cd B2G-flash-tool.

chmod +x backup_restore_profile.py

Sauvegarder les données de votre téléphone

Depuis le répertoire où vous avez sauvegardé le dépôt exécutez la commande suivante :

python backup_restore_profile.py -b

Cela devrait sauvegarder votre profil dans un répertoire mozilla-profile situé dans le même répertoire que le script.

Restaurer les données sur votre téléphone

Depuis le répertoire où est situé mozilla-profile, exécutez la commande suivante :

python backup_restore_profile.py -r

Installer des application sur votre Flame

Les outils App Manager et WebIDE rendent facile l'installation et le débogage des applications sur votre téléphone.

Ajuster la taille de la RAM

Vous pouvez modifier la taille de la RAM de votre téléphone pour tester le comportement du système ou des applications sur des téléphones qui auraient moins de RAM que le Flame.

Cela est géré depuis le mode fastboot (installez d'abord fastboot et ADB) et exécutez les commandes suivantes :

adb reboot bootloader
fastboot oem mem [0|256-1024]

“0” indique que la quantité de RAM sera détectée automatiquement, “256-1024” correspond à un nombre de megabytes. Par exemple, si vous voulez que votre système n'utilise que 512Mo entrez la commande fastboot oem mem 512.

Pour que les modifications soient prises en compte, vous devrez redémarrer votre téléphone en utilisant la commande suivante :

fastboot reboot

La quantité de mémoire actuellement utilisée / paramétrée peut être récupérée avec la commande suivante :

fastboot getvar mem