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

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

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

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

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

    יתרונות:

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

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

    יתרונות:

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

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

התקנה

מנהל חבילות SWIFT

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

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

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

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

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

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

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

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

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

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

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

platform :ios, '15.0'

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

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

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

מנהל חבילות SWIFT

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

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

Cocoapods

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

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

התקנה ידנית

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

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