WebIDE diagnostic de connexion

Connecter un appareil sous Firefox OS via USB

Si votre appareil fonctionnant sous Firefox OS ne se connecte pas au WebIDE, voici quelques points à vérifier :

  • Vérifiez la version de votre Firefox OS: celle-ci doit être un Firefox OS 1.2/Boot2Gecko 1.2 ou supérieure. Pour vérifier la version, aller dans l'application Paramètres de votre appareil, puis Appareil Informations > Logiciel. Si vous n'avez pas une version suffisante, trouvez votre appareil dans le guide du téléphone pour développeur et suivez les instructions pour la mise à jour du système.
  • Activez le débogage à distance  :
    • Firefox OS 1.3 : Paramètres > Informations sur l'appareil > Plus d'informations > Developpeurs. puis cochez l'option "Débogage distant"
    • Firefox OS 1.4 :  Paramètres > Developpeurs. puis mettez l'option "Débogage distant" à "ADB et outils de developpement"
    • Firefox OS 2.0 et plus : Paramètres > Developpeurs. puis mettez l'option "Débogage USB" à "ADB et outils de developpement"
  • Désactivez l'écran de vérouillage : Paramètres > Verouillage puis désactivez "Écran de verouillage". C'est une bonne idée car quand l'ecran se vérouille, la connection au téléphone est perdue, et donc plus disponible pour le débogage.
  • Vérifiez que vous n'avez pas connecté d'appareil Android en même temps qu'un appareil Firefox OS.
  • Vérifiez le câble USB que vous utilisez :
    •  Essayez de débrancher puis de rebrancher votre câble USB.
    • Essayez de brancher votre câble USB sur un autre port USB.
    • Essayez avec un autre câble USB. Les câbles fournis avec les téléhones on tendence à se déteriorer rapidement.
    • Essayez avec un câble USB plus court, Il arrive que les câbles USB longs posent des problèmes.
  • Essayez de désactiver puis réactiver le débogage distant dans l'application paramètres.
  • Si vous avez désactivé l'ADB Addon Helper, avez vous efféctué avec succès la commande adb forward ?
  • Si vous utilisez Linux :
    • Assurez vous d'avoir ajouté un fichier de règles  udev , comme documenté dans la troisième étape de ce guide pour configurer un appareil Android. l'attribut idVendor à utiliser pour le Geeksphone est "05c6", et cette page liste les autres valeurs de l'atribut idVendor. Ensuite lancez la commande adb devices afin d'être sur que votre appareil est bein dans la liste. Si l'appareil apparait en tant que  "no permission", vous avez besoin de redémarer adb server (e.g. adb kill-server;adb start-server).
  • Si vous utilisez Windows :
  • Si vous utilisez Mac OS X :
    • Si vous avez des érreurs de timeout à la connction et du simulateur et de vrais appareils, il est possible que vous ne pouvez pas vous connecter au localhost à cause d'un fichier /etc/hosts vide. Il est possible de résoudfre ce problème en remplisant le fichier et en flushant le cache DNS ainsi que décrit ici.
    • Si vous êtes un utilisateur de EasyTether, vous avez besoin de désinstaller ou de désactiver EasyTether : sudo kextunload /System/Library/Extensions/EasyTetherUSBEthernet.kext

Connecter un appareil Firefox OS via Wi-Fi

  • Vérifiez votre version : Le débogage via Wi-Fi requiert une version de Firefox superieure ou égale à la version 39, et un appareil Firefox OS tournant sous une compilation de Firefox OS 3.0 de 2015-03-27 ou plus récent.
  • Le scanner de QR code peut être frustrant actuellement, étant donné que les appareils semblent prendre une image très base résolution. Le bug 1145772 à pour but d'améliorer la situation rapidement. Si vous avez des problèmes avec le scanner, essayez de scanner avec des orientations diférentes. Si vous choisisez "Scan and Remembe", alors vous n'aurez pas à re-scanner le code la prochaine fois que vous souhaitez connecter le même appareil.

Se connecter à Firefox pour Android

