Signaler une erreur de Firefox OS

Avant de tenter de faire autre chose

Les instructions suivantes supposent que vous avez déjà suivi ces trois étapes :

1. Assurez-vous que le débogage à distance est autorisé sur votre appareil et que ADB est installé. Ceci autorise votre ordinateur à communiquer avec votre appareil.
2. Connectez votre appareil à votre ordinateur via USB.
3. Installez ADB Helper Add-on sur le bureau Firefox pour gérer tout transfert de port nécessaire.

Installer BusyBox

Il est également recommandé que vous installiez notre service BusyBox qui ajoute un grand nombre de commandes utiles à ADB pour aider à tester et déboguer Firefox OS.

Pour l'installer, assurez-vous que l'appareil est en marche puis :

1. Téléchargez BusyBox ;
2. Dézippez l'archive à un endroit précis ;
3. cd dans le dossier busybox-b2g extrait ;
4. Exécutez ./install.sh pour l'installer.

Tous les services busybox ont des liens symboliques en /system/bin, ce qui fait que vous pouvez exécuter des commandes comme ping directement. Voici quelques exemples de commandes :

adb shell ping 8.8.8.8   => ping command

adb shell ifconfig wlan0 => check tx/rx bytes 

adb shell cat /proc/net/route    => check the default route

adb shell iptables -t nat -nvL   => check if the packets are sent from application to IP layer, check Chain OUTPUT (policy ACCEPT 2 packets, 168 bytes)

Obtenir des rapports d'erreurs depuis un appareil sous Firefox OS

Nous avons créé une application Firefox OS pour nous permettre de récupérer des rapports d'erreurs — About Crashes — qui fonctionne sur les versions 1.2+.

Pour l'installer sur votre appareil, suivez les étapes ci-dessous.

1. About Crashes est une application certifiée, vous devez donc autoriser le débogage des applications certifiées (voir les instructions de App Manager, et WebIDE).
2. Téléchargez le fichier zip About Crashes depuis le lien ci-dessus et l'extraire le fichier en local.
3. Dans le bureau Firefox, ouvrez App Manager ou WebIDE (en fonction de la version de Firefox que vous utilisez) sous Outils > Développeur Web.
4. Dans un des outils, ajoutez l'application About Crashes comme une application packagée (App Manager : cliquez sur le plus à côté de l'option Add Packaged App, WebIDE: ouvrez le menu déroulant de gauche et sélectionnez Add Packaged App...).
5. Connectez votre appareil à App Manager/WebIDE (App Manager: vous le trouverez listé au bas de l'interface utilisateur, WebIDE: vous le trouverez sous Select Runtime).
6. Installez et ouvrez l'application sur l'appareil (App Manager: pressez le bouton Update, WebIDE: pressez le bouton "Play" (Install and Run)).
7. Sur l'appareil, pressez le bouton Update dans About Crashes pour voir vos erreurs les plus récentes.

Obtenir des IDs d'erreurs depuis la ligne de commande

Vous pouvez obtenir une liste d'IDs d'erreurs via la ligne de commande en saisissant la commande suivante dans votre terminal :

adb shell ls -l /data/b2g/mozilla/Crash\ Reports/submitted/

Si vous avez une longue liste d'erreurs et que vous voulez les trier par date, utilisez cette commande-ci :

adb shell busybox ls -ltr /data/b2g/mozilla/Crash\ Reports/submitted/

Obtenir/Vérifier le rapport d'erreur

Pour vérifier un rapport d'erreur:

1. Copiez le nom de fichier sans l'extension.
2. Allez sur Mozilla Crash Reports.
3. Collez le nom de fichier sans l'extension dans la barre de recherche dans le coin en haut à droite.

Cela devrait afficher le rapport d'erreurs que vous avez soumis.

Comment forcer un plantage

Pour déclencher un plantage du système Firefox OS, saisissez la commande suivante dans votre terminal pour trouver l'ID du processus source :

adb shell ps | grep b2g

Vous allez devoir trouver la ligne qui commence par root, et qui finit par /system/b2g/b2g. Elle devrait ressembler à ceci :

root 109 1 191120 66024 ffffffff 400fa330 S /system/b2g/b2g

Le nombre au début de la ligne est l'ID du processus kill que vous devrez utiliser pour killer ce processus. Exécutez la commande suivante, en remplaçant l'espace de texte réservé par l'ID :

adb shell kill -11 [ENTER ID HERE]

Killer le processus root plantera votre l'appareil.

Comment exécuter le script GDB pour b2g

1. Démarrez l'application Galerie sur le téléphone, puis exécutez la commande suivante dans votre terminal :

   adb shell b2g-ps

2. Notez le pid de l'application Galerie, puis exécutez la commande suivante :

   ./run-gdb.sh attach <pid>

3. Provoquez le plantage.
4. Exécutez cette commande :

   (gdb) bt