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'lara olan bağımlılıklarınızı nasıl yöneteceğiniz konusunda yol gösterici bilgiler sağlanmaktadır.

  • İş 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 Yerler SDK'sının yeni nokta sürümlerini kullanmaya başlayabilirsiniz. Yeni nokta sürümleri geriye dönük olarak uyumlu olduğundan, bu işlem için uygulamanızda güncelleme yapılması gerekmez.

    Avantajları:

    • Android için Yerler SDK'sında sorunlar olduğunu fark ederseniz Mobil destek politikası uyarınca düzeltmeler ana sürümün ilk kullanıma sunulmasından itibaren 12 ay boyunca geriye dönük uyumlu bir şekilde sağlanır. Düzeltmelerden yararlanmak için acilen incompatible bir SDK sürümüne geçmeniz gerekmez.
    • Uygulamanız en son sürümde oluşturulduğunda en son iyileştirmeler ve özellikler kolayca kullanılabilir.
    • SDK'nın en yeni ana sürümüne her yıl yapılacak artımlı güncellemeler, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için birden fazla ana sürüm genelinde ortaya çıkan ve geriye dönük olarak uyumsuz olan değişiklikleri yönetmekten daha az çalışma gerektirebilir.

  • Kritik olmayan uygulamalar için sabit bir sürüme bağlantı verin. Söz konusu düzeltilmiş sürüm için kullanımdan kaldırma bildirimi aldığınızda, güncellenmiş uygulama kodunuzu kullanıcılarınıza sunmak için 12 ayınız olacaktır.

    Avantajları:

    • Daha seyrek 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 (yeni bir SDK sürümüne yükseltmeniz gerekene kadar) desteklemeye devam eder.

E-posta adresleri izlenen Proje Sahipleri, projelerinin her birini etkileyen değişiklikler hakkında proaktif bildirimler alır. Büyük güncellemeler, kullanımdan kaldırmalar ve diğer değişiklikler hakkında bilgilerden haberdar olun.

Döşeme

Uygulama düzeyindeki build.gradle dosyanızda, ön ek aralığı (+) veya latest yerine daima bir sürüm belirtin. Bu sürümler, öngörülemeyen ve tekrarlanamayan derlemelere yol açabilir. Android için Yerler SDK'sı anlamsal sürüm oluşturmaya bağlıdır ve yeni ana sürüm sürümleri zarar veren değişiklikler içerebilir. Desteklenen minimum API düzeyi 21'dir.

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ığın yeni sürümü kullanılabilir olduğunda uyarı verir. Teknik borcu en aza indirmek için mümkün olan 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 olarak uyumsuz değişiklikler ve kodunuzu nasıl güncelleyeceğiniz için sürüm notlarına göz atın.

Google Cloud proje sahipleri, yeni sürümler için yoklamanın yanı sıra projelerini etkileyebilecek geriye dönük olarak uyumsuz değişiklikler hakkında e-posta alır. Geriye dönük olarak uyumsuz değişiklikler hakkında proaktif bildirim almak için projelerinizin her birine, izlenen bir e-posta adresiyle sahip rolü atayın.

Android için Yerler SDK'sından 3.2.0 veya önceki bir sürümden yeni sürüme geçiyorsanız

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

  1. Uygulamanızda kullanılan API anahtarında Places API'yi (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.3.0'
      }

    kotlin-bom bağımlılığı hakkında daha fazla bilgi için Geçişli bağımlılıklarda en yeni kotlin-stdlib sürümünün kullanımı bölümüne bakın.

  3. Mevcut uygulamanızı, uygulamanızı ilk kullanıma hazırlamak için yeni Places.initializeWithNewPlacesApiEnabled() yöntemini çağıracak şekilde güncelleyin. Daha fazla bilgi için Place API istemcisini başlatma bölümüne bakın.

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