הגדרת פרויקט ב-Xcode

אחרי שמפעילים את החיוב ויוצרים מפתח API, אפשר להגדיר את פרויקט Xcode שבו משתמשים כדי לפתח את האפליקציה.

נתוני הגרסה זמינים לכל גרסה.

שלב 1: מתקינים את התוכנה הנדרשת

כדי ליצור פרויקט באמצעות Navigation SDK ל-iOS, צריך להוריד ולהתקין את:

  • ‫Xcode גרסה 26.0 ואילך

שלב 2: יוצרים את הפרויקט ב-Xcode ומתקינים את Navigation SDK

Swift Package Manager

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

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

  1. פותחים את project או workspace ב-Xcode, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת יחסי תלות של חבילות).
  2. מזינים את כתובת ה-URL‏ https://github.com/googlemaps/ios-navigation-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על Add Package.
  3. כדי להתקין version ספציפי, מגדירים את השדה כלל תלות לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ביותר ולהשתמש באפשרות Exact Version. בסיום, לוחצים על "הוספת חבילה".
  4. בחלון Choose Package Products, מוודאים שהמוצר GoogleNavigation יתווסף ליעד main שציינתם. בסיום, לוחצים על "הוספת חבילה".
  5. כדי לוודא שההתקנה בוצעה, עוברים לחלונית General (כללי) של היעד. בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע) אמורות להופיע החבילות שהותקנו. אפשר גם לבדוק את הקטע Package Dependencies (יחסי תלות של חבילות) ב-Project Navigator (ניווט בפרויקט) כדי לאמת את החבילה ואת הגרסה שלה.

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

  1. ב-Xcode, עוברים אל File (קובץ) > Packages (חבילות) > Update To Latest Package Versions (עדכון לגרסאות החבילות הכי עדכניות).
  2. כדי לאמת את ההתקנה, עוברים לקטע Package Dependencies (יחסי תלות של חבילות) ב-Project Navigator (ניווט בפרויקט) ומאמתים את החבילה ואת הגרסה שלה.

כדי להסיר את Navigation SDK ל-iOS שהותקן באופן ידני:
  1. בהגדרות של פרויקט Xcode, מחפשים את Frameworks, Libraries, and Embedded Content. משתמשים בסימן המינוס(-) כדי להסיר את ה-framework הבא:
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  2. מסירים את החבילה GoogleMaps מהספרייה ברמה העליונה של פרויקט Xcode.

התקנה ידנית

במדריך הזה מוסבר איך להוסיף באופן ידני לפרויקט את ה-XCFrameworks שמכילים את Navigation SDK ל-iOS ואת SDK של מפות ל-iOS, ואיך לקבוע את הגדרות ה-build ב-Xcode. ‫XCFramework היא חבילה בינארית שאפשר להשתמש בה בכמה פלטפורמות, כולל מכונות שמשתמשות בערכת השבבים M1

