Menginstal Maps SDK for Android v.3.1.0 versi BETA

Panduan ini menunjukkan cara menginstal Maps SDK for Android v.3.1.0 versi BETA. Setelah Anda siapkan, pelajari cara menggunakan fitur baru.

Menginstal Maps SDK for Android v3.1.0 versi BETA

Ikuti langkah-langkah berikut untuk menambahkan library klien Maps SDK for Android v3.1.0 versi Beta ke project Android Studio Anda secara manual.

  1. Download library statis Tempat (Anda dapat melewati langkah ini jika tidak menggunakan Tempat):

  2. Salin file AAR ke dalam folder app/libs pada project Android Studio Anda.
  3. Library Maps SDK for Android tersedia melalui repositori Maven Google. Untuk menambahkan SDK ke aplikasi Anda, lakukan hal berikut:

  4. Di bagian buildscript.repositories dari file build.gradle tingkat atas Anda, pastikan repo Maven Google tercantum:

    buildscript {
        repositories {
            google()
            // ...
        }
    }
  5. Di bagian dependencies dari file build.gradle tingkat aplikasi Anda, tambahkan Maps SDK for Android, dan secara opsional, library statis Tempat serta dependensi yang diperlukan:

    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'
    }
  6. Di bagian dependencies pada file build.gradle tingkat aplikasi Anda, hapus baris penerapan untuk versi sebelumnya (baris akan muncul seperti berikut):

  7. implementation 'com.google.android.gms:play-services-maps:17.0.0'

    Jika Anda menggunakan Paket Premium Google Maps Platform, baris penerapan yang akan dihapus akan tampak seperti salah satu baris berikut:

    implementation(name:'google-maps-sdk-m4b', ext:'aar')
    implementation project(':googlemapssdkm4b_lib')
    
  8. Sinkronkan project Gradle Anda.
  9. Lakukan konversi pada konfigurasi yang ada.

    • Jika aplikasi yang ada menggunakan Maps SDK for Android melalui layanan Google Play, ganti semua referensi untuk paket com.google.android.gms.maps dengan paket com.google.android.libraries.maps (gunakan Edit > Replace in Path... di Android Studio).
    • Jika aplikasi Anda yang ada menggunakan Paket Premium Google Maps Platform, ganti semua referensi untuk paket com.google.android.m4b.maps dengan paket com.google.android.libraries.maps. Selain itu, hapus awalan m4b_ dari semua referensi untuk atribut tata letak XML. Misalnya: m4b_mapType harus menjadi mapType dan m4b_cameraZoom harus menjadi cameraZoom.
  10. Perbarui aturan ProGuard Anda untuk mempertahankan class Maps SDK for Android saat penyingkatan kode dan obfuscation diaktifkan pada build rilis.

    -keep,allowoptimization class com.google.android.libraries.maps.** { *; }
    

Mengimpor library utilitas yang kompatibel dengan versi beta

Jika Anda menggunakan library utilitas Google Maps Android API, Anda juga perlu memperbarui dependensi project untuk mengganti versi yang ada ke versi yang kompatibel dengan versi beta menggunakan cara berikut:

  1. Impor library utilitas yang kompatibel dengan versi beta di file build.gradle Anda:
    implementation 'com.google.maps.android:android-maps-utils-v3:1.3.1'
    
  2. Hapus hal berikut dari build.gradle untuk menghapus library utilitas yang tidak kompatibel dengan versi beta:
    implementation 'com.google.maps.android:android-maps-utils:1.3.1'
    

Menjalankan sampel

Repositori Google Samples di GitHub mencakup contoh aplikasi yang menunjukkan penggunaan Maps SDK for Android v3.1.0 versi Beta.