Configuration initiale

Pour tous systèmes d'exploitation

Vous devez installer les outils ADB et Fastboot sur votre ordinateur. Ces applications permettent notamment d'interagir avec votre téléphone lorsque ceux-ci sont connectés par USB. Ce sont elles qui vous permettront de "flasher" votre téléphone dans une version de Firefox OS, le rétablir si il est "briqué", pousser des applications, etc...

ADB et Fastboot sont disponibles sur Android Developer Toolkit:

1. Rendez-vous sur le site
2. Cliquez sur Download Eclipse ADT button.
3. Acceptez le contrat d'utilisation après l'avoir lu.
4. Sélectionnez la version 32-bits ou 64-bit suivant votre système d'exploitation courant (si vous ne savez pas laquelle prendre, utilisez la version 32-bit).
5. Cliquez sur le bouton Download Eclipse ADT with the Android SDK....
6. Après téléchargement du fichier dézippez le dans le répertoire de votre choix.
7. Le nom du dossier étant assez compliqué, vous pouvez le renommer le dossier en adt si vous le souhaitez.

ADB est un outil qui fonctione uniquement en ligne de commande. Ouvrez une invite de ligne de commande ou un terminal de votre système et rendez-vous dans le dossier que vous venez de dézipper puis dans adt/sdk/platform-tools et lancez la commande adb. Vous devriez voir apparaitre une liste d'informations en réponse. Exécuter la commande adb devices devrait retourner la liste des appareils reliés à votre ordinateur (la liste sera vide si votre téléphone n'est pas connecté.

Afin que l'ensemble des outils fonctionnent, vous devez ajouter les outils ADB à la variable système PATH. Gràce à ça, la commande adb sera exécutable depuis n'importe quel dossier.

Pour faire cela sous Windows 8 (pour Windows 7, ce sera identique mais le nom des menus peut différer) :

• Effectuez un clic droit sur le bouton Windows qui est en bas à gauche de votre écran et sélectionnez button in the bottom left and select Panneau de configuration > Système et sécurité > Système > Paramètres système avancés > Variables d'environnement.
• Dans les variables système, trouvez la variable appelée Path, sélectionnez là et cliquez sur Editer...
• Dans le champ texte Valeur, assurez-vous de vous positionner à la fin du texte (il peut être particulièrement long) et tapez un point-virgule (;) suivi par le chemin du dossier des outils ADB. Cela devrait ressembler à ça si vous avez laissé le dossier adt sur le bureau : C:\Users\[votre nom d'utilisateur]\Desktop\adt\sdk\platform-tools.
  
  Si votre nom d'utilisateur est pierredupond vous ajouterez à la fin ;C:\Users\pierredupond\Desktop\adt\sdk\platform-tools, ou pour ceux qui auraient une version datant d'aout 2016 du SDK sous windows 8.1, devraient le trouver à C:\Users\[YOUR USER NAME]\AppData\Local\Android\sdk\platform-tools (si ce n'est pas le cas faire la mise à jour depuis le SDK et retourner voir).
• Appuyez sur OK sur l'ensemble des fenêtres ouvertes pour valider les modifications.
• Fermez la ligne de commande précédemment ouverte et ouvrez en une nouvelle. Tapez ensuite directement adb devices. Si la réponse est List of devices attached, cela signifie que vous avez bien configuré les outils ADB. Rendez-vous maintenant à la section étapes supplémentaires pour windows.

Sous Mac/Linux:

• Ouvrez votre répertoire personnel et éditez le fichier nommé .bash_profile ou .bashrc file avec un éditeur de texte simple comme VIM, Text Wrangler ou Sublime Text (n'utilisez pas d'éditeur de texte avancé comme Word ou Writer).
• Ajoutez une nouvelle ligne à la fin du fichier qui précisera le chemin du dossier adt :
  • Mac : PATH=/Users/[votre nom d'utilisateur]/Desktop/adt/sdk/platform-tools:$PATH
  • Linux : PATH=/home/[votre nom d'utilisateur]/Desktop/adt/sdk/platform-tools:$PATH
• Sauvegardez et fermez le fichier.
• Redémarrez un nouveau terminal et testez la configuration en tapant la commande adb devices. Si la commande répond List of devices attached, vous avez correctement configuré les outils ADB.

Enable remote debugging

Assurez-vous que le débogage est activé sur votre Flame, en utilisant l'option Débogage distant/Dégogage USB de l'appareil Paramètres développeurs (L'option est nommée différemment, selon que vous ayez Firefox 1.3 et inférieur, ou Firefox 1.4+ installé).

Étapes supplémentaires pour Linux

Suivant la distribution que vous utilisez, vous devrez peut-être ajouter une nouvelle règle udev pour votre téléphone.

Afin de déterminer le vendor ID de votre téléphone, connectez-le via USB et exécutez la commande lsusb qui listera l'ensemble de vos périphériques USB. Trouvez votre téléphone dans la liste et notez les quatre derniers chiffres qui suivent le préfixe "ID". Un identifiant de Flame est habituellement 05c6, donc la règle UDEV à ajouter serait :

SUBSYSTEM=="usb", ATTRS{idVendor}=="05c6", MODE="0666"

Si votre téléphone est listé avec un autre identifiant, utilisez le à la place. Par exemple :

SUBSYSTEM=="usb", ATTRS{idVendor}=="18d1", MODE="0666"

Après modification, exécutez la commande udevadm control --reload-rules pour recharger la configuration, débranchez puis rebranchez votre téléphone avant de continuer.

Étapes supplémentaires pour Windows

Pour accéder à un téléphone Flame avec les outils ADB ainsi qu'avec les outils de développement de Mozilla comme App Manager/WebIDE , un driver USB est demandé. La suite de ce paragraphe va vous détailler les étapes d'installation de celui-ci.

Télécharger le driver

Téléchargez le driver Windows. Extrayez le fichier ZIP sur dans un répertoire.

Installer le driver USB

Connectez votre téléphone Flame à votre ordinateur avec un câble USB.

Pour installer le driver, ouvrer le répertoire Alcatel_USB_Driver_Q_4.0.0_2013_11_11_noinstall créé après extraction et exécutez le fichier DriverInstaller.exe. Vous pouvez recevoir un message d'avertissement de la part de Windows indiquant qu'il ne connait pas l'éditeur de l'application. Si c'est le cas, cliquez sur oui pour continuer.

Cliquez sur le bouton Install pour installer le driver.

Après installation, vous pouvez contrôler que tout fonctionne correctement en ouvrant un terminal et en exécutant la commande adb devices.

Assurez-vous que le débogage à distance est activé sur votre téléphone en activant l'option Remote debugging/Debugging via USB dans les paramètres pour développeur (suivant la version que vous utilisez le nom de l'option et sa localisation dans les menus peut légèrement différer).

Le résultat de la commande doit ressembler à ça :

List of devices attached
3561d02a          device

Si votre téléphone n'apparait pas, contrôler le gestionnaire de périphériques de Windows. Le Flame devrait apparaitre sous le nom "ACER ADB Interface". Vous pouvez confirmer sa présence en débranchant le câble USB : il devrait alors disparaitre de liste des périphériques. Désinstallez le driver en effectuant un clic droit sur "ACER ADB Interface" et cliquez sur désinstaller. Assurez-vous de bien cocher la case pour désinstaller le driver.  Relancez l'installation. Il peut être utile de désactiver la mise en veille de votre téléphone durant l'installation : Windows peut vouloir utiliser un driver par défaut quand l'écran est éteint.