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

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

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

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

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

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

CocoaPods

‫Places SDK ל-iOS ו-Places Swift SDK ל-iOS זמינים כ-pods של CocoaPod, ‏ GooglePlaces ו-GooglePlacesSwift.

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

sudo gem install cocoapods

יוצרים Podfile כדי להתקין את ערכות ה-SDK ואת יחסי התלות שלהן:

  1. אם עדיין אין לכם פרויקט Xcode, אתם יכולים ליצור אחד עכשיו ולשמור אותו במחשב המקומי. אם אתם חדשים בפיתוח ל-iOS, אתם יכולים ליצור פרויקט חדש ולבחור באפשרות iOS App template (תבנית של אפליקציית iOS).
  2. יוצרים קובץ בשם Podfile בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט.
  3. עורכים את קובץ Podfile ומוסיפים את התלויות עם הגרסאות שלהן. זו דוגמה שמציינת את שם יעד האפליקציה ואת השמות של הפודים GooglePlaces ו-GooglePlacesSwift: 
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '10.1.0'
  pod 'GooglePlacesSwift', '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 לאפליקציה

בדוגמאות הבאות, מחליפים את הערך 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 כדי לקבל עדכונים ומידע נוסף.

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

השלבים הבאים