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

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

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

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

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

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

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

Swift Package Manager

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

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

  1. פותחים את project או את workspace ב-Xcode, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת יחסי תלות של חבילות).
  2. מזינים את כתובת ה-URL‏ https://github.com/googlemaps/ios-places-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על Add Package.
  3. כדי להתקין version ספציפי, מגדירים את השדה כלל תלות לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ביותר ולהשתמש באפשרות Exact Version. בסיום, לוחצים על "הוספת חבילה".
  4. בחלון Choose Package Products, מוודאים ש-GooglePlaces, GooglePlacesSwift או שניהם יתווספו ליעד הראשי שהגדרתם. בסיום, לוחצים על הוספת חבילה.

    אם אתם מעדכנים את Google Places Swift מכתובת ה-URL של GitHub שהוצאה משימוש

    חשוב: כתובת ה-URL של GitHub לגישה ל-Google Places Swift השתנתה החל מגרסה 0.3.0. אם אתם מעדכנים גרסה של GooglePlacesSwift שניגשתם אליה דרך כתובת ה-URL הישנה, https://github.com/googlemaps/ios-places-swift-sdk, הסירו אותה מהקטע של יחסי התלות של החבילה ב-Xcode.

  5. כדי לוודא שההתקנה בוצעה, עוברים לחלונית General (כללי) של היעד. בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע) אמורות להופיע החבילות שהותקנו. אפשר גם להציג את הקטע Package Dependencies (יחסי תלות של חבילות) ב-Project Navigator (ניווט בפרויקט) כדי לאמת את החבילה ואת הגרסה שלה.

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

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

    אם אתם מעדכנים את Google Places Swift מכתובת ה-URL של GitHub שהוצאה משימוש

    חשוב: כתובת ה-URL של GitHub לגישה ל-Google Places Swift השתנתה החל מגרסה 0.3.0. אם אתם מעדכנים גרסה של GooglePlacesSwift שניגשתם אליה דרך כתובת ה-URL הישנה, https://github.com/googlemaps/ios-places-swift-sdk, הסירו אותה מהקטע של יחסי התלות של החבילה ב-Xcode.

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

כדי להסיר את Places SDK ל-iOS שהותקן ידנית:

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

התקנה ידנית

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

  1. מורידים את הקבצים הבינאריים וקובצי המשאבים הבאים של ה-SDK:
  2. אם אתם מתקינים את Places Swift SDK ל-iOS, התקינו את הקבצים הבאים:
  3. מחלצים את הקבצים כדי לגשת ל-XCFramework ולמשאבים.
  4. מפעילים את Xcode ופותחים פרויקט קיים או יוצרים פרויקט חדש. אם אתם חדשים בפיתוח ל-iOS, צרו פרויקט חדש ובחרו ב-תבנית אפליקציה ל-iOS.
  5. מסירים מהפרויקט את כל החבילות של מפות Google מגרסאות קודמות.
  6. פותחים את הכרטיסייה כללי. גוררים את ה-XCFramework הבא לפרויקט בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע). חשוב לבחור באפשרות Do Not Embed:
    • GooglePlaces.xcframework
    אם מתקינים את Places SDK ל-Swift, גוררים את ה-XCFramework הבא לפרויקט בקטע Frameworks, Libraries, and Embedded Content. חשוב לבחור באפשרות Do Not Embed:
    • GooglePlacesSwift.xcframework
  7. מעתיקים את GooglePlaces.bundle מ-GooglePlacesResources שהורדתם לספרייה ברמה העליונה של פרויקט Xcode. כשמוצגת בקשה, חשוב לבחור באפשרות העתקת פריטים לתיקייה של קבוצת היעד.

    אם מתקינים את Places SDK ל-Swift, מעתיקים את GooglePlacesSwift.bundle מ-GooglePlacesSwiftResources שהורדתם לספרייה ברמה העליונה של פרויקט Xcode. כשמוצגת בקשה, חשוב לבחור באפשרות העתקת פריטים לתיקייה של קבוצת היעד.
  8. בוחרים את הפרויקט בחלונית הניווט בפרויקט, ובוחרים את היעד של האפליקציה.
  9. פותחים את הכרטיסייה Build Phases. בקטע Link Binary with Libraries, מוסיפים את הספריות וה-frameworks הבאים:
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework
  10. בוחרים את הפרויקט, ולא יעד ספציפי, ופותחים את הכרטיסייה Build Settings. בקטע Linking - General -> Other Linker Flags, מוסיפים את -ObjC ל-Debug ול-Release. אם ההגדרות האלה לא מופיעות, משנים את המסנן בסרגל Build Settings מ-Basic ל-All.

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

בדוגמאות הבאות, צריך להחליף את YOUR_API_KEY במפתח ה-API שלכם.

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

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

  • מוסיפים את הצהרת הייבוא הבאה:
    import GooglePlacesSwift
  • מוסיפים את הקוד הבא ל-method‏ application(_:didFinishLaunchingWithOptions:), ומחליפים את YOUR_API_KEY במפתח ה-API שלכם:
    PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

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

  • מוסיפים את הצהרת הייבוא הבאה:
    import GooglePlaces
  • מוסיפים את הקוד הבא ל-method‏ application(_:didFinishLaunchingWithOptions:), ומחליפים את YOUR_API_KEY במפתח ה-API שלכם:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

  • מוסיפים את הצהרת הייבוא הבאה:
    @import GooglePlaces;
  • מוסיפים את הקוד הבא ל-method‏ application:didFinishLaunchingWithOptions:, ומחליפים את YOUR_API_KEY במפתח ה-API שלכם:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

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

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

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

השלבים הבאים