לפני שמתחילים לשלב את הכניסה באמצעות חשבון Google באפליקציה, צריך להגדיר פרויקט ב-Google API Console ולהגדיר את הפרויקט ב-Android Studio. השלבים שבדף הזה מסבירים איך לעשות את זה. בקטע השלבים הבאים מוסבר איך לשלב את הכניסה לחשבון Google באפליקציה.
דרישות מוקדמות
כדי להשתמש בכניסה באמצעות חשבון Google ל-Android, צריך לעמוד בדרישות הבאות:
- מכשיר תואם עם מערכת Android מגרסה 6.0 ואילך, שכולל את חנות Google Play או אמולטור עם מכשיר וירטואלי של Android (AVD) שמריץ את פלטפורמת Google APIs על בסיס Android מגרסה 4.2.2 ואילך, וכולל את Google Play Services מגרסה 15.0.0 ואילך.
- הגרסה האחרונה של Android SDK, כולל רכיב SDK Tools. ערכת ה-SDK זמינה מ-Android SDK Manager ב-Android Studio.
- פרויקט שהוגדר להדרת גרסה של Android 6.0 (Marshmallow) ומעלה.
המדריך הזה מיועד למשתמשים ב-Android Studio, שהיא סביבת הפיתוח המומלצת.
הוספת Google Play Services
בקובץ build.gradle ברמה העליונה של הפרויקט, מוודאים שמאגר ה-Maven של Google נכלל:
allprojects {
repositories {
google()
// If you're using a version of Gradle lower than 4.1, you must instead use:
// maven {
// url 'https://maven.google.com'
// }
}
}
לאחר מכן, בקובץ build.gradle ברמת האפליקציה, מצהירים על Google Play Services כתלות:
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-auth:21.3.0'
}
הגדרת פרויקט ב-Google API Console
- פותחים את הפרויקט בקונסולת ה-API, או יוצרים פרויקט אם עדיין אין לכם אחד.
- בדף מסך ההסכמה של OAuth, מוודאים שכל המידע מלא ומדויק.
- בדף Credentials, יוצרים מזהה לקוח מסוג Android לאפליקציה, אם עדיין אין לכם כזה. תצטרכו לציין את שם החבילה של האפליקציה ואת טביעת האצבע לאישור SHA-1. מידע נוסף זמין במאמר אימות הלקוח.
איך מקבלים את מזהה הלקוח ב-OAuth 2.0 של שרת הקצה העורפי
אם האפליקציה מאומתת באמצעות שרת קצה עורפי או ניגשת ל-Google APIs משרת הקצה העורפי, צריך לקבל את מזהה הלקוח ב-OAuth 2.0 שמייצג את שרת הקצה העורפי.
כדי ליצור מזהה לקוח לשרת:
פותחים את הפרויקט ב-API Console.
בדף Credentials, יוצרים מזהה לקוח מסוג Web application. חשוב לשים לב למחרוזת של מזהה הלקוח, כי תצטרכו להעביר אותה לשיטה
requestIdTokenאוrequestServerAuthCodeכשתיצרו את האובייקטGoogleSignInOptions.
השלבים הבאים
אחרי שמגדירים פרויקט ב-Google API Console ומגדירים את הפרויקט ב-Android Studio, אפשר לשלב את התכונה 'כניסה באמצעות חשבון Google' באפליקציה.