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

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

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

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

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

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

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

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

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

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

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

    לדוגמה, מומלץ לתת שם לקבוצה. google-maps-platform-sdk-users@workspacedomain.com בתהליך ההצטרפות.

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

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

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

כניסה באמצעות 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

מנהל חבילות SWIFT

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

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

  1. פותחים את ה-Xcode project או workspace, ועוברים אל File > (קובץ >) הוספת יחסי תלות של חבילה.
  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. אם אתה משדרג מגרסה קודמת מ-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 כדי לאמת את החבילה והגרסה שלה.

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

  1. סוגרים את סביבת העבודה של Xcode. פותחים את הטרמינל ומריצים את הפקודה הבאה: 
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. מסירים את Podfile, Podfile.resolved ואת Xcode workspace אם אתם לא משתמשים בהם לאף מטרה אחרת מלבד CocoaPods.

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

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

    • GoogleRidesharingDriver.xcframework

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

התקנה ידנית

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

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

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

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

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

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

  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 (קישור 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