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ğlanacak?
-
İş 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 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 uygulamanızda güncelleme gerektirmez.
Avantajları:
- iOS için Driver SDK'da 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 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 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. Bunun için, 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 düzeltilen bir sürümün bağlantısını ekleyin. 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 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ırmalar ve diğer değişikliklerden haberdar olun.
Kurulum
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.
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 Driver SDK 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:
-
Xcode
project
veyaworkspace
dosyanızı açın, ardından Dosya > Paket Bağımlılıkları Ekle'ye gidin. - 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.
-
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. İşlem tamamlandığında "Paket Ekle"yi tıklayın.
Mevcut bir projenin package
değerini güncellemek için aşağıdaki adımları uygulayın:
- Yüklemenizin doğruluğunu kontrol etmek için Proje Gezgini'nin 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 spesifikasyonlarınızı güncelleyin. Yeni bir büyük 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.
Cocoapod'lar
-
Bir terminal penceresi açın ve
Podfile
öğesini 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ı öğrenmek amacıyla
pod outdated
çalıştırın. - SDK'nın daha yeni bir sürümü bulunursa
Podfile
öğenizi 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. pod update
'ü çalıştırın.- Yükseltme sonucunda gerekli değişiklikleri yapın. Her sürümdeki değişikliklerin listesini Sürüm Notları'nda bulabilirsiniz.
- Ü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 bölümünde 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.