Mettre à jour votre Flame

Cet article nécessite une relecture technique. Voici comment vous pouvez aider.

Cet article nécessite une relecture rédactionnelle. Voici comment vous pouvez aider.

Cet article explique comment mettre à jour la partie logicielle de votre Flame — y compris la mise à jour de Firefox OS et l'ajout de nouvelles applications sur votre téléphone — comment conserver vos données, et d'autres informations utiles. Avant toute chose, vous devriez vous assurer que vous avez suivi les étapes d'initialisation nécessaires

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.

Prérequis: Assurez vous d'avoir adb et fastboot installés et fonctionnels sur votre système (voir Installer ADB et Fastboot).
 
  1. Télécharger la dernière image —Base image v18D_nightly_v4sur 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.

Nota: Vous pouvez vérifier la qualité de l'image téléchargée en tapant la commande ci-dessous :

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).

Nota: si vous voulez avoir la dernière version instable pour Flame (qui n'a pas été pleinement testée), aller dans settings -> developer, descendre vers le bas et changer le channel pour nightly-latest.  Rebooter le Flame, retourner dans settings -> device info et vérifier s'il y a des MAJ. Vous pouvez obtenir ainsi la dernière version sans "shallow flash". Pour le "shallow flashing" voir plus bas dans cet article.

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.

Note: Vous pouvez connaître l'image utilisée par votre périphérique en utilisant la commande: adb shell getprop ro.bootloader

Important: Attention, lorsque vous effectuez une installation complète ou partielle (shallow) à partir de ces images, vous perdez les informations contenues dans votre téléphone. Avant d'effectuer le "flash", vous devriez faire une sauvegarde de vos données personnelles. Vous pourrez ainsi les restaurer après. Rendez-vous à la section "sauvegarder et restaurer les données de votre Flame".

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.
Note: Les images de Firefox OS v180 et suivantes sont basées sur Android KK (Kitkat, 4.4); les images basées sur JB (Jellybean, 4.1-4.3) ne sont plus supportées et sont obsolètes. N'utilisez pas de version inférieure à v180.

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

Note: Si vous rencontrez une erreur "permission denied" ou un erreur "Waiting for device" lorsque vous exécutez, il s'agit probablement d'une erreur provoquée par des droits système manquant. Vous pouvez résoudre ce problème en exécutant la commande suivante chmod +x flash.sh depuis le bon répertoire.

Note : Vous pouvez aussi essayer d'installer vos propres versions de Firefox OS sur votre Flame. Pour cela, rendez vous ici: Compiler et installer Firefox OS.

Régler les problèmes de font

Attention : cette étape est spécifique à l'image v180

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.

Note : Vous pouvez aussi utiliser le script update_system_fonts.sh qui téléchargera et installera automatiquement les fonts manquantes.

Mettre à jour votre Flame avec une image du canal nightly

Note: Actuellement, les versions Nightly de Firefox OS ne proposent pas de support pour A-GPS ce qui peut poser des soucis de performance avec la fonctionnalité GPS de votre téléphone. Il est prévu que cela soit résolu dans une future version publiée sur ce canal.

Important: Attention, lorsque vous effectuez une installation complète ou partielle (shallow) à partir de ces images, vous perdez les informations contenues dans votre téléphone. Avant d'effectuer le "flash", vous devriez faire une sauvegarde de vos données personnelles. Vous pourrez ainsi les restaurer après. Rendez-vous à la section "sauvegarder et restaurer les données de votre Flame".

  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 http://ftp.mozilla.org/pub/mozilla.org/b2g/nightly/). Vous pouvez aussi utiliser une des images suivantes :
  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 .

Note: Si vous rencontrez une erreur "permission denied" ou une erreur "Waiting for device" lorsque vous exécutez l'étape ci-dessus, il s'agit probablement d'une erreur provoquée par des droits système manquants. Vous pouvez résoudre ce problème en exécutant la commande suivante: chmod +x flash.sh depuis le bon répertoire.

Note: Une installation "shallow flash" met à jour Gecko, Gaia et seulement quelques données systèmes en opposition à une installation complète qui met à jour Gecko/Gaia mais aussi Gonk avec l'ensemble des paramétrages spécifiques à votre téléphone. C'est pour cette raison qu'il est conseillé d'installer une image complète à jour avant d'effectuer une installation "shallow" : de cette manière vous êtes assuré d'avoir une version à jour de Gonk et ses paramètres.

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.

Note: Vous avez le choix entre de nombreux canaux de mise à jour . Exécutez la commande "./change_channel.sh -h" pour les lister.

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.

Emergency download tool dialog box as it is when it start.

Note : L'outil n'est compatible qu'avec Windows.

Note : L'outil de récupération est fourni dans l'état, sans instructions supplémentaires ou documentation (tout du moins pas encore).

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.

Note: Lorsque vous utilisez cet outil, assurez-vous d'avoir activé le mode debogage distant via USB depuis les paramètres pour développeurs sur Firefox OS et que l'outil ADB est installé sur votre ordinateur.

Note: Si vous avez un message d'erreur à propos d'autorisations manquantes pour exécuter le script, exécutez la commande suivante :

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

Note: Vous pouvez lister l'ensemble des options disponibles en exécutant la commande python backup_restore_profile.py -h.

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

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : jwhitlock, BiiO, kriss, Vosky, r3d, Nalah, tchevalier, brunetton, Hywan, keguira, Toumitoun
 Dernière mise à jour par : jwhitlock,