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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הערה: קבוצות ב-Workspace לא זהות לקבוצות ב-Google, שמסתיימות ב[e-mail]. יש תמיכה רק בקבוצות ב-Workspace.

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

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

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

gcloud

gcloud auth login

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

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

כדי להגדיר את המארחים של האוטומציה במערכות בנייה או בשילוב מתמשך, צריך להשתמש ברשימת השיטות שצוינו לשימוש בחשבון שירות כדי לבצע אימות מול ממשקי ה-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 של אלפא ובטא עבור 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: פותחים חלון Terminal ועוברים לתיקייה עם ה-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 באמצעות Swift Package Manager. כדי להוסיף את ה-SDK, צריך לוודא שהסרתם את כל יחסי התלות הקיימים ב-Driver SDK.

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

1. פותחים את Xcode project או workspace, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת תלות בחבילה).
2. מזינים את כתובת ה-URL https://github.com/googlemaps/ios-driver-sdk, מקישים על Enter כדי למשוך את החבילה, ולוחצים על 'הוספת חבילה'.
3. כדי להתקין version ספציפי, מגדירים את השדה Dependency Rule (כלל תלות) לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ולהשתמש באפשרות Exact Version (גרסה מדויקת). בסיום, לוחצים על 'הוספת חבילה'.
4. בחלון Choose Package Products (בחירת מוצרים לחבילה), מוודאים שהמוצר GoogleRidesharingDriver יתווסף ליעד main שצוין. בסיום, לוחצים על 'הוספת חבילה'.
5. כדי לאמת את ההתקנה, עוברים לחלונית כללי של היעד. בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע) אמורים להופיע החבילות המותקנות. אפשר גם לעיין בקטע Package Dependencies (תלות בחבילה) ב-Project Navigator (סייר הפרויקטים) כדי לאמת את החבילה ואת הגרסה שלה.

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

1. ב-Xcode, עוברים אל File > Packages > Update To Latest Package Versions (קובץ > חבילות > עדכון לגרסאות החבילה העדכניות ביותר).
2. כדי לאמת את ההתקנה, עוברים לקטע Package Dependencies (תלות בחבילה) ב-Project Navigator (סרגל הניווט של הפרויקט) כדי לאמת את החבילה ואת הגרסה שלה.

חשוב: לפעמים אי אפשר לפתור בעיות שקשורות לארטיפקטים, או שמתרחשות שגיאות. במקרה כזה, בוחרים באפשרות File > Packages > Reset Package Cache (קובץ > חבילות> איפוס של מטמון החבילות).

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

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

   • GoogleRidesharingDriver.xcframework

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

התקנה ידנית

במדריך הזה מוסבר איך להוסיף באופן ידני את ה-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 App.

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

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

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

7. בוחרים את הפרויקט בחלונית הניווט בפרויקט, ואז בוחרים את היעד של האפליקציה.

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 גם לניפוי באגים וגם לגרסת ההפצה.

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

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

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

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

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

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