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

Platformu 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ığınızı nasıl yöneteceğiniz açıklanmaktadır.

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

    Uygulamanızın yeni sürümlerini yıl boyunca kullanıma sunarken, iOS için Yerler 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 yapılması gerekmez.

    Avantajları:

    • iOS için Yerler SDK'sında herhangi bir sorunla karşılaşırsanız düzeltmeler, ana sürümün ilk sürümünden sonraki 12 ay boyunca mobil destek politikası uyarınca geriye dönük uyumlu bir şekilde sağlanır. Düzeltmelerden yararlanmak için acilen uyumlu olmayan bir SDK sürümüne geçmeniz gerekmez.
    • Uygulamanız zaten en son sürümde oluşturulduğunda en son iyileştirmeler ve özellikler kolayca benimsenebilir.
    • SDK'nın en yeni ana sürümüne yıllık olarak yapılan ek güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için daha az çaba sarf etmenizi gerektirebilir. Bunun için ana sürüm sürümlerinde geriye dönük olarak uyumlu olmayan değişiklikler yapılması gerekmez.

  • Kritik olmayan uygulamalar için herhangi bir sabit sürüme bağlantı oluşturun. Bu sabit sürüm için kullanımdan kaldırma bildirimi aldığınızda, güncellenmiş uygulama kodunuzu kullanıcılarınıza sunmak için 12 ayınız vardır.

    Avantajları:

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

İzlenen e-posta adresleri olan Proje Sahipleri, her bir projesini etkileyen değişikliklerle ilgili proaktif bildirimler alır. Önemli güncellemeler, kullanımdan kaldırma işlemleri ve diğer değişiklikler hakkında bilgi edinin.

Döşeme

Tahmin edilemeyen ve tekrarlanabilir 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 Yerler SDK'sı anlamsal sürüm oluşturma kurallarına uyar ve yeni ana sürümler, zarar veren değişiklikleri içerir.

CocoaPods'u kullanma

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

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

platform :ios, '14.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '8.0.0'
end

Carthage'ı kullanma

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

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

Bakım ve yükseltme

En son iyileştirmelerle derleme yapmak için düzenli olarak yeni sürümleri kontrol edin ve sürüm özelliklerinizi güncelleyin. Yeni bir ana sürüme güncelleme yapıyorsanız geriye dönük olarak uyumlu olmayan değişiklikler ve kodunuzu nasıl güncelleyeceğiniz için sürüm notlarını kontrol edin.

CocoaPods kullanma

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

    cd <path-to-project>
  2. iOS için Yerler SDK'sının daha yeni bir sürümünün olup olmadığını öğrenmek için pod outdated aracını çalıştırın.
  3. SDK'nın daha yeni bir sürümü bulunursa Podfile cihazınızı bu yeni sürümle güncelleyin. Podfile cihazınızda belirli bir sürümü nasıl ayarlayacağınızı öğrenmek için Kapsül sürümlerini belirtme sayfasına bakın.
  4. pod update dosyasını çalıştırın.
  5. Yükseltme işlemi sonucunda gerekli tüm değişiklikleri yapın. Her sürümdeki değişikliklerin listesi için Sürüm Notları'na bakın.
  6. Ürün > Temizle'yi ve ardından Ürün > Derleme'yi seçerek projenizi temizleyin ve yeniden oluşturun

Carthage'ı kullanma

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

    cd <path-to-project>
  2. iOS için Yerler SDK'sının daha yeni bir sürümünün olup olmadığını öğrenmek üzere carthage outdated komutunu çalıştırın.
  3. SDK'nın daha yeni bir sürümü bulunursa Cartfile cihazınızı bu yeni sürümle güncelleyin. Cartfile sürümünüzde belirli bir sürümü nasıl ayarlayacağınızı öğrenmek için Sürüm gereksinimleri bölümüne bakın.
  4. carthage update dosyasını çalıştırın.
  5. Yükseltme işlemi sonucunda gerekli tüm değişiklikleri yapın. Her sürümdeki değişikliklerin listesi için Sürüm Notları'na bakın.
  6. Ürün > Temizle'yi ve ardından Ürün > Derleme'yi seçerek projenizi temizleyin ve yeniden oluşturun

Manuel

SDK'yı yükleme sayfasından en yeni kaynak dosyaların bağlantısını alın.

Yeni sürümler için anket yapmanın yanı sıra, Google Cloud proje sahipleri projelerini etkileyebilecek geriye dönük uyumlu olmayan değişiklikler hakkında e-postalar alır. Geriye dönük uyumlu olmayan değişiklikler hakkında proaktif bildirim almak için tüm projelerinizde izlenen e-posta adresiyle sahip rolünü atayın.