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.

מנהל חבילות SWIFT

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

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

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

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

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

כדי להסיר יחסי תלות קיימים של 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.

CocoaPods

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

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

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

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

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

קקאופודים

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 פרויקט בעלים מקבלים הודעות אימייל על שינויים שלא תואמים לאחור, שעשויים להשפיע על הפרויקטים שלהם. שפת תרגום לקבל התראה יזומה על שינויים שלא תואמים לאחור, להקצות תפקיד הבעלים עם כתובת אימייל במעקב לכל אחד מהפרויקטים שלכם.