Driver SDK לגרסאות iOS

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

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

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

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

  יתרונות:

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

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

  יתרונות:

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

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

התקנה

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

הערה: Driver SDK ל-iOS לא תומך בהתקנה באמצעות Carthage.

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.

חשוב: ההוראות האלה מבוססות על שימוש ב-Xcode 15 ואילך, אבל הן אמורות להיות דומות לגרסאות קודמות של Xcode.

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

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

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

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

חשוב: לפעמים לא ניתן לפתור פריטי מידע שנוצרו בתהליך הפיתוח (Artifact) או שעלולות להתרחש שגיאות, במקרה כזה בחרו באפשרות 'קובץ' > חבילות > איפוס המטמון של החבילה".

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

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

Cocoapods

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

   cd <path-to-project>

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

התקנה ידנית

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

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