In dieser Anleitung wird erläutert, wie sich die Betaversion 3.1.0 von Maps SDK for Android installieren lässt. Nach der Einrichtung solltest du dich informieren, wie du die neuen Funktionen verwendest.
BETAVERSION 3.1.0 von Maps SDK for Android installieren
Führe die folgenden Schritte aus, um die Clientbibliothek der Betaversion 3.1.0 von Maps SDK for Android deinem Android Studio-Projekt hinzuzufügen.
-
Lade die statische Places-Bibliothek herunter. Wenn du Places nicht nutzt, kannst du diesen Schritt überspringen:
- places-maps-sdk-3.1.0-beta.aar (optional, nur zur Verwendung mit der Betaversion 3.1.0 von Maps SDK for Android)
- Kopiere die AAR-Datei in den Ordner
app/libs
deines Android Studio-Projekts. -
Im Abschnitt
buildscript.repositories
der Dateibuild.gradle
auf oberster Ebene muss das Maven-Repository von Google aufgeführt sein:buildscript { repositories { google() // ... } }
-
Füge im Abschnitt
dependencies
der Dateibuild.gradle
auf App-Ebene das Maps SDK for Android und optional die statische Places-Bibliothek und die zugehörigen erforderlichen Abhängigkeiten hinzu:dependencies { implementation 'com.google.android.libraries.maps:maps:3.1.0-beta' // If you are using Places, add all of the dependencies below implementation name:'places-maps-sdk-3.1.0-beta', ext:'aar' implementation 'com.google.android.gms:play-services-gcm:17.0.0' implementation 'com.google.auto.value:auto-value-annotations:1.6.2' }
Entferne im Abschnitt
dependencies
der Dateibuild.gradle
auf App-Ebene die Implementierungszeile für die vorherige Version, die in etwa so aussieht:- Synchronisiere dein Gradle-Projekt.
Konvertiere vorhandene Konfigurationen.
- Wenn in deiner bestehenden App Maps SDK for Android über Google Play-Dienste verwendet wird, ersetze alle Verweise auf das Paket
com.google.android.gms.maps
durch das Paketcom.google.android.libraries.maps
. Wähle in Android Studio Edit > Replace in Path.... - Wenn in deiner vorhandenen App Google Maps Platform Premium Plan verwendet wird, ersetze alle Verweise auf das Paket
com.google.android.m4b.maps
durch das Paketcom.google.android.libraries.maps
. Entferne außerdem das Präfixm4b_
aus allen Referenzen zu den XML-Layoutattributen. Beispiel:m4b_mapType
sollte zumapType
undm4b_cameraZoom
zucameraZoom
werden.
- Wenn in deiner bestehenden App Maps SDK for Android über Google Play-Dienste verwendet wird, ersetze alle Verweise auf das Paket
-
Aktualisiere deine ProGuard-Regeln, damit Maps SDK for Android-Klassen beibehalten werden, wenn die Codekomprimierung und -verschleierung in Release-Builds aktiviert sind.
-keep,allowoptimization class com.google.android.libraries.maps.** { *; }
Die Maps SDK for Android-Bibliothek ist über das Maven-Repository von Google verfügbar. So fügst du das SDK der App hinzu:
implementation 'com.google.android.gms:play-services-maps:17.0.0'
Wenn du den Google Maps Platform Premium Plan verwendest, sieht die zu entfernende Implementierungszeile so aus:
implementation(name:'google-maps-sdk-m4b', ext:'aar') implementation project(':googlemapssdkm4b_lib')
Mit Betaversion kompatible Dienstprogrammbibliothek importieren
Wenn du die Google Maps Android API-Dienstprogrammbibliothek verwendest, musst du auch die Projektabhängigkeiten aktualisieren, um die vorhandene Version durch die Version zu ersetzen, die mit der Betaversion kompatibel ist. Gehe dazu so vor:
- Importiere die mit der Betaversion kompatible Dienstprogrammbibliothek in die Datei
build.gradle
:implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
- Lösche Folgendes aus
build.gradle
, um eine nicht mit der Betaversion kompatible Dienstprogrammbibliothek zu entfernen:implementation 'com.google.maps.android:android-maps-utils:1.3.1'
Beispiele ausführen
Das Google-Beispiel-Repository auf GitHub enthält Beispiel-Apps, die die Verwendung der Betaversion 3.1.0 von Maps SDK for Android demonstrieren.
- Maps SDK for Android – Beispiele
- Places SDK for Android – Beispiele (nur zur Verwendung mit der Betaversion 3.1.0 von Maps SDK for Android)