להורדת ה-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 של 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.

Swift Package Manager

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

כדי להוסיף את ה-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.

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

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

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

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

1. מורידים את קובץ ה-binary ואת המשאבים של ה-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.