דף זה תורגם על ידי Cloud Translation API.

Driver SDK לגרסאות iOS

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

לאיזו גרסה לקשר?

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

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

יתרונות:
- אם יזוהו בעיות ב-Driver SDK ל-iOS, התיקונים יסופקו תוך תאימות לאחור למשך 12 חודשים אחרי הפצת הגרסה הראשית, בהתאם למדיניות התמיכה במכשירים ניידים. לא יהיה צורך לשדרג בדחיפות לגרסת SDK לא תואמת כדי ליהנות מהתיקונים.
- כשהאפליקציה כבר מבוססת על הגרסה האחרונה, קל להשתמש בשיפורים ובתכונות העדכניים ביותר.
- עדכונים מצטברים שנתיים לגרסה הראשית העדכנית ביותר של ה-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 באמצעות Package Manager של Swift. כדי להוסיף את ה-SDK, צריך לוודא שהסרתם את כל יחסי התלות הקיימים של Driver SDK.

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

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

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

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

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

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

Cocoapods

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

התקנה ידנית

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

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