Places SDK לגרסאות iOS

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

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

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

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

    יתרונות:

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

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

    יתרונות:

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

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

התקנה

מנהל חבילות Swift

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

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

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

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

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

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

  1. סגירת סביבת העבודה של Xcode. פותחים את הטרמינל ומריצים את הפקודה הבאה:
    sudo gem install cocoapods-deintegrate cocoapods-clean 
    pod deintegrate 
    pod cache clean --all
  2. יש להסיר את ה-Podfile, Podfile.resolved ואת ה-Xcode workspace אם לא משתמשים בהם למטרה אחרת מלבד CocoaPods.

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, עוברים אל 'קובץ > חבילות > עדכון לגרסאות האחרונות של החבילה'.
  2. כדי לאמת את ההתקנה, עוברים לקטע תלויי חבילה ב-Project Navigator ומאמתים את החבילה והגרסה שלה.

קוקופודים

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

    cd <path-to-project>
  2. מריצים את pod outdated כדי לבדוק אם קיימת גרסה חדשה יותר של Places SDK ל-iOS.
  3. אם נמצאה גרסה חדשה יותר של ה-SDK, יש לעדכן את Podfile בגרסה החדשה הזו. בקטע ציון גרסאות של רצף מודעות מוסבר איך להגדיר גרסה ספציפית ב-Podfile.
  4. מריצים את pod update.
  5. יש לבצע את השינויים הנדרשים כתוצאה מהשדרוג. בנתוני הגרסה מפורטת רשימה של השינויים בכל גרסה.
  6. כדי לנקות ולבנות מחדש את הפרויקט, בוחרים באפשרות מוצר > ניקוי ואז מוצר > פיתוח

ידני

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

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