להורדת ה-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: פותחים טרמינל ועוברים לתיקייה עם ה-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. פותחים את project או את workspace ב-Xcode, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת יחסי תלות של חבילות).
2. מזינים את כתובת ה-URL‏ https://github.com/googlemaps/ios-driver-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על Add Package.
3. כדי להתקין version ספציפי, מגדירים את השדה Dependency Rule (כלל תלות) לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ולהשתמש באפשרות Exact Version (גרסה מדויקת). בסיום, לוחצים על "הוספת חבילה".
4. בחלון Choose Package Products (בחירת מוצרים לחבילה), מוודאים שחבילת המוצרים GoogleRidesharingDriver תתווסף ליעד main שצוין. בסיום, לוחצים על 'הוספת חבילה'.
5. כדי לאמת את ההתקנה, עוברים לחלונית General של היעד. בקטע 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 (קובץ > חבילות> איפוס של מטמון החבילות).

כדי להסיר את ה-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. בוחרים את הפרויקט בחלונית הניווט בפרויקט, ובוחרים את היעד של האפליקציה.

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