להורדת ה-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. פותחים את Xcode project או workspace, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת תלות בחבילה).
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. בספרייה ברמה העליונה של פרויקט Xcode, מסירים את חבילת GoogleRidesharingDriver.

התקנה ידנית

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

לפני שממשיכים במדריך הזה, צריך:

• מורידים את 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. בוחרים את הפרויקט מתוך 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 גם לניפוי באגים וגם להפצה.

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