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

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

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

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

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

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

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

   pod install
   

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

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

מנהל חבילות SWIFT

אפשר להתקין את 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, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע) אמורים להופיע החבילות שהותקנו. אפשר גם לעיין בקטע 'חבילות תלויות' ב-Project Navigator כדי לוודא את החבילה ואת הגרסה שלה.

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

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

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

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

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

   • GoogleRidesharingDriver.xcframework

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

התקנה ידנית

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

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

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

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

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

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

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

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

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

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

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

5. כדי להתקין את Driver SDK, גוררים את הקובץ GoogleRidesharingDriver.xcframework לפרויקט בקטע Frameworks, Libraries, and Embedded Content. אם מתבקשים, בוחרים העתקת פריטים.

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

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

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

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

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

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

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