Driver SDK לגרסאות iOS

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

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

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

    יתרונות:

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

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

    יתרונות:

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

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

התקנה

תמיד צריך לציין מספר גרסה ביחסי התלות במקום להשתמש באופרטור אופטימי (~>), כי זה עלול להוביל ל-builds בלתי צפויים ולא ניתנים לחזור עליהם. 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 Package Manager

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

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

  1. פותחים את Xcode project או workspace, ואז עוברים אל קובץ > הוספת יחסי תלות בחבילות.
  2. מזינים את כתובת ה-URL https://github.com/googlemaps/ios-driver-sdk, מקישים על Enter כדי לשלוח את החבילה ולוחצים על 'הוספת חבילה'.
  3. כדי להתקין version ספציפי, מגדירים את השדה Dependency Rule לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה האחרונה ולהשתמש באפשרות 'גרסה מדויקת'. בסיום, לוחצים על 'הוספת חבילה'.

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

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

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

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

Cocoapods

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

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

התקנה ידנית

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

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