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

      כאן יש דוגמה שכוללת את רצפי האלפא והבטא של ה-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

אפשר להתקין את 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 ספציפי, צריך להגדיר את השדה כלל תלות לאחד אפשרויות שמבוססות על גרסאות. בפרויקטים חדשים, מומלץ לציין את הגרסה האחרונה באמצעות "גרסה מדויקת" כאפשרות. בסיום, לוחצים על 'הוספת חבילה'.
4. בחלון Choose Package Products, מוודאים ש-GoogleRidesharingDriver יתווסף ליעד main שהוגדר. בסיום, לוחצים על 'הוספת חבילה'.
5. כדי לבדוק את ההתקנה, צריך לעבור לחלונית General של היעד. בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע) אמורים להופיע החבילות שהותקנו. אפשר גם לעיין בקטע 'חבילות תלויות' ב-Project Navigator כדי לוודא את החבילה ואת הגרסה שלה.

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

1. מ-Xcode, עוברים אל 'File >' חבילות > יש לעדכן לגרסאות האחרונות של החבילה".
2. כדי לאמת את ההתקנה, עוברים לקטע 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 בכרטיסייה 'הגדרות'. בקטע סימוני מקשר אחרים, מוסיפים -ObjC בשביל גם לניפוי באגים וגם להשקה.

   אם ההגדרות האלה לא מוצגות, שנו את בסרגל הגדרות Build, מבסיסי להכול.