לפני שתוכלו להתחיל לשלב את 'כניסה באמצעות חשבון Google' באפליקציה שלכם, עליכם להגדיר פרויקט ב-Google API Console ולהגדיר את הפרויקט ב-Android Studio. השלבים שמפורטים בדף הזה עושים בדיוק את זה. בשלבים הבאים מוסבר איך לשלב את הכניסה באמצעות חשבון Google באפליקציה.
דרישות מוקדמות
הדרישות לכניסה באמצעות חשבון Google ל-Android הן:
- מכשיר Android תואם עם מערכת Android בגרסה 6.0 ואילך, שכולל את חנות Google Play או אמולטור עם AVD שפועל על פלטפורמת Google APIs שמבוססת על Android 4.2.2 ואילך, ועם Google Play Services בגרסה 15.0.0 ואילך.
- הגרסה האחרונה של Android SDK, כולל הרכיב SDK Tools. ערכת ה-SDK זמינה ב-Android SDK Manager ב-Android Studio.
- פרויקט שהוגדר ל-compile עבור 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 Console, או יוצרים פרויקט אם עדיין אין לכם פרויקט.
- בדף מסך ההסכמה של 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 Sign-In באפליקציה.