להורדת iOS Consumer SDK

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

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

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

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

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

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

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

קבלת ה-SDK לצרכן

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

מנהל חבילות SWIFT

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

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

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

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

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

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

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

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

שימוש ב-CocoaPods

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

    sudo gem install cocoapods
    

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

  2. יצירת Podfile for 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: הפקודה הזו מתקינה את ממשקי ה-API שצוינו ב-Podfile, יחד עם כל יחסי התלות שיש להם.

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

התקנה ידנית

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

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

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

  • להתקין את SDK של מפות Google

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

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

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

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

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

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

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

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

  9. פותחים את הכרטיסייה Build Phases (שלבי הבנייה) ובקטע Link Binary with Libraries (קישור 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. בקטע סימוני מקשר אחר, צריך להוסיף -ObjC גם לניפוי באגים וגם לגרסה.

    אם ההגדרות האלה לא מוצגות, אפשר לשנות את המסנן סרגל יצירת ההגדרות מבסיסי להכול.

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

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

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

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

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