הגדרת פרויקט ב-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. פותחים את Xcode project או workspace, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת תלות בחבילה).
  2. מזינים את כתובת ה-URL https://github.com/googlemaps/ios-places-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על 'הוספת חבילה'.
  3. כדי להתקין version ספציפי, מגדירים את השדה Dependency Rule (כלל תלות) לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ביותר ולהשתמש באפשרות 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, אתם צריכים להסיר אותה מהקטע package dependencies (תלות בחבילות) ב-Xcode.

  5. כדי לאמת את ההתקנה, עוברים לחלונית כללי של היעד. בקטע 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, אתם צריכים להסיר אותה מהקטע package dependencies (תלות בחבילות) ב-Xcode.

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

כדי להסיר Places SDK for iOS קיים שהותקן באופן ידני, פועלים לפי השלבים הבאים:

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

התקנה ידנית

במדריך הזה מוסבר איך להוסיף באופן ידני לפרויקט את ה-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. מסירים מהפרויקט את כל חבילות המפות מגרסאות קודמות.
  6. פותחים את הכרטיסייה כללי. גוררים את ה-XCFramework הבא לפרויקט בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע). חשוב לבחור באפשרות לא להטמיע:
    • GooglePlaces.xcframework
    אם אתם מתקינים את Places Swift SDK, גוררים את XCFramework הבא לפרויקט שלכם בקטע Frameworks, Libraries, and Embedded Content. חשוב לבחור באפשרות לא להטמיע:
    • GooglePlacesSwift.xcframework
  7. מעתיקים את GooglePlaces.bundle מהתיקייה GooglePlacesResources שהורדתם אל ספריית הרמה העליונה של פרויקט Xcode. כשמוצגת בקשה לעשות זאת, חשוב לבחור באפשרות העתקת הפריטים לתיקייה של קבוצת היעד.

    אם אתם מתקינים את Places Swift SDK, צריך להעתיק את GooglePlacesSwift.bundle מ-GooglePlacesSwiftResources שהורדתם אל ספריית הרמה העליונה של פרויקט Xcode. כשמוצגת בקשה לעשות זאת, חשוב לוודא שבוחרים באפשרות העתקת פריטים לתיקייה של קבוצת היעד.
  8. בוחרים את הפרויקט בחלונית הניווט בפרויקט, ואז בוחרים את היעד של האפליקציה.
  9. פותחים את הכרטיסייה Build Phases (שלבי בנייה). בקטע Link Binary with Libraries (קישור קובץ בינארי לספריות), מוסיפים את המסגרות והספריות הבאות:
    • 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 שלכם.

GooglePlacesSwift

מוסיפים את מפתח ה-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 (אופציונלי): בודקים את קובץ מניפסט הפרטיות של אפל

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

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

השלבים הבאים