הגדרת Google Play Services

כדי לפתח אפליקציה באמצעות Google Play Services ממשקי API, פועלים לפי ההוראות שבדף הזה כדי להגדיר את הפרויקט באמצעות ערכות ה-SDK הרלוונטיות, שזמינות מאגר Maven.

כדי לבדוק את האפליקציה במהלך השימוש ב-Google Play Services, צריך להשתמש באחת הבאים:

  • מכשיר Android תואם עם Android 6.0 (API רמה 23) ואילך והוא כולל את אפליקציית חנות Google Play מותקנת.
  • האמולטור של Android עם שרת AVD שמפעיל את ממשקי ה-API של Google שמבוססת על Android 6.0 (רמת API 23) ואילך.

הצהרה על יחסי תלות של Google Play Services

כדי לפתח תכונות שתלויות בממשקי ה-API של Google Play Services באפליקציה שלכם: מבצעים את השלבים הבאים:

  1. פותחים את הקובץ build.gradle בספריית המודול של האפליקציה.

  2. עבור כל ערכת SDK שנדרשת לאפליקציה, צריך לכלול את התלות של אותה SDK. בדף הזה מופיע קטע שבו מפורטים שירותי Google Play נפוצים תלות של אפליקציות ל-Android. כדאי גם להוסיף יחסי התלות של Firebase project.

  3. שומרים את השינויים ומסנכרנים את project.

בקטע הקוד הבא מוצג קובץ build.gradle לדוגמה שמשתמש ברכיב ספריית המיקומים:

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-location:21.3.0'
}

גרסאות חדשות של ערכות ה-SDK של Google Play Services עם תיקוני באגים ותכונות חדשות מתפרסמות מדי פעם. העדכונים האלה מפורסמים בגרסה הערות. אם האפליקציה שלך משתמשת בתלות שכבר מעודכן, צריך לעבור לגרסה האחרונה של יחסי התלות של האפליקציה של התיקונים האלה.

בדיקה אם Google Play Services מותקנת

כפי שמתואר בסקירה הכללית של Google Play Services, חבילת Google Play Services מקבלת עדכונים אוטומטיים ב-Android 6.0 (רמת API 23) ואילך באמצעות האפליקציה של חנות Google Play. לעומת זאת, במכשירי Android בלי Google Play שירותי Google Play לא מותקנים בחנות. אם האפליקציה פועלת במכשירים בלי Google Play Services, כדאי לבדוק אם Google Play מותקנים במכשיר לפני שמנסים להשתמש ב-Google APIs, או להפעיל תכונות באפליקציה שמחייבות פעולה של Google Play Services.

כדי לבדוק את הנוכחות של Google Play Services במכשיר, משתמשים ב isGooglePlayServicesAvailable() .

כדי להתחיל חיבור אל Google Play Services, או ללמוד איך לזהות אם הגרסה של Google Play Services שמותקנת תומכת בממשק API ספציפי, קראו את המדריך בנושא גישה ל-Google APIs.

יחסי תלות של Google Play Services

בטבלה הבאה מפורטים יחסי התלות של שירותי Google Play שניתן להשתמש בהם כוללים באפליקציה ל-Android. כדי לסנן את הרשימה לפי סוג מכשיר, אפשר לבחור אחד מהלחצנים, וניתן לחפש תלות או תרחיש ספציפי לדוגמה על ידי הזנת טקסט בתיבה שמופיעה אחרי הלחצנים.

