Aralık ayında San Francisco'da düzenlenecek bir sonraki Google Haritalar Platformu Geliştirici Topluluğu Günü'nde bize katılın. Katılmak için hemen başvurun.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

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ınızı nasıl yöneteceğinizle ilgili bilgiler verilmiştir.

Hangi sürüme bağlanacak?

Görev 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ınladıkça 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 uygulamanızda güncelleme yapmanız gerekmez.

Avantajları:
- Android için Yerler SDK'sında sorunlarla karşılaşırsanız Mobil destek politikası uyarınca, ana sürümün ilk yayınlanmasından sonraki 12 ay boyunca geriye dönük uyumlu düzeltmeler sağlanır. Düzeltmelerden yararlanmak için acilen uyumsuz bir SDK sürümüne geçmeniz gerekmez.
- Uygulamanız en yeni sürüm üzerine geliştirildiğinde en yeni iyileştirmeleri ve özellikleri kolayca kullanabilirsiniz.
- SDK'nın en yeni ana sürümüne yıllık artımlı güncellemeler yapmak, uygulamanızı uyarlamak, yeniden yazmak ve test etmek için birden fazla ana sürümde yapılan geriye dönük uyumsuz değişiklikleri ele almaktan daha az çalışma gerektirebilir.
Kritik olmayan uygulamalar için herhangi bir düzeltilmiş sürüme bağlantı verin. Bu düzeltilmiş sürüm için desteğin sonlandırılması bildirimi aldığınızda, güncellenmiş uygulama kodunuzu kullanıcılarınıza sunmak için 12 ayınız olur.

Avantajları:
- Daha seyrek bakım çalışması.
- Uygulamanızın yeni sürümleri, kullanıcıların daha 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.

İzlenen e-posta adreslerine sahip proje sahipleri, projelerini etkileyen değişikliklerle ilgili 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ığı (+) veya latest yerine her zaman bir sürüm belirtin. Aksi takdirde, öngörülemeyen ve tekrarlanamayan derlemeler oluşabilir. Android için Yerler SDK'sı, anlamsal sürüm oluşturma kurallarına uyar ve yeni ana sürüm sürümleri, zarar veren 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:6.0.2")
}

Bakım ve yükseltme

Android Studio, daha yeni sürümler olup olmadığını otomatik olarak kontrol eder ve bir bağımlılığın daha yeni bir sürümü mevcut 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 geçiyorsanı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 proje sahipleri, yeni sürümleri kontrol etmenin yanı sıra projelerini etkileyebilecek geriye dönük uyumsuz değişikliklerle ilgili e-postalar alır. Geriye dönük uyumsuz değişikliklerle ilgili proaktif bildirim almak için projelerinizin her birine izlenen bir e-posta adresiyle sahip rolü atayın.

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

Yeni SDK'ya geçerken taşıma işlemi yapmanız gerekmez. Tek yapmanız gereken:

Uygulamanızda kullanılan API anahtarında Places API'yi (Yeni) etkinleştirin. Daha fazla bilgi için API Anahtarlarını Kullanma başlıklı makaleyi inceleyin.
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.
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 Places API istemcisini ilk kullanıma hazırlama 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.