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

בחירת פלטפורמה: Android iOS JavaScript

צוות פלטפורמת מפות Google מעדכן את ערכות ה-SDK באופן קבוע עם תכונות חדשות, תיקוני באגים ושיפורים בביצועים. בדף הזה מוסבר איך לנהל את יחסי התלות שלכם ב-SDK לנייד.

  • לאפליקציות חיוניות, צריך לקשר לגרסה האחרונה עם הנקודה של הגרסה הראשית שבה אתם משתמשים (X.*) ולשדרג מדי שנה לגרסה הראשית החדשה.

    כשאתם משיקים גרסאות חדשות של האפליקציה במהלך השנה, אתם יכולים להתחיל להשתמש בגרסאות חדשות יותר של ה-SDK של מפות Google ל-iOS. לא תצטרכו לעדכן את האפליקציה, כי גרסאות הנקודה החדשות תואמות לאחור.

    יתרונות:

    • אם תגלו בעיות ב-SDK של מפות ל-iOS, תקבלו תיקונים שתואמים לגרסאות קודמות למשך 12 חודשים אחרי ההשקה הראשונית של הגרסה הראשית, בהתאם למדיניות התמיכה בניידים. לא תצטרכו לשדרג באופן דחוף לגרסת SDK לא תואמת כדי ליהנות מהתיקונים.
    • כשהאפליקציה כבר מבוססת על הגרסה האחרונה, קל להטמיע את התכונות והשיפורים האחרונים.
    • עדכונים מצטברים שנתיים לגרסה הראשית העדכנית ביותר של ה-SDK עשויים לדרוש פחות עבודה כדי להתאים, לכתוב מחדש ולבדוק את האפליקציה, מאשר לטפל בשינויים שלא תואמים לגרסאות קודמות שנוספו במספר גרסאות ראשיות.

  • לאפליקציות לא קריטיות, אפשר לקשר לכל גרסה מתוקנת. כשתקבלו הודעה על הוצאה משימוש של הגרסה המתוקנת, יהיו לכם 12 חודשים כדי להפוך את קוד האפליקציה המעודכן לזמין למשתמשים.

    יתרונות:

    • עבודות תחזוקה בתדירות נמוכה יותר.
    • גרסאות חדשות של האפליקציה ימשיכו לתמוך במכשירים של משתמשים עם מערכות הפעלה לנייד ישנות יותר למשך זמן ארוך יותר (עד שתצטרכו לשדרג לגרסה חדשה של SDK).

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

התקנה

Swift Package Manager

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

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

  1. פותחים את Xcode project או workspace, ואז עוברים אל קובץ > הוספת יחסי תלות בחבילות.
  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, עוברים אל 'קובץ' > 'חבילות' > 'עדכון לגרסאות החבילות העדכניות ביותר'.
  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 וב-workspace של Xcode למטרה אחרת מלבד CocoaPods, כדאי להסיר אותם.

CocoaPods

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

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

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

platform :ios, '15.0'

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

תחזוקה ושדרוג

כדי לפתח גרסאות עם השיפורים האחרונים, כדאי לבדוק באופן קבוע אם יש גרסאות חדשות יותר ולעדכן את מפרטי הגרסה. אם אתם מעדכנים לגרסה ראשית חדשה, כדאי לבדוק את הערות המוצר כדי למצוא שינויים שלא תואמים לגרסאות קודמות ולגלות איך לעדכן את הקוד.

Swift Package Manager

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

  1. כדי לאמת את ההתקנה, עוברים לקטע Package Dependencies ב-Project Navigator כדי לאמת את החבילה ואת הגרסה שלה.

Cocoapods

  1. פותחים מסוף ועוברים לספרייה שמכילה את Podfile:

    cd <path-to-project>
  2. מריצים את pod outdated כדי לבדוק אם יש גרסה חדשה יותר של ה-SDK של מפות ל-iOS.
  3. אם נמצאת גרסה חדשה יותר של ה-SDK, מעדכנים את Podfile בגרסה החדשה הזו. במאמר ציון גרסאות של מודולים מוסבר איך להגדיר גרסה ספציפית ב-Podfile.
  4. מריצים את pod update.
  5. מבצעים את השינויים הנדרשים כתוצאה מהשדרוג. בנתוני הגרסה מופיעה רשימה של השינויים בכל גרסה.
  6. כדי לנקות ולבנות מחדש את הפרויקט, בוחרים באפשרות Product > Clean ואז באפשרות Product > Build.

התקנה ידנית

מקבלים את הקישור לקובצי המקור העדכניים ביותר במאמר 'התקנת ה-SDK'.

בנוסף לבדיקה של גרסאות חדשות יותר, בעלי פרויקטים ב-Google Cloud מקבלים אימיילים על שינויים שלא תואמים לאחור שעשויים להשפיע על הפרויקטים שלהם. כדי לקבל התראות יזום על שינויים שלא תואמים לאחור, מקצים את תפקיד הבעלים עם כתובת אימייל במעקב לכל אחד מהפרויקטים.