Si vous essayez de vous connecter à une instance de Firefox tournant sous Android que l'instance ne s'affiche pas, voici quelques manipulations que vous pouvez essayer :

  • Vérifiez votre version de Firefox : l'appareil doit avoir Firefox 36 ou plus. WebIDE ne détectera pas les versions plus anciennes automatiquement, vous avez donc besoin d'activer le suivi de port et de vous connecter au port de l'appareil. Pour cela, suivez les instructions du guide disponible ici.
  • Vérifiez que vous avez activé le débogage distant dans Firefox : ouvrez Firefox pour Android, ouvrez son menu, séléctionez Paramètres, et cochez la case a cocher situé dans outils de développement > débogage distant.
  • Vérifiez que le débogage USB est autorisé dans les options de développement de l'appareil.
  • Si vous ne voyez toujours pas votre appareil dans la fenêtre de WebIDE, essayez d'activer/désactiver le débogage distant sur le téléphone :
    • Déconnectez votre appareil et désactivez le débogage distant sur votre téléphone.
    • Reconnectez l'appareil et activez le débogage distant. Cela relance l'instance de débogage du téléphone.
    • Essayez de nouveau de vous connecter avec WebIDE.
  • Si vous utilisez Windows, verifiez que votre appareil Android est correctement reconnu qu'il utilise le driver Google USB Driver qui est inclu dans le SDK Android.

Se connecter à d'autres navigateurs (Chrome, Safari)

WebIDE utilise Valence (anciennement Firefox Tools Adapter) pour atteindre les autres navigateurs.

Si vous rencontrez des problèmes à vous conecter à d'autres navigateurs, vérifiez les étapes de configuraiton et les autres notes sur ces navigateurs décrites dans la page de Valence.

Impossible de déboguer certaines applications

Si vous n'arivez pas à déboguer des applications certifiées, des applications intégrées ou des applications installées sur un appareil, alors il est possible que vous soyez nez à nez avec la restriction des privilèges de la politique de sécuritée de WebIDE. pour en savoir plus, lisez la section sur Débogage non restreint des applications  (incluant les applications certifiées, les process principaux, etc...).

Impossible de charger la liste des projets

Si vous ouvrez WebIDE dans une version de Firefox puis passez à une version anterieure de Firefox avec le même profil, il est possible que vous ayez l'érreur  "Unable to load project list" en ouvrant WebIDE dans la version anterieure de Firefox.

Cela peut se produire quand le système de stockage que WebIDE utilise (IndexedDB) a besoin de déplacer ou restructurer ses fichiers internes pour une version de Firefox plus récente. La liste du projet devient alors inaccessible à la version antérieure de Firefox.

Aucune donnée n'a été perdu, mais vous devez cependant continuez d'utiliser la veersion récente de Firefox qui a été utilisé avec votre profil pour avoir la liste.

Si vous voulez vraiment utiliser la version antérieure de Firefox, vous pouvez essayez de suprimer uniquement la liste de la façon décrite ci-dessous mais cette façon n'est pas recommandée et il peut en résulter des problèmes additionels de des pertes de données :

  1. Fermer Firefox
  2. Trouver le dossier contenant votre profil Firefox
  3. Trouver le dossier storage à l'interieur du dossier du profil.
  4. Dans une partie de cet arbre de fichiers, il devrait y avoir des fichiers et/ou des dossiers qui commencent par 4268914080AsptpcPerjo (un nom haché de la base de donnée)
  5. Suprimers les fichiers/dossiers sus-mentionés
  6. Relancer Firefox et WebIDE

Activer le logging

Vous pouvez activer les messages verbeux (verbose logging) pour obtenir des diagnostiques :

  1. Ourvrez about:config, et ajoutez une nouvelle préférence nomée extensions.adbhelper@mozilla.org.sdk.console.logLevel, avec pour valeur de chaine de caractères all, et passez  extensions.adbhelper@mozilla.org.debug à true.
  2. Dans le Manageur des modules complémentaires, désactivez pour réactivez le module complémentaire ADB Helper.
  3. Ouvrez la Console du navigateur et vous verez que les messages de la console sont préfixés par adb.Si les messages sont du chinois pour vous, demandez de l'aide.

Obtenir de l'aide

Allez dans la salle #devtools sur IRC  et nous essairons de vous aider.

 

Connecter un appareil sous Firefox OS via USB

