Versi Maps SDK for iOS

Pilih platform: Android iOS JavaScript

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.

  • 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 diupdate karena versi dot baru kompatibel dengan versi lama.

    Manfaat:

    • Jika Anda menemukan masalah di Maps 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 diterapkan jika aplikasi Anda sudah dibuat di versi terbaru.
    • Update inkremental 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).

Project Owner 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 telah menghapus dependensi Maps SDK for iOS yang ada.

Untuk menambahkan SDK ke project baru atau yang sudah ada, ikuti langkah-langkah berikut:

  1. Buka project atau workspace Xcode, lalu buka File > Add Package Dependencies.
  2. Masukkan https://github.com/googlemaps/ios-maps-sdk sebagai URL, tekan Enter untuk mengambil paket, lalu klik "Add Package".
  3. Untuk menginstal version tertentu, tetapkan kolom Dependency Rule ke salah satu opsi berbasis versi. Untuk project baru, sebaiknya tentukan versi terbaru dan gunakan opsi "Exact Version". Setelah selesai, klik "Tambahkan Paket".
  4. Dari jendela Choose Package Products, pastikan GoogleMaps (untuk versi sebelum 9.0.0, pastikan GoogleMaps, GoogleMapsBase, dan GoogleMapsCore) akan ditambahkan ke target main yang Anda tentukan. Setelah selesai, klik "Tambahkan Paket".
  5. Untuk memverifikasi penginstalan, buka panel General target Anda. Di Frameworks, Libraries, and Embedded Content, Anda akan melihat paket yang diinstal. Anda juga dapat melihat bagian "Package Dependencies" di "Project Navigator" untuk memverifikasi paket dan versinya.

Untuk memperbarui package untuk project yang ada, ikuti langkah-langkah berikut:

  1. Jika Anda mengupgrade dari versi sebelum 9.0.0, Anda harus menghapus dependensi berikut: GoogleMapsBase, GoogleMapsCore, dan GoogleMapsM4B setelah mengupgrade. Jangan hapus dependensi untuk GoogleMaps. Untuk informasi selengkapnya, lihat Catatan Rilis Versi 9.0.0.

    Dari setelan konfigurasi project Xcode, temukan Frameworks, Libraries, and Embedded Content. 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)
  2. Dari Xcode, buka File > Packages > Update To Latest Package Versions.
  3. Untuk memverifikasi penginstalan, buka bagian Package Dependencies di Project Navigator untuk memverifikasi paket dan versinya.

Untuk menghapus dependensi Maps SDK for iOS yang ada yang ditambahkan menggunakan CocoaPods, ikuti langkah-langkah berikut:

  1. Tutup ruang kerja Xcode Anda. Buka terminal dan jalankan perintah berikut: 
    sudo gem install cocoapods-deintegrate cocoapods-clean
pod deintegrate
pod cache clean --all
  2. Hapus Podfile, Podfile.resolved, dan workspace Xcode jika Anda tidak menggunakannya untuk hal lain selain CocoaPods.

Pemeliharaan dan upgrade

Untuk membangun dengan peningkatan terbaru, periksa versi yang lebih baru secara berkala dan update spesifikasi versi Anda. Jika Anda mengupdate ke versi utama yang baru, periksa catatan rilis untuk mengetahui perubahan inkompatibilitas mundur serta cara mengupdate kode.

Swift Package Manager




To update the package for an existing project, follow these steps:


  
    
    
    
    
  1. 
      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
    2.

Penginstalan manual

Dapatkan link ke file sumber terbaru di 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.