להורדת ה-SDK של הנהג

בקטע הזה מוסבר איך לוודא שהמערכת עומדת בדרישות המינימליות. להגדיר את הקבוצה ב-Workspace ולקבל את ה-Driver SDK.

לפני שמתחילים

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

• צריך את Navigation SDK.
• מפעילים את ה-SDK של מפות Google ל-iOS במסוף Google Cloud ומקבלים מפתח API.

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

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

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

קבלת גישה ל-Google Workspace

לקוחות Google Workspace צריכים לבצע את השלבים הבאים:

1. יוצרים קבוצת Workspace. מידע נוסף זמין במאמר קבוצה ב-Workspace.

   לדוגמה, מומלץ לתת שם לקבוצה. [e-mail] בתהליך ההצטרפות.

2. צריך לציין את השם ל-Google כדי להוסיף את הקבוצה ב-Workspace לרשימת ההיתרים מעניק גישה למאגרים הנכונים של CocoaPods.

3. מוודאים שכתובות האימייל וכתובות האימייל של חשבונות השירות של המשתמשים שנדרשת עבורן גישה שנכללים ברשימה הזו.

אם בארגון שלכם אין אפשרות ליצור קבוצות ב-Workspace, אפשר לשלוח ל-Google רשימה של אימיילים של משתמשים וחשבונות שירות שזקוקים לגישה לפריטי המידע האלה שנוצרו בתהליך הפיתוח (Artifact).

הערה: הקבוצות ב-Workspace אינן זהות לקבוצות Google, שמסתיימות ב- @googlegroups.com יש תמיכה רק בקבוצות Workspace.

כניסה באמצעות Cloud SDK

לפיתוח מקומי, צריך להיכנס באמצעות Cloud SDK. לפרטים נוספים, ראו התקנת ה-CLI של gcloud.

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

gcloud

gcloud auth login

צריך להשתמש בכתובת אימייל של חבר בקבוצה ב-Workspace.

הגדרה של מארחי פעולות אוטומטיות

כדי להשתמש במערכות build או באינטגרציה רציפה (CI), צריך להגדיר את מארחי האוטומציה ברשימת השיטות לשימוש בחשבון שירות לצורך אימות ממשקי API והשירותים של Google. פרטים נוספים זמינים בקטע בנושא חשבון שירות בדף 'שיטות אימות' בדף של Google.

• אם התהליך פועל בסביבת Google Cloud, כדאי להשתמש בזיהוי אוטומטי של פרטי הכניסה. למידע נוסף, ראו זיהוי אוטומטי של פרטי כניסה.

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

כתובת האימייל של חשבון השירות המשויכת לפרטי הכניסה חייבת להיות חברה ב- הקבוצה של Workspace.

להורדת Driver SDK

מתקינים ומגדירים את Driver SDK.

CocoaPods

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

   sudo gem install cocoapods
   

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

2. יצירת Podfile ל-Driver SDK: משתמשים ב-Podfile כדי להתקין את ה-API ואת יחסי התלות שלו.

   1. יוצרים קובץ בשם Podfile בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט.

   2. עורכים את Podfile ומוסיפים את יחסי התלות. כאן אנחנו מזכירים כוללת את יחסי התלות:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

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

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

   3. שומרים את ה-Podfile: פותחים מסוף ונכנסים לתיקייה עם ה-Podfile:

      cd <path-to-project>
      

3. הרצת הפקודה של התקנת pod: הפקודה הזו תתקין את ממשקי ה-API שצוינו ב-Podfile, יחד עם כל יחסי התלות שיש להם.

   pod install
   

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

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

Swift Package Manager

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

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

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

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

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

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

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

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

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

   • GoogleRidesharingDriver.xcframework

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

התקנה ידנית

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

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

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

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

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

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

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

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

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

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

8. פותחים את הכרטיסייה Build Phases (שלבי הבנייה) ובקטע Link Binary with Libraries (קישור בינארי לספריות), מוסיפים את של הספריות והמסגרות הבאות, אם הן עדיין לא קיימות:

   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • LocalAuthentication.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • WebKit.framework

9. בוחרים בפרויקט שלכם (ולא ביעד ספציפי) ופותחים את Build בכרטיסייה 'הגדרות'. בקטע Other Linker Flags מוסיפים את הערך -ObjC גם ל-debug וגם ל-release.

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

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

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

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

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

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