הגדרת Google Play Services

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

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

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

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

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

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

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

  3. שומרים את השינויים ומסנכרנים את הפרויקט.

קטע הקוד הבא מציג קובץ 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 Services. אם האפליקציה שלכם פועלת במכשירים ללא שירותי Google Play, כדאי לבדוק אם שירותי Google Play מותקנים במכשיר לפני שאתם מנסים להשתמש ב-Google APIs, או להפעיל באפליקציה תכונות שדורשות את שירותי Google Play כדי לפעול.

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

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

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

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

טבלה 1. יחסי התלות של Google Play Services שצריך ל��לול באפליקציות ל-Android
שם תרחיש לדוגמה ושם התלות מכשירים נתמכים
Google Mobile Ads
com.google.android.gms:play-services-ads:23.6.0
טלפון, טאבלט
מזהה הפרסום ב-Android‏ (AAID)
com.google.android.gms:play-services-ads-identifier:18.1.0
טלפון, טאבלט, Android TV, ‏ ChromeOS
גרסה קלה של Google Mobile Ads
com.google.android.gms:play-services-ads-lite:23.6.0
טלפון, טאבלט
מודעות בהתאמה אישית לחיפוש (CSA) ב-AdSense לחיפוש (AFS)
com.google.android.gms:play-services-afs-native:19.1.0
טלפון, טאבלט, ChromeOS
ערכת פיתוח תוכנה ל-Google Analytics Services ל-Android
com.google.android.gms:play-services-analytics:18.1.1
הוצא משימוש. במקום זאת, צריך להשתמש ב-Google Analytics for Firebase.
App Index
com.google.android.gms:play-services-appindex:16.2.0
טלפון, טאבלט, Android TV
AppSearch
com.google.android.gms:play-services-appsearch:16.0.1
טלפון, טאבלט, 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
Block 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
טלפון, טאבלט, רכב, 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.5.0
טלפון, טאבלט, Android TV, ‏ Auto, ‏ Android Go, ‏ ChromeOS, ‏ Wear OS
Google Cast
com.google.android.gms:play-services-cast:22.0.0
טלפון, טאבלט, Android Go, ‏ ChromeOS
Google Cast Application Framework‏ (CAF)
com.google.android.gms:play-services-cast-framework:22.0.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-beta02
טלפון, טאבלט, Android Go
אימות Fast 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 v2 ל-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 for Android
com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1
טלפון, טאבלט, Android TV, ‏ Android Go, ‏ ChromeOS
Google Play Games Services v1 ל-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
Google Maps SDK ל-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 Kit
com.google.android.gms:play-services-mlkit-image-labeling:16.0.8
טלפון, ט��בלט, Android Go, ‏ ChromeOS
ML Kit image labeling custom
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 Kit
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 Kit לשפה הסינית
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) ואילך.
ספריות גישה פרוגרמטיות (PAL)
com.google.android.gms:play-services-pal:21.0.0
טלפון, טאבלט, Android TV
התכונה נתמכת במכשירים עם 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 for Passes)
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
ממשקי API של SafetyNet (כולל אימות מכשיר, גלישה בטוחה, 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.1
טלפון, טאבלט, 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 for Android
com.google.android.gms:play-services-tflite-acceleration-service:16.3.0-beta01
טלפון, טאבלט, Android Go, ‏ ChromeOS
TensorFlow Lite GPU Delegate API ל-Google Play Services
com.google.android.gms:play-services-tflite-gpu:16.3.0
טלפון, טאבלט, Android Go, ‏ ChromeOS
TensorFlow Lite Java API ל-Google Play Services
com.google.android.gms:play-services-tflite-java:16.3.0
טלפון, טאבלט, Android Go, ‏ ChromeOS
TensorFlow Lite Support API ל-Google Play Services
com.google.android.gms:play-services-tflite-support:16.3.0
טלפון, טאבלט, Android Go, ‏ ChromeOS
Thread Network API
com.google.android.gms:play-services-threadnetwork:16.2.1
טלפון, טאבלט
Mobile Vision
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
טלפון, טאבלט, רכב, Android Go, ‏ ChromeOS, ‏ Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:19.0.0
טלפון, טאבלט, Wear OS

פלאגינים של Gradle

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

טבלה 2. רשימת הפלאגינים של Gradle שכלולים ב-Google Play Services
תרחיש לדוגמה ושם הפלאגין של 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