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

Swift Package Manager

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

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

1. פותחים את Xcode project או workspace, ואז עוברים אל קובץ > הוספת יחסי תלות בחבילות.
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, צריך להסיר אותה מהקטע 'חבילות תלויות' ב-Xcode.

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

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

1. ב-Xcode, עוברים אל 'קובץ' > 'חבילות' > 'עדכון לגרסאות החבילות העדכניות ביותר'.

   אם אתם מעדכנים את 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. משתמשים בסימן המינוס(-) כדי להסיר את המסגרות הבאות:
   • GooglePlaces.xcframework
   • GooglePlacesSwift.xcframework
2. מסירים את החבילה GooglePlaces מהספרייה ברמה העליונה של פרויקט Xcode.

התקנה ידנית

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

1. מורידים את קובצי ה-SDK הבינאריים ואת קובצי המשאבים הבאים:
   • GooglePlaces
   • GooglePlacesResources
2. אם מתקינים את Places Swift SDK ל-iOS (גרסת Preview), צריך להתקין את הקבצים הבאים:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. חילוץ הקבצים כדי לגשת ל-XCFramework ולמשאבים.
4. פותחים את Xcode ופותחים פרויקט קיים או יוצרים פרויקט חדש. אם אתם מפתחים חדשים ב-iOS, תוכלו ליצור פרויקט חדש ולבחור באפשרות iOS App template.
5. מסירים מהפרויקט חבילות של מפות מגרסת קודמת.
6. פותחים את הכרטיסייה כללי. גוררים את ה-XCFramework הבא לפרויקט בקטע Frameworks, Libraries, and Embedded Content. חשוב לבחור באפשרות לא להטמיע:
   • GooglePlaces.xcframework
   אם מתקינים את Places Swift SDK ל-iOS (גרסת Preview), גוררים את ה-XCFramework הבא לפרויקט בקטע Frameworks, Libraries and Embedded Content. חשוב לבחור באפשרות לא להטמיע:
   • GooglePlacesSwift.xcframework
7. מעתיקים את GooglePlaces.bundle מ-GooglePlacesResources שהורדת לתיקיית הרמה העליונה של פרויקט Xcode. חשוב לבחור באפשרות העתקת פריטים לתיקייה של קבוצת היעד כשמופיעה הבקשה.
   
   אם מתקינים את Places Swift SDK ל-iOS (גרסת Preview), מעתיקים את 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 (גרסת Preview) זמינים כ-pods של CocoaPod, ‏ GooglePlaces ו-GooglePlacesSwift.

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

sudo gem install cocoapods

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

1. אם עדיין אין לכם פרויקט Xcode, אתם יכולים ליצור אחד עכשיו ולשמור אותו במחשב המקומי. אם אתם מפתחים חדשים ב-iOS, תוכלו ליצור פרויקט חדש ולבחור באפשרות iOS App template.
2. יוצרים קובץ בשם Podfile בספריית הפרויקט. הקובץ הזה מגדיר את יחסי התלות של הפרויקט.
3. עורכים את הקובץ Podfile ומוסיפים את יחסי התלות יחד עם הגרסאות שלהם. בדוגמה הבאה מצוין שם היעד של האפליקציה, וגם השמות של ה-pods GooglePlaces ו-GooglePlacesSwift:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '9.2.0'
     pod 'GooglePlacesSwift', '0.3.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 לגרסה האחרונה.

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

GooglePlacesSwift

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

• מוסיפים את הצהרת הייבוא הבאה:

  import GooglePlacesSwift

• מוסיפים את הטקסט הבא ל-method‏ application(_:didFinishLaunchingWithOptions:), מחליפים את YOUR_API_KEY במפתח ה-API שלכם:

  PlacesClient.provideAPIKey("YOUR_API_KEY")