Driver SDK לגרסאות iOS

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

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

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

    יתרונות:

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

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

    יתרונות:

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

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

התקנה

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

CocoaPods

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

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

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end

מנהל חבילות SWIFT

אפשר להתקין את Driver SDK דרך Swift Package Manager. כדי להוסיף את ה-SDK, צריך לוודא שהסרתם את כל יחסי התלות הקיימים של Driver SDK.

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

  1. פותחים את ה-Xcode project או workspace ועוברים אל 'קובץ' > 'הוספת יחסי תלות של חבילה'.
  2. מזינים את הכתובת https://github.com/googlemaps/ios-driver-sdk בתור כתובת ה-URL, מקישים על Enter כדי למשוך את החבילה ולוחצים על 'הוספת חבילה'.
  3. כדי להתקין version ספציפי, צריך להגדיר את השדה כלל תלות לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה האחרונה ולהשתמש באפשרות 'גרסה מדויקת'. בסיום, לוחצים על 'הוספת חבילה'.
  4. בחלון Choose Package Products, מוודאים שהערך של GoogleRidesharingDriver יתווסף ליעד 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, עוברים אל 'קובץ' > 'חבילות' > 'עדכון לגרסאות האחרונות של החבילה'.
  3. כדי לאמת את ההתקנה, עוברים לקטע Package Dependencies של Project Navigator כדי לאמת את החבילה ואת הגרסה שלה.

כדי להסיר יחסי תלות קיימים של Driver SDK שנוספו באמצעות CocoaPods, מבצעים את השלבים הבאים:

  1. סוגרים את סביבת העבודה של Xcode. פותחים את הטרמינל ומריצים את הפקודה הבאה:
    sudo gem install cocoapods-deintegrate cocoapods-clean 
pod deintegrate 
pod cache clean --all
  2. מסירים את Podfile, Podfile.resolved ואת ה-Xcode workspace אם אתם לא משתמשים בהם לכל מטרה אחרת מלבד CocoaPods.

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

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

קקאופודים

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

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

התקנה ידנית

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

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