SDK לצרכנים לגרסאות iOS

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

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

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

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

  יתרונות:

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

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

  יתרונות:

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

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

התקנה

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

הערה: ערכת ה-SDK לצרכנים ל-iOS לא תומכת בהתקנה באמצעות Carthage.

מנהל חבילות SWIFT

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

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

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

1. פותחים את ה-Xcode project או workspace, ועוברים אל File > (קובץ >) הוספת יחסי תלות של חבילה.
2. מזינים את הכתובת https://github.com/googlemaps/ios-consumer-sdk בתור כתובת ה-URL ומקישים על Enter. כדי למשוך את החבילה, וללחוץ על "הוספת חבילה".
3. כדי להתקין version ספציפי, צריך להגדיר את השדה כלל תלות לאחד אפשרויות שמבוססות על גרסאות. בפרויקטים חדשים, מומלץ לציין את הגרסה האחרונה באמצעות "גרסה מדויקת" כאפשרות. בסיום, לוחצים על 'הוספת חבילה'.
4. בחלון Choose Package Products, מוודאים שהתוסף GoogleRidesharingConsumer יתווסף אל היעד שהגדרת ל-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) או שעלולות להתרחש שגיאות, במקרה כזה בחרו באפשרות 'קובץ' > חבילות > איפוס המטמון של החבילה".

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

CocoaPods

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

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

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', ' 2.2.0'
    end
    

דוגמה לתלות של Podfile בשימוש בגרסת בטא של SDK לצרכנים:

    source "https://cpdc-eap.googlesource.com/ridesharing-consumer-sdk"
    source "https://github.com/CocoaPods/Specs.git"

    target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
      pod 'GoogleRidesharingConsumer', '2.1.0-beta01.0'
    end
    

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

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

קקאופודים

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

   cd <path-to-project>

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

ידני

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

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