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ığınızı nasıl yöneteceğiniz açıklanmaktadır.
Hangi sürüme bağlanılmalı?
-
Görev açısından kritik uygulamalar için, kullandığınız ana sürümün (X.*) en son sürümüne bağlantı verin ve her yıl yeni ana sürüme geçiş yapın.
Uygulamanızın yeni sürümlerini yıl boyunca kullanıma sunarken, iOS için Haritalar 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 için uygulamanızda güncelleme yapılması gerekmez.
Avantajları:
- iOS için Haritalar SDK'sında herhangi bir sorunla karşılaşırsanız düzeltmeler, ana sürümün ilk sürümünden sonraki 12 ay boyunca Mobil destek politikası uyarınca geriye dönük uyumlu bir şekilde sağlanır. Düzeltmelerden yararlanmak için acilen uyumlu olmayan bir SDK sürümüne geçmeniz gerekmez.
- Uygulamanız zaten en son sürümde oluşturulduğunda en son iyileştirmeler ve özellikler kolayca benimsenebilir.
- SDK'nın en yeni ana sürümüne yıllık olarak yapılan ek güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için daha az çaba sarf etmenizi gerektirebilir. Bunun için ana sürüm sürümlerinde geriye dönük olarak uyumlu olmayan değişiklikler yapılması gerekmez.
Kritik olmayan uygulamalar için herhangi bir sabit sürüme bağlantı oluşturun. Bu sabit 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 vardır.
Avantajları:
- Daha az bakım çalışması.
- Uygulamanızın yeni sürümleri, eski mobil işletim sistemlerini çalıştıran kullanıcıların cihazlarını desteklemeye devam eder (yeni bir SDK sürümüne geçmeniz gerekene kadar).
İzlenen e-posta adresleri olan Proje Sahipleri, her bir projesini etkileyen değişikliklerle ilgili proaktif bildirimler alır. Önemli güncellemeler, kullanımdan kaldırma işlemleri ve diğer değişiklikler hakkında bilgi edinin.
Döşeme
Tahmin edilemeyen ve tekrarlanabilir 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 Haritalar SDK'sı semantik sürüme bağlıdır ve yeni ana sürümler, zarar veren değişiklikleri içerir.
Podfile söz dizimini kullanan bir Podfile bağımlılığı örneği:
source 'https://github.com/CocoaPods/Specs.git' platform :ios, '14.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GoogleMaps', '8.2.0' end
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 güncelleme yapıyorsanız geriye dönük olarak uyumlu olmayan değişiklikler ve kodunuzu nasıl güncelleyeceğiniz için sürüm notlarını kontrol edin.
CocoaPods kullanma
Bir terminal penceresi açın ve
Podfile
ifadesini içeren dizine gidin:cd <path-to-project>
- iOS için Haritalar SDK'sının daha yeni bir sürümünün olup olmadığını görmek için
pod outdated
özelliğini çalıştırın. - SDK'nın daha yeni bir sürümü bulunursa
Podfile
cihazınızı bu yeni sürümle güncelleyin.Podfile
cihazınızda belirli bir sürümü nasıl ayarlayacağınızı öğrenmek için Kapsül sürümlerini belirtme sayfasına bakın. pod update
dosyasını çalıştırın.- Yükseltme işlemi sonucunda gerekli tüm değişiklikleri yapın. Her sürümdeki değişikliklerin listesi için Sürüm Notları'na bakın.
- Ürün > Temizle'yi ve ardından Ürün > Derleme'yi seçerek projenizi temizleyin ve yeniden oluşturun
Manuel
SDK'yı yükleme sayfasından en yeni kaynak dosyaların bağlantısını alın.
Yeni sürümler için anket yapmanın yanı sıra, Google Cloud proje sahipleri projelerini etkileyebilecek geriye dönük uyumlu olmayan değişiklikler hakkında e-postalar alır. Geriye dönük uyumlu olmayan değişiklikler hakkında proaktif bildirim almak için tüm projelerinizde izlenen e-posta adresiyle sahip rolünü atayın.