Utiliser le gestionnaire d'applications

Le gestionnaire d'applications est composé de :

• Un panneau " Applications " qui gère les applications locales (les applications dont le code source est situé sur votre ordinateur) et les applications hébergées autre part. Il vous permet de les empaqueter et de les installer sur votre appareil ou sur votre simulateur et de les déboguer en utilisant les outils de développement.
• Un panneau " Appareil " qui affiche les informations à propos de l'appareil connecté comprenant la version de Firefox OS installée, les permissions requises pour utiliser les APIs sur l'appareil et les applications installées.
• Les outils de développement : collection d'outils pour le développeur (console web, inspecteur, debugger, etc.) pouvant être connectés à une application en cours d'exécution via le panneau " Applications " pour réaliser des opérations de débogage.

Installation rapide

Cette section est conçue pour vous permettre de démarrer rapidement. Si vous avez besoin de plus de détails, rendez-vous à la section Configuration du système et de l'appareil. Consultez également la section Dépannage, si vous rencontrez des problèmes.

1. Assurez-vous que vous avez installé Firefox 26 ou plus ;
2. ouvrez le gestionnaire d'applications (tapez about:app-manager dans la barre d'URL).
3. En fonction de votre situation :

a.  Si vous n'avez pas d'appareil physique : 

• Installez le simulateur de Firefox OS ;
• dans la barre d'outils du bas du gestionnaire d'applications, cliquez sur Lancer le simulateur, puis cliquez sur le nom du simulateur installé pour qu'il apparaisse.

b. Si vous avez un appareil physique :

• Assurez-vous que votre appareil utilise Firefox OS 1.2 ou plus ;
• sur Windows, installez les pilotes fournis par le fabricant de votre téléphone ;
• dans les paramètres de votre appareil, désactivez le verrouillage (Paramètres > Verrouillage) et activez le débogage distant (Paramètres > Informations sur l'appareil > Plus d'informations > Développeurs) ;
• installez l'extension ADB Helper sur Firefox pour ordinateur ;
• connectez votre appareil à votre ordinateur via un câble USB ;
• vous devriez voir le nom de votre appareil dans la barre d'outils du bas du gestionnaire d'applications, cliquez dessus.

La barre du bas devrait afficher " Connecté à xxx "

1. Cliquez sur le panneau Applications et ajoutez une application (empaquetée ou hébergée) ;
2. le bouton Mettre à jour valide votre application et l'installe sur le simulateur ou l'appareil ;
3. le bouton Déboguer connecte les outils de développement à l'application en cours d'exécution.

Consultez la section Dépannage, si vous rencontrez des problèmes.

Configuration du système et de l'appareil

La première chose que vous avez besoin de faire quand vous utilisez le gestionnaire d'applications, c'est de vous assurer que votre système et votre téléphone sont installés correctement. Cette partie va passer en revue toutes les étapes requises.

Firefox 1.2+ requis

Assurez-vous que votre appareil dispose de Firefox OS 1.2/Boot2Gecko 1.2 ou plus. Pour vérifier la version de Firefox OS que votre appareil utilise, rendez-vous dans Paramètres > Informations sur l'appareil > Logiciel.

Si votre version n'est pas assez récente, selon le téléphone que vous avez, vous aurez besoin soit d'installer une version nightly téléchargeable de Firefox OS 1.2 ou plus, soit de configurer et de compiler vous-même une version de Firefox OS depuis les sources.

Versions disponibles :

