Google Play Hizmetleri'ni kur

Google Play Hizmetleri API'lerini kullanarak uygulama geliştirmek için bu sayfadaki talimatları uygulayarak projenizi Google maven deposundan edinilebilen ilgili SDK'larla ayarlayın.

Google Play Hizmetleri'ni kullanırken uygulamanızı test etmek için aşağıdakilerden birini kullanmanız gerekir:

  • Android 6.0 (API düzeyi 23) veya sonraki sürümleri çalıştıran ve Google Play Store uygulamasının yüklü olduğu uyumlu bir Android cihaz.
  • Android 6.0 (API düzeyi 23) veya sonraki sürümlere dayalı Google API'leri platformunu çalıştıran bir AVD içeren Android emülatör.

Google Play Hizmetleri için bağımlılıkları beyan etme

Uygulamanızda Google Play Hizmetleri API'lerine dayalı özellikler geliştirmek için aşağıdaki adımları uygulayın:

  1. Uygulamanızın modül dizininde build.gradle dosyasını açın.

  2. Uygulamanızın ihtiyaç duyduğu her SDK için ilgili SDK'nın bağımlılığını ekleyin. Bu sayfada, Android uygulamaları için yaygın Google Play Hizmetleri bağımlılıklarını listeleyen bir bölüm yer alır. Ayrıca projenize Firebase bağımlılıklarını ekleyebilirsiniz.

  3. Değişiklikleri kaydedin ve projenizi senkronize edin.

Aşağıdaki snippet'te, konum kitaplığını kullanan örnek bir build.gradle dosyası gösterilmektedir:

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.3.0'
}

Google Play Hizmetleri SDK'larının hata düzeltmeleri ve yeni özellikler içeren yeni sürümleri düzenli olarak yayınlanır. Bu güncellemeler sürüm notlarında duyurulur. Uygulamanız güncellenmiş bir bağımlı kullanıyorsa bu düzeltmelerden yararlanmak için uygulamanızın bağımlılarındaki en son sürüme geçin.

Google Play Hizmetleri'nin yüklü olup olmadığını kontrol etme

Google Play Hizmetleri'ne genel bakış bölümünde açıklandığı gibi, Google Play Hizmetleri, Android 6.0 (API düzeyi 23) ve sonraki sürümlerde Google Play Store uygulaması aracılığıyla otomatik güncelleme alır. Ancak Google Play Store'u olmayan Android cihazlarda Google Play Hizmetleri yüklü değildir. Uygulamanız Google Play Hizmetleri'nin yüklü olmadığı cihazlarda çalışıyorsa Google API'lerini kullanmayı denemeden önce cihazda Google Play Hizmetleri'nin yüklü olup olmadığını kontrol edebilir veya uygulamanızda Google Play Hizmetleri'nin çalışmasını gerektiren özellikleri etkinleştirebilirsiniz.

Cihazdaki Google Play Hizmetleri'nin varlığını kontrol etmek için isGooglePlayServicesAvailable() yöntemini kullanın.

Ardından Google Play Hizmetleri ile bağlantı başlatmak veya yüklü Google Play Hizmetleri sürümünün belirli bir API'yi destekleyip desteklemediğini nasıl tespit edeceğinizi öğrenmek için Google API'lerine erişme başlıklı kılavuzu okuyun.

Google Play Hizmetleri bağımlılıkları

Aşağıdaki tabloda, Android uygulamanıza dahil edebileceğiniz Google Play Hizmetleri bağımlılıkları listelenmiştir. Düğmelerden birini seçerek listeyi cihaz türüne göre filtreleyebilir, düğmelerden sonra görünen kutuya metin girerek belirli bir kullanım alanını veya bağımlılık adını arayabilirsiniz.

