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

Swift Package Manager

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

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

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

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

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

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

התקנה ידנית

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

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

1. מורידים את קובצי ההפעלה (binaries) וקובצי המשאבים הבאים של ה-SDK:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. מפעילים את Xcode ופותחים פרויקט קיים או יוצרים פרויקט חדש. אם אתם חדשים ב-iOS, אתם צריכים ליצור פרויקט חדש ולבחור בתבנית של אפליקציית iOS.
3. מסירים מהפרויקט את כל ההפניות הקיימות למפות Google, לניווט ולמקומות.
4. גוררים את מסגרות XCFrameworks הבאות אל הפרויקט בקטע 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 (קישור קובץ בינארי לספריות), מוסיפים את המסגרות והספריות הבאות:
   • 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 (פרטיות – מיקום תמיד וכשהאפליקציה בשימוש, תיאור השימוש)
      ערך: "האפליקציה הזו צריכה הרשאה להשתמש במיקום שלכם כדי לספק ניווט מפורט."

Swift

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

1. מוסיפים את הצהרות הייבוא הבאות:

   import GoogleMaps
   import GoogleNavigation

2. מוסיפים את הטקסט הבא לשיטה application(_:didFinishLaunchingWithOptions:):

   GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

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

1. מוסיפים את הצהרות הייבוא הבאות:

   @import GoogleMaps;
   @import GoogleNavigation;

2. מוסיפים את הטקסט הבא לשיטה application:didFinishLaunchingWithOptions::

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];