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

Platform 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ınlarken Android için Yerler 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 Yerler 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 kullanıma sunulan 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ümle bağlantı oluşturun. 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 Yerler SDK'sı, anlamsal sürüm oluşturma özelliğine uygundur ve yeni ana sürüm yayınları, uyumluluğu bozacak değişiklikler içerebilir. Desteklenen minimum API düzeyi 24'tür.

dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:4.3.1")
}

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 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şikliklerle ilgili e-postalar da 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.

Android için Yerler SDK'sının 3.2.0 veya önceki bir sürümünden yükseltme yapıyorsanız

Yeni SDK'ya geçiş yaparken taşıma işlemi yapmanız gerekmez. Yapmanız gereken tek şey:

  1. Uygulamanızda kullanılan API anahtarında Places API (Yeni)'yi etkinleştirin. Daha fazla bilgi için API Anahtarlarını Kullanma başlıklı makaleyi inceleyin.

  2. Modül düzeyindeki dependencies dosyanızın build.gradle bölümünde, places bağımlılığını güncelleyin ve kotlin-bom bağımlılığını ekleyin:

      dependencies {
      implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
      implementation 'com.google.android.libraries.places:places:3.5.0'
  }

    kotlin-bom bağımlılığı hakkında daha fazla bilgi için Geçişli bağımlılıklarda en son kotlin-stdlib sürümünün kullanımı başlıklı makaleyi inceleyin.

  3. Uygulamanızı başlatmak için yeni Places.initializeWithNewPlacesApiEnabled() yöntemini çağırmak üzere mevcut uygulamanızı güncelleyin. Daha fazla bilgi için Places API istemcisini başlatma başlıklı makaleyi inceleyin.

Mevcut uygulamalarınız değişmeden çalışmaya devam eder ancak artık tüm yeni SDK özelliklerinden yararlanabilirsiniz.