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 Maps 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 Maps SDK for iOS, perbaikan akan diberikan di kompatibel dengan versi sebelumnya selama 12 bulan setelah rilis awal versi utama, sesuai dengan halaman 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
Swift Package Manager
Maps SDK for iOS dapat diinstal melalui Swift Package Manager. Untuk menambahkan SDK, pastikan Anda memiliki menghapus semua dependensi Maps SDK for iOS yang ada.
Untuk menambahkan SDK ke project baru atau yang sudah ada, ikuti langkah-langkah berikut:
-
Buka
project
atauworkspace
Xcode, lalu buka File > Menambahkan Dependensi Paket. - Masukkan https://github.com/googlemaps/ios-maps-sdk sebagai URL, tekan Enter untuk menarik paket, dan klik "{i>Add Package<i}".
-
Untuk menginstal
version
tertentu, setel kolom Dependency Rule ke salah satu opsi berbasis versi. Untuk proyek baru, sebaiknya tentukan versi terbaru dan menggunakan "Versi Persis" sebelumnya. Setelah selesai, klik "Add Package". -
Dari jendela Choose Package Products, verifikasi
GoogleMaps
(untuk versi sebelum 9.0.0, verifikasiGoogleMaps
,GoogleMapsBase
, danGoogleMapsCore
) akan ditambahkan ke targetmain
yang Anda tetapkan. Setelah selesai, klik "Add Package". -
Untuk memverifikasi penginstalan, buka panel
General
target Anda. Di Frameworks, Libraries, and Embedded Content, Anda akan melihat paket yang diinstal. Anda juga dapat melihat "{i>Package Dependencies<i}" bagian "Navigator Proyek" untuk memverifikasi paket dan versinya.
Untuk mengupdate package
untuk project yang sudah ada, ikuti langkah-langkah berikut:
Jika mengupgrade dari versi yang lebih lama dari 9.0.0, Anda harus menghapus dependensi berikut:
GoogleMapsBase
,GoogleMapsCore
, danGoogleMapsM4B
setelah mengupgrade. Jangan hapus dependensi untukGoogleMaps
. Untuk informasi selengkapnya, lihat Catatan Rilis Versi 9.0.0.Dari setelan konfigurasi proyek Xcode Anda, temukan Frameworks, Libraries, dan Konten yang Disematkan. Gunakan tanda minus(-) untuk menghapus framework berikut:
GoogleMapsBase
(Hanya untuk upgrade dari versi sebelum 9.0.0)GoogleMapsCore
(Hanya untuk upgrade dari versi sebelum 9.0.0)GoogleMapsM4B
(Hanya untuk upgrade dari versi sebelum 9.0.0)
- Dari Xcode, buka "File > Paket > Update Ke Versi Paket Terbaru".
- Untuk memverifikasi penginstalan, buka bagian Package Dependencies Project Navigator untuk memverifikasi paket dan versinya.
Untuk menghapus dependensi Maps SDK for iOS yang ditambahkan menggunakan
CocoaPods
, ikuti langkah berikut:
- Tutup ruang kerja Xcode Anda. Buka terminal dan jalankan perintah berikut:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
Hapus
Podfile
,Podfile.resolved
, dan Xcodeworkspace
jika Anda tidak menggunakannya untuk hal apa pun selain CocoaPods.
CocoaPods
Selalu tentukan nomor versi dalam dependensi Anda, bukan menggunakan operator optimis
(~>
) karena dapat menyebabkan build yang tidak dapat diprediksi dan tidak dapat diulang. Tujuan
Maps SDK for iOS mematuhi pembuatan versi semantik,
dan rilis versi utama yang baru
menyertakan perubahan yang dapat menyebabkan gangguan.
Contoh dependensi Podfile menggunakan Sintaksis Podfile:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '15.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '8.4.0' end
Pemeliharaan dan upgrade
Untuk membuat aplikasi dengan peningkatan terbaru, periksa versi yang lebih baru secara rutin dan update versi Anda spesifikasi produk. Jika Anda mengupdate ke versi utama yang baru, periksa catatan rilis untuk mengetahui perubahan inkompatibilitas mundur dan cara memperbarui kode.
Swift Package Manager
Untuk mengupdate package
untuk project yang sudah ada, ikuti langkah-langkah berikut:
Jika mengupgrade dari versi yang lebih lama dari 9.0.0, Anda harus menghapus dependensi berikut:
GoogleMapsBase
,GoogleMapsCore
, danGoogleMapsM4B
setelah mengupgrade. Jangan hapus dependensi untukGoogleMaps
. Untuk informasi selengkapnya, lihat Catatan Rilis Versi 9.0.0.Dari setelan konfigurasi proyek Xcode Anda, temukan Frameworks, Libraries, dan Konten yang Disematkan. Gunakan tanda minus(-) untuk menghapus framework berikut:
GoogleMapsBase
(Hanya untuk upgrade dari versi sebelum 9.0.0)GoogleMapsCore
(Hanya untuk upgrade dari versi sebelum 9.0.0)GoogleMapsM4B
(Hanya untuk upgrade dari versi sebelum 9.0.0)
- Dari Xcode, buka "File > Paket > Update Ke Versi Paket Terbaru".
- Untuk memverifikasi penginstalan, buka bagian Package Dependencies Project Navigator untuk memverifikasi paket dan versinya.
Cocoapods
Buka terminal, lalu buka direktori yang berisi
Podfile
:cd <path-to-project>
- Jalankan
pod outdated
untuk melihat apakah Maps SDK for iOS memiliki versi yang lebih baru yang tersedia. - Jika versi SDK yang lebih baru ditemukan, update
Podfile
Anda dengan versi baru ini. Lihat Menentukan versi pod untuk mempelajari cara menyetel versi tertentu diPodfile
. - Jalankan
pod update
. - Buat perubahan yang diperlukan sebagai akibat dari upgrade. Lihat Catatan Rilis untuk mengetahui daftar perubahan dalam setiap rilis.
- Bersihkan dan bangun ulang project Anda dengan memilih Product > Bersihkan, lalu Produk > Bangun
Penginstalan manual
Mendapatkan link ke file sumber terbaru saat Menginstal SDK.
Selain melakukan polling untuk versi yang lebih baru, Google Cloud proyek pemilik akan menerima email tentang perubahan inkompatibilitas mundur yang dapat memengaruhi project mereka. Kepada mendapatkan notifikasi proaktif tentang perubahan inkompatibilitas mundur, tetapkan peran pemilik dengan alamat email yang dipantau untuk setiap project Anda.