להורדת iOS Consumer SDK

בחירת פלטפורמה: Android iOS JavaScript

כדי לעקוב אחרי נסיעות על פי דרישה באפליקציות לצרכנים ב-iOS, צריך להשתמש ב-Consumer SDK. מידע נוסף על מעקב אחרי נסיעות ועל התכונה הזו זמין במאמר מעקב אחרי נסיעה ב-iOS.

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

  1. בדיקת דרישות המערכת המינימליות
  2. איך מקבלים את Consumer SDK
  3. בדיקת קובץ המניפסט של אפל בנושא פרטיות.
  4. הגדרת פרויקט במסוף Google Cloud.
  5. קבלת טוקני אימות
  6. אתחול Consumer SDK.

בדיקת דרישות המערכת המינימליות

כדאי לעיין בהערות לגבי הגרסה כדי לראות מהן הדרישות המינימליות של גרסת Consumer SDK שבה אתם משתמשים. הערות מוצר

  • במכשיר הנייד צריכה לפעול מערכת iOS בגרסה 16 ואילך.
  • ‫Xcode של Apple בגרסה 26 ואילך.

קבלת ה-SDK לצרכנים

מתקינים ומגדירים את Consumer SDK באמצעות CocoaPods.

Swift Package Manager

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

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

  1. פותחים את Xcode project או workspace, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת תלות בחבילה).
  2. מזינים את כתובת ה-URL https://github.com/googlemaps/ios-consumer-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על 'הוספת חבילה'.
  3. כדי להתקין version ספציפי, מגדירים את השדה Dependency Rule (כלל תלות) לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ולהשתמש באפשרות Exact Version (גרסה מדויקת). בסיום, לוחצים על 'הוספת חבילה'.
  4. בחלון Choose Package Products (בחירת מוצרים לחבילה), מוודאים שהמוצר GoogleRidesharingConsumer יתווסף ליעד main שצוין. בסיום, לוחצים על 'הוספת חבילה'.
  5. כדי לאמת את ההתקנה, עוברים לחלונית כללי של היעד. בקטע 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 (מסגרות, ספריות ותוכן מוטמע). כדי להסיר את המסגרת הבאה, משתמשים בסימן המינוס(-):

    • GoogleRidesharingConsumer.xcframework

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

שימוש ב-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.

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

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

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

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

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

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

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

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

  8. בוחרים את הפרויקט בחלונית הניווט בפרויקט, ואז בוחרים את היעד של האפליקציה.

  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 (דגלים אחרים של Linker), מוסיפים את הערך -ObjC גם לניפוי באגים וגם לפרסום.

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

בדיקת קובץ מניפסט הפרטיות של אפל

‫Apple דורשת פרטי פרטיות של אפליקציות ב-App Store. אפשר לעבור אל הדף של Apple App Store בנושא פרטיות באפליקציות כדי לקבל עדכונים ומידע נוסף.

קובץ המניפסט של הפרטיות של אפל נכלל בחבילת המשאבים של ה-SDK. כדי לוודא שקובץ הצהרת הפרטיות נכלל ולבדוק את התוכן שלו, יוצרים ארכיון של האפליקציה ומפיקים דוח פרטיות מהארכיון.

המאמרים הבאים

הגדרת פרויקט במסוף Google Cloud