Tablo 1. Android uygulamalarına eklenecek Google Play Hizmetleri bağımlılıklarını
Büyük/küçük harf kullanımı ve bağımlılık adı Desteklenen cihazlar
Google Mobil Reklamlar
com.google.android.gms:play-services-ads:23.5.0
Telefon, Tablet
Android Reklam Kimliği (AAID)
com.google.android.gms:play-services-ads-identifier:18.1.0
Telefon, Tablet, Android TV, ChromeOS
Google Mobil Reklamlar'ın hafif sürümü
com.google.android.gms:play-services-ads-lite:23.5.0
Telefon, Tablet
Arama İçin AdSense (AFS) Özel Arama Reklamları (ÖAR)
com.google.android.gms:play-services-afs-native:19.1.0
Telefon, Tablet, ChromeOS
Android için Google Analytics Hizmetleri SDK'sı
com.google.android.gms:play-services-analytics:18.1.1
Kullanımdan kaldırıldı. Bunun yerine Firebase için Google Analytics'i kullanın.
App Index
com.google.android.gms:play-services-appindex:16.2.0
Telefon, Tablet, Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.1
Telefon, Tablet, Android TV
Android Uygulama Grubu Kimliği
com.google.android.gms:play-services-appset:16.1.0
Telefon, Tablet, Android TV, ChromeOS
Android için Google ile Oturum Açma
com.google.android.gms:play-services-auth:21.2.0
Telefon, Tablet, Android TV, Auto, Android Go, ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.1.0
Telefon, Tablet, Android Go
Store API'yi engelleme (kullanıcı kimlik bilgisi depolama alanı dahildir)
com.google.android.gms:play-services-auth-blockstore:16.4.0
Telefon, Tablet, Android Go, ChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.1.0
Telefon, Tablet, Otomatik, Android Go, ChromeOS
Yardımcı sınıflar
com.google.android.gms:play-services-base:18.5.0
Telefon, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Yardımcı sınıflar için sahte verileri test etme
com.google.android.gms:play-services-base-testing:16.1.0
Telefon, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Diğer yardımcı sınıflar
com.google.android.gms:play-services-basement:18.5.0
Telefon, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:22.0.0
Telefon, Tablet, Android Go, ChromeOS
Google Cast Uygulama Çerçevesi (CAF)
com.google.android.gms:play-services-cast-framework:22.0.0
Telefon, Tablet, Android Go, ChromeOS
Google Code Scanner
com.google.android.gms:play-services-code-scanner:16.1.0
Telefon, Tablet, Android Go, ChromeOS
Chromium ağ yığını (Cronet)
com.google.android.gms:play-services-cronet:18.1.0
Telefon, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Cihazlar arası etkileşimler (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta02
Telefon, Tablet, Android Go
Fast IDentity Online (FIDO) Kimlik Doğrulama
com.google.android.gms:play-services-fido:21.1.0
Telefon, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS

Android 7.0 (API düzeyi 24) veya sonraki sürümlerin yüklü olduğu cihazlarda desteklenir.
Android için Google Fit API ve mobil cihazlarda Kayıt API'si (kullanıcı fitness verileri için)
com.google.android.gms:play-services-fitness:21.2.0
Telefon, Tablet, Android Go, ChromeOS, Wear OS
Android için Google Play Games Hizmetleri v2
com.google.android.gms:play-services-games-v2:20.1.2
Telefon, Tablet, Android TV, Android Go, ChromeOS
Android için Google Play Games Hizmetleri v2 Yerel C SDK'sı
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
Telefon, Tablet, Android TV, Android Go, ChromeOS
Android için Google Play Games Hizmetleri 1. sürüm
com.google.android.gms:play-services-games:23.2.0
Telefon, Tablet, Android TV, Android Go, ChromeOS
Matter API
com.google.android.gms:play-services-home:16.0.0
Telefon, Tablet
Google Play Instant
com.google.android.gms:play-services-instantapps:18.1.0
Telefon, Tablet, Android TV, Android Go, ChromeOS

Android 5.0 (API düzeyi 21) veya sonraki sürümlerin yüklü olduğu cihazlarda desteklenir.
Android için Konum Hizmetleri
com.google.android.gms:play-services-location:21.3.0
Telefon, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Android için Google Haritalar SDK'sı
com.google.android.gms:play-services-maps:19.0.0
Telefon, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
ML Kit barkod taraması
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1
Telefon, Tablet, Android Go, ChromeOS
ML Kit belge tarayıcı
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
Telefon, Tablet, Android Go, ChromeOS
ML Kit yüz algılama
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
Telefon, Tablet, Android Go, ChromeOS
ML Kit resim etiketleme
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
Telefon, Tablet, Android Go, ChromeOS
ML Kit resim etiketleme özel
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
Telefon, Tablet, Android Go, ChromeOS
ML Kit dil tanımlama
com.google.android.gms:play-services-mlkit-language-id:17.0.0
Telefon, Tablet, Android Go, ChromeOS
ML Kit akıllı yanıt
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
Telefon, Tablet, Android Go, ChromeOS
ML Kit konu segmentasyonu
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
Telefon, Tablet, Android Go, ChromeOS
ML Kit metin tanıma
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
Telefon, Tablet, Android Go, ChromeOS
Çince için ML Kit metin tanıma
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1
Telefon, Tablet, Android Go, ChromeOS
Devanagari için ML Kit metin tanıma
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1
Telefon, Tablet, Android Go, ChromeOS
Japonca için ML Kit metin tanıma
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
Telefon, Tablet, Android Go, ChromeOS
Kore dili için ML Kit metin tanıma
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1
Telefon, Tablet, Android Go, ChromeOS
Yakındaki cihazları keşfetme ve bunlara bağlanma
com.google.android.gms:play-services-nearby:19.3.0
Telefon, Tablet, Android TV, Auto, Android Go
Açık kaynak lisanslarını gösterme
com.google.android.gms:play-services-oss-licenses:17.1.0
Telefon, Tablet, Android TV, Auto, Android Go, ChromeOS
Android 5.0 (API düzeyi 21) veya sonraki sürümlerin yüklü olduğu cihazlarda desteklenir.
Programatik Erişim Kitaplıkları (PAL)
com.google.android.gms:play-services-pal:21.0.0
Telefon, Tablet, Android TV
Android 5.0 (API düzeyi 21) veya sonraki sürümlerin yüklü olduğu cihazlarda desteklenir.
Ekran kilidi kalite kontrolü
com.google.android.gms:play-services-password-complexity:18.1.0
Telefon, Tablet, Android Go, ChromeOS, Wear OS

Android 4.4 (API düzeyi 19) ile Android 9 (API düzeyi 28) arasındaki sürümleri çalıştıran cihazlarda desteklenir.
Google Cüzdan (eski adıyla Kartlar için Google Pay)
com.google.android.gms:play-services-pay:16.5.0
Telefon, Tablet, Android Go, ChromeOS

Android 5.0 (API düzeyi 20) veya sonraki sürümlerin yüklü olduğu cihazlarda desteklenir.
Uygulama enstrümantasyonu için reCAPTCHA Enterprise
com.google.android.gms:play-services-recaptcha:17.1.0
Telefon, Tablet, Android TV, Android Go, ChromeOS
SafetyNet API'leri (cihaz onayı, güvenli tarama, reCAPTCHA ve uygulama doğrulamasını içerir)
com.google.android.gms:play-services-safetynet:18.1.0
Telefon, Tablet, Android TV, Auto, Android Go, ChromeOS
Google Etiket Yöneticisi
com.google.android.gms:play-services-tagmanager:18.1.1
Telefon, Tablet, Android TV, Android Go, ChromeOS
Android'de Tasks API
com.google.android.gms:play-services-tasks:18.2.0
Telefon, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS
Android için Hızlandırma Hizmeti
com.google.android.gms:play-services-tflite-acceleration-service:16.3.0-beta01
Telefon, Tablet, Android Go, ChromeOS
Google Play Hizmetleri için TensorFlow Lite GPU Temsilci API'si
com.google.android.gms:play-services-tflite-gpu:16.3.0
Telefon, Tablet, Android Go, ChromeOS
Google Play Hizmetleri için TensorFlow Lite Java API
com.google.android.gms:play-services-tflite-java:16.3.0
Telefon, Tablet, Android Go, ChromeOS
Google Play Hizmetleri için TensorFlow Lite Destek API'si
com.google.android.gms:play-services-tflite-support:16.3.0
Telefon, Tablet, Android Go, ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.2.1
Telefon, Tablet
Mobil Vision
com.google.android.gms:play-services-vision:20.1.3
Telefon, Tablet, Android Go, ChromeOS
Android'de Ödeme için Google Pay
com.google.android.gms:play-services-wallet:19.4.0
Telefon, Tablet, Auto, Android Go, ChromeOS, Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:19.0.0
Telefon, Tablet, Wear OS

Gradle eklentileri

Google Play Hizmetleri, aşağıdaki tabloda gösterildiği gibi çeşitli Gradle eklentileri de içerir. Önceki tablodan önce görünen düğmelerin bu tabloda görünen bilgileri değiştirmediğini unutmayın.

Tablo 2. Google Play Hizmetleri'ne dahil edilen Gradle eklentilerinin listesi
Kullanım alanı ve Gradle eklentisi adı Desteklenen cihazlar
Açık kaynak lisanslarını göster
com.google.android.gms:oss-licenses-plugin:0.10.6
Telefon, Tablet, ChromeOS
Katı sürüm kontrolü
com.google.android.gms:strict-version-matcher-plugin:1.2.4
Telefon, Tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS