מעבר ל-GMSPlaceField בתור NS_OPTIONS

החל מגרסה 4.0.0 של Places SDK ל-iOS, המאקרו NS_OPTIONS משמש עכשיו לציון GMSPlaceFieldtype. גרסאות 3.x של ה-SDK כוללות את GMSPlaceField בתור NS_ENUM, והן עדיין נתמכות.

• אם אתם משתמשים ב-Objective-C: אין השלכות. אתם יכולים להמשיך להשתמש ב-GMSPlaceField כמו קודם.

• אם אתם משתמשים ב-Swift: ההטמעה שלכם תיפסק אם אתם משתמשים בתחביר GMSPlaceField(rawValue:) כבונה, שגרסאות ישנות יותר של ה-SDK החזירו כ-GMSPlaceField? אופציונלי. בגרסה 4.0.0 ואילך מוחזר ערך GMSPlaceField לא אופציונלי. כל הפעולות שמתבצעות על הערך האופציונלי, כמו בדיקות מותנות או ביטול אריזה בכוח, ייכשלו. בנוסף, עכשיו אפשר להשתמש בתחביר של מערכים כדי לשלב בין GMSPlaceFields

העברת הקוד

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

הסרת עטיפה מותנית

בדוגמה הבאה אפשר לראות איך משתמשים ב-if כדי ליצור מערך GMSPlaceField שנדרש בו ביטול עטיפה מותנה. התוצאה תהיה שגיאת קומפילציה ("Initializer for conditional binding must have Optional type, not GMSPlaceField").

// Before.
if let field = GMSPlaceField(
    rawValue: GMSPlaceField.name.rawValue | GMSPlaceField.photos.rawValue
) { // Do something }

כדי לפתור את הבעיה, צריך להסיר את ההצהרה if, כמו שמוצג כאן:

// After.
let field =  GMSPlaceField(
    rawValue: GMSPlaceField.name.rawValue | GMSPlaceField.photos.rawValue
)
// Do something

אפשר גם להשתמש בתחביר של מערך, כמו שמוצג כאן:

let field = [GMSPlaceField.name, GMSPlaceField.photos]
// or
let field: GMSPlaceField = [.name, .photos]

אילוץ פתיחה

בדוגמה הבאה אפשר לראות שימוש ב-GMSPlaceField כסוג לא אופציונלי. הפעולה הזו תגרום לשגיאת קומפיילר ("לא ניתן לבטל את האריזה של ערך מסוג GMSPlaceField שאינו אופציונלי"):

// Before.
let field = GMSPlaceField(
    rawValue: GMSPlaceField.name.rawValue | GMSPlaceField.photos.rawValue
)!

כדי לפתור את הבעיה, צריך להשתמש ב-GMSPlaceField כסוג אופציונלי, כמו שמוצג כאן:

// After.
let field =  GMSPlaceField(
    rawValue: GMSPlaceField.name.rawValue | GMSPlaceField.photos.rawValue
)

אפשר גם להשתמש בתחביר של מערך, כמו שמוצג כאן:

let field = [GMSPlaceField.name, GMSPlaceField.photos]
// or
let field: GMSPlaceField = [.name, .photos]