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 yönelik bağımlılıklarınızı nasıl yöneteceğiniz hakkında bilgi verilmektedir.
Hangi sürümle bağlantı oluşturulur?
-
İş 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 Android 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 yapmanız gerekmez.
Avantajları:
- Android için Haritalar SDK'sında sorunlar tespit ederseniz Mobil destek politikası uyarınca, ana sürümün ilk yayınlanmasından sonraki 12 ay boyunca geriye dönük uyumlu şekilde düzeltmeler sağlanır. Düzeltmelerden yararlanmak için uyumsuz bir SDK sürümüne acilen yükseltmeniz gerekmez.
- Uygulamanız zaten en son sürümde oluşturulduysa en yeni 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ümde geriye dönük uyumlu olmayan değişiklikleri ele almaktan daha az iş gerektirebilir.
Kritik olmayan uygulamalar için düzeltilmiş bir sürümün bağlantısını ekleyin. Düzeltilmiş sürüm için desteğin sonlandırılması 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ı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 yükseltmeniz 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ırılan özellikler ve diğer değişiklikler hakkında bilgi edinin.
Kurulum
Uygulama düzeyindeki build.gradle.kts veya build.gradle dosyanızda, önek aralığı (+) ya da latest yerine her zaman bir sürüm belirtin. Bunlar, tahmin edilemeyen ve tekrarlanamayan derlemelere yol açabilir. Android için Haritalar SDK'sı, anlamsal sürüm oluşturma özelliğine uygundur ve yeni ana sürüm yayınları, uyumluluğu bozan değişiklikler içerebilir. Desteklenen minimum API düzeyi 21'dir.
Gradle söz dizimini kullanarak Google Play Hizmetleri'nde Haritalar bağımlılığını belirtme.
dependencies { // Maps SDK for Android implementation(libs.play.services.maps) }
Google Play Hizmetleri sürüm oluşturmayı yönetme hakkında ek bilgiler edinin.
Bakım ve yükseltme
Android Studio, daha yeni sürümlerin olup olmadığını otomatik olarak kontrol eder ve bir bağımlılığın daha yeni bir sürümü mevcut olduğunda uyarı gösterir. Teknik borcu en aza indirmek için en kısa sürede mevcut en yeni sürüme güncelleyin. Yeni bir ana 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.
Google Cloud proje sahipleri, daha yeni sürümler için yoklama yapmanın yanı sıra projelerini etkileyebilecek geriye dönük uyumsuz değişiklikler hakkında e-posta alır. Geriye dönük uyumsuz değişikliklerle ilgili proaktif bildirim almak için her projenizde izlenen bir e-posta adresiyle sahip rolünü atayın.