הגדרת פרויקט ב-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 כדי למשוך את החבילה ולוחצים על Add Package.
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. מסירים את החבילה GoogleMaps מהספרייה ברמה העליונה של פרויקט Xcode.

התקנה ידנית

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

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

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

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"];