Accéder aux serveurs locaux et aux instances Chrome avec le transfert de port

Kayce Basques

Meggin Kearney

Sofia Emelianova

Vous pouvez utiliser le transfert de port pour :

• Cas 1 : Déboguez un onglet ouvert dans une autre instance Chrome.
• Cas 2 : Hébergez un site sur un serveur Web d'un ordinateur de développement, puis accédez au contenu depuis un appareil Android à l'aide d'un câble USB.

Dans le cas 2, le transfert de port fonctionne via un port TCP d'écoute sur votre appareil Android qui correspond à un port TCP sur votre ordinateur de développement. Le trafic entre les ports transite par la connexion USB entre votre appareil Android et votre ordinateur de développement. La connexion ne dépend donc pas de la configuration de votre réseau.

De plus, si votre serveur Web utilise un domaine personnalisé, vous pouvez configurer votre appareil Android pour accéder au contenu de ce domaine avec le mappage de domaine personnalisé.

Configurer le transfert de port

Suivez les étapes suivantes en fonction de votre cas.

Cas d'utilisation 1 : Configurer le transfert de port vers une autre instance Chrome

1. Exécutez une autre instance Chrome avec le paramètre --remote-debugging-port=PORT, par exemple :

   macOS

   open -a "Google Chrome" --args --remote-debugging-port=PORT

   Windows

   start chrome --remote-debugging-port=PORT

   Linux

   google-chrome --remote-debugging-port=PORT

2. Dans l'instance Chrome avec laquelle vous effectuez le débogage :

   1. Ouvrez chrome://inspect/#devices.
   2. Assurez-vous que l'option Cibles du réseau Discovery est cochée.
   3. Cliquez sur Configurer à côté de la case à cocher.

   4. Dans Paramètres de découverte de la cible, saisissez localhost:PORT, cochez Activer la redirection de port, puis cliquez sur OK.

      

   5. De retour dans Appareils, vous verrez une nouvelle cible à distance. Cliquez sur Inspecter à côté de l'onglet que vous souhaitez déboguer.

      

3. Une nouvelle fenêtre d'outils de développement s'ouvre en mode appareil. Dans la barre d'adresse en haut de l'écran, vous pouvez saisir l'adresse du site Web que vous souhaitez déboguer.

   

4. À côté de la barre d'adresse, vous pouvez activer ou désactiver les méthodes de saisie.

Cas 2 : Configurer le transfert de port via USB pour votre appareil Android

1. Configurez le débogage à distance entre votre ordinateur de développement et votre appareil Android. Une fois l'opération terminée, votre appareil Android devrait s'afficher dans la liste.

   

2. Assurez-vous que l'option Découvrir les périphériques USB  est cochée.

3. Cochez la case, puis cliquez sur Transfert de port.

4. Dans les paramètres de transfert de port, localhost:8080 est configuré par défaut. Cochez Activer le transfert de port.

   .

5. Si vous souhaitez configurer d'autres ports, suivez les étapes suivantes. Sinon, ignorez les étapes et cliquez sur OK.

6. Dans le champ de texte Port à gauche, saisissez le numéro de port à partir duquel vous souhaitez pouvoir accéder au site sur votre appareil Android. Par exemple, si vous souhaitez accéder au site depuis localhost:5000, saisissez 5000.

7. Dans le champ de texte Adresse IP et port à droite, saisissez l'adresse IP ou le nom d'hôte sur lequel votre site s'exécute sur le serveur Web de votre machine de développement, suivi du numéro de port. Par exemple, si votre site est exécuté sur localhost:5000, saisissez localhost:5000.

8. Cliquez sur OK.

Le transfert de port est désormais configuré. Un indicateur d'état du transfert de port s'affiche en haut de l'écran et à côté du nom de l'appareil.

Pour afficher le contenu, ouvrez Chrome sur votre appareil Android et accédez au port localhost que vous avez spécifié dans le champ Port de l'appareil. Par exemple, si vous avez saisi 5000 dans le champ, vous devez accéder à localhost:5000.

Mapper des domaines locaux personnalisés

Le mappage de domaine personnalisé vous permet d'afficher du contenu sur un appareil Android à partir d'un serveur Web sur votre ordinateur de développement qui utilise un domaine personnalisé.

Par exemple, supposons que votre site utilise une bibliothèque JavaScript tierce qui ne fonctionne que sur le domaine autorisé chrome.devtools. Vous créez donc une entrée dans votre fichier hosts sur votre ordinateur de développement pour mapper ce domaine sur localhost (c'est-à-dire 127.0.0.1 chrome.devtools). Après avoir configuré le mappage de domaine personnalisé et la redirection de port, vous pourrez afficher le site sur votre appareil Android à l'URL chrome.devtools.

Configurer le transfert de port vers le serveur proxy

Pour mapper un domaine personnalisé, vous devez exécuter un serveur proxy sur votre ordinateur de développement. Voici quelques exemples de serveurs proxy : Charles, Squid et Fiddler.

Pour configurer le transfert de port vers un proxy :

1. Exécutez le serveur proxy et notez le port qu'il utilise.

2. Configurez le transfert de port vers votre appareil Android. Dans le champ Adresse locale, saisissez localhost: suivi du port sur lequel votre serveur proxy s'exécute. Par exemple, s'il s'exécute sur le port 8000, vous devez saisir localhost:8000. Dans le champ Port de l'appareil, saisissez le numéro sur lequel vous souhaitez que votre appareil Android écoute, par exemple 3333.

Configurer les paramètres proxy sur votre appareil

Vous devez ensuite configurer votre appareil Android pour qu'il communique avec le serveur proxy.

1. Sur votre appareil Android, accédez à Paramètres > Wi-Fi.

2. Appuyez de manière prolongée sur le nom du réseau auquel vous êtes connecté.

3. Appuyez sur Modifier le réseau.

4. Appuyez sur Options avancées. Les paramètres proxy s'affichent.

5. Appuyez sur le menu Proxy, puis sélectionnez Manuel.

6. Dans le champ Nom d'hôte du proxy, saisissez localhost.

7. Dans le champ Port du proxy, saisissez le numéro de port que vous avez indiqué pour Port de l'appareil dans la section précédente.

8. Appuyez sur Enregistrer.

Avec ces paramètres, votre appareil transfère toutes ses requêtes au proxy sur votre machine de développement. Le proxy effectue des requêtes au nom de votre appareil, de sorte que les requêtes adressées à votre domaine local personnalisé sont correctement résolues.

Vous pouvez désormais accéder aux domaines personnalisés sur votre appareil Android comme vous le feriez sur l'ordinateur de développement.

Si votre serveur Web s'exécute sur un port non standard, n'oubliez pas de spécifier le port lorsque vous demandez le contenu depuis votre appareil Android. Par exemple, si votre serveur Web utilise le domaine personnalisé chrome.devtools sur le port 7331, lorsque vous consultez le site depuis votre appareil Android, vous devez utiliser l'URL chrome.devtools:7331.