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 Package Manager

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

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

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

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

   אם אתם מעדכנים את Google Places Swift

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

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

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

1. ב-Xcode, עוברים אל 'קובץ' > 'חבילות' > 'עדכון לגרסאות החבילות העדכניות ביותר'.

   אם אתם מעדכנים את Google Places Swift

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

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

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

CocoaPods

תמיד צריך לציין מספר גרסה ביחסי התלות במקום להשתמש באופרטור אופטימי (~>), כי זה עלול להוביל ל-builds בלתי צפויים ולא ניתנים לחזור עליהם. ‏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', '9.2.0'
  pod 'GooglePlacesSwift', '0.3.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 בגרסה החדשה הזו. במאמר ציון גרסאות של מודולים מוסבר איך להגדיר גרסה ספציפית ב-Podfile.
4. מריצים את pod update.
5. מבצעים את השינויים הנדרשים כתוצאה מהשדרוג. בנתוני הגרסה מופיעה רשימה של השינויים בכל גרסה.
6. כדי לנקות ולבנות מחדש את הפרויקט, בוחרים באפשרות Product > Clean ואז באפשרות Product > Build.

התקנה ידנית

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

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