להורדת ה-SDK של הנהג

בקטע הזה מוסבר איך לוודא שהמערכת עומדת בדרישות המינימום, איך להגדיר את קבוצת ה-Workspace ואיך לקבל את Driver SDK.

לפני שמתחילים

כדי להשתמש ב-Driver SDK ל-iOS, האפליקציה שלכם צריכה לעמוד בקריטריונים הבאים:

• צריך את Navigation SDK.
• מפעילים את SDK של מפות ל-iOS במסוף Google Cloud ומקבלים מפתח API.

בדיקת דרישות המערכת המינימליות

כדאי לבדוק את הערות המוצר כדי למצוא את הדרישות המינימליות לגרסה של Driver SDK שבה אתם משתמשים. נתוני הגרסה

• במכשיר הנייד צריכה לפעול מערכת iOS בגרסה 14 ואילך.
• Xcode של Apple מגרסה 15 ואילך.

קבלת גישה ל-Google Workspace

לקוחות Google Workspace צריכים לבצע את השלבים הבאים:

1. יוצרים קבוצת Workspace. מידע נוסף זמין במאמר קבוצת Workspace.

   לדוגמה, מומלץ לתת לקבוצה את השם [e-mail] במהלך תהליך ההצטרפות.

2. עליכם לספק את השם ל-Google כדי להוסיף את קבוצת Workspace לרשימת ההיתרים שמעניקה גישה למאגרי CocoaPods הנכונים.

3. מוודאים שכתובות האימייל של המשתמשים וכתובות האימייל של חשבונות השירות שזקוקים לגישה כלולות ברשימה הזו.

אם הארגון שלכם לא יכול ליצור קבוצות Workspace,עליכם לשלוח ל-Google רשימה של כתובות אימייל של משתמשים וחשבונות שירות שצריכים גישה לפריטים האלה.

הערה: קבוצות Workspace הן לא קבוצות Google, שהסיומת שלהן היא @googlegroups.com. יש תמיכה רק בקבוצות Workspace.

כניסה באמצעות Cloud SDK

לפיתוח מקומי, נכנסים באמצעות Cloud SDK. פרטים נוספים זמינים במאמר התקנת ה-CLI של gcloud.

בדוגמאות הבאות מוסבר איך להיכנס באמצעות Cloud SDK.

gcloud

gcloud auth login

צריך להשתמש בכתובת אימייל ששייכת לקבוצה ב-Workspace.

הגדרת המארחים של האוטומציה

במערכות build או בשילוב רצוף (CI), מגדירים את המארחים של האוטומציה על סמך רשימת השיטות שצוינה לשימוש בחשבון שירות לאימות מול ממשקי ה-API והשירותים של Google. פרטים נוספים זמינים בקטע בנושא חשבונות שירות בדף 'שיטות אימות ב-Google'.

• אם התהליך פועל בסביבת Google Cloud, השתמשו בזיהוי אוטומטי של פרטי הכניסה. מידע נוסף זמין במאמר זיהוי אוטומטי של פרטי כניסה.

• אחרת, מאחסנים את קובץ המפתח של חשבון השירות במיקום מאובטח במערכת הקבצים של המארח ומגדירים את משתנה הסביבה GOOGLE_APPLICATION_CREDENTIALS בהתאם. פרטים נוספים זמינים במאמר GOOGLE_APPLICATION_CREDENTIALS.

כתובת האימייל של חשבון השירות שמשויכת לפרטי הכניסה חייבת להיות חברת בקבוצת Workspace.

הורדת Driver SDK

מתקינים ומגדירים את Driver SDK.

CocoaPods

1. מתקינים את הכלי CocoaPods: פותחים חלון טרמינל ומריצים את הפקודה הבאה.

   sudo gem install cocoapods
   

   פרטים נוספים זמינים במדריך למתחילים ב-CocoaPods.

2. יצירת Podfile ל-Driver SDK: משתמשים ב-Podfile כדי להתקין את ה-API ואת יחסי התלות שלו.

   1. יוצרים קובץ בשם Podfile בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט.

   2. עורכים את Podfile ומוסיפים את יחסי התלות. דוגמה שכוללת את יחסי התלות:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      דוגמה שכוללת את ה-pods של Alpha ו-Beta ל-Driver SDK כיחסי תלות:

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

   3. שומרים את ה-Podfile: פותחים מסוף ונכנסים לתיקייה עם ה-Podfile:

      cd <path-to-project>
      

3. מריצים את הפקודה pod install: הפקודה הזו מתקינה את ממשקי ה-API שצוינו ב-Podfile, יחד עם כל התלויות שלהם.

   pod install
   

4. פותחים את הפרויקט ב-Xcode: סוגרים את Xcode ואז פותחים (לחיצה כפולה) את קובץ ה-‎ .xcworkspace של הפרויקט כדי להפעיל את Xcode. כדי לפתוח את הפרויקט מאוחר יותר, משתמשים בקובץ ‎.xcworkspace.

   הערה: כדאי להריץ מדי פעם את הפקודה pod outdated כדי לזהות אם יש גרסה חדשה יותר של ה-SDK. מידע נוסף זמין במאמר Driver SDK לגרסאות iOS.

