כדי לפתח אפליקציה באמצעות ממשקי ה-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 Services
כדי לפתח תכונות שתלויות בממשקי ה-API של Google Play Services באפליקציה:
פותחים את הקובץ
build.gradleשבתוך ספריית המודול של האפליקציה.עבור כל SDK שהאפליקציה שלכם דורשת, צריך לציין את התלות של אותה SDK. בדף הזה יש קטע שבו מפורטות סוגי תלות נפוצים של שירותי Google Play באפליקציות ל-Android. אפשר גם להוסיף יחסי תלות של Firebase לפרויקט.
שומרים את השינויים ומסנכרנים את הפרויקט.
קטע הקוד הבא מציג קובץ build.gradle לדוגמה שמשתמש בספריית המיקומים:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-location:21.0.1'
}
מדי פעם מתפרסמות גרסאות חדשות של ערכות ה-SDK של Google Play Services עם תיקוני באגים ותכונות חדשות. העדכונים האלה מתפרסמים בנתוני הגרסה. אם באפליקציה נעשה שימוש בתלות שעודכנו, צריך להחליף לגרסה האחרונה של יחסי התלות של האפליקציה כדי לנצל את התיקונים.
איך בודקים אם Google Play Services מותקנת
כפי שמתואר בסקירה הכללית של Google Play Services, שירותי Google Play מקבלים עדכונים אוטומטיים ב-Android בגרסה 5.0 (API ברמה 21) ואילך דרך האפליקציה של חנות Google Play. עם זאת, שירותי Google Play לא מותקנים במכשירי Android בלי חנות Google Play. אם האפליקציה פועלת במכשירים ללא Google Play Services, כדאי לבדוק אם שירותי Google Play מותקנים במכשיר לפני שמנסים להשתמש ב-Google APIs, או להפעיל תכונות באפליקציה שמחייבות פעולה של Google Play Services.
כדי לבדוק את הנוכחות של Google Play Services במכשיר, משתמשים ב-method isGooglePlayServicesAvailable().
כדי להתחיל את החיבור ל-Google Play Services או להבין איך לזהות אם הגרסה של Google Play Services שמותקנת תומכת ב-API ספציפי, תוכלו לקרוא את המדריך בנושא גישה ל-Google APIs.
יחסי תלות של Google Play Services
בטבלה הבאה מפורטים יחסי התלות של 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 ל-Androidcom.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 |
מזהה קבוצת אפליקציות ל-Androidcom.google.android.gms:play-services-appset:16.0.2 |
טלפון, טאבלט, Android TV, ChromeOS |
כניסה באמצעות חשבון Google ל-Androidcom.google.android.gms:play-services-auth:20.7.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS |
ממשק API של SMS Retrievercom.google.android.gms:play-services-auth-api-phone:18.0.1 |
טלפון, טאבלט, Android Go |
חסימת Store API (כולל אחסון של פרטי כניסה של משתמשים)com.google.android.gms:play-services-auth-blockstore:16.2.0 |
טלפון, טאבלט, Android Go, ChromeOS |
Google Awareness APIcom.google.android.gms:play-services-awareness:19.0.1 |
טלפון, טאבלט, Auto, Android Go, ChromeOS |
סיווגי שירותיםcom.google.android.gms:play-services-base:18.2.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.2.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Google Castcom.google.android.gms:play-services-cast:21.4.0 |
טלפון, טאבלט, Android Go, ChromeOS |
Google Cast Application Framework (CAF)com.google.android.gms:play-services-cast-framework:21.4.0 |
טלפון, טאבלט, Android Go, ChromeOS |
מקלטים ל-Android TVcom.google.android.gms:play-services-cast-tv:21.0.1 |
Android TV |
Google Code Scannercom.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 |
אימות באמצעות מזהה מהיר באינטרנט (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 ל-Androidcom.google.android.gms:play-services-fitness:21.1.0 |
טלפון, טאבלט, Android Go, ChromeOS, Wear OS |
Google Play Games Services גרסה 2 ל-Androidcom.google.android.gms:play-services-games-v2:19.0.0 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
Native C SDK ל-Google Play Games Services גרסה 2com.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
Google Play Games Services גרסה 1 ל-Androidcom.google.android.gms:play-services-games:23.1.0 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
Matter APIcom.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) ומעלה. |
Fused Location Provider ל-Android (כולל זיהוי פעילות וגבולות וירטואליים)com.google.android.gms:play-services-location:21.0.1
| טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS |
SDK של מפות Google ל-Androidcom.google.android.gms:play-services-maps:18.2.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS |
סריקת ברקוד של ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.0 |
טלפון, טאבלט, Android Go, ChromeOS |
זיהוי פנים של ערכת ML Kitcom.google.android.gms:play-services-mlkit-face-detection:17.1.0 |
טלפון, טאבלט, Android Go, ChromeOS |
הוספת תוויות לתמונות ב-ML Kitcom.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 Kitcom.google.android.gms:play-services-mlkit-language-id:17.0.0 |
טלפון, טאבלט, Android Go, ChromeOS |
תשובה מהירה בנושא ML Kitcom.google.android.gms:play-services-mlkit-smart-reply:16.0.0-beta1 |
טלפון, טאבלט, Android Go, ChromeOS |
פילוח לפי נושא ML Kitcom.google.android.gms:play-services-mlkit-subject-segmentation:16.0.0-beta1 |
טלפון, טאבלט, Android Go, ChromeOS |
זיהוי טקסט ב-ML Kitcom.google.android.gms:play-services-mlkit-text-recognition:19.0.0 |
טלפון, טאבלט, Android Go, ChromeOS |
זיהוי טקסט בערכת ML לסינית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.0.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 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 API (כולל אימות של מכשירים, גלישה בטוחה, reCAPTCHA ואימות אפליקציות)com.google.android.gms:play-services-safetynet:18.0.1 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS |
Google Tag Managercom.google.android.gms:play-services-tagmanager:18.0.4 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
Tasks API ב-Androidcom.google.android.gms:play-services-tasks:18.0.2 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS |
שירות Acceleration ל-Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.0.0-beta01 |
טלפון, טאבלט, Android Go, ChromeOS |
TensorFlow Lite GPU רחוב API לשירותי Google Playcom.google.android.gms:play-services-tflite-gpu:16.2.0 |
טלפון, טאבלט, Android Go, ChromeOS |
TensorFlow Lite Java API לשירותי Google Playcom.google.android.gms:play-services-tflite-java:16.1.0 |
טלפון, טאבלט, Android Go, ChromeOS |
TensorFlow Lite Support API לשירותי Google Playcom.google.android.gms:play-services-tflite-support:16.1.0 |
טלפון, טאבלט, Android Go, ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.0.0 |
טלפון, טאבלט |
תצוגה לניידcom.google.android.gms:play-services-vision:20.1.3 |
טלפון, טאבלט, Android Go, ChromeOS |
Google Pay לתשלומים ב-Androidcom.google.android.gms:play-services-wallet:19.2.1 |
טלפון, טאבלט, Auto, Android Go, ChromeOS, Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:18.1.0 |
טלפון, טאבלט, Wear OS |
יישומי פלאגין של Gradle
חבילת Google Play Services כוללת גם כמה יישומי פלאגין של Gradle, כפי שמתואר בטבלה הבאה. שימו לב שהלחצנים שמופיעים לפני הטבלה הקודמת לא משנים את המידע שמופיע בטבלה.
| תרחיש שימוש ושם הפלאגין של 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 |