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.
Hangi sürüme bağlanacaksınız?
-
İş 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'sının daha 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 Sürücü SDK'sında sorunlar olduğunu fark ederseniz Mobil destek politikası uyarınca, ana sürümün ilk sürümünün yayınlanmasından sonraki 12 ay boyunca düzeltmeler geriye dönük olarak 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
İyimser bir operatör (
~>) kullanmak yerine bağımlılıklarınızda her zaman bir sürüm numarası belirtin. Bu, öngörülemeyen ve tekrarlanamayan derlemelere yol açabilir. iOS için Sürücü SDK'sı, anlamsal sürüm oluşturma ilkesine bağlıdır. Yeni ana sürüm sürümleri ise zarar veren değişiklikleri içerir.
Swift Paket Yöneticisi
Sürücü SDK'sı, Swift Package Manager üzerinden yüklenebilir. SDK'yı eklemek için mevcut tüm Driver SDK 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:
-
Xcode
projectveya
workspacecihazınızı açın, ardından File > Add Package Dependencies'e (Dosya > Paket Bağımlılıkları Ekle) gidin.
- URL olarak https://github.com/googlemaps/ios-driver-sdk girin, paketi çekmek için Enter tuşuna basın ve "Paket Ekle"yi tıklayın.
-
Belirli bir
versionyü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.
-
Paket Ürünlerini Seçin penceresinde,
GoogleRidesharingDriverürününün belirlediğiniz
mainhedefine ekleneceğini doğrulayın. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
-
Yüklemenizi doğrulamak için hedefinizin
Generalbö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:
- Xcode'dan "Dosya > Paketler > En Son Paket Sürümlerine Güncelle"ye gidin.
- 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 Driver SDK bağımlılıklarını kaldırmak için şu adımları uygulayın:
- 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
-
Podfile,
Podfile.resolvedve Xcode
workspaceöğelerini CocoaPods dışında bir şey için kullanmıyorsanız kaldırın.
CocoaPods
Podfile söz diziminin kullanıldığı 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
Bakım ve yükseltme
En son iyileştirmelerle uygulama geliştirmek 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 olarak uyumsuz değişiklikler ve kodunuzu nasıl güncelleyeceğiniz için sürüm notlarına göz atın.
Kakaoayaklar
-
Bir terminal penceresi açın ve
Podfileöğelerini içeren dizine gidin:
cd <path-to-project>
- iOS için Driver SDK'nın daha yeni bir sürümünün olup olmadığını görmek için
pod outdatedkomutunu çalıştırın.
- SDK'nın daha yeni bir sürümü bulunursa
Podfileuygulamanı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.
pod updatekomutunu çalıştırın.
- 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.
- Ü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.