להורדת iOS Consumer SDK

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

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

דוגמאות אפשר למצוא באפליקציות לדוגמה ל-iOS או בדוגמאות המשולבות.

כדי להגדיר את Consumer SDK לאפליקציית הצרכן ל-iOS:

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

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

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

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

הורדת ה-SDK של הצרכן

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

Swift Package Manager

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

חשוב: ההוראות האלה מבוססות על שימוש ב-Xcode בגרסה 15 ואילך, אבל הן אמורות להיות דומות גם לגרסאות קודמות של Xcode.

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

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

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

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

חשוב: לפעמים אי אפשר לפתור את הארטיפקטים או שיכולות להתרחש שגיאות. במקרה כזה, בוחרים באפשרות 'קובץ > חבילות > איפוס מטמון החבילות'.

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

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

   • 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.

   הערה: כדאי להריץ מדי פעם את הפקודה pod outdated כדי לזהות אם יש גרסה חדשה יותר של ה-SDK. מידע נוסף זמין בקטע 'גרסאות SDK לצרכן' בהערות המוצר של SDK לצרכן.

התקנה ידנית

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

זהירות: מומלץ להשתמש ב-Cocoapods כדי להתקין את ה-SDK של הצרכן בכל הזדמנות אפשרית.

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

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

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

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.

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

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

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

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

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