כדי להתקין את ה-XCFrameworks של Navigation SDK ל-iOS ושל SDK של מפות ל-iOS:

  1. מורידים את קובצי המשאבים והקבצים הבינאריים הבאים של ה-SDK:
  2. מפעילים את Xcode ופותחים פרויקט קיים או יוצרים פרויקט חדש. אם אתם משתמשים חדשים ב-iOS, צרו פרויקט חדש ובחרו באפשרות תבנית אפליקציה ל-iOS.
  3. מסירים מהפרויקט את כל ההפניות הקיימות למפות, לניווט ולמקומות.
  4. גוררים את קובצי ה-XCFramework הבאים לפרויקט בקטע Frameworks, Libraries, and Embedded Content כדי להתקין את Maps SDK ואת Navigation SDK (כשמוצגת בקשה, בוחרים באפשרות Copy items if needed):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. גוררים את GoogleMaps.bundle מ-GoogleMapsResources שהורדתם לספרייה ברמה העליונה של פרויקט Xcode. כשמופיעה בקשה, מוודאים שהאפשרות העתקת פריטים במקרה הצורך מסומנת.
  6. גוררים את GoogleNavigation.bundle מ-GoogleNavigationResources שהורדתם לספרייה ברמה העליונה של פרויקט Xcode. כשמוצגת בקשה, מוודאים שהאפשרות העתקת פריטים לתיקייה של קבוצת היעד מסומנת.
  7. בוחרים את הפרויקט בחלונית הניווט בפרויקט, ובוחרים את היעד של האפליקציה.
  8. פותחים את הכרטיסייה Build Phases, ובקטע Link Binary with Libraries מוסיפים את הספריות וה-frameworks הבאים:
    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.framework
    • CarPlay.framework
    • Contacts.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libxml2.tbd
    • libz.tbd
    • MapKit.framework
    • Metal.framework
    • OpenGLES.framework
    • QuartzCore.framework
    • Security.framework
    • SystemConfiguration.framework
    • UIKit.framework
    • UserNotifications.framework
    • WebKit.framework
  9. ביעד של האפליקציה, בוחרים בכרטיסייה Capabilities, מפעילים את Background Modes ומפעילים את המצבים הבאים:
    • אודיו, AirPlay ותמונה בתוך תמונה
    • עדכונים לגבי מיקום
  10. בוחרים את הפרויקט, ולא יעד ספציפי, ופותחים את הכרטיסייה Build Settings. בקטע Other Linker Flags, מוסיפים את ‑ObjC גם ל-debug וגם ל-release. אם ההגדרות האלה לא מופיעות, משנים את המסנן בסרגל Build Settings מ-Basic ל-All.
  11. פותחים את Info.plist ומוסיפים את צמדי המפתח/ערך הבאים:
    • מפתח: NSLocationWhenInUseUsageDescription (Privacy - Location When In Use Usage Description)
      ערך: "אפליקציה זו זקוקה להרשאה להשתמש במיקום שלך לצורך ניווט מסלול מפורט."
    • מפתח: NSLocationAlwaysAndWhenInUseUsageDescription (Privacy - Location Always and When In Use Usage Description)
      ערך: "האפליקציה הזו צריכה הרשאה להשתמש במיקום שלך לצורך ניווט מפורט".

שלב 3: מוסיפים את מפתח ה-API לפרויקט

בדוגמאות הבאות מוסבר איך להוסיף את מפתח ה-API לפרויקט ב-Xcode:

Swift

מוסיפים את מפתח ה-API ל-AppDelegate.swift באופן הבא:

  1. מוסיפים את הצהרות הייבוא הבאות: 
    import GoogleMaps
import GoogleNavigation
  2. מוסיפים את הקוד הבא ל-method‏ application(_:didFinishLaunchingWithOptions:): 
    GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

מוסיפים את מפתח ה-API ל-AppDelegate.m באופן הבא:

  1. מוסיפים את הצהרות הייבוא הבאות: 
    @import GoogleMaps;
@import GoogleNavigation;
  2. מוסיפים את הקוד הבא ל-method‏ application:didFinishLaunchingWithOptions:: 
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

שלב 4 (אופציונלי): בודקים את קובץ מניפסט הפרטיות של אפל

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

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

אם אתם לקוחות של Mobility Services

אם אתם לקוחות של Mobility Services, תוכלו לקרוא על החיוב במסמכי התיעוד של Mobility. למידע נוסף על רישום עסקאות, קראו את המאמר הגדרת החיוב. כדי ללמוד איך להוסיף מזהי עסקאות להטמעה של Navigation SDK, קראו את המאמר שיוך השימוש בשירות לעסקאות ב-Mobility.

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

עכשיו, כשיש לכם מפתח API ופרויקט Xcode, אתם יכולים ליצור ולהפעיל אפליקציות. ב-Navigation SDK ל-iOS יש מדריכים שיעזרו לכם להתחיל לעבוד. לפרטים נוספים: