אחרי שמפעילים את החיוב ויוצרים מפתח 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 לפרויקט חדש או קיים, פועלים לפי השלבים הבאים:
-
פותחים את
projectאו אתworkspaceב-Xcode, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת יחסי תלות של חבילות). - מזינים את כתובת ה-URL https://github.com/googlemaps/ios-places-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על Add Package.
-
כדי להתקין
versionספציפי, מגדירים את השדה כלל תלות לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ביותר ולהשתמש באפשרות Exact Version. בסיום, לוחצים על "הוספת חבילה". - בחלון 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. - כדי לוודא שההתקנה בוצעה, עוברים לחלונית General (כללי) של היעד. בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע) אמורות להופיע החבילות שהותקנו. אפשר גם להציג את הקטע Package Dependencies (יחסי תלות של חבילות) ב-Project Navigator (ניווט בפרויקט) כדי לאמת את החבילה ואת הגרסה שלה.
כדי לעדכן את package בפרויקט קיים, פועלים לפי השלבים הבאים:
-
ב-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. - כדי לאמת את ההתקנה, עוברים לקטע Package Dependencies (יחסי תלות של חבילות) ב-Project Navigator (ניווט בפרויקט) ומאמתים את החבילה ואת הגרסה שלה.
כדי להסיר את Places SDK ל-iOS שהותקן ידנית:
-
בהגדרות של פרויקט Xcode, מחפשים את Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע). משתמשים בסימן המינוס (-) כדי להסיר את ה-frameworks הבאים:
GooglePlaces.xcframeworkGooglePlacesSwift.xcframework
-
מסירים את החבילה
GooglePlacesמהספרייה ברמה העליונה של פרויקט Xcode.
התקנה ידנית
במדריך הזה מוסבר איך להוסיף באופן ידני את ה-XCFrameworks שמכילים את Places SDK ל-iOS ואת Places Swift SDK ל-iOS לפרויקט, ואיך לקבוע את הגדרות ה-build ב-Xcode. XCFramework היא חבילה בינארית שאפשר להשתמש בה בכמה פלטפורמות, כולל מכונות שמשתמשות ב-Apple Silicon. אתם יכולים להוסיף את Places SDK ל-iOS, את Places Swift SDK ל-iOS או את שניהם.
- מורידים את הקבצים הבינאריים וקובצי המשאבים הבאים של ה-SDK:
- אם אתם מתקינים את Places Swift SDK ל-iOS, התקינו את הקבצים הבאים:
- מחלצים את הקבצים כדי לגשת ל-XCFramework ולמשאבים.
- מפעילים את Xcode ופותחים פרויקט קיים או יוצרים פרויקט חדש. אם אתם חדשים בפיתוח ל-iOS, צרו פרויקט חדש ובחרו ב-תבנית אפליקציה ל-iOS.
- מסירים מהפרויקט את כל החבילות של מפות Google מגרסאות קודמות.
-
פותחים את הכרטיסייה כללי. גוררים את ה-XCFramework הבא לפרויקט בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע). חשוב לבחור באפשרות Do Not Embed:
GooglePlaces.xcframework
GooglePlacesSwift.xcframework
-
מעתיקים את
GooglePlaces.bundleמ-GooglePlacesResources שהורדתם לספרייה ברמה העליונה של פרויקט Xcode. כשמוצגת בקשה, חשוב לבחור באפשרות העתקת פריטים לתיקייה של קבוצת היעד.
אם מתקינים את Places SDK ל-Swift, מעתיקים אתGooglePlacesSwift.bundleמ-GooglePlacesSwiftResources שהורדתם לספרייה ברמה העליונה של פרויקט Xcode. כשמוצגת בקשה, חשוב לבחור באפשרות העתקת פריטים לתיקייה של קבוצת היעד. - בוחרים את הפרויקט בחלונית הניווט בפרויקט, ובוחרים את היעד של האפליקציה.
-
פותחים את הכרטיסייה Build Phases. בקטע Link Binary with Libraries, מוסיפים את הספריות וה-frameworks הבאים:
CoreGraphics.frameworkCoreLocation.frameworklibc++.tbdlibz.tbdQuartzCore.frameworkUIKit.framework
-
בוחרים את הפרויקט, ולא יעד ספציפי, ופותחים את הכרטיסייה Build Settings. בקטע Linking - General -> Other Linker Flags, מוסיפים את
-ObjCל-Debug ול-Release. אם ההגדרות האלה לא מופיעות, משנים את המסנן בסרגל Build Settings מ-Basic ל-All.
שלב 3: מוסיפים את מפתח ה-API לאפליקציה
בדוגמאות הבאות, צריך להחליף את YOUR_API_KEY במפתח ה-API שלכם.
מוסיפים את מפתח ה-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. כדי לוודא שקובץ מניפסט הפרטיות נכלל באפליקציה ולבדוק את התוכן שלו, צריך ליצור ארכיון של האפליקציה ולהפיק דוח פרטיות מהארכיון.
השלבים הבאים
- מתחילים לכתוב קוד. מומלץ להתחיל בהטמעה של אפליקציה לתחילת הדרך שמקבלת את המיקום הנוכחי של המשתמש.
- אחרי שמגדירים את הפרויקט, אפשר לבדוק את האפליקציות לדוגמה.
- שימוש ב-App Check כדי לאבטח את מפתח ה-API.