SDK של מפות Google לגרסאות iOS

Swift Package Manager

אפשר להתקין את Maps SDK ל-iOS דרך Swift Package Manager. כדי להוסיף את ה-SDK, צריך לוודא שהסרתם את כל יחסי התלות הקיימים של Maps 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 (כלל תלות) לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ולהשתמש באפשרות 'גרסה מדויקת'. לסיום, לוחצים על 'הוספת חבילה'.

כדי לעדכן את 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.

CocoaPods

תמיד צריך לציין מספר גרסה בתלות במקום להשתמש באופרטור אופטימי (~>), כי זה עלול להוביל לבנייה בלתי צפויה ולא עקבית. ‫Maps SDK ל-iOS פועל לפי גרסאות סמנטיות, והשקות של גרסאות ראשיות חדשות כוללות שינויים שעלולים לשבור את התאימות לאחור.

דוגמה לתלות ב-Podfile באמצעות התחביר של Podfile:

source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleMaps', '10.1.0'
end