GMSPlaceField को NS_OPTIONS में माइग्रेट करना

iOS के लिए Places SDK के वर्शन 4.0.0 से, GMSPlaceField टाइप अब NS_OPTIONS मैक्रो का इस्तेमाल करता है. SDK के 3.x वर्शन में GMSPlaceField को NS_ENUM के तौर पर इस्तेमाल किया जाता है. ये वर्शन अब भी काम करते हैं.

  • अगर Objective-C का इस्तेमाल किया जा रहा है: तो कोई असर नहीं पड़ेगा. GMSPlaceField का इस्तेमाल पहले की तरह जारी रखा जा सकता है.

  • अगर Swift का इस्तेमाल किया जा रहा है, तो: अगर कंस्ट्रक्टर के तौर पर GMSPlaceField(rawValue:) सिंटैक्स का इस्तेमाल किया जा रहा है, तो आपका कोड काम नहीं करेगा. एसडीके के पुराने वर्शन, इसे वैकल्पिक GMSPlaceField? के तौर पर दिखाते थे. 4.0.0 और इसके बाद के वर्शन, GMSPlaceField की वैल्यू को गैर-ज़रूरी के तौर पर दिखाते हैं. हालांकि, इस वैल्यू पर किए गए सभी ऑपरेशन (जैसे कि शर्त के हिसाब से जांच करना या फ़ोर्स अनरैप) काम नहीं करेंगे. इसके अलावा, अब GMSPlaceField को जोड़ने के लिए, कलेक्शन सिंटैक्स का इस्तेमाल किया जा सकता है

कोड माइग्रेट करना

Swift में, कुछ कंडिशनल अनरैपिंग या फ़ोर्स अनरैपिंग सिंटैक्स काम नहीं करेंगे. यहां दिए गए उदाहरणों में, इन समस्याओं को कैसे ठीक करें, यह बताया गया है. साथ ही, GMSPlaceField का एलान करने के लिए, अरे सिंटैक्स का इस्तेमाल करने का तरीका भी बताया गया है:

कंडिशनल अनरैपिंग

नीचे दिए गए उदाहरण में, if का इस्तेमाल करके GMSPlaceField कलेक्शन बनाने का तरीका बताया गया है. इसके लिए, शर्त के साथ अनरैप करना ज़रूरी है. इससे कंपाइलर में गड़बड़ी होगी ("कंडिशनल बाइंडिंग के लिए इनिशलाइज़र का टाइप Optional होना चाहिए, न कि 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 को गैर-ज़रूरी टाइप के तौर पर इस्तेमाल करने के बारे में बताया गया है. इससे कंपाइलर की गड़बड़ी होगी ("Cannot force unwrap value of non-optional type 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]