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

Platform seçin: Android iOS JavaScript

Google Haritalar Platformu ekibi, SDK'ları yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri. Bu sayfa, bağımlılıklarınızı nasıl yöneteceğiniz konusunda yol gösterir test edilir.

  • İş açısından kritik uygulamalar için ana sürümün en yeni (X.*) kullanın ve her yıl yeni ana sürüme yükseltin.

    Uygulamanızın yeni sürümlerini kullanıma sundukça Yıl boyunca, Android için Yerler SDK'sının yeni nokta sürümlerini kullanmaya başlayabilirsiniz. Bu, Yeni nokta sürümleri geriye dönük uyumlu olduğundan uygulamanızda güncelleme gerektirmeyecektir.

    Avantajları:

    • Android için Yerler SDK'sında sorunlar fark ederseniz, uygulamanın düzeltilmesi gereken kullanıma sunulmasından sonra 12 ay boyunca geriye dönük uyumluluğa Mobil destek politikasına tabidir. Acil olarak uyumlu olmayan bir SDK sürümüne yükseltmeniz gerekmez yararlanmanız için sunulacak.
    • En son iyileştirmeler ve özellikler, uygulamanız için zaten geliştirilmiş olduğunda kolayca benimsenebilir en son sürüme güncelleyin.
    • SDK'nın en yeni ana sürümüne yönelik yıllık artımlı güncellemeler daha az çalışma gerektirebilir. eski sürümlerle uyumsuzlukları çözmek yerine uygulamanızı uyarlamak, yeniden yazmak ve test etmek Birden fazla ana sürümde yapılan değişiklikler.

  • Kritik olmayan uygulamalar için sabit bir sürüme bağlantı verin. Desteğin sonlandırılması durumunda bildirimi almanız gerekiyorsa güncellenmiş uygulama kodunuzu ne kadar iyi karşıladığını görebileceksiniz.

    Avantajları:

    • Daha seyrek bakım çalışmaları.
    • Uygulamanızın yeni sürümleri, eski mobil işletim sistemi çalıştıran cihazlar daha uzun süre kullanılabilir (yeni bir SDK sürümüne yükseltmeniz gerekene kadar).

İzlenen e-posta adreslerine sahip Proje Sahipleri, nasıl etkilediğini öğreneceğiz. Kal ve diğer değişiklikler hakkında bilgilendirilmeyi sağlar.

Kurulum

Uygulama düzeyindeki build.gradle.kts veya build.gradle dosyanızda her zaman belirtin. önek aralığı (+) veya latest yerine bir sürüm tekrarlamaya engel olur. Android için Yerler SDK'sının şunlara uyması gerekir: semantik sürüm oluşturma ve yeni ana sürüm sürümleri zararlı değişiklikler içerebilir. Desteklenen minimum API düzeyi: 21) bulabilirsiniz.

dependencies {
    // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation 'com.google.android.libraries.places:places:3.3.0'
}

Bakım ve yükseltme

Android Studio yeni sürümleri otomatik olarak kontrol eder ve bağımlılığın yeni sürümü mevcut. Teknik borcu en aza indirmek için en kısa sürede kullanıma sunulmasını sağlar. Yeni bir ana sürüme güncelleme yapıyorsanız sürüm notlarını kontrol edin konusunda daha fazla bilgi edinmek için Yardım Merkezimizi ziyaret edin.

Google Cloud, daha yeni sürümleri yoklamanın yanı sıra proje sahipleri geriye dönük olarak uyumsuz değişiklikler nasıl etkilediğini öğreneceğiz. Eski sürümlerle uyumsuzluk hakkında proaktif bildirim almak için için, sahip rolüne sahip olmanız gerekir.

Android için Yerler SDK'sından 3.2.0 veya önceki bir sürüme geçiş yapıyorsanız

Yeni SDK'ya geçiş yapmak için taşıma işlemi gerekmez. Yapmanız gerekenler:

  1. Uygulamanızda kullanılan API anahtarında Places API'sini (Yeni) etkinleştirin. Daha fazla bilgi için API Anahtarlarını Kullanma bölümüne bakın.

  2. Modül düzeyinizin dependencies bölümünde build.gradle dosyası, 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 bkz. Geçişli bağımlılıklarda en yeni kotlin-stdlib sürümünün kullanımı.

  3. Yeni uygulamayı çağırmak için mevcut uygulamanızı güncelleyin Places.initializeWithNewPlacesApiEnabled() yöntemini seçin. Daha fazla bilgi için bkz. Places API istemcisini başlatın.

Mevcut uygulamalarınız değişmeden çalışmaya devam eder. Bununla birlikte, tüm yeni SDK özelliklerinden yararlanmaya karar verdik.