Aller au contenu
Capgo - Compilez, déployez et mettez à jour vos apps Capacitor Capgo

Configuration Android

GitHub
Enregistrement sur émulateur Android avec Google Maps : épingles de localisation des magasins, zones de livraison, un itinéraire, 500 marqueurs groupés, une caméra 3D inclinée et des types de carte satellite

Android utilise le Google Maps SDK. Ajoutez votre clé API comme métadonnées du manifeste dans android/app/src/main/AndroidManifest.xml à l'intérieur <application>:

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${GOOGLE_MAPS_API_KEY}" />

Dans android { defaultConfig { ... } } dans android/app/build.gradle, associez le placeholder à une variable d’environnement ou à un secret local :

android {
    defaultConfig {
        manifestPlaceholders = [
            GOOGLE_MAPS_API_KEY: System.getenv("GOOGLE_MAPS_API_KEY") ?: "REPLACE_WITH_YOUR_GOOGLE_MAPS_API_KEY"
        ]
    }
}

Exporter GOOGLE_MAPS_API_KEY avant de compiler, sinon Gradle injecte la chaîne de repli et le SDK Maps échoue à l’exécution.

Activer SDK Maps pour Android pour la clé dans la Google Cloud Console. Passez la même clé à NativeMap.create({ apiKey }) pour la cohérence avec les builds web.

Carte derrière la WebView

Section intitulée « Carte derrière la WebView »

Pendant create, le plugin attache un MapView sous la WebView Capacitor, appelle bringToFront() sur la WebView, et définit webView.setBackgroundColor(Color.TRANSPARENT) so your HTML UI can render above the map.

Pour les cartes intégrées, passez un élément conteneur à NativeMap.create({ element }). Le plugin mesure cet élément et synchronise le cadre de la carte native lors du redimensionnement ou du défilement.

Pour mode arrière-plan, passez toBack: true et configurez config.x, config.y, config.width, et config.height (viewport defaults apply when omitted). Call updateLayout lorsque la taille ou l'orientation de la fenêtre change pour que le MapView reste aligné avec la WebView.