בקטע הזה מוסבר איך לוודא שהמערכת עומדת בדרישות המינימליות. להגדיר את הקבוצה ב-Workspace ולקבל את ה-Driver SDK.
לפני שמתחילים
כדי להשתמש ב-Driver SDK ל-iOS, האפליקציה צריכה לעמוד בקריטריונים הבאים:
- התקנת SDK לניווט.
- מפעילים את ה-SDK של מפות Google ל-iOS במסוף Google Cloud ומקבלים מפתח API.
בדיקת דרישות המערכת המינימליות
חשוב לבדוק את נתוני הגרסה כדי לראות את הדרישות המינימליות לגרסה של ה-SDK של מנהל ההתקן שבו השתמשת. פרטים נוספים זמינים בנתוני הגרסה.
- במכשיר הנייד צריכה לפעול מערכת iOS בגרסה 14 ואילך.
- Apple Xcode גרסה 15 ואילך.
קבלת גישה ל-Google Workspace
לקוחות Google Workspace צריכים לבצע את השלבים הבאים:
יוצרים קבוצת Workspace. מידע נוסף זמין במאמר קבוצה ב-Workspace.
לדוגמה, מומלץ לתת שם לקבוצה.
google-maps-platform-sdk-users@workspacedomain.com
בתהליך ההצטרפות.צריך לציין את השם ל-Google כדי להוסיף את הקבוצה ב-Workspace לרשימת ההיתרים מעניק גישה למאגרים הנכונים של CocoaPods.
מוודאים שכתובות האימייל וכתובות האימייל של חשבונות השירות של המשתמשים שנדרשת עבורן גישה שנכללים ברשימה הזו.
אם בארגון שלכם אין אפשרות ליצור קבוצות ב-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
מתקינים את הכלי CocoaPods: פותחים חלון טרמינל ומריצים את הפקודה הבאה הפקודה.
sudo gem install cocoapods
לפרטים נוספים, אפשר לעיין במדריך לתחילת העבודה של CocoaPods.
יצירת Podfile ל-Driver SDK: כדי להתקין את הקובץ צריך להשתמש ב-Podfile. בין ה-API לבין יחסי התלות שלו.
יוצרים קובץ בשם
Podfile
בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט.עורכים את ה-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
שמירת ה-Podfile: פותחים טרמינל ועוברים אל התיקייה שמכילה את Podfile:
cd <path-to-project>
הרצת הפקודה של התקנת pod: הפקודה הזו תתקין את ממשקי ה-API שצוינו ב-Podfile, יחד עם כל יחסי התלות שיש להם.
pod install
פותחים את הפרויקט ב-Xcode: סוגרים את ה-Xcode ופותחים אותו. (לוחצים לחיצה כפולה) על קובץ ה- .xcworkspace של הפרויקט כדי להפעיל את Xcode. פתיחה את הפרויקט מאוחר יותר, משתמשים בקובץ ה- .xcworkspace
מנהל חבילות SWIFT
ניתן להתקין את ה-SDK של מנהל ההתקן דרך SWIFT Package Manager. כדי להוסיף את ה-SDK, צריך לוודא שיש לך הוסרו כל יחסי התלות הקיימים של Driver SDK.
כדי להוסיף את ה-SDK לפרויקט חדש או קיים:
-
פותחים את ה-Xcode
project
אוworkspace
, ועוברים אל File > (קובץ >) הוספת יחסי תלות של חבילה. - מזינים את כתובת ה-URL https://github.com/googlemaps/ios-driver-sdk ומקישים על Enter. כדי למשוך את החבילה, וללחוץ על "הוספת חבילה".
-
כדי להתקין
version
ספציפי, צריך להגדיר את השדה כלל תלות לאחד אפשרויות שמבוססות על גרסאות. בפרויקטים חדשים, מומלץ לציין את הגרסה האחרונה באמצעות "גרסה מדויקת" כאפשרות. בסיום, לוחצים על 'הוספת חבילה'. -
בחלון Choose Package Products, מוודאים שהתוסף
GoogleRidesharingDriver
יתווסף אל היעד שהגדרת ל-main
. בסיום, לוחצים על 'הוספת חבילה'. -
כדי לבדוק את ההתקנה, צריך לעבור לחלונית
General
של היעד. ב-Frameworks, ספריות ותוכן מוטמע אתם אמורים לראות את החבילות המותקנות. אפשר גם לראות את העמודה 'יחסי תלות של חבילה' הקטע של Project Navigator כדי לאמת את החבילה והגרסה שלה.
כדי לעדכן את package
בפרויקט קיים:
אם אתה משדרג מגרסה קודמת מ-9.0.0, עליך להסיר את יחסי התלות האלה:
GoogleMapsBase
,GoogleMapsCore
,GoogleMapsM4B
אחרי השדרוג. אל תסירו את התלות שלGoogleMaps
מידע נוסף זמין במאמר נתוני גרסה 9.0.0.בהגדרות האישיות של פרויקט Xcode, מחפשים את Frameworks, ספריות, ותוכן מוטמע. משתמשים בסימן המינוס(-) כדי להסיר את המסגרת הבאה:
GoogleMapsBase
(רק לשדרוגים מגרסאות מוקדמות יותר מ-9.0.0)GoogleMapsCore
(רק לשדרוגים מגרסאות מוקדמות יותר מ-9.0.0)GoogleMapsM4B
(רק לשדרוגים מגרסאות מוקדמות יותר מ-9.0.0)
- מ-Xcode, עוברים אל 'File >' חבילות > יש לעדכן לגרסאות האחרונות של החבילה".
- כדי לאמת את ההתקנה, עוברים לקטע Package Dependencies של Project Navigator כדי לאמת את החבילה והגרסה שלה.
כדי להסיר יחסי תלות קיימים של Driver SDK שנוספו באמצעות
CocoaPods
, יש לבצע את השלבים הבאים:
- סוגרים את סביבת העבודה של Xcode. פותחים את הטרמינל ומריצים את הפקודה הבאה:
sudo gem install cocoapods-deintegrate cocoapods-clean pod deintegrate pod cache clean --all
-
מסירים את
Podfile
,Podfile.resolved
ואת Xcodeworkspace
אם אתם לא משתמשים בהם לאף מטרה אחרת מלבד CocoaPods.
כדי להסיר את Driver SDK הקיים שהותקן ידנית, בצעו את השלבים הבאים:
בהגדרות האישיות של פרויקט Xcode, מחפשים את Frameworks, ספריות ותוכן מוטמע. משתמשים בסמל המינוס
(-)
כדי להסיר את המסגרת הבאה:GoogleRidesharingDriver.xcframework
מהספרייה ברמה העליונה של פרויקט Xcode, מסירים את חבילה של
GoogleRidesharingDriver
.
התקנה ידנית
במדריך הזה מוסבר איך להוסיף ידנית את ה-XCFramework שמכיל את Driver SDK לפרויקט שלך וקביעת הגדרות ה-build ב-Xcode.
לפני שתבצעו את הפעולות הבאות במדריך הזה:
מורידים את XCFramework, חבילה בינארית שבה משתמשים כדי להתקין את SDK של מנהל התקן. אפשר להשתמש בחבילה הזו בכמה פלטפורמות, כולל מכונות שמשתמשות ב-Apple silicon
מתקינים את Navigation SDK.
כדי להתקין באופן ידני את Driver SDK, מבצעים את השלבים הבאים:
מורידים את הקובץ הבינארי ומשאבים של ה-SDK:
פורקים את קובצי ה-ZIP כדי לגשת ל-XCFramework ולמשאבים.
מפעילים את Xcode ופותחים פרויקט קיים או יוצרים פרויקט. אם אתם חדשים ב-iOS, יוצרים פרויקט חדש ובוחרים את תבנית האפליקציה ל-iOS.
אם קבוצת הפרויקטים לא מכילה קבוצת Frameworks, צריך ליצור אותה.
כדי להתקין את Driver SDK, גוררים את הסמל קובץ אחד (
GoogleRidesharingDriver.xcframework
) בפרויקט בקטע Frameworks, ספריות ותוכן מוטמע. אם מתבקשים, בוחרים העתקת פריטים.גוררים את
GoogleRidesharingDriver.bundle
שהורדתם לרמה העליונה של פרויקט ה-Xcode שלכם. אם מופיעה בקשה, בוחרים באפשרות העתקת פריטים.בוחרים את הפרויקט מ-Project Navigator ואז בוחרים היעד של האפליקציה.
פותחים את הכרטיסייה 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
בוחרים בפרויקט שלכם (ולא ביעד ספציפי) ופותחים את Build בכרטיסייה 'הגדרות'. בקטע סימוני מקשר אחרים, מוסיפים
-ObjC
בשביל גם לניפוי באגים וגם להשקה.אם ההגדרות האלה לא מוצגות, שנו את בסרגל הגדרות Build, מבסיסי להכול.
בדיקת קובץ מניפסט הפרטיות של Apple
Apple דורשת פרטים לגבי הפרטיות של אפליקציות ב-App Store. עדכונים ומידע נוסף זמינים בדף פרטי הפרטיות של Apple App Store.
קובץ מניפסט הפרטיות של Apple כלול בחבילת המשאבים של ה-SDK. כדי לוודא שקובץ מניפסט הפרטיות נכלל וכדי לבדוק את התוכן שלו, יש ליצור ארכיון של האפליקציה ולהפיק דוח פרטיות מהארכיון.