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

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 yönelik bağımlılıklarınızı nasıl yöneteceğiniz hakkında bilgi verilmektedir.

  • İş 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 Driver SDK'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 Sürücü SDK'sında sorunlar keşfederseniz Mobil destek politikası uyarınca, ana sürümün ilk yayınlanmasından sonraki 12 ay boyunca geriye dönük uyumlu şekilde düzeltmeler sağlanır. Düzeltmelerden yararlanmak için uyumsuz bir SDK sürümüne acilen yükseltmeniz gerekmez.
    • Uygulamanız zaten en son sürümde oluşturulduysa en yeni iyileştirmeleri ve özellikleri kolayca kullanabilirsiniz.
    • SDK'nın en yeni ana sürümüne yapılan yıllık artımlı güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için birden fazla ana sürümde geriye dönük uyumlu olmayan değişiklikleri ele almaktan daha az iş gerektirebilir.

  • Kritik olmayan uygulamalar için düzeltilmiş bir sürümün bağlantısını ekleyin. Düzeltilmiş sürüm için desteğin sonlandırılması bildirimi aldığınızda, güncellenmiş uygulama kodunuzu kullanıcılarınıza sunmak için 12 ayınız olur.

    Avantajları:

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

Öngörülemeyen ve tekrarlanamayan 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 Sürücü SDK'sı, anlamsal sürüm oluşturma özelliğine uygundur ve yeni ana sürüm yayınları, zarar veren 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 üzerinden yüklenebilir. SDK'yı eklemek için mevcut sürücü SDK'sı bağımlılıklarını 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 File > Add Package Dependencies'e (Dosya > Paket Bağımlılıkları Ekle) gidin.
  2. URL olarak https://github.com/googlemaps/ios-driver-sdk adresini girin, paketi çekmek için Enter tuşuna basın ve "Add Package" (Paket Ekle) seçeneğini 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. Bu işlem tamamlandıktan sonra "Paket Ekle"yi tıklayın.

Mevcut bir projenin package bölümünü güncellemek için aşağıdaki adımları uygulayın:

  1. Yüklemenizi doğrulamak için Paket Bağımlılıkları bölümüne giderek paketi ve sürümünü doğrulayın.

Bakım ve yükseltme

En son iyileştirmelerle geliştirmeler yapmak için düzenli olarak yeni sürümleri kontrol edin ve sürüm spesifikasyonlarınızı güncelleyin. Yeni bir ana sürüme güncelliyorsanız geriye dönük uyumsuz 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çın ve Podfile içeren dizine gidin:

    cd <path-to-project>
  2. iOS için Driver SDK'sının daha yeni bir sürümü olup olmadığını görmek için pod outdated komutunu ç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 Pod sürümlerini belirtme başlıklı makaleyi inceleyin.
  4. Koşu pod update.
  5. Yükseltme sonucunda gerekli değişiklikleri yapın. Her sürümdeki değişikliklerin listesi için sürüm notlarına bakın.
  6. Product > Clean (Ürün > Temizle) ve ardından Product > Build (Ürün > Oluştur) seçeneklerini belirleyerek projenizi temizleyin ve yeniden oluşturun.

Manuel yükleme

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

Google Cloud, yeni sürümleri yoklamanın yanı sıra proje sahiplerine projelerini etkileyebilecek geriye dönük uyumsuz değişiklikler hakkında e-posta gönderir. Geriye dönük uyumsuzluk içeren değişiklikler hakkında proaktif bildirim almak için her projeniz için izlenen bir e-posta adresiyle sahip rolünü atayın.