Application React web-first pour la consultation de points géodésiques et les signalements (@ign/gdp-tools).
Gestion du projet (intranet) : Loop.
En cas de blocage : Dépannage.
Prérequis : Node.js ≥ 22, accès SSH GitHub IGNF (mobile-core, mobile-device, collaboratif-client-api).
Depuis la racine du monorepo geodesie-de-poche/ :
cp gdp-mobile/.env.dist gdp-mobile/.env # puis renseigner les variables
npm installnpm run devOuvre l’app sur http://localhost:5173 (gdp-tools en watch + Vite).
Sur main, en local :
La première fois, pensez à créer le fichier .env.qualif depuis .env.qualif.dist
git checkout main
git pull
npm run build:qualifDéposer le contenu de gdp-mobile/dist/ via SFTP :
sftp://cadillac2.ign.fr/var/www/intranet/qlf-gdp/
Consultation : http://sgm.ign.fr/qlf-gdp/map
Aperçu local du même build : npm run preview:qualif -w gdp-mobile → http://localhost:4173/qlf-gdp/.
Variable (.env.qualif) |
Rôle |
|---|---|
VITE_BASE_PATH |
Sous-chemin, ex. /qlf-gdp/ |
VITE_USE_QUALIF |
true |
VITE_OAUTH_WEB_REDIRECT_URI |
<url-qualif>/qlf-gdp/auth/callback |
VITE_GDP_REPORT_COMMUNITY_ID |
ID de la communauté géodésie |
VITE_GDP_REPORT_DISPLAY_THEMES |
Thèmes à afficher |
VITE_GDP_REPORT_SUBMISSION_THEME |
Thème pour les signalements |
VITE_GDP_NEWS_URL |
JSON news / alertes (docs/NEWS.md) |
!! A terme, cette commande lancera aussi le déploiement sur les stores. !!
Un numéro semver dans package.json, recopié dans Android / iOS. Pas de suffixe. Le versionCode Android vaut major × 10000 + minor × 100 + patch (4.0.1 → 40001). L’écran À propos affiche cette version.
Semver = semantic versioning : un numéro en trois parties, majeur.mineur.patch.
Depuis main :
git checkout main
git pull
npm run bump:version -- 4.0.1
git push && git push origin v4.0.1Commit 4.0.1 + tag v4.0.1. Le push du tag déclenche la CI store.
Hot-reload via le serveur Vite, sans APK. Brancher le téléphone en USB (débogage USB activé).
npm run dev
adb reverse tcp:5173 tcp:5173 # à refaire après chaque reconnexion USBSur le téléphone : Chrome → http://localhost:5173. Inspecter depuis le poste : chrome://inspect. Redirect OAuth : http://localhost:5173/auth/callback.
Prérequis : JDK 17 ou 21, Android SDK (ANDROID_HOME). Première fois :
npm run setup-androidTéléphone branché en USB (débogage USB activé) — build, installe et lance l’app (sans Android Studio) :
npm run run-apkPour seulement produire le fichier (clé USB, mail, etc.) :
npm run generate-apkAPK : gdp-mobile/android/app/build/outputs/apk/debug/app-debug.apk. Identifiant fr.ign.gdp : cohabite avec l’ancienne app fr.ign.canex.
Inspecter la WebView (bundle dist, pas Vite) : chrome://inspect/#devices → WebView in fr.ign.gdp.
| Commande | Rôle |
|---|---|
npm run dev |
Serveur Vite (local) |
npm run build |
Build web à la racine / |
npm run build:qualif |
Build qualification (/qlf-gdp/) |
npm run build:mobile |
Build web pour l’APK (gdp-tools en dist) — appelé par generate-apk / run-apk |
npm run preview:qualif |
Aperçu local du build qualif |
npm run setup-android |
Première config Android |
npm run generate-apk |
Produit le fichier APK debug |
npm run run-apk |
Build, installe et lance l’APK sur le téléphone USB |
npm run bump:version -- 4.0.1 |
Version + commit + tag v4.0.1 |
npm run lint |
ESLint |
npm run lint:css-modules |
Contrôle des CSS modules |
Depuis la racine du monorepo, les mêmes noms marchent pour dev, build, build:qualif, setup-android, generate-apk, run-apk et bump:version.