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 bağımlılarınızı yönetme konusunda yol gösterici bilgiler sağlanmaktadır.
Hangi sürüme bağlanacak?
-
Görev açısından kritik uygulamalar için, kullanmakta olduğunuz ana sürümün (X.*) en son nokta sürümüne bağlantı verin ve yıllık olarak yeni ana sürüme yükseltin.
Yıl boyunca uygulamanızın yeni sürümlerini kullanıma sunarken Android için Haritalar SDK'sının 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ı:
- Android için Haritalar SDK'sında sorunlar olduğunu fark ederseniz ana sürümün ilk yayınlanmasından sonraki 12 ay boyunca Mobil destek politikası uyarınca düzeltmeler geriye dönük olarak uyumlu bir şekilde sağlanır. Düzeltmelerden yararlanmak için acil olarak uyumsuz bir SDK sürümüne geçmeniz gerekmez.
- Uygulamanız zaten en son sürüm üzerindeyse en son iyileştirmeleri ve özellikleri kolayca kullanabilirsiniz.
- SDK'nın en yeni ana sürümüne yapılan yıllık artımlı güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için birden fazla ana sürüm sürümünde yapılan ve geriye dönük olarak uyumlu olmayan değişiklikleri yönetmek zorunda kalma konusunda daha az çalışma gerektirebilir.
Kritik olmayan uygulamalar için sabit sürümlere bağlanın. 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 olur.
Avantajları:
- Daha az bakım çalışması.
- Uygulamanızın yeni sürümleri, kullanıcıları eski mobil işletim sistemlerini çalıştıran cihazları daha uzun süre (yeni bir SDK sürümüne yükseltmediğiniz sürece) desteklemeye devam eder.
İzlenen e-posta adreslerine sahip 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.
Kurulum
Uygulama düzeyindeki build.gradle dosyanızda, ön ek aralığı (+) veya latest yerine her zaman bir sürüm belirtin. Bunlar, öngörülemez ve tekrarlanamaz derlemelere neden olabilir. Android için Haritalar SDK'sı, semantik sürüm oluşturmaya uyar. Yeni ana sürümler, zarar veren değişiklikler içerebilir. Desteklenen minimum API düzeyi 19'dur.
Gradle söz dizimi kullanarak Google Play Hizmetleri'nde Haritalar bağımlılığını belirtme.
dependencies {
implementation 'com.google.android.gms:play-services-maps:18.1.0'
// ...
}
Google Play Hizmetleri sürüm oluşturmayı yönetme ile ilgili ek kılavuza bakın.
Bakım ve yükseltme
Android Studio, kullanılabilir yeni sürümleri otomatik olarak kontrol eder ve bağımlılığın daha yeni bir sürümü varsa uyarı verir. Teknik borcu en aza indirmek için mümkün olan en kısa sürede en yeni sürüme 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 hakkında sürüm notlarına göz atın.
Google Cloud proje sahipleri, yeni sürümler için anket yapmanın yanı sıra projelerini etkileyebilecek, geriye dönük olarak uyumlu olmayan değişiklikler hakkında e-postalar da alır. Eski sürümlerle uyumsuz olan değişiklikler hakkında proaktif bildirim almak istiyorsanız projelerinizin her birine ait izleme e-posta adresini kullanarak sahip rolünü atayın.