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

Platform seçin: Android iOS JavaScript

Google Haritalar Platformu Ekibi, SDK'ları düzenli olarak yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle günceller. Bu sayfada, mobil SDK'lardaki bağımlılıklarınızı nasıl yöneteceğiniz hakkında bilgi verilmektedir.

  • İş açısından kritik uygulamalar için, kullandığınız ana sürümün (X.*) en son nokta sürümüne 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ınladıkça 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 sorunlar 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 şekilde düzeltmeler sağlanır. Düzeltmelerden yararlanmak için uyumsuz bir SDK sürümüne acilen yükseltmeniz gerekmez.
    • Uygulamanız zaten en son sürümde oluşturulduysa en yeni iyileştirmeleri ve özellikleri kolayca kullanabilirsiniz.
    • SDK'nın en yeni ana sürümüne yapılan yıllık artımlı güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için birden fazla ana sürümde kullanıma sunulan geriye dönük uyumlu olmayan değişiklikleri ele almaktan daha az iş gerektirebilir.

  • Kritik olmayan uygulamalar için düzeltilmiş bir sürümle bağlantı oluşturun. Düzeltilmiş sürüm için desteğin sonlandırılmasıyla ilgili bir bildirim aldığınızda, güncellenmiş uygulama kodunuzu kullanıcılarınıza sunmak için 12 ayınız olur.

    Avantajları:

    • Daha az bakım çalışması
    • 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 yükseltmeniz 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 sahibi olun.

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 File > Add Package Dependencies'e (Dosya > Paket Bağımlılıkları Ekle) gidin.
  2. URL olarak https://github.com/googlemaps/ios-maps-sdk adresini girin, paketi çekmek için Enter tuşuna basın ve "Add Package" (Paket Ekle) seçeneğini tıklayın.
  3. Belirli bir version yüklemek için Bağımlılık Kuralı alanını sürüm tabanlı 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 bölümünü güncellemek için aşağıdaki adımları uygulayın:

  1. 9.0.0'dan önceki bir sürümden yükseltme yapıyorsanız yükseltme işleminden 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 notlarını inceleyin.

    Xcode proje yapılandırma ayarlarınızda Frameworks, Libraries, and Embedded Content'ı (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) 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 "File > Packages > Update To Latest Package Versions" (Dosya > Paketler > En Son Paket Sürümlerine Güncelle) seçeneğine gidin.
  3. Yüklemenizi doğrulamak için Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın. Proje Gezgini'ni kullanı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. Podfile, Podfile.resolved ve Xcode workspace'u CocoaPods dışında bir amaçla kullanmıyorsanız bunları kaldırın.

CocoaPods

Öngörülmeyen ve tekrarlanamayan derlemelere yol açabileceğinden, iyimser operatör (~>) kullanmak yerine bağımlılıklarınızda her zaman bir sürüm numarası belirtin. iOS için Haritalar SDK'sı, anlamsal sürüm oluşturma işlemine uyar ve yeni ana sürüm yayınları, ö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, '16.0'

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

Bakım ve yükseltme

En son iyileştirmelerle geliştirmek için düzenli olarak daha yeni sürümleri kontrol edin ve sürüm spesifikasyonlarınızı güncelleyin. Yeni bir ana sürüme güncelliyorsanız geriye dönük uyumsuz 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 bölümünü güncellemek için aşağıdaki adımları uygulayın:

  1. Yüklemenizi doğrulamak için Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın. Proje Gezgini'ni kullanın.

Cocoapods

  1. Bir terminal açın ve 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ü olup olmadığını görmek için pod outdated komutunu çalıştırın.
  3. SDK'nın daha yeni bir sürümü bulunursa Podfile öğenizi bu yeni sürümle güncelleyin. Podfile dosyanızda belirli bir sürümü nasıl ayarlayacağınızı öğrenmek için Pod sürümlerini belirtme başlıklı makaleyi inceleyin.
  4. Koşu pod update.
  5. Yükseltme sonucunda gerekli değişiklikleri yapın. Her sürümdeki değişikliklerin listesi için sürüm notlarına bakın.
  6. Product > Clean'i ve ardından Product > Build'i seçerek projenizi temizleyin ve yeniden oluşturun.

Manuel yükleme

En son kaynak dosyalarının bağlantısını SDK'yı yükleme bölümünde bulabilirsiniz.

Google Cloud, yeni sürümler için yoklama yapmanın yanı sıra proje sahiplerine projelerini etkileyebilecek geriye dönük uyumsuz değişikliklerle ilgili e-postalar da gönderir. Geriye dönük uyumsuzluk içeren değişiklikler hakkında proaktif bildirim almak için her projeniz için izlenen bir e-posta adresiyle sahip rolünü atayın.