להורדת iOS Consumer SDK

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

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

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

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

כדי להוסיף את ה-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. אם אתה משדרג מגרסה קודמת מ-9.0.0, עליך להסיר את יחסי התלות האלה: GoogleMapsBase, GoogleMapsCore, GoogleMapsM4B אחרי השדרוג. אל תסירו את התלות של GoogleMaps מידע נוסף זמין במאמר נתוני גרסה 9.0.0.

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

   • GoogleMapsBase (רק לשדרוגים מגרסאות מוקדמות יותר מ-9.0.0)
   • GoogleMapsCore (רק לשדרוגים מגרסאות מוקדמות יותר מ-9.0.0)
   • GoogleMapsM4B (רק לשדרוגים מגרסאות מוקדמות יותר מ-9.0.0)
2. מ-Xcode, עוברים אל 'File >' חבילות > יש לעדכן לגרסאות האחרונות של החבילה".
3. כדי לאמת את ההתקנה, עוברים לקטע Package Dependencies של Project Navigator כדי לאמת את החבילה והגרסה שלה.

חשוב: לפעמים לא ניתן לפתור פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) או שעלולות להתרחש שגיאות, במקרה כזה בחרו באפשרות 'קובץ' > חבילות > איפוס המטמון של החבילה".

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

1. סוגרים את סביבת העבודה של Xcode. פותחים את הטרמינל ומריצים את הפקודה הבאה:

   sudo gem install cocoapods-deintegrate cocoapods-clean 
   pod deintegrate 
   pod cache clean --all

2. מסירים את Podfile, Podfile.resolved ואת Xcode workspace אם אתם לא משתמשים בהם לאף מטרה אחרת מלבד CocoaPods.

כדי להסיר את ערכת ה-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

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

התקנה ידנית

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

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

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

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

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

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

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

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