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

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

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

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

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

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

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

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 (כלל תלות) לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ולהשתמש באפשרות 'גרסה מדויקת'. לסיום, לוחצים על 'הוספת חבילה'.

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

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

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

התקנה ידנית

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

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

  1. מורידים את קובצי ההפעלה (binaries) וקובצי המשאבים הבאים של ה-SDK:
  2. מפעילים את Xcode ופותחים פרויקט קיים או יוצרים פרויקט חדש. אם אתם משתמשים חדשים ב-iOS, אתם צריכים ליצור פרויקט חדש ולבחור באפשרות iOS App template (תבנית לאפליקציית 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. בוחרים את הפרויקט מתוך 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 (Privacy - Location When In Use Usage Description)
      ערך: "This app needs permission to use your location for turn-by-turn navigation."
    • מפתח: NSLocationAlwaysAndWhenInUseUsageDescription (פרטיות – תיאור השימוש במיקום תמיד ובזמן השימוש)
      ערך: "האפליקציה הזו צריכה הרשאה להשתמש במיקום שלכם כדי לספק ניווט מפורט."

CocoaPods

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

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

sudo gem install cocoapods

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

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

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleNavigation', '10.1.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 (אופציונלי): בדיקת קובץ הצהרת הפרטיות של אפל

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

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

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

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

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

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