Places SDK לגרסאות iOS

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

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

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

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

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

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

  יתרונות:

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

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

  יתרונות:

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

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

התקנה

Swift Package Manager

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

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

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

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

   חשוב: כתובת ה-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 (ניווט בפרויקט) כדי לאמת את החבילה ואת הגרסה שלה.

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

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

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

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

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

חשוב: לפעמים אי אפשר לפתור את הבעיות ברכיבי ה-SDK או שמתרחשות שגיאות. במקרה כזה, בוחרים באפשרות File > Packages > Reset Package Cache.

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

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

Swift Package Manager

To update the package for an existing project, follow these steps:

  

    
    
    

      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
  
  
  

    Important: Sometimes, artifacts cannot be resolved or errors can occur, 
    in this case select "File > Packages > Reset Package Cache".
  

התקנה ידנית

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

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