• Les versions Keon/Peak de Geeksphone (pour en apprendre plus sur comment les utiliser, lisez l'article concernant Geeksphone)
• D'autres à suivre

Débogage distant

Ensuite, vous avez besoin d'activer le débogage distant dans Firefox OS. Pour ce faire, rendez-vous dans Paramètres > Informations sur l'appareil > Plus d'informations > Développeurs et cochez la case Débogage distant.

ADB ou ADB Helper

Le processus utilise l'Android Debug Bridge (ADB) pour la connexion et la communication entre l'ordinateur et l'appareil. Il y a deux options pour utiliser ADB :

• Laissez Firefox s'occuper d'ADB (recommandé). Installer l'extension ADB Helper qui rend le processus plus facile. Avec cette extension, il n'est pas nécessaire d'installer ADB et il n'y a pas besoin de taper la commande adb forward. Tout est pris en charge par l'extension.

  Télécharger l'extension ADB Helper
• Utilisez ADB manuellement. ADB doit être installé sur votre ordinateur. Téléchargez et installez adb comme expliqué dans Installer et utiliser ADB. Vous aurez besoin d'activer la redirection de port en exécutant la commande suivante dans votre terminal :

  adb forward tcp:6000 localfilesystem:/data/local/debugger-socket

  Notez que vous aurez besoin de le faire à chaque fois que le téléphone sera redémarré ou qu'il sera déconnecté puis reconnecté à l'ordinateur.

Connecter votre appareil au gestionnaire d'applications

Une fois votre configuration terminée, il est temps de brancher votre appareil sur votre ordinateur et de démarrer le gestionnaire d'applications :

1. Branchez l'appareil sur votre ordinateur via USB ;
2. Désactivez le verrouillage sur votre appareil en allant dans Paramètres > Verrouillage et décochez la case Écran de verrouillage. C'est pratique car quand l'écran se verrouille, la connexion avec le téléphone se perd. Il ne sera donc plus disponible pour le débogage.
3. Démarrez le gestionnaire d'applications — Dans Firefox pour ordinateur, sélectionnez l'option dans le menu Développement web > Gestionnaire d'applications, ou tapez about:app-manager dans la barre d'URL.
4. Dans l'onglet du bas du gestionnaire d'application, vous verrez une barre de statut de connexion (reportez-vous à l'image ci-dessous). Vous devriez être capable de connecter votre appareil en cliquant sur le bouton « Se connecter à localhost:6000 ».
5. Si cela fonctionne, une boîte de dialogue devrait apparaître sur votre appareil : « Une requête entrante pour permettre une connexion de débogage à distance a été détectée. Autoriser la connexion ? ». Appuyez sur le bouton OK ( vous aurez peut-être besoin d'appuyer sur le bouton « Power » du téléphone pour voir la boîte de dialogue). La barre de statut de connexion devrait s'actualiser pour afficher « Connecté à B2G » avec un bouton « Se déconnecter » pour permettre d'interrompre la connexion.

Utiliser un simulateur de Firefox OS

Si vous n'avez pas d'appareil physique disponible, vous pouvez essayer d'utiliser le gestionnaire d'applications sur un simulateur de Firefox OS. Pour commencer, installez le simulateur en utilisant le bouton suivant (plusieurs versions sont disponibles ; vous devriez toutes les installer pour pouvoir tester sur le plus de versions possible) :

Installer le simulateur

Une fois que vous avez installé le ou les simulateurs, rendez-vous dans le gestionnaire d'applications et cliquez sur le bouton « Lancer le simulateur » dans la barre de statut de connexion dans l'onglet du bas. Au moins trois boutons vont apparaître :

• « Firefox OS 1.3 », « Firefox OS 1.2 », etc. (ou quelque chose de similaire) : le bouton le plus à gauche contient le nom de la version des simulateurs installés. Cliquez sur l'un d'entre eux pour démarrer une connexion à un simulateur.
• « Ajouter » : le bouton du milieu dirige vers le lien d'installation des simulateurs de cet article de façon à ce que vous puissiez installer plus de simulateurs (Firefox OS 1.2, Firefox OS 1.3, etc.).
• « Annuler » : le bouton de droite annule la connexion.

Lancer ses propres versions dans le gestionnaire d'applications

Vous pouvez lancer des versions de B2G pour ordinateur et de Gaia/Gecko que vous avez compilées dans le gestionnaire d'application avec le simulateur. Lire la page lancer ses propres versions de Firefox OS/Gaia dans le gestionnaire d'applications pour plus d'informations sur comment procéder.

Le panneau « Applications » : Tester et déboguer les applications Firefox OS

Maintenant que tout fonctionne, examinons les fonctionnalités disponibles dans le gestionnaire d'applications. Commençons avec le panneau Applications. D'ici, vous pouvez importer une application existante pour l'envoyer sur votre appareil et la déboguer :

• Pour installer une application locale, cliquez sur le bouton « Ajouter une application empaquetée » et utilisez la boîte de dialogue pour sélectionner le répertoire dans lequel votre application se trouve.
• Pour installer une application hébergée autre part, renseignez l'URL absolue du fichier manifeste de l'application dans le champ texte à l'intérieur de l'encadré « Ajouter une application hébergée », puis cliquez sur l'icône .

Les informations à propos de votre application devraient apparaître sur le côté droit de la fenêtre, comme sur l'image ci-dessous :

L'éditeur de manifeste

Depuis Firefox 28, le panneau Applications incorpore un éditeur pour le manifeste de l'application :

Le débogage

Cliquer sur « Mettre à jour » mettra à jour (installera) l'application sur l'appareil. Cliquer sur « Déboguer » connectera les outils de développement à l'application, vous permettant ainsi de déboguer directement son code.

Avant Firefox 28, les outils de développement se lancent dans une fenêtre séparée. Depuis Firefox 28, les outils de développement se lancent dans un onglet dans le gestionnaire d'applications lui-même auprès des onglets Applications et Appareil. L'icône de votre application s'affiche dans le nouvel onglet, il est donc facile de le repérer :

Les erreurs

Si une application ne s'ajoute pas — par exemple si l'URL est incorrecte — une entrée sera ajoutée sur la page de cette application indiquant des informations sur l'erreur.

Vous pouvez également supprimer une application depuis cette vue en survolant le nom ou la description de l'application sur la gauche de la fenêtre et en cliquant sur la croix qui apparaît. Cependant, cela ne supprime pas l'application de l'appareil. Pour ce faire, vous devez supprimer l'application manuellement en utilisant directement l'appareil.

Le panneau « Appareil »

L'onglet Appareil affiche des informations sur l'appareil connecté. Dans la fenêtre « Applications installées », les applications sur l'appareil peuvent être démarrées et déboguées.

La fenêtre des « Permissions » affiche les privilèges requis pour les différentes API web sur l'appareil actuel :

Enfin, vous pouvez prendre une capture d'écran de l'appareil actuel  en cliquant sur le bouton « Capture d'écran ». La capture d'écran apparaitra alors dans un nouvel onglet de Firefox. Depuis celui-ci, vous pouvez le sauvegarder ou l'abandonner.

Déboguer des applications certifiées

Actuellement, seuls les appareils tournant sous un « build » de Firefox OS 1.2+ sont capables de déboguer les applications certifiées. Si vous avez ce type d'appareil, vous pouvez activer le débogage d'applications certifiées en changeant les préférences devtools.debugger.forbid-certified-apps à false dans votre profil. Pour ce faire , suivez les étapes décrites ci-dessous :

En utilisant un appareil

1. Sur votre ordinateur, entrez la commande suivante dans le Terminal/console pour entrer dans le système de fichiers de l'appareil via l'invite de commandes :

   adb shell

   La console devrait changer pour devenir root@android.

2. Ensuite, stoppez B2G en utilisant la commande suivante :

   stop b2g

3. Naviguez dans le dossier suivant :

   cd /data/b2g/mozilla/*.default/

4. Il faut maintenant mettre à jour le fichier prefs.js avec la ligne suivante :

   echo 'user_pref("devtools.debugger.forbid-certified-apps", false);' >> prefs.js

5. Après avoir modifié et sauvegardé le fichier, redémarrez B2G avec la commande suivante :

   start b2g

6. Sortez du système de fichier d'Android en utilisant la commande exit. Vous retournerez au terminal normal.

7. Ensuite, reconnectez-vous au gestionnaire d'applications, vous devriez alors voir les applications certifiées disponibles pour le débogage

En utilisant le client B2G pour ordinateur

Avec le client B2G Desktop, la préférence est déjà définie dans votre profil dans greprefs.js, située à la racine du répertoire de votre client B2G pour ordinateur. Arrêtez le client puis éditez le fichier afin de passer devtools.debugger.forbid-certified-apps à false. Ensuite, redémarrer le client B2G et connectez le gestionnaire d'applications. Vous devriez désormais pouvoir toutes les applications.

Dépannage

Si l’appareil n’est pas reconnu :

• Si cliquer sur le bouton correspondant à votre téléphone Firefox OS ne fait rien, vérifiez que vous n'avez pas connecté un téléphone Android ET un téléphone Firefox OS.
• Lisez bien la section configuration des appareils et systèmes et assurez-vous de suivre toutes les étapes :
  • Votre téléphone est-il au minimum sous Firefox OS 1.2 ?
  • Vous ne voyez pas toutes les applications ? Avez-vous besoin d'activer le Débogage d'applications certifiées ?
  • Avez-vous autorisé le « Débogage à distance » dans les paramètres de votre téléphone ?

• Si vous n'utilisez pas ADB ou ADB Helper :
  • Avez-vous reussi à exécuter la commande adb forward ?
• Si vous utilisez ADB ou ADB Helper et que votre appareil n'est pas listé dans la barre d'outils en bas :
  • Si vous utilisez Linux,  soyez sûr de configurer correctement udev ;
  • Si vous utilisez Windows, soyez sûr d'avoir installé les drivers appropriés ;
  • Vous pouvez aussi  activer le verbose logging pour rassembler des diagnostics :
    • utilisez about:config  pour mettre la préférence « [email protected].console.logLevel » à la valeur string "all"
    • désactivez et réactivez le module complémentaire ADB Helper depuis le gestionnaire des modules complémentaires, ou redémarrez Firefox ;
    • ouvrez à nouveau le gestionnaire d'applications ;
    • dans la Console JavaScript, vous devriez maintenant voir de nouvelles lignes qui mentionnent « adbhelper ».
    • Si vous les voyez, mais n'êtes pas sûr de leurs significations, faites un tour sur le canal  #devtools  ou rapportez un bug avec les logs.
• Vous voyez « ??????? » à la place du nom de l'appareil sous Linux ? Vous avez des problèmes de permissions :  Assurez-vous d'avoir correctement configuré udev.
• Votre écran de téléphone est-il débloqué ?
• Si la commande « adb devices » ne montre pas d'entrée alors que le téléphone est connecté et débloqué, il est possible que vous ayez à éditer adb_usb.ini.

Vous ne pouvez pas connecter votre appareil au gestionnaire d'applications ou démarrer le simulateur ? Informez-nous ou rapportez un bug.