להורדת iOS Consumer SDK

Swift Package Manager

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

כדי להוסיף את ה-SDK לפרויקט חדש או קיים:

1. פותחים את ה-Xcode project או workspace ועוברים אל 'קובץ' > 'הוספת יחסי תלות של חבילה'.
2. מזינים את כתובת ה-URL https://github.com/googlemaps/ios-consumer-sdk, מקישים על Enter כדי לשלוח את החבילה ולוחצים על 'הוספת חבילה'.
3. כדי להתקין version ספציפי, צריך להגדיר את השדה כלל תלות לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה האחרונה ולהשתמש באפשרות 'גרסה מדויקת'. בסיום, לוחצים על 'הוספת חבילה'.

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

1. כדי לאמת את ההתקנה, עוברים לקטע Package Dependencies של Project Navigator כדי לאמת את החבילה ואת הגרסה שלה.

כדי להסיר את Consumer SDK הקיים שהותקן באופן ידני:

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

   • GoogleRidesharingConsumer.xcframework

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

שימוש ב-CocoaPods

1. מתקינים את הכלי CocoaPods: פותחים חלון טרמינל ומריצים את הפקודה הבאה:

   sudo gem install cocoapods
   

   לפרטים נוספים, קראו את המדריך לתחילת העבודה של CocoaPods.

2. יצירת Podfile ל-Consumer SDK: משתמשים ב-Podfile כדי להתקין את ה-API ואת יחסי התלות שלו.

   1. יוצרים קובץ בשם Podfile בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט.

   2. עורכים את ה-Podfile ומוסיפים את יחסי התלות. לפניכם דוגמה שכוללת את יחסי התלות:

      source "https://github.com/CocoaPods/Specs.git"
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingConsumer'
      end
      

   3. שומרים את ה-Podfile: פותחים מסוף ועוברים לתיקייה שבה נמצא ה-Podfile:

      cd <path-to-project>
      

3. מריצים את הפקודה pod install: הפקודה הזו מתקינה את ממשקי ה-API שצוינו ב-Podfile, יחד עם כל התלויות שלהם.

   pod install
   

4. פתיחת הפרויקט ב-Xcode: סוגרים את Xcode ואז פותחים (לחיצה כפולה) את קובץ ה-‎.xcworkspace של הפרויקט כדי להפעיל את Xcode. כדי לפתוח את הפרויקט מאוחר יותר, משתמשים בקובץ ‎.xcworkspace.

התקנה ידנית

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

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

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

• מתקינים את ה-SDK של מפות Google.

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

   • GoogleRidesharingConsumer.xcframework
   • GoogleRidesharingConsumer.bundle
   • gRPCCertificates.bundle

2. פותחים את הקבצים הארוזים כדי לגשת ל-XCFramework ולמשאבים.

3. מפעילים את Xcode ופותחים או יוצרים פרויקט. אם זו הפעם הראשונה שאתם משתמשים ב-iOS, יוצרים פרויקט חדש ובוחרים את תבנית האפליקציה ל-iOS.

4. אם קבוצת הפרויקטים לא מכילה קבוצה Frameworks, יוצרים אותה.

5. גוררים את קובץ gRPCCertificates.bundle שהורדתם לתיקייה ברמה העליונה של פרויקט Xcode. אם מופיעה בקשה, בוחרים באפשרות העתקת פריטים.

6. כדי להתקין את Consumer SDK, גוררים את הקובץ GoogleRidesharingConsumer.xcframework לפרויקט בקטע Frameworks, Libraries, and Embedded Content. אם מופיעה בקשה, בוחרים באפשרות העתקת פריטים.

7. גוררים את הקובץ GoogleRidesharingConsumer.bundle שהורדתם לספרייה ברמה העליונה של פרויקט Xcode. אם מופיעה בקשה, בוחרים באפשרות העתקת פריטים.

8. בוחרים את הפרויקט מ-Project Navigator ובוחרים את יעד האפליקציה.

9. פותחים את הכרטיסייה Build Phases, ובקטע Link Binary with Libraries מוסיפים את המסגרות והספריות הבאות, אם הן עדיין לא מופיעות:

   • Accelerate.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework

10. בוחרים את הפרויקט ולא יעד ספציפי, ופותחים את הכרטיסייה Build Settings. בקטע Other Linker Flags מוסיפים את הערך -ObjC גם ל-debug וגם ל-release.

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