Aby tworzyć aplikacje za pomocą interfejsów API Usług Google Play, postępuj zgodnie z instrukcjami na tej stronie, aby skonfigurować projekt za pomocą odpowiednich pakietów SDK, które są dostępne w repozytorium Google Maven.
Aby testować aplikację podczas korzystania z Usług Google Play, musisz użyć jednego z tych elementów:
- zgodnego urządzenia z Androidem w wersji 6.0 (poziom interfejsu API 23) lub nowszej, na którym jest zainstalowana aplikacja Sklep Google Play;
- emulatora Androida z AVD, który korzysta z platformy interfejsów API Google opartej na Androidzie 6.0 (poziom interfejsu API 23) lub nowszym.
Deklarowanie zależności od Usług Google Play
Aby tworzyć w aplikacji funkcje, które zależą od interfejsów API Usług Google Play, wykonaj te czynności:
Otwórz plik
build.gradlew katalogu modułu aplikacji.W przypadku każdego pakietu SDK, którego wymaga aplikacja, dodaj zależność od tego pakietu. Na tej stronie znajduje się sekcja z listą typowych zależności od Usług Google Play w przypadku aplikacji na Androida. Możesz też dodać Firebase do projektu.
Zapisz zmiany i zsynchronizuj swój projekt.
Ten fragment kodu przedstawia przykładowy plik build.gradle, który korzysta z biblioteki lokalizacji:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.3.0'
}
Okresowo są udostępniane nowe wersje pakietów SDK Usług Google Play z poprawkami błędów i nowymi funkcjami. Informacje o tych aktualizacjach znajdziesz w informacjach o wersji. Jeśli Twoja aplikacja korzysta z zależności, która została zaktualizowana, zmień ją na najnowszą wersję w zależnościach aplikacji, aby korzystać z tych poprawek.
Sprawdzanie, czy Usługi Google Play są zainstalowane
Jak opisano w artykule Omówienie Usług Google Play , Usługi Google Play są automatycznie aktualizowane na Androidzie 6.0 (poziom interfejsu API 23) i nowszym za pomocą aplikacji Sklep Google Play. Jednak na urządzeniach bez Sklepu Google Play nie są zainstalowane Usługi Google Play. Jeśli Twoja aplikacja działa na urządzeniach bez Usług Google Play, przed użyciem interfejsów API Google lub włączeniem funkcji, które ich wymagają, zawsze sprawdzaj, czy Usługi Google Play są zainstalowane.
Aby sprawdzić, czy na urządzeniu są zainstalowane Usługi Google Play, użyj
isGooglePlayServicesAvailable()
metody.
Aby rozpocząć połączenie z Usługami Google Play lub dowiedzieć się, jak wykryć czy zainstalowana wersja Usług Google Play obsługuje określony interfejs API, przeczytaj przewodnik Dostęp do interfejsów API Google.
Zależności od Usług Google Play
W tabeli poniżej znajdziesz zależności od Usług Google Play, które możesz uwzględnić w aplikacji na Androida. Możesz filtrować listę według typu urządzenia, klikając jeden z przycisków, a także wyszukiwać konkretny przypadek użycia lub nazwę zależności, wpisując tekst w polu, które pojawi się po kliknięciu przycisków.
| Przypadek użycia i nazwa zależności | Obsługiwane urządzenia |
|---|---|
Reklamy mobilne Googlecom.google.android.gms:play-services-ads:25.1.0 |
Telefon, tablet |
Identyfikator wyświetlania reklam na urządzeniach z Androidem (AAID)com.google.android.gms:play-services-ads-identifier:18.3.0 |
Telefon, tablet, Android TV, ChromeOS |
Lekka wersja reklam mobilnych Googlecom.google.android.gms:play-services-ads-lite:24.8.0 |
Telefon, tablet |
AdSense dla wyszukiwania (AFS) Reklamy w wyszukiwarce niestandardowej (CSA)com.google.android.gms:play-services-afs-native:19.1.0 |
Telefon, tablet, ChromeOS |
Pakiet SDK usług Google Analytics na Androidacom.google.android.gms:play-services-analytics:18.1.1 |
Wycofany. Zamiast niego używaj Google Analytics dla Firebase. |
Indeksowanie aplikacjicom.google.android.gms:play-services-appindex:16.2.0 |
Telefon, tablet, Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
Telefon, tablet, Android TV |
Identyfikator zestawu aplikacji na Androidacom.google.android.gms:play-services-appset:16.1.0 |
Telefon, tablet, Android TV, ChromeOS |
Logowanie przez Google na Androidacom.google.android.gms:play-services-auth:21.5.1 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS |
SMS Retriever APIcom.google.android.gms:play-services-auth-api-phone:18.3.0 |
Telefon, tablet, Android Go |
Block Store API (obejmuje magazyn danych logowania użytkownika)com.google.android.gms:play-services-auth-blockstore:16.4.0 |
Telefon, tablet, Android Go, ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:20.0.0 |
Telefon, tablet, Auto, Android Go, ChromeOS |
Klasy narzędziowecom.google.android.gms:play-services-base:18.10.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Testowanie fałszywych klas narzędziowychcom.google.android.gms:play-services-base-testing:16.2.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Więcej klas narzędziowychcom.google.android.gms:play-services-basement:18.10.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Wzmocnienie obrazu w słabym oświetleniucom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta07 |
Telefon, tablet |
Google Castcom.google.android.gms:play-services-cast:22.3.1 |
Telefon, tablet, Android Go, ChromeOS |
Google Cast Application Framework (CAF)com.google.android.gms:play-services-cast-framework:22.3.1 |
Telefon, tablet, Android Go, ChromeOS |
Skaner kodów Googlecom.google.android.gms:play-services-code-scanner:16.1.0 |
Telefon, tablet, Android Go, ChromeOS |
Stos sieciowy Chromium (Cronet)com.google.android.gms:play-services-cronet:18.1.1 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Interakcje między urządzeniami (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta02 |
Telefon, tablet, Android Go |
Pakiet SDK weryfikatora kluczycom.google.android.gms:contactkeys:16.0.0 |
Telefon, tablet |
Uwierzytelnianie Fast IDentity Online (FIDO)com.google.android.gms:play-services-fido:21.2.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS Obsługiwane na urządzeniach z Androidem 7.0 (poziom interfejsu API 24) lub nowszym. |
Interfejs Google Fit API na Androida i Recording API na urządzeniach mobilnych (do danych o aktywności fizycznej użytkownika)com.google.android.gms:play-services-fitness:21.3.0 |
Telefon, tablet, Android Go, ChromeOS, Wear OS |
Usługi gier Google Play w wersji 2 na Androidacom.google.android.gms:play-services-games-v2:21.0.0 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Usługi gier Google Play w wersji 2 – natywny pakiet SDK w języku C na Androidacom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Usługi gier Google Play w wersji 1 na Androidacom.google.android.gms:play-services-games:24.0.0 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Matter APIcom.google.android.gms:play-services-home:16.0.0 |
Telefon, tablet |
Aplikacja błyskawiczna w Google Playcom.google.android.gms:play-services-instantapps:18.2.0 |
Wycofane. Więcej informacji znajdziesz w artykule Aplikacja błyskawiczna w Google Play. |
Usługi lokalizacyjne na Androidacom.google.android.gms:play-services-location:21.3.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Pakiet SDK Map Google na Androidacom.google.android.gms:play-services-maps:20.0.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Pakiet SDK Map Google 3D na Androidacom.google.android.gms:play-services-maps3d:0.2.0 |
Telefon, tablet |
Wzmocnienie efektów multimedialnychcom.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta03 |
Telefon, tablet |
Skanowanie kodów kreskowych za pomocą ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 |
Telefon, tablet, Android Go, ChromeOS |
Skaner dokumentów ML Kitcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0 |
Telefon, tablet, Android Go, ChromeOS |
Wykrywanie twarzy za pomocą ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Telefon, tablet, Android Go, ChromeOS |
Etykietowanie obrazów za pomocą ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Telefon, tablet, Android Go, ChromeOS |
Niestandardowe etykietowanie obrazów za pomocą ML Kitcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
Telefon, tablet, Android Go, ChromeOS |
Rozpoznawanie języka za pomocą ML Kitcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Telefon, tablet, Android Go, ChromeOS |
Inteligentna odpowiedź za pomocą ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Telefon, tablet, Android Go, ChromeOS |
Segmentacja obiektów za pomocą ML Kitcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
Telefon, tablet, Android Go, ChromeOS |
Rozpoznawanie tekstu za pomocą ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.1 |
Telefon, tablet, Android Go, ChromeOS |
Rozpoznawanie tekstu w języku chińskim za pomocą ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 |
Telefon, tablet, Android Go, ChromeOS |
Rozpoznawanie tekstu w języku dewanagari za pomocą ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1 |
Telefon, tablet, Android Go, ChromeOS |
Rozpoznawanie tekstu w języku japońskim za pomocą ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 |
Telefon, tablet, Android Go, ChromeOS |
Rozpoznawanie tekstu w języku koreańskim za pomocą ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1 |
Telefon, tablet, Android Go, ChromeOS |
Wykrywanie urządzeń w pobliżu i łączenie się z nimicom.google.android.gms:play-services-nearby:19.3.0 |
Telefon, tablet, Android TV, Auto, Android Go |
Wyświetlanie licencji open sourcecom.google.android.gms:play-services-oss-licenses:17.5.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym. |
Biblioteki dostępu zautomatyzowanego (PAL)com.google.android.gms:play-services-pal:23.0.0 |
Telefon, tablet, Android TV Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym. |
Sprawdzanie jakości blokady ekranu com.google.android.gms:play-services-password-complexity:18.1.0 |
Telefon, tablet, Android Go, ChromeOS, Wear OS Obsługiwane na urządzeniach z Androidem od 4.4 (poziom interfejsu API 19) do 9 (poziom interfejsu API 28). |
Portfel Google (wcześniej Google Pay dla kart)com.google.android.gms:play-services-pay:16.5.0 |
Telefon, tablet, Android Go, ChromeOS Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 20) lub nowszym. |
reCAPTCHA Enterprise do instrumentacji aplikacjicom.google.android.gms:play-services-recaptcha:17.1.0 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Interfejsy SafetyNet API (obejmują bezpieczne przeglądanie i weryfikację aplikacji)com.google.android.gms:play-services-safetynet:18.1.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS |
Menedżer tagów Googlecom.google.android.gms:play-services-tagmanager:18.3.0 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Tasks API na Androidacom.google.android.gms:play-services-tasks:18.4.1 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Acceleration Service na Androidacom.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01 |
Telefon, tablet, Android Go, ChromeOS |
TensorFlow Lite GPU Delegate API na Usługi Google Playcom.google.android.gms:play-services-tflite-gpu:16.4.0 |
Telefon, tablet, Android Go, ChromeOS |
TensorFlow Lite Java API na Usługi Google Playcom.google.android.gms:play-services-tflite-java:16.4.0 |
Telefon, tablet, Android Go, ChromeOS |
TensorFlow Lite Support API na Usługi Google Playcom.google.android.gms:play-services-tflite-support:16.4.0 |
Telefon, tablet, Android Go, ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.3.0 |
Telefon, tablet |
Trusted Time APIcom.google.android.gms:play-services-time:16.0.1 |
Telefon, tablet, Auto, Android Go, Wear OS |
Mobile Visioncom.google.android.gms:play-services-vision:20.1.3 |
Telefon, tablet, Android Go, ChromeOS |
Google Pay do płatności na Androidacom.google.android.gms:play-services-wallet:19.5.0 |
Telefon, tablet, Auto, Android Go, ChromeOS, Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:19.0.0 |
Telefon, tablet, Wear OS |
Wtyczki Gradle
Usługi Google Play obejmują też kilka wtyczek Gradle, jak pokazano w tabeli poniżej. Pamiętaj, że przyciski, które pojawiają się przed poprzednią tabelą, nie zmieniają informacji w tej tabeli.
| Przypadek użycia i nazwa wtyczki Gradle | Obsługiwane urządzenia |
|---|---|
Wyświetlanie licencji open sourcecom.google.android.gms:oss-licenses-plugin:0.11.0 |
Telefon, tablet, ChromeOS |
Ścisłe sprawdzanie wersjicom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |