לפני שתוכלו להתחיל לשלב את האפליקציה ל-iOS או ל-macOS עם הרכיבים של 'כניסה באמצעות חשבון Google', תצטרכו להוריד את יחסי התלות ולהגדיר את פרויקט ה-Xcode שלכם. השלבים באתר בדף הזה עושות את זה. השלבים הבאים מתארים את אופן השילוב תכונות של כניסה באמצעות חשבון Google לאפליקציה.
לפני שמתחילים
מתקינים גרסה עדכנית של Xcode.
התקנת יחסי התלות של כניסה באמצעות חשבון Google בפרויקט
CocoaPods
אם עדיין לא התקנתם את CocoaPods, פועלים לפי השלבים תחילת העבודה של CocoaPods מותאמת אישית.
פותחים חלון טרמינל ומנווטים למיקום של ה-Xcode של האפליקציה פרויקט.
אם עדיין לא יצרת Podfile לאפליקציה, צריך ליצור קובץ כזה עכשיו:
pod init
פותחים את ה-Podfile שנוצר לאפליקציה ומוסיפים את הפרטים הבאים:
pod 'GoogleSignIn'
אם משתמשים ב-SwiftUI, מוסיפים גם את תוסף pod עבור "כניסה" עם Google" לחצן:
pod 'GoogleSignInSwiftSupport'
שמירת הקובץ והפעלה:
pod install
פותחים את קובץ Workspace שנוצר עבור האפליקציה ב-
.xcworkspace
Xcode. יש להשתמש בקובץ הזה בשביל כל פיתוח באפליקציה בעתיד. (הערה: שהוא שונה מקובץ הפרויקט.xcodeproj
הכלול, עלולות לגרום לשגיאות build כשפותחים אותו.)אפשר לעיין באפליקציה לדוגמה של Objective-C Podfile כדוגמה.
מנהל חבילות SWIFT
פותחים פרויקט ב-Xcode.
הוספת יחסי תלות של כניסה באמצעות חשבון Google לאפליקציה (מסמכי תיעוד של Xcode):
מאגר https://github.com/google/GoogleSignIn-iOS
גרסה 7.0.0 מוצר ארוז GoogleSignIn אם משתמשים ב-SwiftUI, מוסיפים גם את המוצר הבא של חבילת התוספים עבור 'כניסה באמצעות חשבון Google' לחצן:
מוצר ארוז GoogleSignInSwift
קבלת מזהה לקוח ב-OAuth
לאפליקציה שלך נדרש מזהה לקוח OAuth כדי להזדהות באימות של Google בקצה העורפי. באפליקציות ל-iOS ו-macOS, משתמשים בסוג האפליקציה של OAuth Client-ID. צריך להיות מוגדר כ-iOS.
אם עדיין לא יצרתם מזהה לקוח ב-OAuth, צריך ללחוץ על הלחצן למטה כדי לעשות זאת.
אחרי שיוצרים את מזהה הלקוח ב-OAuth, כדאי לשים לב למחרוזת של מזהה הלקוח, יהיה עליך להגדיר את האפשרות 'כניסה באמצעות חשבון Google' באפליקציה שלך. אפשר מורידים את קובץ התצורה, שמכיל את מזהה הלקוח שלכם של נתוני התצורה לשימוש עתידי.
אם כבר יצרתם מזהה לקוח ב-OAuth, תוכלו למצוא את פרוטוקול OAuth הקיים מידע על ידי לחיצה על הלחצן שלמטה.
קבלת מזהה לקוח של שרת OAuth
רוב האפליקציות יצטרכו להעביר את הזהות של המשתמשים שנכנסו לשירות לקצה העורפי סוג כלשהו. כדי להעביר באופן מאובטח את הזהות של המשתמשים שנכנסו באמצעות חשבון Google לקצה העורפי, משתמשים באסימונים מזהים, כפי שמתואר בקטע אימות באמצעות שרת עורפי. כדי לאחזר אסימון מזהה של משתמש נדרש מזהה לקוח שני – השרת שלכם. מזהה לקוח, שמייצג את הקצה העורפי שלכם.
כדי ליצור מזהה לקוח בשרת:
פותחים את הפרויקט ב מסוף Cloud.
יוצרים מזהה לקוח חדש של OAuth מסוג אפליקציית אינטרנט. חשוב לשים לב מחרוזת של מזהה לקוח, שנדרשת להגדרה של 'כניסה באמצעות חשבון Google' אפליקציה.
הגדרת פרויקט האפליקציה
כדי להיכנס לחשבון Google, צריך להגדיר את הפרויקט באמצעות מזהה הלקוח ב-OAuth וסכימה של כתובת URL מותאמת אישית. אפשר גם להוסיף את מזהה הלקוח של השרת עבור לבצע אימות בקצה העורפי או לבצע אופטימיזציה של האפליקציה עבור Google דומיין של Workspace.
הוספה של מזהה הלקוח ב-OAuth וסכימה של כתובת URL מותאמת אישית
עדכון קובץ Info.plist
של האפליקציה כדי להוסיף את OAuth
Client-ID וסכימה של כתובת URL מותאמת אישית על סמך מזהה הלקוח ההפוך.
מזהה הלקוח ההפוך הוא מזהה הלקוח שלך, לפי הסדר של הפורמט המופרד באמצעות נקודות
הערכים השתנו. ההגדרה הזו מוצגת גם בקטע 'סכמת כתובת ה-URL של iOS'. כאשר בוחרים
לקוח OAuth קיים ב-iOS בענן
מסוף. מוצרים לדוגמה:
com.googleusercontent.apps.1234567890-abcdefg
<key>GIDClientID</key> <string>YOUR_IOS_CLIENT_ID</string> <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string> </array> </dict> </array>
אופציונלי: הגדרת אימות לקצה העורפי
אם אתם צריכים אסימונים מזהים לצורך אימות בקצה העורפי,
להגדיר גם את המפתח GIDServerClientID
בקובץ Info.plist
של האפליקציה.
<key>GIDServerClientID</key> <string>YOUR_SERVER_CLIENT_ID</string>
אופציונלי: אופטימיזציה לדומיין Google Workspace או לתחום OpenID
כדאי להשתמש בפרמטר GIDHostedDomain
אם רוצים לבצע אופטימיזציה של תהליך הכניסה בשביל
דומיין של Google Workspace.
<key>GIDHostedDomain</key> <string>YOUR_HOSTED_DOMAIN</string>
משתמשים בפרמטר GIDOpenIDRealm
אם רוצים לציין תחום OpenID.
<key>GIDOpenIDRealm</key> <string>YOUR_OPENID_REALM</string>
חתימה על הבקשה שלך
כדי להריץ את האפליקציה, עליך לחתום על אישור שהונפק על ידי Apple במכשירי macOS ו-iOS כדי לאחסן פרטי כניסה באמצעות מחזיק מפתחות.
השלבים הבאים
עכשיו, לאחר שהורדתם את יחסי התלות של הפרויקט והגדרתם את ה-Xcode פרויקט, תוכלו להוסיף כניסה באמצעות חשבון Google לאפליקציה ל-iOS.