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

gcloud

gcloud auth login

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.

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

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

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

   • GoogleRidesharingDriver.xcframework

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

התקנה ידנית

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

לפני שמתחילים, צריך:

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

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

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

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

2. פורקים את קובצי ה-ZIP כדי לגשת ל-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 מוסיפים את הספריות וה-frameworks הבאים, אם הם עדיין לא קיימים:

   • 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.