Versi Places SDK for Android

Tim Google Maps Platform mengupdate SDK secara rutin dengan fitur baru, perbaikan bug, dan peningkatan performa. Halaman ini memberikan panduan tentang cara mengelola dependensi Anda pada SDK seluler.

Menautkan ke versi mana?

• Untuk aplikasi penting, tautkan ke rilis dot terbaru dari versi utama yang Anda gunakan (X.*), dan upgrade ke versi utama baru setiap tahun.

  Saat merilis versi baru aplikasi sepanjang tahun, Anda dapat mulai menggunakan versi dot yang lebih baru dari Places SDK for Android. Penggunaan ini tidak mengharuskan aplikasi Anda di-update karena versi dot baru kompatibel dengan versi sebelumnya.

  Manfaat:

  • Jika Anda menemukan masalah di Places SDK for Android, perbaikan akan dilakukan di kompatibel dengan versi sebelumnya selama 12 bulan setelah rilis awal versi utama, sesuai dengan situs Dukungan seluler kebijakan kami. Anda tidak perlu segera melakukan upgrade ke versi SDK yang tidak kompatibel agar dapat menerima perbaikan ini.
  • Peningkatan dan fitur terbaru mudah diterapkan jika aplikasi Anda sudah dibuat di versi terbaru.
  • Update bertahap tahunan pada SDK versi utama terbaru mungkin memerlukan lebih sedikit upaya untuk menyesuaikan, menulis ulang, dan menguji aplikasi Anda, daripada harus menangani perubahan yang tidak kompatibel dengan versi sebelumnya yang diterapkan di beberapa rilis versi utama.

• Untuk aplikasi yang tidak penting, tautkan ke versi tetap mana pun. Saat menerima pemberitahuan penghentian penggunaan untuk versi tetap tersebut, Anda memiliki waktu 12 bulan untuk memberikan kode aplikasi yang telah diupdate kepada pengguna.

  Manfaat:

  • Pengurangan frekuensi upaya pemeliharaan.
  • Versi baru aplikasi Anda akan terus mendukung perangkat pengguna yang menjalankan sistem operasi seluler lama untuk waktu yang lebih lama (hingga Anda harus mengupgrade ke SDK versi baru).

Pemilik Project dengan alamat email yang dipantau akan menerima notifikasi proaktif tentang perubahan yang memengaruhi setiap project mereka. Pantau terus informasi terbaru tentang pembaruan penting, penghentian penggunaan, dan perubahan lainnya.

Penginstalan

Di file build.gradle.kts atau build.gradle tingkat aplikasi, selalu tentukan versi, bukan rentang awalan (+) atau latest karena hal ini dapat menghasilkan build yang tidak dapat diprediksi dan tidak dapat diulang. Places SDK for Android mematuhi pembuatan versi semantik, dan rilis versi utama mungkin menyertakan perubahan yang dapat menyebabkan gangguan. Level API minimum yang didukung adalah 23.

dependencies {
    // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation 'com.google.android.libraries.places:places:3.3.0'
}

Pemeliharaan dan upgrade

Android Studio akan otomatis memeriksa apakah terdapat versi yang lebih baru dan memberikan peringatan saat versi dependensi yang lebih baru tersedia. Untuk meminimalkan biaya teknis yang tidak perlu, update ke versi terbaru yang tersedia sesegera mungkin. Jika Anda mengupdate ke versi utama yang baru, periksa catatan rilis untuk mengetahui perubahan inkompatibilitas mundur serta cara mengupdate kode.

Selain diberi tahu tentang versi yang lebih baru, pemilik project Google Cloud juga akan menerima email terkait perubahan inkompatibilitas mundur yang dapat memengaruhi project mereka. Untuk mendapatkan notifikasi proaktif terkait perubahan inkompatibilitas mundur, tetapkan peran pemilik dengan alamat email yang dipantau untuk setiap project Anda.

Jika Anda mengupgrade dari Places SDK for Android versi 3.2.0 atau yang lebih lama

Tidak ada migrasi yang diperlukan saat berpindah ke SDK baru. Anda hanya perlu:

1. Aktifkan Places API (Baru) pada kunci API yang digunakan di aplikasi Anda. Untuk informasi selengkapnya, lihat Menggunakan Kunci API.

2. Di bagian dependencies pada tingkat modul build.gradle, update dependensi places dan tambahkan dependensi kotlin-bom:

     dependencies {
         implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
         implementation 'com.google.android.libraries.places:places:3.5.0'
     }

   Untuk informasi selengkapnya tentang dependensi kotlin-bom, lihat Penggunaan versi kotlin-stdlib terbaru dalam dependensi transitif.

3. Update aplikasi yang ada untuk memanggil aplikasi baru Places.initializeWithNewPlacesApiEnabled() untuk menginisialisasi aplikasi Anda. Untuk informasi selengkapnya, lihat Melakukan inisialisasi klien Places API.

Aplikasi yang ada akan terus berfungsi tanpa perubahan, tetapi kini Anda dapat memanfaatkan semua fitur SDK baru.