כדי לפתח אפליקציה באמצעות ממשקי ה-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, צריך לבצע את השלבים הבאים:
פותחים את הקובץ
build.gradle
בספריית המודול של האפליקציה.לכל ערכת SDK שנדרשת לאפליקציה, צריך לכלול את התלות ב-SDK הזו. בדף הזה יש קטע עם רשימה של יחסי התלות הנפוצים של Google Play Services באפליקציות ל-Android. מומלץ גם להוסיף לפרויקט יחסי תלות ל-Firebase.
שומרים את השינויים ומסנכרנים את הפרויקט.
קטע הקוד הבא מציג קובץ 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. אפשר לסנן את הרשימה לפי סוג המכשיר על ידי לחיצה על אחד מהלחצנים, ולחפש שם ספציפי של יחסי תלות או תרחיש לדוגמה על ידי הזנת טקסט בתיבה שמופיעה אחרי הלחצנים.
שם תרחיש לדוגמה ושם התלות | מכשירים נתמכים |
---|---|
Google Mobile Adscom.google.android.gms:play-services-ads:23.6.0 |
טלפון, טאבלט |
מזהה הפרסום ב-Android (AAID)com.google.android.gms:play-services-ads-identifier:18.2.0 |
טלפון, טאבלט, Android TV, ChromeOS |
גרסה קלה של Google Mobile Adscom.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 ל-Androidcom.google.android.gms:play-services-analytics:18.1.1 |
הוצא משימוש. במקום זאת, צריך להשתמש ב-Google Analytics for Firebase. |
App Indexcom.google.android.gms:play-services-appindex:16.2.0 |
טלפון, טאבלט, Android TV |
AppSearchcom.google.android.gms:play-services-appsearch:16.0.1 |
טלפון, טאבלט, Android TV |
מזהה קבוצת אפליקציות ל-Androidcom.google.android.gms:play-services-appset:16.1.0 |
טלפון, טאבלט, Android TV, ChromeOS |
כניסה באמצעות חשבון Google ל-Androidcom.google.android.gms:play-services-auth:21.3.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS |
SMS Retriever APIcom.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 APIcom.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 Castcom.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 Scannercom.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 ל-Androidcom.google.android.gms:play-services-games-v2:20.1.2 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
Google Play Games Services v2 Native C SDK for Androidcom.google.android.gms:play-services-games-v2-native-c:17.0.0-beta1 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
Google Play Games Services v1 ל-Androidcom.google.android.gms:play-services-games:23.2.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.1.0 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS התכונה נתמכת במכשירים עם Android מגרסה 5.0 (רמת API 21) ואילך. |
שירותי המיקום ל-Androidcom.google.android.gms:play-services-location:21.3.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Google Maps SDK ל-Androidcom.google.android.gms:play-services-maps:19.0.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS |
סריקת ברקודים ב-ML Kitcom.google.android.gms:play-services-mlkit-barcode-scanning:18.3.1 |
טלפון, טאבלט, Android Go, ChromeOS |
סורק המסמכים של ML Kitcom.google.android.gms:play-services-mlkit-document-scanner:16.0.0-beta1 |
טלפון, טאבלט, 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 image labeling customcom.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.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 Kitcom.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 Managercom.google.android.gms:play-services-tagmanager:18.1.1 |
טלפון, טאבלט, Android TV, Android Go, ChromeOS |
Tasks API ב-Androidcom.google.android.gms:play-services-tasks:18.2.0 |
טלפון, טאבלט, Android TV, Auto, Android Go, ChromeOS, Wear OS |
Acceleration Service for Androidcom.google.android.gms:play-services-tflite-acceleration-service:16.4.0-beta01 |
טלפון, טאבלט, Android Go, ChromeOS |
TensorFlow Lite GPU Delegate API ל-Google Play Servicescom.google.android.gms:play-services-tflite-gpu:16.4.0 |
טלפון, טאבלט, Android Go, ChromeOS |
TensorFlow Lite Java API ל-Google Play Servicescom.google.android.gms:play-services-tflite-java:16.4.0 |
טלפון, טאבלט, Android Go, ChromeOS |
TensorFlow Lite Support API ל-Google Play Servicescom.google.android.gms:play-services-tflite-support:16.4.0 |
טלפון, טאבלט, Android Go, ChromeOS |
Thread Network APIcom.google.android.gms:play-services-threadnetwork:16.2.1 |
טלפון, טאבלט |
Trusted Time APIcom.google.android.gms:play-services-time:16.0.0 |
טלפון, טאבלט, רכב, Android Go, Wear OS |
Mobile Visioncom.google.android.gms:play-services-vision:20.1.3 |
טלפון, טאבלט, Android Go, ChromeOS |
Google Pay לתשלומים ב-Androidcom.google.android.gms:play-services-wallet:19.4.0 |
טלפון, טאבלט, רכב, Android Go, ChromeOS, Wear OS |
Wearable Data Layer APIcom.google.android.gms:play-services-wearable:19.0.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 |