Si votre appareil fonctionnant sous Firefox OS ne se connecte pas au WebIDE, voici quelques points à vérifier :

  • Vérifiez la version de votre Firefox OS: celle-ci doit être un Firefox OS 1.2/Boot2Gecko 1.2 ou supérieure. Pour vérifier la version, aller dans l'application Paramètres de votre appareil, puis Appareil Informations > Logiciel. Si vous n'avez pas une version suffisante, trouvez votre appareil dans le guide du téléphone pour développeur et suivez les instructions pour la mise à jour du système.
  • Activez le débogage à distance  :
    • Firefox OS 1.3 : Paramètres > Informations sur l'appareil > Plus d'informations > Developpeurs. Puis cochez l'option "Débogage distant"
    • Firefox OS 1.4 :  Paramètres > Developpeurs. puis mettez l'option "Débogage distant" à "ADB et outils de développement"
    • Firefox OS 2.0 et plus : Paramètres > Developpeurs. puis mettez l'option "Débogage USB" à "ADB et outils de développement"
  • Désactivez l'écran de verrouillage : Paramètres > Verrouillage puis désactivez "Écran de verrouillage". C'est une bonne idée car quand l'écran se verrouille, la connection avec le téléphone est perdue, et donc plus disponible pour le débogage.
  • Vérifiez que vous n'avez pas connecté d'appareil Android en même temps qu'un appareil Firefox OS.
  • Vérifiez le câble USB que vous utilisez :
    •  Essayez de débrancher puis de rebrancher votre câble USB.
    • Essayez de brancher votre câble USB sur un autre port USB.
    • Essayez avec un autre câble USB. Les câbles fournis avec les téléphones ont tendance à se détériorer rapidement.
    • Essayez avec un câble USB plus court, Il arrive que les câbles USB longs posent des problèmes.
  • Essayez de désactiver puis de réactiver le débogage distant dans l'application paramètres.
  • Si vous avez désactivé l'ADB Addon Helper, avez-vous effectué avec succès la commande adb forward ?
  • Si vous utilisez Linux :
    • Assurez vous d'avoir ajouté un fichier de règles  udev , comme documenté dans la troisième étape de ce guide pour configurer un appareil Android. l'attribut idVendor à utiliser pour le Geeksphone est "05c6", et cette page liste les autres valeurs de l’attribut idVendor. Ensuite lancez la commande adb devices afin d'être sur que votre appareil est bien dans la liste. Si l'appareil apparaît en tant que "no permission", vous avez besoin de redémarrer adb server (e.g. adb kill-server;adb start-server).
  • Si vous utilisez Windows :
  • Si vous utilisez Mac OS X :
    • Si vous avez des erreurs de timeout à la connection et du simulateur et de vrais appareils, il est possible que vous ne pouvez pas vous connecter au localhost à cause d'un fichier /etc/hosts vide. Il est possible de résoudre ce problème en remplissant le fichier et en flushant le cache DNS ainsi que décrit ici.
    • Si vous êtes un utilisateur de EasyTether, vous avez besoin de désinstaller ou de désactiver EasyTether : sudo kextunload /System/Library/Extensions/EasyTetherUSBEthernet.kext

Connecter un appareil Firefox OS via Wi-Fi

  • Vérifiez votre version : Le débogage via Wi-Fi requiert une version de Firefox supérieure ou égale à la version 39, et un appareil Firefox OS tournant sous une compilation de Firefox OS 3.0 de 2015-03-27 ou plus récent.
  • Le scanner de QR code peut être frustrant actuellement, étant donné que les appareils semblent prendre une image très basse résolution. Le bug 1145772 à pour but d'améliorer la situation rapidement. Si vous avez des problèmes avec le scanner, essayez de scanner avec des orientations différentes. Si vous choisissez "Scan and Remember", alors vous n'aurez pas à re-scanner le code la prochaine fois que vous souhaitez connecter le même appareil.

Se connecter à Firefox pour Android

