Aby opracować aplikację przy użyciu interfejsów API usług Google Play, postępuj zgodnie z instrukcjami na tej stronie, aby skonfigurować projekt z odpowiednimi pakietami SDK, które są dostępne w repozytorium Google Maven.
Aby przetestować aplikację podczas korzystania z usług Google Play, musisz użyć jednego z tych elementów:
- Zgodne urządzenie z Androidem w wersji 6.0 (poziom interfejsu API 23) lub nowszej z zainstalowaną aplikacją Sklep Google Play.
- emulator Androida z AVD, który działa na platformie 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 w aplikacji opracować funkcje zależne 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 Twoja aplikacja, uwzględnij 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 projekt.
Poniższy fragment pokazuje 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 publikowane są nowe wersje pakietów SDK Usług Google Play z poprawkami błędów i nowymi funkcjami. Informacje o tych aktualizacjach są podawane 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 skorzystać z tych poprawek.
Sprawdzanie, czy Usługi Google Play są zainstalowane
Jak opisano w omówieniu usług Google Play, usługi Google Play są automatycznie aktualizowane na urządzeniach z Androidem 6.0 (poziom interfejsu API 23) lub 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ą dostępne Usługi Google Play, użyj metody
isGooglePlayServicesAvailable().
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 Uzyskiwanie dostępu do interfejsów API Google.
Zależności od Usług Google Play
W tabeli poniżej znajdziesz listę zależności usług Google Play, które możesz uwzględnić w swojej aplikacji na Androida. Możesz filtrować listę według typu urządzenia, wybierając jeden z przycisków, a także wyszukiwać konkretne przypadki użycia lub nazwy 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 |
|---|---|
Google Mobile Adscom.google.android.gms:play-services-ads:24.4.0 |
Telefon, tablet |
Identyfikator wyświetlania reklam na urządzeniach z Androidem (AAID)com.google.android.gms:play-services-ads-identifier:18.2.0 |
Telefon, tablet, Android TV, ChromeOS |
Lekka wersja mobilnych reklam Googlecom.google.android.gms:play-services-ads-lite:24.3.0 |
Telefon, tablet |
Reklamy AdSense dla wyszukiwania (AFS) 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 |
Wycofano. Zamiast tego używaj Google Analytics dla Firebase. |
Indeks aplikacjicom.google.android.gms:play-services-appindex:16.2.0 |
Telefony, tablety, Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
Telefony, tablety, 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.3.0 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS |
SMS Retriever APIcom.google.android.gms:play-services-auth-api-phone:18.2.0 |
Telefony, tablety, Android Go |
Block Store API (obejmuje przechowywanie danych logowania użytkownika)com.google.android.gms:play-services-auth-blockstore:16.4.0 |
Telefony, tablety, Android Go, ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:19.1.0 |
Telefony, tablety, samochody, Android Go, ChromeOS |
Klasy narzędziowecom.google.android.gms:play-services-base:18.7.2 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Testowanie atrap klas narzędziowychcom.google.android.gms:play-services-base-testing:16.1.0 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Więcej klas narzędziowychcom.google.android.gms:play-services-basement:18.7.1 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Wzmocnienie przy słabym oświetleniucom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta03 |
Telefon, tablet |
Google Castcom.google.android.gms:play-services-cast:22.1.0 |
Telefony, tablety, Android Go, ChromeOS |
Google Cast Application Framework (CAF)com.google.android.gms:play-services-cast-framework:22.1.0 |
Telefony, tablety, Android Go, ChromeOS |
Skaner kodów Googlecom.google.android.gms:play-services-code-scanner:16.1.0 |
Telefony, tablety, Android Go, ChromeOS |
Stos sieciowy Chromium (Cronet)com.google.android.gms:play-services-cronet:18.1.0 |
Telefony, tablety, 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 |
Telefony, tablety, Android Go |
Uwierzytelnianie Fast IDentity Online (FIDO)com.google.android.gms:play-services-fido:21.2.0 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS Obsługiwane na urządzeniach z Androidem 7.0 (poziom interfejsu API 24) lub nowszym. |
Google Fit API na Androida i Recording API na urządzeniach mobilnych (w przypadku danych użytkownika dotyczących aktywności fizycznej)com.google.android.gms:play-services-fitness:21.2.0 |
Telefony, tablety, 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 |
Telefony, tablety, Android TV, Android Go, ChromeOS |
Natywny pakiet SDK w języku C usług gier Google Play w wersji 2 na Androidacom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
Telefony, tablety, Android TV, Android Go, ChromeOS |
Usługi gier Google Play w wersji 1 na Androidacom.google.android.gms:play-services-games:23.2.0 |
Telefony, tablety, Android TV, Android Go, ChromeOS |
Matter APIcom.google.android.gms:play-services-home:16.0.0 |
Telefon, tablet |
Aplikacje błyskawiczne z Google Playcom.google.android.gms:play-services-instantapps:18.1.0 |
Telefony, tablety, Android TV, Android Go, ChromeOS Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym. |
Usługi lokalizacyjne na Androidziecom.google.android.gms:play-services-location:21.3.0 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Google Maps SDK na Androidacom.google.android.gms:play-services-maps:19.2.0 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Pakiet SDK Map 3D na Androidacom.google.android.gms:play-services-maps3d:0.0.2 |
Telefon, tablet |
Skanowanie kodów kreskowych za pomocą ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 |
Telefony, tablety, Android Go, ChromeOS |
Skaner dokumentów ML Kitcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1 |
Telefony, tablety, Android Go, ChromeOS |
Wykrywanie twarzy w ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Telefony, tablety, Android Go, ChromeOS |
Oznaczanie obrazów etykietami w ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Telefony, tablety, Android Go, ChromeOS |
Niestandardowe oznaczanie obrazów w ML Kitcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
Telefony, tablety, Android Go, ChromeOS |
Identyfikacja języka w ML Kitcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Telefony, tablety, Android Go, ChromeOS |
Inteligentna odpowiedź w ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Telefony, tablety, Android Go, ChromeOS |
Segmentacja obiektów w ML Kitcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
Telefony, tablety, Android Go, ChromeOS |
Rozpoznawanie tekstu w ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.1 |
Telefony, tablety, Android Go, ChromeOS |
Rozpoznawanie tekstu w języku chińskim w ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 |
Telefony, tablety, Android Go, ChromeOS |
Rozpoznawanie tekstu w ML Kit w przypadku pisma dewanagaricom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1 |
Telefony, tablety, Android Go, ChromeOS |
Rozpoznawanie tekstu w języku japońskim w ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 |
Telefony, tablety, Android Go, ChromeOS |
Rozpoznawanie tekstu w języku koreańskim w ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1 |
Telefony, tablety, Android Go, ChromeOS |
Wykrywanie urządzeń w pobliżu i nawiązywanie z nimi połączeniacom.google.android.gms:play-services-nearby:19.3.0 |
Telefony, tablety, Android TV, Auto, Android Go |
Pokaż licencje open sourcecom.google.android.gms:play-services-oss-licenses:17.2.1 |
Telefony, tablety, 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:22.0.0 |
Telefony, tablety, 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 |
Telefony, tablety, Android Go, ChromeOS, Wear OS Obsługiwane na urządzeniach z Androidem w wersji od 4.4 (API na poziomie 19) do 9 (API na poziomie 28). |
Portfel Google (wcześniej Google Pay na karty)com.google.android.gms:play-services-pay:16.5.0 |
Telefony, tablety, 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 |
Telefony, tablety, Android TV, Android Go, ChromeOS |
Interfejsy API SafetyNet (obejmują bezpieczne przeglądanie i weryfikację aplikacji)com.google.android.gms:play-services-safetynet:18.1.0 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS |
Menedżer tagów Googlecom.google.android.gms:play-services-tagmanager:18.3.0 |
Telefony, tablety, Android TV, Android Go, ChromeOS |
Tasks API na Androidziecom.google.android.gms:play-services-tasks:18.3.2 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Usługa przyspieszania na Androidacom.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01 |
Telefony, tablety, Android Go, ChromeOS |
Interfejs TensorFlow Lite GPU Delegate API dla usług Google Playcom.google.android.gms:play-services-tflite-gpu:16.4.0 |
Telefony, tablety, Android Go, ChromeOS |
Interfejs API TensorFlow Lite Java dla usług Google Playcom.google.android.gms:play-services-tflite-java:16.4.0 |
Telefony, tablety, Android Go, ChromeOS |
Interfejs TensorFlow Lite Support API dla usług Google Playcom.google.android.gms:play-services-tflite-support:16.4.0 |
Telefony, tablety, 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 |
Telefony, tablety, samochody, Android Go, Wear OS |
Mobile Visioncom.google.android.gms:play-services-vision:20.1.3 |
Telefony, tablety, Android Go, ChromeOS |
Google Pay do płatności na Androidziecom.google.android.gms:play-services-wallet:19.4.0 |
Telefony, tablety, samochody, Android Go, ChromeOS, Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:19.0.0 |
Telefony, tablety, Wear OS |
Wtyczki Gradle
Usługi Google Play zawierają 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 |
|---|---|
Pokaż licencje open sourcecom.google.android.gms:oss-licenses-plugin:0.10.6 |
Telefon, tablet, ChromeOS |
Ścisłe sprawdzanie wersjicom.google.android.gms:strict-version-matcher-plugin:1.2.4 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS |