Places SDK לגרסאות iOS

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

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

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

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

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

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

  הטבות:

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

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

  הטבות:

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

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

התקנה

Swift Package Manager

אפשר להתקין את Places SDK ל-iOS באמצעות Swift Package Manager. כדי להוסיף את ה-SDK, צריך לוודא שהסרתם את כל התלות הקיימת ב-Places SDK ל-iOS.

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

1. פותחים את Xcode project או workspace, ואז עוברים אל File > Add Package Dependencies (קובץ > הוספת תלות בחבילה).
2. מזינים את כתובת ה-URL https://github.com/googlemaps/ios-places-sdk, מקישים על Enter כדי למשוך את החבילה ולוחצים על 'הוספת חבילה'.
3. כדי להתקין version ספציפי, מגדירים את השדה Dependency Rule (כלל תלות) לאחת מהאפשרויות שמבוססות על גרסה. בפרויקטים חדשים, מומלץ לציין את הגרסה העדכנית ולהשתמש באפשרות Exact Version (גרסה מדויקת). לסיום, לוחצים על 'הוספת חבילה'.
4. בחלון Choose Package Products (בחירת מוצרים לחבילה), מוודאים שמוצר GooglePlaces, מוצר GooglePlacesSwift או שניהם יתווספו ליעד הראשי שצוין. לסיום, לוחצים על הוספת חבילה.

   אם אתם מעדכנים את Google Places Swift מכתובת ה-URL שהוצאה משימוש ב-GitHub

   חשוב: החל מגרסה 0.3.0, כתובת ה-URL של GitHub לגישה ל-Google Places Swift השתנתה. אם אתם מעדכנים גרסה של GooglePlacesSwift שהגישה אליה הייתה דרך כתובת ה-URL הישנה, https://github.com/googlemaps/ios-places-swift-sdk, אתם צריכים להסיר אותה מהקטע package dependencies ב-Xcode.

5. כדי לאמת את ההתקנה, עוברים לחלונית כללי של היעד. בקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע), אמורים להופיע החבילות שהותקנו. אפשר גם לעיין בקטע Package Dependencies (תלות בחבילה) בProject Navigator (סרגל הניווט בפרויקט) כדי לאמת את החבילה ואת הגרסה שלה.

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

1. ב-Xcode, עוברים אל File > Packages > Update To Latest Package Versions (קובץ > חבילות> עדכון לגרסאות החבילה העדכניות ביותר).

   אם אתם מעדכנים את Google Places Swift מכתובת ה-URL שהוצאה משימוש ב-GitHub

   חשוב: החל מגרסה 0.3.0, כתובת ה-URL של GitHub לגישה ל-Google Places Swift השתנתה. אם אתם מעדכנים גרסה של GooglePlacesSwift שהגישה אליה הייתה דרך כתובת ה-URL הישנה, https://github.com/googlemaps/ios-places-swift-sdk, אתם צריכים להסיר אותה מהקטע package dependencies ב-Xcode.

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

חשוב: לפעמים אי אפשר לפתור בעיות שקשורות לארטיפקטים, או שמתרחשות שגיאות. במקרה כזה, בוחרים באפשרות 'קובץ > חבילות > איפוס מטמון החבילות'.

CocoaPods

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

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

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

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '10.8.0'
  pod 'GooglePlacesSwift', '10.8.0'
end

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

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

Swift Package Manager

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

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

חשוב: לפעמים אי אפשר לפתור בעיות שקשורות לארטיפקטים, או שמתרחשות שגיאות. במקרה כזה, בוחרים באפשרות 'קובץ > חבילות > איפוס מטמון החבילות'.

Cocoapods

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

   cd <path-to-project>

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

התקנה ידנית

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

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