Versi

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.
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 setiap tahun ke versi utama baru.

    Saat merilis versi baru aplikasi sepanjang tahun, Anda dapat mulai menggunakan versi titik Maps yang lebih baru untuk iOS. Hal ini tidak memerlukan update dalam aplikasi Anda karena versi titik baru kompatibel dengan versi sebelumnya.

    Manfaat:

    • Jika Anda menemukan masalah di Maps SDK for iOS, perbaikan akan dilakukan dengan cara yang kompatibel dengan versi lama 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 untuk mendapatkan manfaat dari perbaikan.
    • Peningkatan dan fitur terbaru mudah digunakan jika aplikasi Anda sudah di-build di versi terbaru.
    • Update inkremental tahunan untuk SDK versi utama terbaru mungkin memerlukan lebih sedikit pekerjaan 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 untuk versi tetap tersebut, Anda memiliki waktu 12 bulan untuk menyediakan kode aplikasi yang telah diupdate kepada pengguna.

    Manfaat:

    • Pekerjaan pemeliharaan yang lebih jarang.
    • Versi baru aplikasi akan terus mendukung pengguna' perangkat yang menjalankan sistem operasi seluler lama lebih lama (hingga Anda harus mengupgrade ke versi SDK yang 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. Maps SDK for iOS mematuhi pembuatan versi semantik, dan rilis versi utama yang baru akan menyertakan perubahan yang dapat menyebabkan gangguan.

Menggunakan CocoaPods

Contoh dependensi Podfile yang menggunakan sintaksis Podfile:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '7.1.0'
end

Menggunakan Carthage

Contoh dependensi Cartfile menggunakan sintaksis Cartfile:

binary "https://dl.google.com/geosdk/GoogleMaps.json" == 6.2.1

Pemeliharaan dan upgrade

Untuk mem-build dengan peningkatan terbaru, periksa secara rutin versi yang lebih baru dan perbarui spesifikasi versi Anda. Jika Anda mengupdate ke versi utama yang baru, periksa catatan rilis untuk mengetahui perubahan inkompatibilitas mundur serta cara mengupdate kode.

Menggunakan Cocoapods

  1. Buka terminal dan buka direktori yang berisi Podfile:

    cd <path-to-project>
  2. Jalankan pod outdated untuk melihat apakah versi Maps SDK for iOS yang lebih baru tersedia.
  3. Jika ditemukan versi SDK yang lebih baru, update Podfile Anda dengan versi baru ini. Lihat Menentukan versi pod untuk mempelajari cara menetapkan versi tertentu di Podfile.
  4. Jalankan pod update.
  5. Buat perubahan yang diperlukan sebagai akibat dari upgrade. Lihat Catatan Rilis untuk melihat daftar perubahan dalam setiap rilis.
  6. Bersihkan dan build ulang project Anda dengan memilih Product > Clean, lalu Product > Build

Menggunakan Carthage

  1. Buka terminal dan buka direktori yang berisi Podfile:

    cd <path-to-project>
  2. Jalankan carthage outdated untuk melihat apakah versi Maps SDK for iOS yang lebih baru tersedia.
  3. Jika ditemukan versi SDK yang lebih baru, update Cartfile Anda dengan versi baru ini. Lihat Persyaratan versi untuk mempelajari cara menetapkan versi tertentu di Cartfile Anda.
  4. Jalankan carthage update.
  5. Buat perubahan yang diperlukan sebagai akibat dari upgrade. Lihat Catatan Rilis untuk melihat daftar perubahan dalam setiap rilis.
  6. Bersihkan dan build ulang project Anda dengan memilih Product > Clean, lalu Product > Build

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.