iOS sürümleri için Haritalar SDK'sı

Platform seçin: Android iOS JavaScript

Google Haritalar Platformu ekibi, SDK'ları yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle düzenli olarak günceller. Bu sayfada, mobil SDK'lara olan bağımlılıkları yönetme hakkında yol gösterici bilgiler verilmektedir.

  • İş açısından kritik uygulamalar için, kullandığınız ana sürümün en son nokta sürümüne (X.*) bağlantı verin ve her yıl yeni ana sürüme yükseltin.

    Yıl boyunca uygulamanızın yeni sürümlerini yayınlarken iOS için Haritalar SDK'sının daha yeni nokta sürümlerini kullanmaya başlayabilirsiniz. Yeni nokta sürümleri geriye dönük uyumlu olduğundan bu işlem için uygulamanızda güncelleme yapmanız gerekmez.

    Avantajları:

    • iOS için Haritalar SDK'sında sorun tespit ederseniz Mobil destek politikası uyarınca, ana sürümün ilk yayınlanmasından sonraki 12 ay boyunca geriye dönük uyumlu bir şekilde düzeltmeler sağlanır. Düzeltmelerden yararlanmak için uyumlu olmayan bir SDK sürümüne hemen geçmeniz gerekmez.
    • Uygulamanız en son sürümde oluşturulmuşsa en son iyileştirmeleri ve özellikleri kolayca kullanabilirsiniz.
    • SDK'nın en yeni ana sürümünde yıllık artımlı güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için daha az iş gerektirebilir. Bu, birden fazla ana sürüm sürümünde kullanımdan kaldırılan değişikliklerle uğraşmaktan daha az iş gerektirir.

  • Kritik olmayan uygulamalar için düzeltilen bir sürümün bağlantısını ekleyin. Bu düzeltilmiş sürüm için desteğin sonlandırıldığına dair bildirim aldığınızda, güncellenmiş uygulama kodunuzu kullanıcılarınıza sunmanız için 12 ay süre tanınır.

    Avantajları:

    • Daha seyrek bakım çalışmaları.
    • Uygulamanızın yeni sürümleri, kullanıcıların eski mobil işletim sistemlerini çalıştıran cihazlarını daha uzun süre desteklemeye devam eder (yeni bir SDK sürümüne geçmeniz gerekene kadar).

İzlenen e-posta adreslerine sahip proje sahipleri, projelerinin her birini etkileyen değişiklikler hakkında proaktif bildirimler alır. Önemli güncellemeler, desteği sonlandırılan özellikler ve diğer değişiklikler hakkında bilgi edinin.

Kurulum

Swift Package Manager

iOS için Haritalar SDK'sı, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut iOS için Haritalar SDK'sı bağımlılıklarını kaldırdığınızdan emin olun.

SDK'yı yeni veya mevcut bir projeye eklemek için aşağıdaki adımları uygulayın:

  1. Xcode'unuzu project veya workspace açın, ardından Dosya > Paket Bağımlılıkları Ekle'ye gidin.
  2. URL olarak https://github.com/googlemaps/ios-maps-sdk adresini girin, paketi almak için Enter tuşuna basın ve "Paket Ekle"yi tıklayın.
  3. Belirli bir version yüklemek için Bağımlılık Kuralı alanını sürüme dayalı seçeneklerden birine ayarlayın. Yeni projeler için en son sürümü belirtmenizi ve "Tam Sürüm" seçeneğini kullanmanızı öneririz. Bu işlem tamamlandıktan sonra "Paket Ekle"yi tıklayın.

Mevcut bir projenin package değerini güncellemek için aşağıdaki adımları uygulayın:

  1. 9.0.0'den önceki bir sürümden yükseltme yapıyorsanız yükseltme yaptıktan sonra şu bağımlılıkları kaldırmanız gerekir: GoogleMapsBase, GoogleMapsCore ve GoogleMapsM4B. GoogleMaps için bağımlılığı kaldırmayın. Daha fazla bilgi için 9.0.0 sürümünün sürüm notlarına göz atın.

    Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar ve Yerleşik İçerik'i bulun. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini(-) kullanın:

    • GoogleMapsBase (Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
    • GoogleMapsCore (Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
    • GoogleMapsM4B (Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
  2. Xcode'da "Dosya > Paketler > Son Paket Sürümlerine Güncelle"ye gidin.
  3. Yüklemenizin doğruluğunu kontrol etmek için Proje Gezgini'nin Paket Bağımlılıkları bölümüne gidip paketi ve sürümünü doğrulayın.

CocoaPods kullanılarak eklenen mevcut iOS için Haritalar SDK'sı bağımlılıklarını kaldırmak için aşağıdaki adımları uygulayın:

  1. Xcode çalışma alanınızı kapatın. Terminali açıp aşağıdaki komutu çalıştırın: 
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. CocoaPods dışında bir şey için kullanmıyorsanız Podfile, Podfile.resolved ve Xcode workspace'i kaldırın.

CocoaPods

Tahmini operatör (~>) kullanmak, öngörülemeyen ve tekrarlanamayan derlemelere yol açabileceğinden, bağımlılıklarınızda her zaman bir sürüm numarası belirtin. iOS için Haritalar SDK'sı, anlamsal sürümlemeye uyar ve yeni ana sürüm sürümleri önemli değişiklikler içerir.

Podfile söz dizimini kullanan örnek bir Podfile bağımlılığı:

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

platform :ios, '15.0'

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

Bakım ve yükseltme

En son iyileştirmelerle derleme yapmak için yeni sürümleri düzenli olarak kontrol edin ve sürüm özelliklerinizi güncelleyin. Yeni bir büyük sürüme güncelliyorsanız geriye dönük uyumlu olmayan değişiklikler ve kodunuzu nasıl güncelleyeceğiniz hakkında bilgi edinmek için sürüm notlarını inceleyin.

Swift Package Manager

Mevcut bir projenin package değerini güncellemek için aşağıdaki adımları uygulayın:

  1. Yüklemenizin doğruluğunu kontrol etmek için Proje Gezgini'nin Paket Bağımlılıkları bölümüne gidip paketi ve sürümünü doğrulayın.

Cocoapods

  1. Bir terminal açıp Podfile dosyasını içeren dizine gidin:

    cd <path-to-project>
  2. iOS için Haritalar SDK'sının daha yeni bir sürümünün olup olmadığını görmek amacıyla pod outdated komutunu çalıştırın.
  3. SDK'nın daha yeni bir sürümü bulunursa Podfile'inizi bu yeni sürümle güncelleyin. Podfile'nizde belirli bir sürümü nasıl ayarlayacağınızı öğrenmek için Kapsül sürümlerini belirtme başlıklı makaleyi inceleyin.
  4. pod update'ü çalıştırın.
  5. Yükseltme sonucunda gerekli değişiklikleri yapın. Her sürümdeki değişikliklerin listesini Sürüm Notları'nda bulabilirsiniz.
  6. Ürün > Temizle'yi ve ardından Ürün > Derle'yi seçerek projenizi temizleyin ve yeniden oluşturun.

Manuel yükleme

SDK'yı Yükleme başlıklı makalede en son kaynak dosyaların bağlantısını alın.

Google Cloud proje sahipleri, yeni sürümler için ankete katılmanın yanı sıra projelerini etkileyebilecek geriye dönük uyumlu olmayan değişikliklerle ilgili e-postalar alır. Geriye dönük uyumlu olmayan değişiklikler hakkında proaktif bildirim almak için her projeniz için izlenen bir e-posta adresiyle sahip rolünü atayın.