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

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

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

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

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

  • Xcode גרסה 15.0 ואילך

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

Swift Package Manager

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

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

  1. פותחים את Xcode project או workspace, ואז עוברים אל קובץ > הוספת יחסי תלות בחבילות.
  2. מזינים את כתובת ה-URL https://github.com/googlemaps/ios-navigation-sdk, מקישים על Enter כדי לשלוח את החבילה ולוחצים על 'הוספת חבילה'.
  3. כדי להתקין version ספציפי, מגדירים את השדה Dependency Rule לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה האחרונה ולהשתמש באפשרות 'גרסה מדויקת'. בסיום, לוחצים על 'הוספת חבילה'.

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

  1. כדי לאמת את ההתקנה, עוברים לקטע Package Dependencies ב-Project Navigator כדי לאמת את החבילה ואת הגרסה שלה.

כדי להסיר את Navigation SDK ל-iOS שהותקן באופן ידני:
  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 הבינאריים ואת קובצי המשאבים הבאים:
  2. פותחים את Xcode ופותחים פרויקט קיים או יוצרים פרויקט חדש. אם אתם משתמשים חדשים ב-iOS, יוצרים פרויקט חדש ובוחרים באפשרות iOS App template.
  3. מסירים מהפרויקט את כל ההפניות הקיימות למפות Google, לניווט ולמקומות.
  4. כדי להתקין את ערכות ה-SDK של מפות Google ושל ניווט, גוררים את ה-XCFrameworks הבאים לפרויקט בקטע Frameworks, Libraries and Embedded Content (כשמוצגת בקשה, בוחרים באפשרות Copy items if needed):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. גוררים את GoogleMaps.bundle מ-GoogleMapsResources שהורדתם, לספרייה ברמה העליונה של פרויקט Xcode. כשמוצגת בקשה, מוודאים שהאפשרות העתקת פריטים לפי הצורך מסומנת.
  6. גוררים את GoogleNavigation.bundle מ-GoogleNavigationResources שהורדתם, לספרייה ברמה העליונה של פרויקט Xcode. כשמוצגת בקשה לעשות זאת, מוודאים שבוחרים באפשרות העתקת פריטים לתיקייה של קבוצת היעד.
  7. בוחרים את הפרויקט מ-Project Navigator ובוחרים את היעד של האפליקציה.
  8. פותחים את הכרטיסייה Build Phases, ובקטע Link Binary with Libraries מוסיפים את המסגרות והספריות הבאות:
    • Accelerate.framework
    • AudioToolbox.framework
    • AVFoundation.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
    • 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 (פרטיות – תיאור השימוש במיקום כשהאפליקציה פועלת)
      ערך: "האפליקציה הזו זקוקה להרשאה להשתמש במיקום שלך לצורך ניווט מפורט."
    • מפתח: NSLocationAlwaysAndWhenInUseUsageDescription (פרטיות – תיאור השימוש במיקום תמיד ובזמן השימוש)
      ערך: "האפליקציה הזו זקוקה להרשאה להשתמש במיקום שלך לצורך ניווט מפורט."

CocoaPods

Navigation SDK ל-iOS זמין כ-pod של CocoaPods. CocoaPods הוא מנהל יחסי תלות בקוד פתוח לפרויקטים של Cocoa ב-Swift וב-Objective-C.

אם עדיין לא התקנתם את הכלי CocoaPods, תוכלו להתקין אותו ב-macOS על ידי הפעלת הפקודה הבאה מהטרמינל. פרטים נוספים זמינים במדריך למתחילים ב-CocoaPods.

sudo gem install cocoapods

יוצרים Podfile ל-Navigation SDK ל-iOS ומשתמשים בו כדי להתקין את ה-API ואת יחסי התלות שלו:

  1. אם עדיין אין לכם פרויקט Xcode, אתם יכולים ליצור אחד עכשיו ולשמור אותו במחשב המקומי. אם אתם מפתחים חדשים ב-iOS:
    1. יוצרים פרויקט חדש.
    2. בוחרים את התבנית iOS‏ > App.
    3. במסך האפשרויות של הפרויקט:
      1. מזינים את שם הפרויקט.
      2. מתעדים את הערך בשדה מזהה החבילה. אפשר להשתמש בערך הזה כדי להגביל את מפתח ה-API בהמשך.
      3. מגדירים את ממשק הפרויקט ל-Storyboard.
      4. מגדירים את Language (שפה) ל-Swift או ל-Objective-C.
  2. יוצרים קובץ בשם Podfile בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט.
  3. עורכים את הקובץ Podfile ומוסיפים את יחסי התלות יחד עם הגרסאות שלהם. הנה דוגמה שכוללת את התלות הנדרשת ב-Navigation SDK ל-iOS: # Cocoapods install reference # 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleNavigation', '9.2.0'
end
    חשוב להריץ את pod outdated באופן קבוע כדי לזהות גרסאות חדשות יותר. אם צריך, משדרגים לגרסה העדכנית.
  4. שומרים את ה-Podfile.

  5. פותחים מסוף ועוברים לספרייה שמכילה את Podfile:

    cd <path-to-project>

  6. מריצים את הפקודה pod install. הפקודה הזו מתקינה את ממשקי ה-API שצוינו ב-Podfile, יחד עם יחסי התלות שלהם.

    pod install

  7. סוגרים את Xcode ופותחים (לחיצה כפולה) את הקובץ .xcworkspace של הפרויקט כדי להפעיל את Xcode. מעכשיו והלאה, עליכם להשתמש בקובץ .xcworkspace כדי לפתוח את הפרויקט.

כדי לעדכן את ה-API של פרויקט קיים:

  1. פותחים מסוף ועוברים לספריית הפרויקט שמכילה את Podfile.
  2. מריצים את הפקודה pod update. הפעולה הזו מעדכנת את כל ממשקי ה-API שצוינו ב-Podfile לגרסה האחרונה.

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

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

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

שלב 4 (אופציונלי): בודקים את קובץ Privacy Manifest של Apple

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

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

לקוחות Mobility Services

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

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

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