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 iOS. 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 iOS, perbaikan akan dilakukan dengan cara yang kompatibel dengan versi sebelumnya selama 12 bulan setelah rilis awal versi utama, sesuai dengan kebijakan Dukungan seluler. Anda tidak perlu segera melakukan upgrade ke versi SDK yang tidak kompatibel agar dapat menerima perbaikan ini.
- Peningkatan dan fitur terbaru mudah digunakan 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 diperkenalkan 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
Selalu tentukan nomor versi dalam dependensi Anda, bukan menggunakan operator optimis
(~>
), karena hal tersebut dapat menyebabkan build yang tidak dapat diprediksi dan tidak dapat diulang. Places SDK for iOS mematuhi pembuatan versi semantik, dan rilis versi utama yang baru menyertakan perubahan yang dapat menyebabkan gangguan.
Menggunakan CocoaPods
Contoh dependensi Podfile menggunakan sintaksis Podfile:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '13.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GooglePlaces', '7.4.0' end
Menggunakan Carthage
Contoh dependensi Cartfile menggunakan sintaksis Cartfile:
binary "https://dl.google.com/geosdk/GooglePlaces.json" == 6.2.1
Pemeliharaan dan upgrade
Untuk mem-build dengan peningkatan terbaru, periksa versi yang lebih baru secara berkala dan perbarui spesifikasi versi Anda. Jika Anda mengupdate ke versi utama yang baru, periksa catatan rilis untuk mengetahui perubahan yang tidak kompatibel dengan versi sebelumnya dan cara mengupdate kode Anda.
Menggunakan Cocoapods
Buka terminal dan buka direktori yang berisi
Podfile
:cd <path-to-project>
- Jalankan
pod outdated
untuk melihat apakah versi terbaru Places SDK untuk iOS tersedia. - Jika versi SDK yang lebih baru ditemukan, perbarui
Podfile
dengan versi baru ini. Lihat Menentukan versi pod untuk mempelajari cara menetapkan versi tertentu diPodfile
. - Jalankan
pod update
. - Buat perubahan yang diperlukan sebagai hasil dari upgrade. Lihat Catatan Rilis untuk mengetahui daftar perubahan dalam setiap rilis.
- Bersihkan dan build ulang project Anda dengan memilih Product > Clean, lalu Product > Build
Menggunakan Carthage
Buka terminal dan buka direktori yang berisi
Podfile
:cd <path-to-project>
- Jalankan
carthage outdated
untuk melihat apakah versi terbaru Places SDK untuk iOS tersedia. - Jika versi SDK yang lebih baru ditemukan, perbarui
Cartfile
dengan versi baru ini. Lihat Persyaratan versi untuk mempelajari cara menetapkan versi tertentu diCartfile
Anda. - Jalankan
carthage update
. - Buat perubahan yang diperlukan sebagai hasil dari upgrade. Lihat Catatan Rilis untuk mengetahui daftar perubahan dalam setiap rilis.
- Bersihkan dan build ulang project Anda dengan memilih Product > Clean, lalu Product > Build
Manual
Dapatkan link ke file sumber terbaru saat Menginstal SDK.
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.