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ştirmeleri. Bu sayfa, bağımlılıklarınızı nasıl yöneteceğiniz konusunda yol gösterir test edilir.

  • İş açısından kritik uygulamalar için ana sürümün en yeni (X.*) kullanın ve her yıl yeni ana sürüme yükseltin.

    Uygulamanızın yeni sürümlerini kullanıma sundukça Yıl boyunca, iOS için Haritalar SDK'sının daha yeni nokta sürümlerini kullanmaya başlayabilirsiniz. Bu, Yeni nokta sürümleri geriye dönük uyumlu olduğundan uygulamanızda güncelleme gerektirmeyecektir.

    Avantajları:

    • iOS için Haritalar SDK'sında sorunlar tespit ederseniz kullanıma sunulmasından sonra 12 ay boyunca geriye dönük uyumluluğa Mobil destek politikasına tabidir. Acil olarak uyumlu olmayan bir SDK sürümüne yükseltmeniz gerekmez yararlanmanız için sunulacak.
    • En son iyileştirmeler ve özellikler, uygulamanız gereken şekilde geliştirilmişse kolayca benimsenebilir en son sürüme güncelleyin.
    • SDK'nın en yeni ana sürümüne yönelik yıllık artımlı güncellemeler daha az çalışma gerektirebilir. eski sürümlerle uyumsuzlukları çözmek yerine uygulamanızı uyarlamak, yeniden yazmak ve test etmek Birden fazla ana sürümde yapılan değişiklikler.

  • Kritik olmayan uygulamalar için sabit bir sürüme bağlantı verin. Desteğin sonlandırılması durumunda bildirimi almanız gerekiyorsa güncellenmiş uygulama kodunuzu ne kadar iyi karşıladığını görebileceksiniz.

    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, nasıl etkilediğini öğreneceğiz. Kal ve diğer değişiklikler hakkında bilgilendirilmeyi sağlar.

Kurulum

Swift Package Manager

iOS için Haritalar SDK'sı üzerinden yüklenebilir Swift Package Manager'a dokunun. SDK'yı eklemek için iOS bağımlılıkları için mevcut tüm Haritalar SDK'sını kaldırdı.

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

  1. Xcode project veya workspace dosyanızı açın, ardından Dosya > Paket Bağımlılıkları Ekleyin.
  2. URL olarak https://github.com/googlemaps/ios-maps-sdk adresini girip Enter'a basın. paketi çekin ve "Paket Ekle"yi tıklayın.
  3. Belirli bir version yüklemek için Bağımlılık Kuralı alanını sürüm temelli seçeneklerdir. Yeni projeler için en son sürümü ve "Tam Sürüm"ü kullanarak seçeneğini belirleyin. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
  4. Paket Ürünlerini Seçin penceresinde GoogleMaps alanını doğrulayın (9.0.0'dan önceki sürümler için GoogleMaps, GoogleMapsBase ve GoogleMapsCore) şuna eklenecek: belirlediğiniz main hedefiniz İşlem tamamlandığında "Paket Ekle"yi tıklayın.
  5. Yüklemenizi doğrulamak için hedefinizin General bölmesine gidin. Yüklenen paketleri Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümünde görebilirsiniz. "Paket Bağımlılıkları"nı da görüntüleyebilirsiniz "Project Navigator"ın bölümü .

Mevcut bir projenin package öğesini güncellemek için şu adımları izleyin:

  1. 9.0.0'dan önceki bir sürümden yeni sürüme geçiyorsanız şunları kaldırmanız gerekir: şu bağımlılıklar: GoogleMapsBase, GoogleMapsCore ve Yükseltme işleminden sonra GoogleMapsM4B. Bağımlılığı kaldırmayın: GoogleMaps Daha fazla bilgi için Sürüm 9.0.0 Sürüm Notları.

    Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar, ve yerleştirilmiş içerik gibi diğer özelliklerden de faydalanabilirsiniz. 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'dan "File > (Dosya) > Paketler > En Son Paket Sürümlerine Güncelleyin".
  3. Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne gidin .
ziyaret edin.

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çın ve aşağıdaki komutu yürütün:
    sudo gem install cocoapods-deintegrate cocoapods-clean 
    pod deintegrate 
    pod cache clean --all
  2. Podfile, Podfile.resolved ve CocoaPods dışında bir şey için kullanmıyorsanız Xcode workspace.

CocoaPods

İyimser bir operatör kullanmak yerine bağımlılıklarınızda her zaman bir sürüm numarası belirtin (~>). Bu da öngörülemeyen ve tekrarlanamayan derlemelere yol açabilir. İlgili içeriği oluşturmak için kullanılan iOS için Haritalar SDK'sı semantik sürüm oluşturma ile uyumludur. ve yeni ana sürüm sürümleri de zarar veren değişiklikleri içerir.

Örnek bir Podfile bağımlılığı Podfile söz dizimi:

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

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '8.4.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ünüzü güncelleyin özellikler. Yeni bir ana sürüme güncelleme yapıyorsanız sürüm notlarını inceleyebilirsiniz.

Swift Paket Yöneticisi

Mevcut bir projenin package öğesini güncellemek için şu adımları izleyin:

  1. Xcode'da "Dosya > Paketler > Son Paket Sürümlerine Güncelle"ye gidin.
  2. Yüklemenizi doğrulamak için Project Navigator'ın Paket Bağımlılıkları bölümüne gidin .
ziyaret edin.

Cocoapods

  1. Bir terminal penceresi açın ve Podfile öğesini içeren dizine gidin:

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

Manuel yükleme

En son kaynak dosyaların bağlantısını alın bölümünü okuyun.

Google Cloud, daha yeni sürümleri yoklamanın yanı sıra proje sahipleri projelerini etkileyebilecek geriye dönük uyumsuz değişiklikler hakkında e-posta alır. Alıcı: geriye dönük olarak uyumsuz değişiklikler hakkında proaktif bildirim almak, ata sahip rolüne sahip olmanız gerekir.