Places SDK לגרסאות iOS

בחירת פלטפורמה: Android iOS JavaScript

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

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

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

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

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

  יתרונות:

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

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

  יתרונות:

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

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

התקנה

מנהל חבילות SWIFT

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

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

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

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

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

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

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

CocoaPods

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

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

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

platform :ios, '15.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '8.3.0'
end

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

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

מנהל חבילות SWIFT

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

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

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

Cocoapods

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

   cd <path-to-project>

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

התקנה ידנית

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

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