הגדרת Google Play Services

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

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

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

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

כדי לפתח תכונות שתלויות בממשקי ה-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.2.0'
}

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

איך לבדוק אם שירותי Google Play מותקנים

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

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

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

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

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

טבלה 1. יחסי תלות של Google Play Services שצריך לכלול באפליקציות ל-Android
שם התרחיש לדוגמה והתלות מכשירים נתמכים
מודעות Google לנייד
com.google.android.gms:play-services-ads:22.6.0
טלפון, טאבלט
מזהה הפרסום ב-Android (AAID)
com.google.android.gms:play-services-ads-identifier:18.0.1
טלפון, טאבלט, Android TV, ChromeOS
גרסה פשוטה של מודעות Google לנייד
com.google.android.gms:play-services-ads-lite:22.6.0
טלפון, טאבלט
מודעות לרשת החיפוש בהתאמה אישית ב-AdSense לחיפוש (AFS)
com.google.android.gms:play-services-afs-native:19.0.3
טלפון, טאבלט, ChromeOS
SDK ל-Google Analytics Services ל-Android
com.google.android.gms:play-services-analytics:18.0.4
הוצא משימוש. במקום זאת, יש להשתמש ב-Google Analytics for Firebase.
אינדקס האפליקציה
com.google.android.gms:play-services-appindex:16.1.0
טלפון, טאבלט, Android TV
מזהה קבוצת אפליקציות ל-Android
com.google.android.gms:play-services-appset:16.0.2
טלפון, טאבלט, Android TV, ChromeOS
כניסה באמצעות חשבון Google ל-Android
com.google.android.gms:play-services-auth:21.0.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS
API לשליפה של SMS
com.google.android.gms:play-services-auth-api-phone:18.0.2
טלפון, טאבלט, Android Go
חסימת Store API (כולל אחסון של פרטי כניסה של משתמשים)
com.google.android.gms:play-services-auth-blockstore:16.2.0
טלפון, טאבלט, Android Go, ChromeOS
Google Awareness API
com.google.android.gms:play-services-awareness:19.0.1
טלפון, טאבלט, Auto, Android Go, ChromeOS
סיווגי שירותים
com.google.android.gms:play-services-base:18.3.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
בדיקת זיופים למחלקות תשתיות
com.google.android.gms:play-services-base-testing:16.0.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
עוד סוגים של כלי עזר
com.google.android.gms:play-services-basement:18.3.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
Google Cast
com.google.android.gms:play-services-cast:21.4.0
טלפון, טאבלט, Android Go, ChromeOS
מסגרת אפליקציית Google Cast (CAF)
com.google.android.gms:play-services-cast-framework:21.4.0
טלפון, טאבלט, Android Go, ChromeOS
מקלטי Android TV
com.google.android.gms:play-services-cast-tv:21.0.1
ב-Android TV
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.0.1
טלפון, טאבלט, 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:20.1.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS

נתמך במכשירים עם Android בגרסה 7.0 (API ברמה 24) ואילך.
Google Fit API ל-Android
com.google.android.gms:play-services-fitness:21.1.0
טלפון, טאבלט, Android Go, ChromeOS, Wear OS
Google Play Games Services גרסה 2 ל-Android
com.google.android.gms:play-services-games-v2:19.0.0
טלפון, טאבלט, Android TV, Android Go, ChromeOS
SDK מקורי של Google Play Games Services גרסה 2 ל-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.1.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.0.1
טלפון, טאבלט, Android TV, Android Go, ChromeOS

האפשרות נתמכת במכשירים עם Android בגרסה 5.0 (רמת API 21) ומעלה.
שירותי מיקום ל-Android
com.google.android.gms:play-services-location:21.2.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
SDK של מפות Google ל-Android
com.google.android.gms:play-services-maps:18.2.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
סריקת ברקוד של ML Kit
com.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0
טלפון, טאבלט, 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
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.0
טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט ב-ML Kit לסינית
com.google.android.gms:play-services-mlkit-text-recognition-chinese:16.0.0
טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט בערכת ML עבור דוואנגרי
com.google.android.gms:play-services-mlkit-text-recognition-devanagari:16.0.0
טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט ב-ML Kit ליפנית
com.google.android.gms:play-services-mlkit-text-recognition-japanese:16.0.0
טלפון, טאבלט, Android Go, ChromeOS
זיהוי טקסט ב-ML Kit לקוריאנית
com.google.android.gms:play-services-mlkit-text-recognition-korean:16.0.0
טלפון, טאבלט, Android Go, ChromeOS
איתור מכשירים בקרבת מקום וחיבור
com.google.android.gms:play-services-nearby:19.1.0
טלפון, טאבלט, Android TV, Auto, Android Go
הצגת רישיונות קוד פתוח
com.google.android.gms:play-services-oss-licenses:17.0.1
טלפון, טאבלט, Android TV, Auto, Android Go ו-ChromeOS
האפשרות נתמכת במכשירים עם Android בגרסה 5.0 (רמת API 21) ומעלה.
בדיקת איכות של נעילת מסך
com.google.android.gms:play-services-password-complexity:18.0.1
טלפון, טאבלט, 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.4.0
טלפון, טאבלט, Android Go, ChromeOS

האפשרות נתמכת במכשירים עם Android בגרסה 5.0 (רמת API 20) ומעלה.
reCAPTCHA Enterprise לכל הטמעה של אפליקציות
com.google.android.gms:play-services-recaptcha:17.0.1
טלפון, טאבלט, Android TV, Android Go, ChromeOS
SafetyNet APIs (כולל אימות (attestation) מכשירים, גלישה בטוחה, reCAPTCHA ואימות אפליקציות)
com.google.android.gms:play-services-safetynet:18.0.1
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS
Google Tag Manager
com.google.android.gms:play-services-tagmanager:18.0.4
טלפון, טאבלט, Android TV, Android Go, ChromeOS
Tasks API ב-Android
com.google.android.gms:play-services-tasks:18.1.0
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS
שירות Boost ל-Android
com.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01
טלפון, טאבלט, Android Go, ChromeOS
TensorFlow Lite GPU Delegate API עבור Google Play Services
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 Services
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.0
טלפון, טאבלט
תצוגה לנייד
com.google.android.gms:play-services-vision:20.1.3
טלפון, טאבלט, Android Go, ChromeOS
Google Pay לתשלומים ב-Android
com.google.android.gms:play-services-wallet:19.3.0
טלפון, טאבלט, Auto, Android Go, ChromeOS, Wear OS
Wearable Data Layer API
com.google.android.gms:play-services-wearable:18.1.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