Android sürümleri için Haritalar SDK'sı

Platformu seçin: Android iOS JavaScript

Google Haritalar Platformu Ekibi, SDK'ları düzenli olarak yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle günceller. Bu sayfada, mobil SDK'lardaki bağımlılıklarınızı nasıl yöneteceğiniz hakkında bilgi verilmektedir.

  • İş 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 keşfederseniz 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 kullanıma sunulan geriye dönük uyumsuz 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ıyla ilgili bir bildirim 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 23'tür.

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, kullanılabilir yeni sürümleri otomatik olarak kontrol eder ve bir bağımlılığın daha yeni bir sürümü kullanıma sunulduğunda uyarı verir. 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 uyumsuz değişiklikler ve kodunuzu nasıl güncelleyeceğiniz hakkında bilgi edinmek için sürüm notlarını inceleyin.

Google Cloud, yeni sürümler için yoklama yapmanın yanı sıra proje sahiplerine projelerini etkileyebilecek geriye dönük uyumsuz değişikliklerle ilgili e-postalar da gönderir. 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.