iOS sürümleri için Yerler 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'lara olan bağımlılıklarınızı nasıl yöneteceğiniz konusunda yol gösterici bilgiler sağlanmaktadır.

  • İş 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 Yerler SDK'sının yeni nokta sürümlerini kullanmaya başlayabilirsiniz. Yeni nokta sürümleri geriye dönük olarak uyumlu olduğundan, bu işlem için uygulamanızda güncelleme yapılması gerekmez.

    Avantajları:

    • iOS için Yerler SDK'sında sorunlar olduğunu fark ederseniz Mobil destek politikası uyarınca düzeltmeler ana sürümün ilk kullanıma sunulmasından sonra 12 ay boyunca geriye dönük uyumlu bir şekilde sağlanır. Düzeltmelerden yararlanmak için acilen incompatible bir SDK sürümüne geçmeniz gerekmez.
    • Uygulamanız en son sürümde oluşturulduğunda en son iyileştirmeler ve özellikler kolayca kullanılabilir.
    • SDK'nın en yeni ana sürümüne her yıl yapılacak artımlı güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için birden fazla ana sürüm genelinde ortaya çıkan ve geriye dönük olarak uyumsuz olan değişiklikleri yönetmekten daha az çalışma gerektirebilir.

  • Kritik olmayan uygulamalar için sabit bir sürüme bağlantı verin. Söz konusu düzeltilmiş 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 olacaktır.

    Avantajları:

    • Daha seyrek 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 (yeni bir SDK sürümüne yükseltmeniz gerekene kadar) desteklemeye devam eder.

E-posta adresleri izlenen Proje Sahipleri, projelerinin her birini etkileyen değişiklikler hakkında proaktif bildirimler alır. Büyük güncellemeler, kullanımdan kaldırmalar ve diğer değişiklikler hakkında bilgilerden haberdar olun.

Döşeme

Swift Paket Yöneticisi

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

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

  1. Xcode project veya workspace cihazınızı açın ve File (Dosya) > Add Package Dependencies'e (Paket Bağımlılıkları Ekle) gidin.
  2. URL olarak https://github.com/googlemaps/ios-places-sdk girin, paketi çekmek 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ü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. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
  4. Paket Ürünlerini Seçin penceresinde, GooglePlaces ürününün belirlediğiniz main hedefine ekleneceğini doğrulayın. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
  5. Yüklemenizi doğrulamak için hedefinizin General bölmesine gidin. Çerçeveler, Kitaplıklar ve Yerleşik İçerik'te yüklü paketleri görürsünüz. Paketi ve sürümünü doğrulamak için "Project Navigator"daki "Paket Bağımlılıkları" bölümüne de bakabilirsiniz.

Mevcut bir proje için package öğesini güncellemek üzere şu adımları uygulayın:

  1. Xcode'dan "Dosya > Paketler > En 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 giderek paketi ve sürümünü doğrulayın.

CocoaPods kullanılarak eklenen mevcut iOS bağımlıları için Yerler SDK'sını kaldırmak üzere şu 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 Xcode workspace öğelerini CocoaPods dışında bir şey için kullanmıyorsanız kaldırın.

CocoaPods

İyimser operatör (~>) kullanmak yerine bağımlılıklarınızda her zaman bir sürüm numarası belirtin. Bu numara, öngörülemeyen ve tekrarlanamayan derlemelere yol açabilir. iOS için Yerler SDK'sı anlamsal sürüm oluşturma ilkesine bağlıdır. Yeni ana sürümler zarar veren değişiklikleri içerir.

Podfile söz diziminin kullanıldığı bir Podfile bağımlılığı örneği:

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

platform :ios, '15.0'

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

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üncelliyorsanız geriye dönük olarak uyumsuz değişiklikler ve kodunuzu nasıl güncelleyeceğiniz için sürüm notlarına göz atın.

Swift Paket Yöneticisi

Mevcut bir proje için package öğesini güncellemek üzere şu adımları uygulayın:

  1. Xcode'dan "Dosya > Paketler > En 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 giderek paketi ve sürümünü doğrulayın.

Kakaoayaklar

  1. Bir terminal penceresi açın ve Podfile öğelerini 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ı görmek için pod outdated öğesini çalıştırın.
  3. SDK'nın daha yeni bir sürümü bulunursa Podfile uygulamanızı bu yeni sürümle güncelleyin. Podfile ürününüzde belirli bir sürümü nasıl ayarlayacağınızı öğrenmek için Kapsül sürümlerini belirtme bölümüne bakın.
  4. pod update komutunu çalıştırın.
  5. Yükseltme sonucunda gerekli değişiklikleri yapın. Her sürümdeki değişikliklerin listesini görmek için Sürüm Notları'na bakın.
  6. Ürün > Temizle ve ardından Ürün > Oluştur'u seçerek projenizi temizleyin ve yeniden oluşturun.

Manuel

SDK'yı Yükleme bölümünde en yeni kaynak dosyaların bağlantısını alın.

Google Cloud proje sahipleri, yeni sürümler için yoklamanın yanı sıra projelerini etkileyebilecek, geriye dönük olarak uyumsuz değişiklikler hakkında e-posta alır. Geriye dönük olarak uyumsuz değişiklikler hakkında proaktif bildirim almak için projelerinizin her birine, izlenen bir e-posta adresiyle sahip rolü atayın.