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ınızı nasıl yöneteceğinizle ilgili bilgiler verilmiştir.

  • Görev 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ınladıkça 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 uygulamanızda güncelleme yapmanız gerekmez.

    Avantajları:

    • iOS için Sürücü SDK'sında sorunlar 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 acilen uyumsuz bir SDK sürümüne geçmeniz gerekmez.
    • Uygulamanız en yeni sürüm üzerine geliştirildiğinde en yeni iyileştirmeleri ve özellikleri kolayca kullanabilirsiniz.
    • SDK'nın en yeni ana sürümüne yıllık artımlı güncellemeler yapmak, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için birden fazla ana sürümde yapılan geriye dönük uyumsuz değişiklikleri ele almaktan daha az çalışma gerektirebilir.

  • Kritik olmayan uygulamalar için herhangi bir düzeltilmiş sürüme bağlantı verin. Bu 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 seyrek bakım çalışması.
    • Uygulamanızın yeni sürümleri, kullanıcıların daha 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, projelerini etkileyen değişikliklerle ilgili proaktif bildirimler alır. Önemli güncellemeler, desteği sonlandırılan özellikler ve diğer değişiklikler hakkında bilgi edinin.

Kurulum

Bağımlılıklarınızda her zaman bir sürüm numarası belirtin. İyimser operatör (~>) kullanmak, öngörülemeyen ve tekrarlanamayan derlemelere yol açabilir. iOS için Sürücü SDK'sı, anlamsal sürüm oluşturma kurallarına uyar ve yeni ana sürüm sürümleri, 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

Driver SDK, Swift Package Manager aracılığıyla 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 project veya workspace dosyanızı 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 almak için Enter tuşuna basın ve "Add Package"ı (Paket Ekle) 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 yeni 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ünleri Seçin penceresinde, 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 (Genel) bölmesine gidin. Frameworks, Libraries, and Embedded Content (Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerik) bölümünde yüklü paketleri görürsünüz. Paketi ve sürümünü doğrulamak için "Project Navigator"ın (Proje Gezgini) "Package Dependencies" (Paket Bağımlılıkları) bölümünü de görüntüleyebilirsiniz.

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

  1. Xcode'da File (Dosya) > Packages (Paketler) > Update To Latest Package Versions (En Son Paket Sürümlerine Güncelle) bölümüne gidin.
  2. Yüklemenizi doğrulamak için Project Navigator'ın Package Dependencies bölümüne giderek paketi ve sürümünü doğrulayın.

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 geçiyorsanı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 dosyasını içeren dizine gidin:

    cd <path-to-project>
  2. iOS için Driver SDK'nın daha yeni bir sürümünün mevcut olup olmadığını görmek için pod outdated komutunu çalıştırın.
  3. SDK'nın daha yeni bir sürümü varsa Podfile uygulamanızı 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 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 listesi için Sürüm Notları'na bakın.
  6. Product > Clean ve ardından Product > Build'i seçerek projenizi temizleyip yeniden derleyin.

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, yeni sürümleri kontrol etmenin yanı sıra projelerini etkileyebilecek geriye dönük uyumsuz değişikliklerle ilgili e-postalar alır. Geriye dönük uyumsuz değişiklikler hakkında proaktif bildirim almak için her projenize izlenen bir e-posta adresiyle sahip rolü atayın.