Mise en place des environnements

Un environnement vous permet d'exécuter et de déboguer des applications. Un environnement peut être un appareil Firefox OS connecté à votre machine en USB, cela peut également être un simulateur Firefox OS installé sur votre propre machine, ou encore une autre instance de Firefox pour Bureau.

Dans le menu déroulant « Sélectionner l'environnement », les environnements sont groupés dans quatre types :

PÉRIPHÉRIQUES USB

Les périphériques Firefox OS connectés via USB. À partir de Firefox 36, cela permet aussi de se connecter à Firefox pour Android via USB.

PÉRIPHÉRIQUES WI-FI

Les périphériques Firefox OS connectés en Wi-Fi. À partir de Firefox 39.

SIMULATEURS

Les instances de simulateur Firefox OS que vous avez installé.

AUTRES

Des environnements distants qui peuvent se connecter à WebIDE à partir d'un hôte et port arbitraire. Si vous avez l'extension Valence installée, cette section listera aussi les environnements additionnels activés.

Le reste de cette section décrit comment ajouter des environnements.

Connecter un périphérique Firefox OS

Si vous possédez une version assez récente de Firefox et de Firefox OS, vous pouvez connecter le périphérique Firefox OS en Wi-Fi. Sinon, vous pouvez vous connecter en USB.

Se connecter en USB

Avant de se connecter à un périphérique Firefox OS, il y a quelques prérequis :

• Vérifiez votre version de Firefox OS : Assurez-vous que votre périphérique fonctionne sous Firefox OS 1.2/Boot2Gecko 1.2 minimum. Pour vérifier votre version, allez dans l'application « Paramètres » sur votre périphérique, puis Informations > Logiciel. Si vous n'avez pas une version assez récente, cherchez votre périphérique dans le guide de téléphone développeur et suivez les instructions pour la mise à jour.
• Activer le débogage distant : Dans l'application « Paramètres » sur le périphérique, allez dans  Informations > Plus d'informations > Développeur.
  • Firefox OS 1.3 et avant : « Débogage distant » est une case à cocher simple. Activez là.
  • Firefox OS 1.4 et plus : « Débogage distant » vous propose d'activer juste pour ADB ou pour ADB et outils de développement. Sélectionnez « ADB et outils de développement ».
• Désactivez le verrouillage d'écran sur votre périphérique : Dans l'application « Paramètres » sur le périphérique, allez dans Verrouillage et décocher la case Écran de verrouillage. C'est une étape nécessaire car si l'écran se verrouille, le téléphone perdra la connexion et ne sera plus disponible en débogage.
• Si vous désirez les privilèges illimités, comme les applications certifiées, les applications intégrées et les applications déjà installées sur un vrai périphérique : Consultez la section sur le débogage d'applications non restreintes (comme les applications certifiées, le processus principal, etc.).

S'il y a aussi d'autres périphériques Android connectés à l'ordinateur, déconnectez les. Maintenant connectez le périphérique à l'ordinateur en USB. Vous devriez voir apparaître le périphérique en dessous de "PÉRIPHÉRIQUES USB" :

Si vous ne voyez pas apparaître votre périphérique, consultez la page Dépannage.

Se connecter en Wi-Fi

Pour se connecter via Wi-Fi, vous aurez besoin de :

• Firefox 39 ou plus
• Un périphérique Firefox OS fonctionnant avec une compilation de Firefox OS 3.0 datant de 2015-03-27 ou plus

Cela n'utilisera pas du tout ADB, et est donc susceptible d'être plus fiable que la méthode USB.

Activer le débogage Wi-Fi

Premièrement, activez le débogage Wi-Fi sur le périphérique Firefox OS.

1. Ouvrez les paramètres développeurs sur le périphérique (Paramètres -> Développeurs)
2. Cocher « DevTools via Wi-Fi »
3. Éditez le nom du périphérique si vous désirez

Sélectionnez le périphérique

Dans WebIDE, cliquez sur le menu « Sélectionnez l'environnement ». Vous devriez voir apparaître une section appelée « PÉRIPHÉRIQUES Wi-Fi », et votre périphérique devrait y figurer :

Sélectionnez votre périphérique.

S'authentifier

Ensuite, dans WebIDE vous verrez une invite avec un QR-code :

Sur l'appareil, vous verrez une invite pour la connexion pour « Scanner » ou « Scanner et se souvenir ». Choisissez l'une des options et scannez le code. Désormais, WebIDE devrait se connecter à l'appareil et l'icône de l'appareil doit apparaître en bleu à côté de « Sélectionner l'environnement ».

