Jeśli chcesz utworzyć aplikację, korzystając z interfejsów API Usług Google Play, postępuj zgodnie z instrukcjami na tej stronie. Pozwoli Ci to skonfigurować projekt z użyciem odpowiednich pakietów SDK, które znajdziesz w repozytorium Google Maven.
Aby przetestować aplikację przy użyciu Usług Google Play, musisz użyć jednego z tych elementów:
- Zgodne urządzenie z Androidem w wersji 5.0 (poziom interfejsu API 21) lub nowszym i zainstalowaną aplikacją Sklep Google Play.
- Emulator Androida z interfejsem AVD, który uruchamia platformę interfejsów API Google na podstawie Androida 5.0 (poziom interfejsu API 21) lub nowszego.
Deklarowanie zależności Usług Google Play
Aby utworzyć funkcje zależne od interfejsów API Usług Google Play w aplikacji, wykonaj te czynności:
Otwórz plik
build.gradlew katalogu modułu aplikacji.Dodaj zależność od każdego pakietu SDK, którego wymaga Twoja aplikacja. Ta strona zawiera sekcję zawierającą typowe zależności Usług Google Play w przypadku aplikacji na Androida. Możesz też dodać do projektu zależności Firebase.
Zapisz zmiany i zsynchronizuj projekt.
Ten fragment kodu zawiera 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.0.1'
}
Co jakiś czas publikowane są nowe wersje pakietów SDK Usług Google Play z poprawkami błędów i nowymi funkcjami. Te zmiany są ogłaszane w informacjach o wersji. Jeśli Twoja aplikacja używa zależności, która została zaktualizowana, przejdź na najnowszą wersję w zależnościach aplikacji, aby korzystać z tych poprawek.
Sprawdzanie, czy Usługi Google Play są zainstalowane
Zgodnie z opisem w przeglądzie Usług Google Play Usługi Google Play otrzymują automatyczne aktualizacje na Androida 5.0 (poziom interfejsu API 21) i nowsze za pomocą aplikacji Sklep Google Play. Jednak na urządzeniach z Androidem 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 skorzystaniem z interfejsów API Google sprawdź, czy są na nich zainstalowane Usługi Google Play, lub włącz w aplikacji funkcje, które do ich działania wymagają Usług Google Play.
Aby sprawdzić, czy na urządzeniu występują Usługi Google Play, użyj metody isGooglePlayServicesAvailable().
Aby następnie rozpocząć połączenie z Usługami Google Play lub dowiedzieć się, jak sprawdzić, czy wersja zainstalowanych Usług Google Play obsługuje określony interfejs API, przeczytaj przewodnik Uzyskiwanie dostępu do interfejsów API Google.
Zależności Usług Google Play
Poniższa tabela zawiera listę zależności Usług Google Play, które można uwzględnić w aplikacji na Androida. Możesz filtrować listę według typu urządzenia, wybierają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ę za przyciskami.
| Przypadek użycia i nazwa zależności | Obsługiwane urządzenia |
|---|---|
Reklamy mobilne Googlecom.google.android.gms:play-services-ads:22.5.0 |
Telefon, tablet |
Identyfikator wyświetlania reklam na urządzeniu z Androidem (AAID)com.google.android.gms:play-services-ads-identifier:18.0.1 |
Telefon, tablet, Android TV, ChromeOS |
Uproszczona wersja reklam mobilnych Googlecom.google.android.gms:play-services-ads-lite:22.5.0 |
Telefon, tablet |
Reklamy AdSense dla wyszukiwania w wyszukiwarce niestandardowejcom.google.android.gms:play-services-afs-native:19.0.3 |
Telefon, tablet, ChromeOS |
Pakiet SDK usług Google Analytics na Androidacom.google.android.gms:play-services-analytics:18.0.4 |
Wycofane. Zamiast tego użyj Google Analytics dla Firebase. |
Indeks aplikacjicom.google.android.gms:play-services-appindex:16.1.0 |
Telefon, tablet, Android TV |
Identyfikator zestawu aplikacji na Androidacom.google.android.gms:play-services-appset:16.0.2 |
Telefon, tablet, Android TV, ChromeOS |
Logowanie przez Google na Androidziecom.google.android.gms:play-services-auth:20.7.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS |
Interfejs API SMS Retrievercom.google.android.gms:play-services-auth-api-phone:18.0.1 |
Telefon, tablet, Android Go |
Block Store API (obejmuje magazyn danych logowania użytkowników)com.google.android.gms:play-services-auth-blockstore:16.2.0 |
Telefon, tablet, Android Go, ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:19.0.1 |
Telefon, tablet, Auto, Android Go, ChromeOS |
Klasy narzędzicom.google.android.gms:play-services-base:18.2.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Testowanie fałszywych treści pod kątem klas użytecznościcom.google.android.gms:play-services-base-testing:16.0.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Więcej klas narzędziowychcom.google.android.gms:play-services-basement:18.2.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.3.0 |
Telefon, tablet, Android Go, ChromeOS |
Google Cast Application Framework (CAF)com.google.android.gms:play-services-cast-framework:21.3.0 |
Telefon, tablet, Android Go, ChromeOS |
Odbiorniki Android TVcom.google.android.gms:play-services-cast-tv:21.0.0 |
Android TV |
Skaner Google Code Scannercom.google.android.gms:play-services-code-scanner:16.1.0 |
Telefon, tablet, Android Go, ChromeOS |
Stos sieci Chromium (Cronet)com.google.android.gms:play-services-cronet:18.0.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-beta01 |
Telefon, tablet, Android Go |
Uwierzytelnianie FIDO (Fast IDentity Online)com.google.android.gms:play-services-fido:20.1.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. |
Google Fit API na Androidacom.google.android.gms:play-services-fitness:21.1.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:19.0.0 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Natywny pakiet SDK Usług gier Google Play w wersji 2 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:23.1.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.0.1 |
Telefon, tablet, Android TV, Android Go, ChromeOS Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 21) lub nowszym. |
Dostawca uśrednionej lokalizacji na Androida (w tym rozpoznawanie aktywności i geofencing)com.google.android.gms:play-services-location:21.0.1
| Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Pakiet SDK Map Google na Androidacom.google.android.gms:play-services-maps:18.2.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Skanowanie kodów kreskowych w ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.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 |
Oznaczanie obrazów etykietami w ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Telefon, tablet, Android Go, ChromeOS |
Niestandardowe etykiety obrazów w ML Kitcom.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5 |
Telefon, tablet, Android Go, ChromeOS |
Identyfikacja języka ML Kitcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
Telefon, tablet, Android Go, ChromeOS |
Inteligentna odpowiedź w ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
Telefon, tablet, Android Go, ChromeOS |
Podział tematów na segmenty w ML Kitcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
Telefon, tablet, Android Go, ChromeOS |
Rozpoznawanie tekstu w ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.0 |
Telefon, tablet, Android Go, ChromeOS |
Rozpoznawanie tekstu w języku chińskim w ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0 |
Telefon, tablet, Android Go, ChromeOS |
Rozpoznawanie tekstu w ML Kit dla języka dewanagaricom.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0 |
Telefon, tablet, Android Go, ChromeOS |
Rozpoznawanie tekstu w ML Kit w języku japońskimcom.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0 |
Telefon, tablet, Android Go, ChromeOS |
Rozpoznawanie tekstu w ML Kit w języku koreańskimcom.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0 |
Telefon, tablet, Android Go, ChromeOS |
Wykrywanie urządzeń w pobliżu i nawiązywanie połączeńcom.google.android.gms:play-services-nearby:19.0.0 |
Telefon, tablet, Android TV, Auto, Android Go |
Pokaż licencje open sourcecom.google.android.gms:play-services-oss-licenses:17.0.1 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS 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.0.1 |
Telefon, tablet, Android Go, ChromeOS, Wear OS Obsługiwane na urządzeniach z Androidem 4.4 (poziom interfejsu API 19) i Androidem 9 (poziom interfejsu API 28). |
Google Pay for Cardscom.google.android.gms:play-services-pay:16.4.0 |
Telefon, tablety, Android Go, ChromeOS Obsługiwane na urządzeniach z Androidem 5.0 (poziom interfejsu API 20) lub nowszym. |
ReCAPTCHA Enterprise na potrzeby instrumentacji aplikacjicom.google.android.gms:play-services-recaptcha:17.0.1 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Interfejsy API SafetyNet (w tym atest urządzenia, bezpieczne przeglądanie, reCAPTCHA i weryfikacja aplikacji)com.google.android.gms:play-services-safetynet:18.0.1 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS |
Menedżer tagów Googlecom.google.android.gms:play-services-tagmanager:18.0.4 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Tasks API na Androidziecom.google.android.gms:play-services-tasks:18.0.2 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Usługa akceleracji na Androidacom.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01 |
Telefon, tablet, Android Go, ChromeOS |
TensorFlow Lite GPU Debit API dla usług Google Playcom.google.android.gms:play-services-tflite-gpu:16.2.0 |
Telefon, tablet, Android Go, ChromeOS |
Interfejs API Java TensorFlow Lite dla Usług Google Playcom.google.android.gms:play-services-tflite-java:16.1.0 |
Telefon, tablet, Android Go, ChromeOS |
TensorFlow Lite Support API dla Usług Google Playcom.google.android.gms:play-services-tflite-support:16.1.0 |
Telefon, tablet, Android Go, ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.0.0, |
Telefon, tablet |
Urządzenia mobilne Visioncom.google.android.gms:play-services-vision:20.1.3 |
Telefon, tablet, Android Go, ChromeOS |
Google Pay na urządzeniach z Androidemcom.google.android.gms:play-services-wallet:19.2.1 |
Telefon, tablet, Auto, Android Go, ChromeOS, Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:18.1.0 |
Telefon, tablet, Wear OS |
Wtyczki Gradle
Usługi Google Play zawierają też kilka wtyczek Gradle, jak pokazano w tej tabeli. Pamiętaj, że przyciski widoczne 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.10.6 |
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 |