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

Google Haritalar Platformu ekibi, SDK'ları yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle düzenli olarak günceller. Bu sayfa, mobil SDK'lardaki bağımlılıklarınızı nasıl yöneteceğiniz konusunda yol gösterir.

Hangi sürüme bağlanacaksınız?

• İş açısından kritik uygulamalarda, 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 kullanıma sundukça iOS için Driver 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 uygulamanızda güncelleme gerektirmez.

  Avantajları:

  • iOS için Driver SDK'sında sorunlar tespit ederseniz Mobil destek politikası uyarınca, ana sürümün ilk sürümünden sonraki 12 ay boyunca geriye dönük uyumlu olacak şekilde düzeltmeler sağlanır. Düzeltmelerden yararlanmak için acilen incompatible bir SDK sürümüne yükseltmeniz gerekmez.
  • Uygulamanız en son sürümde oluşturulmuşsa en son iyileştirmeleri ve özellikleri kolayca benimseyebilirsiniz.
  • SDK'nın en yeni ana sürümüne yönelik yıllık artımlı güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için daha az çalışma gerektirebilir. Çünkü birden fazla ana sürümde kullanıma sunulan geriye dönük uyumsuz değişiklikleri ele almak zorunda kalmazsınız.

• Kritik olmayan uygulamalar için sabit bir sürüme bağlantı verin. Bu 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 olur.

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

İ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ırmalar ve diğer değişikliklerden haberdar olun.

Döşeme

Bağımlılıklarınızda iyimser bir operatör (~>) kullanmak yerine her zaman bir sürüm numarası belirtin. Bu, öngörülemeyen ve tekrarlanamayan derlemelere yol açabilir. iOS için Driver SDK'sı anlamsal sürüm oluşturma ile uyumludur. Yeni ana sürüm sürümleri ise zarar veren değişiklikleri içerir.

Not: iOS için sürücü SDK'sı, Carthage kullanılarak yüklemeyi desteklemez.

CocoaPods

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

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

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end
    

Swift Paket Yöneticisi

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

Önemli: Bu talimatlar Xcode 15 veya sonraki sürümlerin kullanıldığını varsayar, ancak Xcode'un önceki sürümleri için benzer olmalıdır.

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ı Ekle'ye gidin.
2. URL olarak https://github.com/googlemaps/ios-driver-sdk 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ü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 penceresinden GoogleRidesharingDriver ü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ştirilmiş İçerikler bölümünde yüklü paketleri göreceksiniz. Paketi ve sürümünü doğrulamak için "Project Navigator"ın "Paket Bağımlılıkları" bölümünü de görüntüleyebilirsiniz.

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 şu bağımlılıkları kaldırmanız gerekir: yeni sürüme geçtikten sonra 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ı'na bakın.

   Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler'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'dan "File > Packages > Update to En Son Paket Sürümlerine Güncelle"ye gidin.
3. 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.

Önemli: Bazen yapılar çözümlenemez veya hatalar oluşabilir. Bu durumda "Dosya > Paketler > Paket Önbelleğini Sıfırla"yı seçin.

CocoaPods kullanılarak eklenen mevcut Driver SDK 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 workspace Xcode'larını CocoaPods dışında bir amaçla kullanmıyorsanız kaldırın.

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 spesifikasyonlarınızı güncelleyin. Yeni bir ana sürüme güncelleme yapıyorsanız geriye dönük olarak uyumsuz değişiklikler görmek ve kodunuzu güncellemek için sürüm notlarını kontrol edin.

Kakao

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

   cd <path-to-project>

2. iOS için Driver SDK'nın daha yeni bir sürümünün olup olmadığını öğrenmek amacıyla pod outdated ç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 Kapsül sürümlerini belirtme bölümüne bakın.
4. pod update çalıştır.
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'yi, ardından Ürün > Derleme'yi seçerek projenizi temizleyin ve yeniden oluşturun.

Manuel yükleme

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

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