Le scanner de QR code peut s'avérer être une option frustrante pour le moment vu la résolution de capture des appareils. Le bug 1145772 vise à résoudre ce problème. Si vous rencontrez un problème lors du scan, essayez d'orienter l'appareil différemment.

Si vous choisissez l'option « Scanner et se souvenir », vous n'aurez plus besoin de scanner le code lorsque vous souhaiterez reconnecter l'appareil avec l'ordinateur.

Se connecter à Firefox pour Android

À partir de Firefox 36, les appareils Android, connectés par USB et qui utilisent Firefox pour Android apparaissent comme environnements sous « Périphériques USB ». Pour plus d'informations, voir l'article se connecter à Firefox pour Android à partir de WebIDE.

Pour les versions antérieures à Firefox 36, il est possible de connecter Firefox pour Android sans utiliser WebIDE ou de paramétrer un environnement distant.

Ajouter un simulateur

Le simulateur Firefox OS est une version des couches supérieures de Firefox OS qui simule un appareil Firefox OS mais qui fonctionne sur un ordinateur de bureau. Il est lancé dans une fenêtre de la même taille qu'un appareil Firefox OS et contient les éléments d'interface utilisateur et les applications natives. Il permet également de simuler certaines API utilisées par les appareils Firefox OS.

Cela signifie que, dans la plupart des cas, il n'est pas nécessaire d'avoir un appareil physique pour déboguer une application.

Le simulateur ne fait pas partie intégrante de Firefox mais peut être téléchargé comme module complémentaire. Si vous cliquez sur « Installer le simulateur » dans la liste déroulante pour les environnements, vous serez envoyés vers une page qui vous permet d'installer les simulateurs correspondants aux différentes versions de Firefox OS.

Vous pouvez installer autant de simulateurs que vous le souhaitez. Cependant, il faudra parfois être armé de patience car le téléchargement peut durer quelques minutes. Une fois que le(s) simulateur(s) est installé, vous pouvez fermer cette fenêtre et les simulateurs apparaîtront dans la liste des environnements disponibles.

Pour plus d'informations sur le simulateur, voir l'article détaillé sur cet outil.

Autres environnements

Environnement distant

Avec un environnement distant, il est possible d'utiliser un nom d'hôte et un port arbitraires pour se connecter à l'appareil.

En réalité, les appareils Firefox OS et Android se connectent à l'ordinateur grâce à un programme appelé Android Debug Bridge (ADB). Par défaut, WebIDE utilise un module complémentaire appelé ADB Helper, cela simplifie le processus d'installation et de redirection des ports pour que l'appareil puisse dialoguer avec l'ordinateur..

Dans la plupart des cas, cette solution est la plus pratique. Cependant, on peut parfois vouloir utiliser ADB en dehors de WebIDE. Par exemple, on peut vouloir utiliser ADB directement depuis la ligne de commandes. Dans ce cas, on connectera l'appareil en définissant un nom et un port et en utilisant la commande adb forward (par exemple adb forward tcp:6000 localfilesystem:/data/local/debugger-socket).

Si, ensuite, vous souhaitez connecter WebIDE avec cet appareil, il faut : désactiver le module complémentaire ADB Helper et effectuer la connexion WebIDE en utilisant l'option « Environnement distant » puis en saisissant l'hôte et le port utilisés avant avec adb forward (par exemple : localhost:6000).

Avant Firefox 36, ADB Helper ne permettait pas de connecter Firefox pour Android, aussi, si vous souhaitez utiliser WebIDE pour vous connecter à Firefox pour Android, vous aurez besoin de paramétrer une redirection de port et d'utiliser un environnment sur mesure. En savoir plus sur la connexion de Firefox pour Android via ADB avec une version antérieure à Firefox 36.

Environnements disponibles avec Valence

Si vous avez installé le module complémentaire Valence, vous verrez trois environneemnts supplémentaires :

• Chrome sur Android
• Safari sur iOS
• Chrome Desktop

Pour les instructions relatives à ses environnements, voir les éléments respectifs sur la page sur le débogage à distance.

Sélectionner un environnement

Une fois que vous avez paramétré un environnement, vous pouvez le sélectionner grâce au menu « Sélectionner l'environnement ».

• Si vous sélectionnez un simulateur, WebIDE démarrera le simulateur
• Si vous sélectionnez un appareil Firefox OS, WebIDE se connectera à l'appareil. Sur l'appareil, vous aurez une boîte de dialogues pour demander confirmation, validez pour accepter la connexion avec « OK ».

Cliquez sur le bouton « Lancer » au milieu de la barre d'outils de WebIDE, cela permettra d'installer de lancer l'application dans l'environnement sélectionné.