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

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

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

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

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

    יתרונות:

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

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

    יתרונות:

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

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

התקנה

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.

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

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

Swift Package Manager

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

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

התקנה ידנית

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

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