להורדת 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 ואילך.
  • ‫Apple Xcode גרסה 26 ואילך.

הורדת ה-SDK לצרכנים

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

Swift Package Manager

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

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

  1. פותחים את project או את workspace ב-Xcode, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת יחסי תלות של חבילות).
  2. מזינים את כתובת ה-URL‏ https://github.com/googlemaps/ios-consumer-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על "Add Package".
  3. כדי להתקין version ספציפי, מגדירים את השדה כלל תלות לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ביותר ולהשתמש באפשרות Exact Version. בסיום, לוחצים על "הוספת חבילה".
  4. בחלון Choose Package Products, מוודאים שהמוצר GoogleRidesharingConsumer יתווסף ליעד main שציינתם. בסיום, לוחצים על "הוספת חבילה".
  5. כדי לאמת את ההתקנה, עוברים לחלונית General של היעד. בקטע Frameworks, Libraries, and Embedded Content אמורות להופיע החבילות שהותקנו. אפשר גם לבדוק את הקטע Package Dependencies (יחסי תלות של חבילות) ב-Project Navigator (ניווט בפרויקט) כדי לאמת את החבילה ואת הגרסה שלה.

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

  1. ב-Xcode, עוברים אל File (קובץ) > Packages (חבילות) > Update To Latest Package Versions (עדכון לגרסאות החבילות הכי עדכניות).
  2. כדי לאמת את ההתקנה, עוברים לקטע Package Dependencies (יחסי תלות של חבילות) ב-Project Navigator (ניווט בפרויקט) ומאמתים את החבילה ואת הגרסה שלה.

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

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

    • 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 שמכיל את ה-SDK לצרכן, ואיך לקבוע את הגדרות ה-build ב-Xcode.

לפני שמתחילים, צריך:

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

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

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

  2. מחלצים את קובצי ה-ZIP כדי לגשת ל-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. בוחרים את הפרויקט בחלונית הניווט בפרויקט, ובוחרים את היעד של האפליקציה.

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

    • 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 גם לניפוי באגים וגם להפצה.

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

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

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

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

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

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