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 sayfada, mobil SDK'lara olan bağımlılıkları yönetme hakkında yol gösterici bilgiler verilmiştir.

  • İş açısından kritik uygulamalar için, kullandığınız ana sürümün en son nokta sürümüne (X.*) 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ınlarken iOS için Sürücü 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 Driver SDK'sında sorun 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 bir şekilde düzeltmeler sağlanır. Düzeltmelerden yararlanmak için uyumlu olmayan bir SDK sürümüne hemen geçmeniz gerekmez.
    • Uygulamanız en son sürümde oluşturulmuşsa en son iyileştirmeleri ve özellikleri kolayca kullanabilirsiniz.
    • SDK'nın en yeni büyük sürümünde yıllık artımlı güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için daha az iş gerektirebilir. Bu, birden fazla büyük sürüm sürümünde kullanımdan kaldırılan değişiklikleri ele almaktan daha az iş gerektirir.

  • Kritik olmayan uygulamalar için düzeltilen bir sürümün bağlantısını ekleyin. Bu düzeltilen sürüm için desteğin sonlandırıldığına dair bildirim aldığınızda, güncellenmiş uygulama kodunuzu kullanıcılarınıza sunmanız için 12 ay süre tanınır.

    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, 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 edinin.

Kurulum

Tahmin edilemez ve tekrarlanamayan derlemelere yol açabileceğinden, iyimser bir operatör (~>) kullanmak yerine bağımlılıklarınızda her zaman bir sürüm numarası belirtin. iOS için Sürücü SDK'sı anlamsal sürümlemeye uyar ve yeni ana sürüm sürümleri, önemli değişiklikler içerir.

CocoaPods

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

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

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

Swift Package Manager

Sürücü SDK'sı, Swift Package Manager aracılığıyla yüklenebilir. SDK'yı eklemek için mevcut sürücü SDK'sı bağımlılıkları 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 Dosya > Paket Bağımlılıkları Ekle'ye gidin.
  2. URL olarak https://github.com/googlemaps/ios-driver-sdk adresini 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üme dayalı 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 değerini güncellemek için aşağıdaki adımları uygulayın:

  1. Yüklemenizin doğruluğunu kontrol etmek için Project Navigator'ın Paket Bağımlılıkları bölümüne gidip paketi ve sürümünü doğrulayı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 özelliklerinizi güncelleyin. Yeni bir ana sürüme güncelliyorsanız geriye dönük uyumlu olmayan değişiklikler ve kodunuzu nasıl güncelleyeceğiniz hakkında bilgi edinmek için sürüm notlarını inceleyin.

Cocoapods

  1. Bir terminal açıp Podfile dosyasını içeren dizine gidin:

    cd <path-to-project>
  2. iOS için Sürücü SDK'sının daha yeni bir sürümünün olup olmadığını görmek üzere pod outdated'yi çalıştırın.
  3. SDK'nın daha yeni bir sürümü bulunursa Podfile dosyanızı bu yeni sürümle güncelleyin. Podfile'nizde belirli bir sürümü nasıl ayarlayacağınızı öğrenmek için Kapsül sürümlerini belirtme başlıklı makaleyi inceleyin.
  4. pod update'ü çalıştırın.
  5. Yükseltme sonucunda gerekli değişiklikleri yapın. Her sürümdeki değişikliklerin listesini Sürüm Notları'nda bulabilirsiniz.
  6. Ürün > Temizle'yi ve ardından Ürün > Derle'yi seçerek projenizi temizleyin ve yeniden oluşturun

Manuel yükleme

SDK'yı Yükleme başlıklı makalede en son kaynak dosyaların bağlantısını alın.

Google Cloud proje sahipleri, yeni sürümler için ankete katılmanın yanı sıra projelerini etkileyebilecek geriye dönük uyumlu olmayan değişikliklerle ilgili e-postalar alır. Geriye dönük uyumlu olmayan değişiklikler hakkında proaktif bildirim almak için her projeniz için izlenen bir e-posta adresiyle sahip rolünü atayın.