Aby utworzyć aplikację korzystającą z 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 Maven Google.
Aby przetestować aplikację podczas korzystania z usług Google Play, musisz użyć jednego z tych elementów:
- Zgodne urządzenie z Androidem 7.0 (poziom interfejsu API 24) lub nowszym i zainstalowaną aplikacją Sklep Google Play.
- Emulator Androida z AVD, który działa na platformie interfejsów API Google opartej na Androidzie 7.0 (poziom interfejsu API 24) lub nowszym.
Deklarowanie zależności od Usług Google Play
Aby opracować funkcje, które zależą od interfejsów API usług Google Play w aplikacji, 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 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.4.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 znajdziesz w informacjach o wersji. Jeśli Twoja aplikacja korzysta z zależności, która została zaktualizowana, zmień ją na najnowszą wersję, aby korzystać 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 Androidzie 7.0 (poziom interfejsu API 24) i nowszych wersjach za pomocą aplikacji Sklep Google Play. Jednak na urządzeniach bez Sklepu Google Play usługi Google Play nie są zainstalowane. 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 sprawdzić, czy zainstalowana wersja usług Google Play obsługuje dany interfejs API, przeczytaj przewodnik na temat uzyskiwania dostępu do interfejsów API Google.
Zależności usług Google Play
W tabeli poniżej znajdziesz zależności 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, i wyszukiwać konkretny przypadek użycia lub nazwę zależności, wpisując tekst w polu, które pojawi się po kliknięciu przycisku.
| Przypadek użycia i nazwa zależności | Obsługiwane urządzenia |
|---|---|
Google Mobile Adscom.google.android.gms:play-services-ads:25.5.0 |
Telefon, tablet |
Identyfikator wyświetlania reklam na urządzeniach z Androidem (AAID)com.google.android.gms:play-services-ads-identifier:18.3.0 |
Telefony, tablety, Android TV, ChromeOS |
Lekka wersja mobilnych reklam Googlecom.google.android.gms:play-services-ads-lite:25.0.0 |
Telefon, tablet |
Reklamy w wyszukiwarce niestandardowej (CSA) w AdSense dla wyszukiwania (AFS)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 |
Telefony, tablety, Android TV, ChromeOS |
Logowanie przez Google na Androidziecom.google.android.gms:play-services-auth:22.0.0 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS |
SMS Retriever APIcom.google.android.gms:play-services-auth-api-phone:18.3.1 |
Telefon, tablet, Android Go |
Block Store API (obejmuje magazyn 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:20.0.0 |
Telefon, tablet, Auto, Android Go, ChromeOS |
Klasy narzędziowecom.google.android.gms:play-services-base:18.11.0 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Testowanie atrap klas narzędziowychcom.google.android.gms:play-services-base-testing:16.2.0 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Więcej klas narzędziowychcom.google.android.gms:play-services-basement:18.12.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Ulepszona jakość obrazu przy słabym oświetleniucom.google.android.gms:play-services-camera-low-light-boost:16.0.1-beta09 |
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 |
Telefony, tablety, Android Go, ChromeOS |
Stos sieciowy Chromium (Cronet)com.google.android.gms:play-services-cronet:18.1.1 |
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 |
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.3.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 interfejs Recording API na urządzenia mobilne (w przypadku danych o aktywności fizycznej użytkownika)com.google.android.gms:play-services-fitness:21.3.0 |
Telefon, tablet, Android Go, ChromeOS, Wear OS |
Fraud Protectcom.google.android.gms:play-services-fraudprotect:16.0.1 |
Telefon, tablet, Android Go |
Usługi gier Google Play w wersji 2 na Androidacom.google.android.gms:play-services-games-v2:22.1.0 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Natywny pakiet SDK usług Gier Google Play w wersji 2 w języku C 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:25.0.0 |
Wycofano. Zamiast tego używaj usług Gier Google Play w wersji 2. |
Matter APIcom.google.android.gms:play-services-home:16.0.0 |
Telefon, tablet |
Google Play Instantcom.google.android.gms:play-services-instantapps:18.2.0 |
Wycofano. Więcej informacji znajdziesz w artykule Aplikacje błyskawiczne w Google Play. |
Usługi lokalizacyjne na Androidziecom.google.android.gms:play-services-location:21.4.0 |
Telefony, tablety, 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.2 |
Telefon, tablet |
Ulepszanie efektów multimedialnychcom.google.android.gms:play-services-media-effect-enhancement:16.0.0-beta08 |
Telefon, tablet |
Efekt multimedialny Dźwięk studyjnycom.google.android.gms:play-services-media-effect-studiosound:16.0.0-beta02 |
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 |
Telefony, tablety, 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 w ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Telefony, tablety, Android Go, ChromeOS |
Niestandardowe etykietowanie 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 |
Telefon, tablet, Android Go, ChromeOS |
Inteligentna odpowiedź 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 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 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 za pomocą ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1 |
Telefony, tablety, Android Go, ChromeOS |
Rozpoznawanie tekstu w ML Kit w przypadku języka koreańskiegocom.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.5.1 |
Telefony, tablety, Android TV, Auto, Android Go |
Pokaż licencje open sourcecom.google.android.gms:play-services-oss-licenses:17.5.2 |
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:23.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 4.4 (poziom API 19) do Androida 9 (poziom API 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 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Remote Gestures APIcom.google.android.gms:play-services-remotegestures:16.0.0 |
Telefon, tablet |
Bezpieczne przeglądanie w wersji 5com.google.android.gms:play-services-safebrowsing:16.0.0 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS |
Interfejsy API SafetyNet (obejmują bezpieczne przeglądanie i weryfikowanie 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 |
Telefony, tablety, Android TV, Android Go, ChromeOS |
Tasks API na Androidziecom.google.android.gms:play-services-tasks:18.4.1 |
Telefony, tablety, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Acceleration Service for Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02 |
Telefon, tablet, Android Go, ChromeOS |
Interfejs TensorFlow Lite GPU Delegate API dla usług Google Playcom.google.android.gms:play-services-tflite-gpu:16.5.0 |
Telefony, tablety, Android Go, ChromeOS |
Interfejs API TensorFlow Lite Java dla Usług Google Playcom.google.android.gms:play-services-tflite-java:16.5.0 |
Telefony, tablety, Android Go, ChromeOS |
Interfejs TensorFlow Lite Support API dla Usług Google Playcom.google.android.gms:play-services-tflite-support:16.5.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 |
Telefony, tablety, Android Go, ChromeOS |
Google Pay do płatności na Androidziecom.google.android.gms:play-services-wallet:20.0.0 |
Telefon, tablet, Auto, Android Go, ChromeOS, Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:20.0.1 |
Telefon, tablet, Wear OS |
Wtyczki Gradle
Usługi Google Play zawierają też kilka wtyczek Gradle, które są wymienione w tabeli poniżej. Pamiętaj, że przyciski, które pojawiają się przed poprzednią tabelą, nie zmieniają informacji wyświetlanych 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.13.0 |
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 |