Driver SDK לגרסאות iOS

הצוות של Google Maps Platform מעדכן באופן קבוע את ערכות ה-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 באמצעות Swift Package Manager. כדי להוסיף את ה-SDK, צריך לוודא שהסרתם את כל יחסי התלות הקיימים של Driver SDK.

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

  1. פותחים את project או workspace ב-Xcode, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת יחסי תלות של חבילות).
  2. מזינים את כתובת ה-URL‏ https://github.com/googlemaps/ios-driver-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על Add Package.
  3. כדי להתקין version ספציפי, מגדירים את השדה כלל תלות לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ביותר ולהשתמש באפשרות Exact Version. בסיום, לוחצים על "הוספת חבילה".
  4. בחלון Choose Package Products, מוודאים שהמוצר GoogleRidesharingDriver יתווסף ליעד main שציינתם. בסיום, לוחצים על "הוספת חבילה".
  5. כדי לוודא שההתקנה בוצעה, עוברים לחלונית General (כללי) של היעד. בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע) אמורות להופיע החבילות שהותקנו. אפשר גם לבדוק את הקטע Package Dependencies (יחסי תלות של חבילות) ב-Project Navigator (ניווט בפרויקט) כדי לאמת את החבילה ואת הגרסה שלה.

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

  1. ב-Xcode, עוברים אל File (קובץ) > Packages (חבילות) > Update To Latest Package Versions (עדכון לגרסאות החבילות הכי עדכניות).
  2. כדי לאמת את ההתקנה, עוברים לקטע 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.

התקנה ידנית

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

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