h1. 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. h2. Pré-requis h3. Installez Chrome (version google nécessaire pour "inspecter" un onglet sous android chrome)
google-chrome --remote-debugging-port=9222
h4. TODO trouver comment inspecter une page android-chrome avec chromium sous debian (note de Fred : simplement utiliser "chromium":https://f-droid.org/packages/com.anddevw.getchromium/ également sur le téléphone) La documentation complète est ici : https://developers.google.com/web/tools/chrome-devtools/remote-debugging/ h3. Configurez votre serveur local Pour développer localement sur un module de Publik, utilisez "publik-devinst en suivant cette documentation":https://dev.entrouvert.org/projects/publik-devinst/wiki/Installation_d'un_environnement_de_d%C3%A9veloppement_local 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":https://dev.entrouvert.org/projects/sysadmin/wiki/WhitelistEO * Adaptez "les instructions pour signer vos certificats SSL avec la CA d' EO en suivant le wiki sur publik-devinst":https://dev.entrouvert.org/projects/publik-devinst/wiki/Installation_d'un_environnement_de_d%C3%A9veloppement_local#Certificats-sign%C3%A9s-par-lautorit%C3%A9-de-certification-EO * 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@ h3. 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":http://pki.entrouvert.org/entrouvert-ca.DER.crt * 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":https://support.google.com/nexus/answer/2844832?hl=en ** à la validation de l'autorité, choisissez le type (étape 8) : @VPN or apps@ h2. 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/