Swift Package Manager

אפשר להתקין את Driver SDK באמצעות Package Manager של Swift. כדי להוסיף את ה-SDK, צריך לוודא שהסרתם את כל יחסי התלות הקיימים של Driver SDK.

חשוב: ההוראות האלה מבוססות על שימוש ב-Xcode בגרסה 15 ואילך, אבל הן אמורות להיות דומות גם לגרסאות קודמות של Xcode.

כדי להוסיף את ה-SDK לפרויקט חדש או קיים:

1. פותחים את Xcode project או workspace, ואז עוברים אל קובץ > הוספת יחסי תלות בחבילות.
2. מזינים את כתובת ה-URL https://github.com/googlemaps/ios-driver-sdk, מקישים על Enter כדי לשלוח את החבילה ולוחצים על 'הוספת חבילה'.
3. כדי להתקין version ספציפי, מגדירים את השדה Dependency Rule לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה האחרונה ולהשתמש באפשרות 'גרסה מדויקת'. בסיום, לוחצים על 'הוספת חבילה'.

כדי לעדכן את package בפרויקט קיים, פועלים לפי השלבים הבאים:

1. כדי לאמת את ההתקנה, עוברים לקטע Package Dependencies ב-Project Navigator כדי לאמת את החבילה ואת הגרסה שלה.

חשוב: לפעמים אי אפשר לפתור את הארטיפקטים או שיכולות להתרחש שגיאות. במקרה כזה, בוחרים באפשרות 'קובץ > חבילות > איפוס מטמון החבילות'.

כדי להסיר את Driver SDK הקיים שהותקן באופן ידני:

1. בהגדרות הפרויקט ב-Xcode, מחפשים את האפשרות Frameworks, Libraries, and Embedded Content. משתמשים בסימן המינוס(-) כדי להסיר את המסגרת הבאה:

   • GoogleRidesharingDriver.xcframework

2. מסירים את החבילה GoogleRidesharingDriver מהספרייה ברמה העליונה של פרויקט Xcode.

התקנה ידנית

במדריך הזה מוסבר איך להוסיף באופן ידני את ה-XCFramework שמכיל את Driver SDK לפרויקט ולהגדיר את הגדרות ה-build ב-Xcode.

זהירות: מומלץ להשתמש ב-Cocoapods כדי להתקין את Driver SDK בכל הזדמנות אפשרית.

לפני שמבצעים את ההוראות במדריך הזה, צריך:

• מורידים את XCFramework, חבילת בינארית שמשמשת להתקנת Driver SDK. אפשר להשתמש בחבילה הזו במספר פלטפורמות, כולל במכונות עם Apple silicon

• מתקינים את Navigation SDK.

כדי להתקין את Driver SDK באופן ידני:

1. מורידים את ה-SDK הבינארי ואת המשאבים:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

2. פותחים את הקבצים הארוזים כדי לגשת ל-XCFramework ולמשאבים.

3. פותחים את Xcode ופותחים פרויקט קיים או יוצרים פרויקט חדש. אם אתם משתמשים חדשים ב-iOS, תוכלו ליצור פרויקט חדש ולבחור באפשרות 'תבנית לאפליקציית iOS'.

4. אם קבוצת הפרויקטים לא מכילה קבוצה Frameworks, יוצרים אותה.

5. כדי להתקין את Driver SDK, גוררים את הקובץ GoogleRidesharingDriver.xcframework לפרויקט בקטע Frameworks, Libraries, and Embedded Content. אם מוצגת בקשה, בוחרים באפשרות העתקת פריטים.

6. גוררים את הקובץ GoogleRidesharingDriver.bundle שהורדתם לתיקייה ברמה העליונה של פרויקט Xcode. אם מוצגת בקשה, בוחרים באפשרות העתקת פריטים.

7. בוחרים את הפרויקט ב-Project Navigator ובוחרים את היעד של האפליקציה.

8. פותחים את הכרטיסייה Build Phases, ובקטע Link Binary with Libraries מוסיפים את המסגרות והספריות הבאות, אם הן לא נמצאות שם כבר:

   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • LocalAuthentication.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • WebKit.framework

9. בוחרים את הפרויקט ולא יעד ספציפי, ופותחים את הכרטיסייה Build Settings. בקטע Other Linker Flags מוסיפים את הערך -ObjC גם ל-debug וגם ל-release.

   אם ההגדרות האלה לא מוצגות, משנים את המסנן בסרגל Build Settings מ-Basic ל-All.

בדיקת קובץ המניפסט של Apple בנושא פרטיות

Apple דורשת פרטי פרטיות של אפליקציות שמוצגות ב-App Store. עדכונים ומידע נוסף זמינים בדף 'פרטים על פרטיות האפליקציה' ב-App Store של Apple.

קובץ המניפסט של Apple לפרטיות נכלל בחבילת המשאבים של ה-SDK. כדי לוודא שקובץ המניפסט של הפרטיות נכלל ולבדוק את התוכן שלו, יוצרים ארכיון של האפליקציה ויוצרים דוח פרטיות מהארכיון.

המאמרים הבאים

הגדרת פרויקט במסוף Google Cloud