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ğlanacaksınız?
-
İş 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 kullanıma sundukç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 uyumlu olduğundan bu işlem uygulamanızda güncelleme gerektirmez.
Avantajları:
- iOS için Driver SDK'sında 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 acilen incompatible bir SDK sürümüne yükseltmeniz gerekmez.
- Uygulamanız en son sürümde oluşturulmuşsa en son iyileştirmeleri ve özellikleri kolayca benimseyebilirsiniz.
- 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. Çünkü 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 sabit bir sürüme bağlantı verin. 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 (yeni bir SDK sürümüne yükseltmeniz gerekene kadar) desteklemeye devam eder.
İ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.
Döşeme
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 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
Swift Paket Yöneticisi
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ü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 penceresinden
GoogleRidesharingDriver
ürününün, belirlediğinizmain
hedefine ekleneceğini doğrulayın. İşlem tamamlandığında "Paket Ekle"yi tıklayın. -
Yüklemenizi doğrulamak için hedefinizin
General
bölmesine gidin. Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler bölümünde yüklü paketleri göreceksiniz. Paketi ve sürümünü doğrulamak için "Project Navigator"ın "Paket Bağımlılıkları" bölümünü de görüntüleyebilirsiniz.
Mevcut bir projenin package
öğesini güncellemek için şu adımları izleyin:
9.0.0'dan önceki bir sürümden yeni sürüme geçiyorsanız şu bağımlılıkları kaldırmanız gerekir: yeni sürüme geçtikten sonra
GoogleMapsBase
,GoogleMapsCore
veGoogleMapsM4B
.GoogleMaps
için bağımlılığı kaldırmayın. Daha fazla bilgi için 9.0.0 Sürüm Notları'na bakın.Xcode proje yapılandırma ayarlarınızdan Çerçeveler, Kitaplıklar ve Yerleştirilmiş İçerikler'i bulun. Aşağıdaki çerçeveyi kaldırmak için eksi işaretini(-) kullanın:
GoogleMapsBase
(Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)GoogleMapsCore
(Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)GoogleMapsM4B
(Yalnızca 9.0.0'dan önceki sürümlerden yapılan yükseltmeler için)
- Xcode'dan "File > Packages > Update to 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 aşağıdaki 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.resolved
veworkspace
Xcode'larını CocoaPods dışında bir amaçla kullanmıyorsanız kaldırı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 ana sürüme güncelleme yapıyorsanız geriye dönük olarak uyumsuz değişiklikler görmek ve kodunuzu güncellemek için sürüm notlarını kontrol edin.
Kakao
-
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
dosyanızda 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 update
çalıştır.- 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'yi, ardından Ürün > Derleme'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, daha yeni sürümler için yoklamaların yanı sıra projelerini etkileyebilecek geriye dönük uyumsuz değişiklikler hakkında e-postalar alır. Geriye dönük uyumsuz değişiklikler hakkında proaktif bildirim almak için projelerinizin her biri için izlenen bir e-posta adresiyle sahip rolü atayın.