טבלה 1. יחסי תלות של Google Play Services שצריך לכלול אפליקציות ל-Android
התרחיש לדוגמה ושם התלות מכשירים נתמכים
מודעות Google לנייד
com.google.android.gms:play-services-ads:23.3.0
טלפון, טאבלט
מזהה הפרסום ב-Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.1.0
טלפון, טאבלט, Android TV, ChromeOS
גרסה פשוטה ונוחה של מודעות Google לנייד
com.google.android.gms:play-services-ads-lite:23.3.0
טלפון, טאבלט
מודעות בהתאמה אישית לרשת החיפוש (CSA) ב-AdSense לחיפוש (AFS)
com.google.android.gms:play-services-afs-native:19.1.0
טלפון, טאבלט, ChromeOS
SDK של Google Analytics Services ל-Android
com.google.android.gms:play-services-analytics:18.1.0
הוצא משימוש. במקום זאת, יש להשתמש ב-Google Analytics for Firebase.
אינדקס האפליקציות
com.google.android.gms:play-services-appindex:16.2.0
טלפון, טאבלט, Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.0
טלפון, טאבלט, Android TV
מזהה קבוצת אפליקציות ל-Android
com.google.android.gms:play-services-appset:16.1.0
טלפון, טאבלט, Android TV, ChromeOS
כניסה באמצעות חשבון Google ל-Android
com.google.android.gms:play-services-auth:21.2.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS
SMS Retriever API
com.google.android.gms:play-services-auth-api-phone:18.1.0
טלפון, טאבלט, Android Go
חסימת Store API (כולל אחסון של פרטי כניסה של משתמשים)
com.google.android.gms:play-services-auth-blockstore:16.4.0
טלפון, טאבלט, Android Go, ChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.1.0
טלפון, טאבלט, Auto, Android Go, ChromeOS
שיעורי עזר
com.google.android.gms:play-services-base:18.5.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
בדיקת זיופים במחלקות עזר
com.google.android.gms:play-services-base-testing:16.1.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
עוד סוגי שירות
com.google.android.gms:play-services-basement:18.4.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.5.0
טלפון, טאבלט, Android Go, ChromeOS
Google Cast Application Framework (CAF)
com.google.android.gms:play-services-cast-framework:21.5.0
טלפון, טאבלט, Android Go, ChromeOS
Google Code Scanner
com.google.android.gms:play-services-code-scanner:16.1.0
טלפון, טאבלט, Android Go, ChromeOS
סטאק רשת Chromium (Cronet)
com.google.android.gms:play-services-cronet:18.1.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
אינטראקציות ממכשיר למכשיר (DTDI)
com.google.android.gms:play-services-dtdi:16.0.0-beta01
טלפון, טאבלט, Android Go
אימות מהיר של IDentity Online (FIDO)
com.google.android.gms:play-services-fido:21.1.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS

נתמך במכשירים עם Android 7.0 (רמת API 24) ומעלה.
Google Fit API ל-Android ו-Recording API בנייד (לנתוני כושר של משתמשים)
com.google.android.gms:play-services-fitness:21.2.0
טלפון, טאבלט, Android Go, ChromeOS, Wear OS
Google Play Games Services גרסה 2 ל-Android
com.google.android.gms:play-services-games-v2:20.1.2
טלפון, טאבלט, Android TV, Android Go, ChromeOS
Google Play Games Services v2 Native C SDK ל-Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
טלפון, טאבלט, Android TV, Android Go, ChromeOS
Google Play Games Services גרסה 1 ל-Android
com.google.android.gms:play-services-games:23.2.0
טלפון, טאבלט, Android TV, Android Go, ChromeOS
Matter API
com.google.android.gms:play-services-home:16.0.0
טלפון, טאבלט
Google Play ללא התקנה
com.google.android.gms:play-services-instantapps:18.1.0
טלפון, טאבלט, Android TV, Android Go, ChromeOS

