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

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

הצוות של Google Maps Platform מעדכן באופן קבוע את ערכות ה-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. פותחים את project או workspace ב-Xcode, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת יחסי תלות של חבילות).
2. מזינים את כתובת ה-URL‏ https://github.com/googlemaps/ios-maps-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על "Add Package".
3. כדי להתקין version ספציפי, מגדירים את השדה כלל תלות לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ביותר ולהשתמש באפשרות Exact Version. בסיום, לוחצים על "הוספת חבילה".
4. בחלון Choose Package Products, מוודאים ש-GoogleMaps (בגרסאות שקודמות ל-9.0.0, מוודאים ש-GoogleMaps,‏ GoogleMapsBase ו-GoogleMapsCore) יתווספו ליעד main שהגדרתם. בסיום, לוחצים על "הוספת חבילה".
5. כדי לוודא שההתקנה בוצעה, עוברים לחלונית General (כללי) של היעד. בקטע 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. משתמשים בסימן המינוס(-) כדי להסיר את ה-framework הבא:

   • 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 או שמתרחשות שגיאות. במקרה כזה, צריך לבחור באפשרות File > Packages > Reset Package Cache.

כדי להסיר יחסי תלות קיימים של 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

To update the package for an existing project, follow these steps:

  

    
    
    

      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
  
  
  

    Important: Sometimes, artifacts cannot be resolved or errors can occur, 
    in this case select "File > Packages > Reset Package Cache".
  

התקנה ידנית

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

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