Si vous essayez de vous connecter à une instance de Firefox tournant sous Android que l'instance ne s'affiche pas, voici quelques manipulations que vous pouvez essayer :

  • Vérifiez votre version de Firefox : l'appareil doit avoir Firefox 36 ou plus. WebIDE ne détectera pas les versions plus anciennes automatiquement, vous avez donc besoin d'activer le suivi de port et de vous connecter au port de l'appareil. Pour cela, suivez les instructions du guide disponible ici.
  • Vérifiez que vous avez activé le débogage distant dans Firefox : ouvrez Firefox pour Android, ouvrez son menu, sélectionnez Paramètres, et cochez la case a cocher situé dans outils de développement > débogage distant.
  • Vérifiez que le débogage USB est autorisé dans les options de développement de l'appareil.
  • Si vous ne voyez toujours pas votre appareil dans la fenêtre de WebIDE, essayez d'activer/désactiver le débogage distant sur le téléphone :
    • Déconnectez votre appareil et désactivez le débogage distant sur votre téléphone.
    • Reconnectez l'appareil et activez le débogage distant. Cela relance l'instance de débogage du téléphone.
    • Essayez de nouveau de vous connecter avec WebIDE.
  • Si vous utilisez Windows, vérifiez que votre appareil Android est correctement reconnu qu'il utilise le driver Google USB Driver qui est inclus dans le SDK Android.

Se connecter à d'autres navigateurs (Chrome, Safari)

WebIDE utilise Valence (anciennement Firefox Tools Adapter) pour atteindre les autres navigateurs.

Si vous rencontrez des problèmes à vous connecter à d'autres navigateurs, vérifiez les étapes de configuraiton et les autres notes sur ces navigateurs décrites dans la page de Valence.

Impossible de déboguer certaines applications

Si vous n'arrivez pas à déboguer des applications certifiées, des applications intégrées ou des applications installées sur un appareil, alors il est possible que vous soyez nez à nez avec la restriction des privilèges de la politique de sécurité de WebIDE. Pour en savoir plus, lisez la section sur Débogage non restreint des applications  (incluant les applications certifiées, les procès principaux, etc...).

Impossible de charger la liste des projets

Si vous ouvrez WebIDE dans une version de Firefox puis passez à une version antérieure de Firefox avec le même profil, il est possible que vous ayez l’erreur "Unable to load project list" en ouvrant WebIDE dans la version antérieure de Firefox.

Cela peut se produire quand le système de stockage que WebIDE utilise (IndexedDB) a besoin de déplacer ou restructurer ses fichiers internes pour une version de Firefox plus récente. La liste du projet devient alors inaccessible à la version antérieure de Firefox.

Aucune donnée n'a été perdue, mais vous devez cependant continuer d'utiliser la version récente de Firefox qui a été utilisé avec votre profil pour avoir la liste.

Si vous voulez vraiment utiliser la version antérieure de Firefox, vous pouvez essayez de supprimer uniquement la liste de la façon décrite ci-dessous mais cette façon n'est pas recommandée et il peut en résulter des problèmes additionnels de des pertes de données :

  1. Fermer Firefox
  2. Trouver le dossier contenant votre profil Firefox
  3. Trouver le dossier storage à l’intérieur du dossier du profil.
  4. Dans une partie de cet arbre de fichiers, il devrait y avoir des fichiers et/ou des dossiers qui commencent par 4268914080AsptpcPerjo (un nom haché de la base de données)
  5. Supprimez les fichiers/dossiers susmentionnés
  6. Relancer Firefox et WebIDE

Activer le logging

Vous pouvez activer les messages verbeux (verbose logging) pour obtenir des diagnostics :

  1. Ouvrez about:config, et ajoutez une nouvelle préférence nommée extensions.adbhelper@mozilla.org.sdk.console.logLevel, avec pour valeur de chaîne de caractères all, et passez extensions.adbhelper@mozilla.org.debug à true.
  2. Dans le Manager des modules complémentaires, désactivez puis réactivez le module complémentaire ADB Helper.
  3. Ouvrez la Console du navigateur et vous verez que les messages de la console sont préfixés par adb.Si les messages sont du chinois pour vous, demandez de l'aide.

Obtenir de l'aide

Allez dans la salle #devtools sur IRC  et nous essaierons de vous aider.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : Porkepix, Flore, Kenjiraw, wordsbybird, maximelore, ameen-mino, paipai
 Dernière mise à jour par : Porkepix,