נתמך במכשירים עם Android מגרסה 5.0 (רמת API 21) ומעלה.
שירותי מיקום ל-Android
com.google.android.gms:play-services-location:21.3.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
SDK של מפות Google ל-Android
com.google.android.gms:play-services-maps:19.0.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
סריקת ברקוד ל-ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1
טלפון, טאבלט, Android Go, ChromeOS
סורק המסמכים ML Kit
com.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1
טלפון, טאבלט, Android Go, ChromeOS
זיהוי פנים ב-ML Kit
com.google.android.gms:play-services-mlkit-face-detection:17.1.0
טלפון, טאבלט, Android Go, ChromeOS
הוספת תוויות לתמונות בערכת ML
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
טלפון, טאבלט, Android Go, ChromeOS
הוספת תוויות לתמונות בערכת ML
com.google.android.gms:play-services-mlkit-image-labeling-custom:16.0.0-beta5
טלפון, טאבלט, Android Go, ChromeOS
זיהוי השפה ב-ML Kit
com.google.android.gms:play-services-mlkit-language-id:17.0.0
טלפון, טאבלט, Android Go, ChromeOS
תשובה מהירה עם ML Kit
com.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1
טלפון, טאבלט, Android Go, ChromeOS
פילוח הנושא של ערכת ML
com.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1
טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט של ML Kit
com.google.android.gms:play-services-mlkit-text-recognition:19.0.1
טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט של ערכת ML בסינית
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.1
טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט של ML Kit בדוונגארי
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.1
טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט של ML Kit ביפנית
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.1
טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט של ML Kit בקוריאנית
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.1
טלפון, טאבלט, Android Go, ChromeOS
גילוי וחיבור של מכשירים בקרבת מקום
com.google.android.gms:play-services-nearby:19.3.0
טלפון, טאבלט, Android TV, Auto, Android Go
הצגת רישיונות קוד פתוח
com.google.android.gms:play-services-oss-licenses:17.1.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS
נתמך במכשירים עם Android מגרסה 5.0 (רמת API 21) ומעלה.
בדיקת איכות של נעילת מסך
com.google.android.gms:play-services-password-complexity:18.1.0
טלפון, טאבלט, Android Go, ChromeOS, Wear OS

נתמך במכשירים עם Android 4.4 (רמת API 19) עד Android 9 (רמת API 28).
Google Wallet (לשעבר Google Pay לכרטיסים)
com.google.android.gms:play-services-pay:16.5.0
טלפון, טאבלט, Android Go, ChromeOS

נתמך במכשירים עם Android מגרסה 5.0 (רמת API 20) ומעלה.
reCAPTCHA Enterprise לאינסטרומנטציה של אפליקציה
com.google.android.gms:play-services-recaptcha:17.1.0
טלפון, טאבלט, Android TV, Android Go, ChromeOS
ממשקי SafetyNet API (כולל אימות המכשיר, גלישה בטוחה, reCAPTCHA ואימות אפליקציות)
com.google.android.gms:play-services-safetynet:18.1.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS
Google Tag Manager
com.google.android.gms:play-services-tagmanager:18.1.0
טלפון, טאבלט, Android TV, Android Go, ChromeOS
Tasks API ב-Android
com.google.android.gms:play-services-tasks:18.2.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
Acceleration Service (שירות האצה ל-Android)
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
טלפון, טאבלט, Android Go, ChromeOS
TensorFlow Lite GPU הענקת API לשירותי Google Play
com.google.android.gms:play-services-tflite-gpu:16.2.0
טלפון, טאבלט, Android Go, ChromeOS
TensorFlow Lite Java API ל-Google Play Services
com.google.android.gms:play-services-tflite-java:16.2.0-beta02
טלפון, טאבלט, Android Go, ChromeOS
TensorFlow Lite Support API לשירותי Google Play
com.google.android.gms:play-services-tflite-support:16.1.0
טלפון, טאבלט, Android Go, ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.0.1
טלפון, טאבלט
צפייה בנייד
com.google.android.gms:play-services-vision:20.1.3
טלפון, טאבלט, Android Go, ChromeOS
Google Pay לתשלומים ב-Android
com.google.android.gms:play-services-wallet:19.4.0
טלפון, טאבלט, Auto, Android Go, ChromeOS, Wear OS
API של שכבת נתונים Wearable Data Layer API
com.google.android.gms:play-services-wearable:18.2.0
טלפון, טאבלט, Wear OS

יישומי פלאגין של Gradle

Google Play Services כוללת גם כמה יישומי פלאגין של Gradle, כפי שמוצג מהטבלה הבאה. שימו לב שהלחצנים שמופיעים לפני הטבלה הקודמת לא לשנות את המידע שמופיע בטבלה הזו.

טבלה 2. רשימת יישומי הפלאגין של Gradle שכלולה ב-Google Play שירותים
שם התרחיש לדוגמה ושם הפלאגין של Gradle מכשירים נתמכים
הצגת רישיונות קוד פתוח
com.google.android.gms:oss-licenses-plugin:0.10.6
טלפון, טאבלט, ChromeOS
בדיקת גרסאות מחמירה
com.google.android.gms:strict-version-matcher-plugin:1.2.4
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS