HowDoWeDoAndroidDebug¶

Pour debugguer un environnement Publik local avec Chrome Android ("remote debugging").
Il ne s'agit pas ici de debugger des application Android, mais simplement d'afficher une URL sur son téléphone et de voir tout ce qui se passe dans le debugguer de son bureau.

Pré-requis¶

Installez Chrome (version google nécessaire pour "inspecter" un onglet sous android chrome)¶

google-chrome --remote-debugging-port=9222

TODO trouver comment inspecter une page android-chrome avec chromium sous debian¶

(note de Fred : simplement utiliser chromium également sur le téléphone)

La documentation complète est ici : https://developers.google.com/web/tools/chrome-devtools/remote-debugging/

Configurez votre serveur local¶

Pour développer localement sur un module de Publik, utilisez publik-devinst en suivant cette documentation

Vous aurez toutefois besoin d'adapter cette installation pour que les DNS de votre installation locale soient aussi accessibles depuis le monde extérieur.

• configurez votre IP interne pour correspondre à votre dns de développement en allant sur https://www.entrouvert.org/nsupdate?name=dev&ip=192.168.x.y
  • cela créera une redirection pour *.dev-[login-eo].ddns.entrouvert.org
  • voir la documentation Whitelist EO

• Adaptez les instructions pour signer vos certificats SSL avec la CA d' EO en suivant le wiki sur publik-devinst * Adaptez aussi les instructions pour configurer votre DNS local afin de diriger sur localhost * "Adaptez le déploiement des nouveaux tenants pour avoir des tenants déployés avec des noms du style *.dev-[login-eo].ddns.entrouvert.org

Configurez le téléphone Android de développement.¶

• installez android-tools-abd sur votre système pour communiqer avec votre Android en debug USB par le biais de la ligne de commande.

sudo apt install android-tools-adb

• Téléchargez et ajoutez l'autorité CA EO
• téléchargez sur votre laptop ce fichier .crt en format DER
• transférez-le sur la mémoire :

adb push entrouvert-ca-der.crt /mnt/sdcard/Download/

• installez le certificat dans votre système Android en suivant ce lien
  • à la validation de l'autorité, choisissez le type (étape 8) : VPN or apps

Debugguez !¶

• Ouvrez les devtools de chromium, et allez à l'onglet remote debugging et envoyez l'URL que vous voulez debugguer, par exemple https://user-combo.dev-[login-eo].ddns.entrouvert.org/