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ştirmeleriyle düzenli olarak günceller. Bu sayfada, mobil SDK'lara olan bağımlılıkları yönetmeyle ilgili yol gösterici bilgiler verilmektedir.

  • İş açısından kritik uygulamalar için, kullandığınız ana sürümün en son nokta sürümüne (X.*) 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. 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.
    • Uygulamanız en son sürümde oluşturulmuşsa en son iyileştirmeleri ve özellikleri kolayca kullanabilirsiniz.
    • SDK'nın en yeni büyük sürümünde yıllık artımlı güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için daha az iş gerektirebilir. Bu, birden fazla büyük sürüm sürümünde kullanımdan kaldırılan değişiklikleri ele almaktan daha az iş gerektirir.

  • Kritik olmayan uygulamalar için, düzeltilmiş herhangi bir sürüme bağlantı verin. Bu düzeltilen sürüm için desteğin sonlandırıldığına dair bildirim aldığınızda, güncellenmiş uygulama kodunuzu kullanıcılarınıza sunmanız için 12 ay süre tanınır.

    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, projelerinin her birini etkileyen değişiklikler hakkında proaktif bildirimler alır. Kal ve diğer değişiklikler hakkında bilgilendirilmeyi sağlar.

Kurulum

Uygulama düzeyindeki build.gradle.kts veya build.gradle dosyanızda, ön ek aralığı (+) veya latest yerine her zaman bir sürüm belirtin. Aksi takdirde, beklenmedik ve tekrarlanamayan derlemelere neden olabilirsiniz. Android için Yerler SDK'sı anlamsal sürümlemeye uygundur ve yeni büyük sürüm sürümleri önemli değişiklikler içerebilir. Desteklenen minimum API düzeyi 23'tür.

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, kullanılabilir yeni sürümleri otomatik olarak kontrol eder ve bir bağımlılık için 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ü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ı 3.2.0 veya önceki bir sürümden yükseltme yapıyorsanız

Yeni SDK'ya geçiş yaparken taşıma işlemi yapmanız gerekmez. Bunun için 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üzeyindeki build.gradle dosyanızın dependencies 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. 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. Ancak artık şunları alabilirsiniz: tüm yeni SDK özelliklerinden yararlanmaya karar verdik.