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

Swift Package Manager

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

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

1. פותחים את Xcode project או workspace, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת תלות בחבילה).
2. מזינים את כתובת ה-URL https://github.com/googlemaps/ios-maps-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על 'הוספת חבילה'.
3. כדי להתקין version ספציפי, מגדירים את השדה Dependency Rule (כלל תלות) לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ולהשתמש באפשרות Exact Version (גרסה מדויקת). בסיום, לוחצים על 'הוספת חבילה'.
4. בחלון Choose Package Products (בחירת מוצרים לחבילה), מוודאים ש-GoogleMaps (בגרסאות מוקדמות יותר מ-9.0.0, מוודאים ש-GoogleMaps,‏ GoogleMapsBase ו-GoogleMapsCore) יתווספו ליעד main שצוין. בסיום, לוחצים על 'הוספת חבילה'.
5. כדי לאמת את ההתקנה, עוברים לחלונית כללי של היעד. בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע) אמורים להופיע החבילות המותקנות. אפשר גם לעיין בקטע Package Dependencies (תלות בחבילה) ב-Project Navigator (סייר הפרויקטים) כדי לאמת את החבילה ואת הגרסה שלה.

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

1. אם אתם משדרגים מגרסה קודמת ל-9.0.0, אתם צריכים להסיר את התלות הבאה: GoogleMapsBase,‏ GoogleMapsCore ו-GoogleMapsM4B אחרי השדרוג. אין להסיר את התלות של GoogleMaps. מידע נוסף זמין בנתוני הגרסה 9.0.0.

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

   • ‫GoogleMapsBase (רק לשדרוגים מגרסאות מוקדמות יותר מ-9.0.0)
   • ‫GoogleMapsCore (רק לשדרוגים מגרסאות מוקדמות יותר מ-9.0.0)
   • ‫GoogleMapsM4B (רק לשדרוגים מגרסאות מוקדמות יותר מ-9.0.0)
2. ב-Xcode, עוברים אל File > Packages > Update To Latest Package Versions (קובץ > חבילות > עדכון לגרסאות החבילה העדכניות ביותר).
3. כדי לאמת את ההתקנה, עוברים לקטע Package Dependencies (תלות בחבילה) ב-Project Navigator (סרגל הניווט של הפרויקט) כדי לאמת את החבילה ואת הגרסה שלה.

כדי להסיר יחסי תלות קיימים ב-SDK של מפות ל-iOS שנוספו באמצעות CocoaPods, פועלים לפי השלבים הבאים:

1. סוגרים את סביבת העבודה של Xcode. פותחים את הטרמינל ומריצים את הפקודה הבאה:

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all

2. מסירים את Podfile, Podfile.resolved ואת Xcode workspace אם אתם לא משתמשים בהם לשום דבר אחר מלבד CocoaPods.

1. בהגדרות התצורה של פרויקט Xcode, מחפשים את Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע). כדי להסיר את המסגרת הבאה, משתמשים בסימן המינוס (–):
   • GoogleMaps
   • ‫GoogleMapsBase (רק להתקנות בגרסה מוקדמת יותר מ-9.2.0)
   • ‫GoogleMapsCore (רק להתקנות בגרסה מוקדמת יותר מ-9.2.0)
   • ‫GoogleMapsM4B (רק להתקנות מגרסה מוקדמת יותר מ-9.0.0)
2. מהספרייה ברמה העליונה של פרויקט Xcode, מסירים את GoogleMaps החבילה.

התקנה ידנית

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

1. מורידים את קובצי ההפעלה וקובצי המשאבים הבאים של ה-SDK:
   • GoogleMaps
   • GoogleMapsResources
2. מחולצים את הקבצים כדי לגשת ל-XCFrameworks ולמשאבים.
3. אם עדיין אין לכם פרויקט Xcode, אתם יכולים ליצור פרויקט חדש ולשמור אותו במחשב המקומי. אם אתם חדשים בפיתוח ל-iOS:
   1. יוצרים פרויקט חדש.
   2. בוחרים בתבנית iOS > App.
   3. במסך האפשרויות של הפרויקט:
      1. מזינים את שם הפרויקט.
      2. מתעדים את הערך של השדה מזהה החבילה. אפשר להשתמש בערך הזה כדי להגביל את מפתח ה-API שבהמשך.
      3. מגדירים את Interface (ממשק) של הפרויקט ל-Storyboard (סטוריבורד).
      4. מגדירים את השפה ל-Swift או ל-Objective-C.
4. פותחים את הכרטיסייה כללי. גוררים את מסגרות XCFrameworks הבאות לפרויקט בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע). חשוב לבחור באפשרות לא להטמיע:
   • GoogleMaps.xcframework
5. מעתיקים את GoogleMaps.bundle מ-GoogleMapsResources שהורדתם לתיקיית הרמה העליונה של פרויקט Xcode. כשמוצגת בקשה לעשות זאת, חשוב לבחור באפשרות העתקת פריטים לתיקייה של קבוצת היעד.
6. בוחרים את הפרויקט בחלונית הניווט בפרויקט, ואז בוחרים את היעד של האפליקציה.
7. פותחים את הכרטיסייה Build Phases (שלבי בנייה) של יעד האפליקציה. בקטע Link Binary with Libraries, מוסיפים את המסגרות והספריות הבאות:
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • MetricKit.framework
   • ‫OpenGLES.framework (רק אם משתמשים ב-OpenGL)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. בוחרים את הפרויקט במקום יעד ספציפי, ופותחים את הכרטיסייה Build Settings. בקטע Linking - General -> Other Linker Flags, מוסיפים את -ObjC ל-Debug ול-Release. אם ההגדרות האלה לא מוצגות, צריך לשנות את המסנן בסרגל Build Settings מ-Basic ל-All.

9. הוראות להתקנת Places SDK ל-iOS XCFramework מופיעות במאמר תחילת העבודה עם Places SDK ל-iOS.

Swift

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

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

   import GoogleMaps

2. מוסיפים את הקוד הבא ל-method‏ application(_:didFinishLaunchingWithOptions:), באמצעות מפתח ה-API:

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. אם אתם משתמשים גם ב-Places API, מוסיפים את המפתח שוב כמו שמוצג כאן:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

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

   @import GoogleMaps;

2. מוסיפים את הקוד הבא ל-method‏ application:didFinishLaunchingWithOptions:, באמצעות מפתח ה-API:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. אם אתם משתמשים גם ב-Places API, מוסיפים את המפתח שוב כמו שמוצג כאן:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];