Aby opracować aplikację za pomocą 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 7.0 (poziom API 24) lub nowszym i zainstalowaną aplikacją Sklep Google Play.
- Emulator Androida z AVD, który korzysta z interfejsów API Google na platformie Android 7.0 (poziom interfejsu API 24) lub nowszej.
Deklarowanie zależności od Usług Google Play
Aby w aplikacji opracować 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 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 również chcieć dodać Firebase do swojego projektu.
Zapisz zmiany i zsynchronizuj projekt.
Poniższy fragment kodu przedstawia przykładowy plik build.gradle, który używa biblioteki lokalizacji:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.4.0'
}
Nowe wersje pakietów SDK usług Google Play zawierają poprawki błędów i nowe funkcje. 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 7.0 (poziom interfejsu API 24) 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ć obecność usług Google Play na urządzeniu, 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
Poniższa tabela zawiera 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 wyszukać konkretny przypadek użycia lub nazwę zależności, wpisując tekst w polu wyświetlanym po przyciskach.
| Przypadek użycia i nazwa zależności | Obsługiwane urządzenia |
|---|---|
Google Mobile Adscom.google.android.gms:play-services-ads:25.4.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 Google Mobile Adscom.google.android.gms:play-services-ads-lite:25.0.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 dla systemu Androidcom.google.android.gms:play-services-analytics:18.1.1 |
Przestarzałe. Zamiast tego użyj Google Analytics dla Firebase. |
Indeks 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 dla Androidacom.google.android.gms:play-services-auth:22.0.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS |
API SMS Retrievercom.google.android.gms:play-services-auth-api-phone:18.3.1 |
Telefony, tablety, Android Go |
Interfejs API magazynu bloków (obejmuje przechowywanie danych uwierzytelniających użytkownika)com.google.android.gms:play-services-auth-blockstore:16.4.0 |
Telefon, tablet, Android Go, ChromeOS |
Interfejs API Google Awarenesscom.google.android.gms:play-services-awareness:20.0.0 |
Telefony, tablety, samochody, Android Go, ChromeOS |
Klasy użytkowecom.google.android.gms:play-services-base:18.10.1 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Testowanie fałszywych wyników dla klas użytecznościcom.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.11.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Wzmocnienie aparatu 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 |
Struktura aplikacji Google Cast (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 urządzenie-urządzenie (DTDI)com.google.android.gms:play-services-dtdi:16.0.0-beta02 |
Telefony, tablety, 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 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS Obsługiwane na urządzeniach z systemem Android 7.0 (poziom API 24) lub nowszym. |
Interfejs API Google Fit dla systemu Android i Interfejs API do nagrywania na urządzeniach mobilnych (dla danych o aktywności fizycznej użytkowników)com.google.android.gms:play-services-fitness:21.3.0 |
Telefony, tablety, Android Go, ChromeOS, Wear OS |
Fraud Protectcom.google.android.gms:play-services-fraudprotect:16.0.1 |
Telefony, tablety, Android Go |
Usługi gier Google Play w wersji 2 dla 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 |
Telefon, tablet, Android TV, Android Go, ChromeOS |
Usługi gier Google Play w wersji 1 dla Androidacom.google.android.gms:play-services-games:25.0.0 |
Przestarzałe. Zamiast tego używaj usług gier Google Play w wersji 2. |
API Mattercom.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 |
Przestarzałe. Więcej informacji znajdziesz w Aplikacja błyskawiczna w Google Play. |
Usługi lokalizacyjne na Androidziecom.google.android.gms:play-services-location:21.4.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Maps SDK na Androidacom.google.android.gms:play-services-maps:20.0.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Zestaw SDK Map Google 3D dla 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 |
Skanowanie kodów kreskowych za pomocą zestawu 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 w ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
Telefon, tablet, Android Go, ChromeOS |
Etykietowanie obrazu ML Kitcom.google.android.gms:play-services-mlkit-image-labeling:16.0.8 |
Telefony, tablety, Android Go, ChromeOS |
Niestandardowe etykietowanie obrazów w zestawie 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 |
Telefon, tablet, Android Go, ChromeOS |
Segmentacja temató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 zestawie ML Kitcom.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1 |
Telefony, tablety, Android Go, ChromeOS |
Rozpoznawanie tekstu w języku dewanagari za pomocą zestawu 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 w zestawie 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 za pomocą 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.5.0 |
Telefon, tablet, Android TV, Auto, Android Go |
Pokaż licencje open sourcecom.google.android.gms:play-services-oss-licenses:17.5.2 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS Obsługiwane na urządzeniach z systemem Android 5.0 (poziom 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 systemem Android 5.0 (poziom 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 systemem Android 4.4 (poziom API 19) do Android 9 (poziom API 28). |
Portfel Google (dawniej Google Pay for Passes)com.google.android.gms:play-services-pay:16.5.0 |
Telefon, tablet, Android Go, ChromeOS Obsługiwane na urządzeniach z systemem Android 5.0 (poziom 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 |
API gestów zdalnychcom.google.android.gms:play-services-remotegestures:16.0.0 |
Telefon, Tablet |
Bezpieczne przeglądanie v5com.google.android.gms:play-services-safebrowsing:16.0.0 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS |
Interfejsy API SafetyNet (w tym bezpieczne przeglądanie i weryfikacja 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 |
Telefon, tablet, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Usługa przyspieszania dla systemu Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.5.0-beta02 |
Telefon, tablet, Android Go, ChromeOS |
Interfejs API delegata GPU TensorFlow Lite dla usług Google Playcom.google.android.gms:play-services-tflite-gpu:16.5.0 |
Telefon, tablet, Android Go, ChromeOS |
TensorFlow Lite Java API dla usług Google Playcom.google.android.gms:play-services-tflite-java:16.5.0 |
Telefon, tablet, 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 |
Interfejs API sieci wątkówcom.google.android.gms:play-services-threadnetwork:16.3.0 |
Telefon, tablet |
Zaufany interfejs API czasucom.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:20.0.0 |
Telefony, tablety, Android 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 obejmują również kilka wtyczek Gradle, jak pokazano w poniższej tabeli. Należy pamiętać, że przyciski znajdujące 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 |