मुख्य मॉड्यूल में, Swift एक्सटेंशन के एपीआई इस्तेमाल करने के लिए माइग्रेट करें

हम अपने Swift एक्सटेंशन SDK टूल को मुख्य SDK टूल में मर्ज कर रहे हैं, ताकि Swift-Native API को ज़्यादा से ज़्यादा लोगों के लिए उपलब्ध कराया जा सके. साथ ही, आने वाले समय में Swift की नई लैंग्वेज सुविधाओं के साथ काम करने की हमारी क्षमता को बढ़ाया जा सकेगा. हम जो बदलाव कर रहे हैं और उनसे आपके प्रोजेक्ट पर होने वाले संभावित असर को नीचे बताया गया है.

क्या बदल रहा है?

Apple SDK टूल के लिए Firebase 10.17.0 के साथ शुरुआत करते हुए, Swift एक्सटेंशन SDK टूल को उनसे जुड़े मुख्य SDK टूल के साथ मर्ज कर दिया गया है. उदाहरण के लिए, FirebaseFirestoreSwift मॉड्यूल के सभी एपीआई को FirebaseFirestore में जोड़ा गया है. इसलिए, अब आपको उन एपीआई को ऐक्सेस करने के लिए, FirebaseFirestoreSwift मॉड्यूल को इंपोर्ट करने की ज़रूरत नहीं है.

सभी Swift एक्सटेंशन अब मुख्य मॉड्यूल का हिस्सा हैं, इसलिए एक्सटेंशन SDK टूल की अब ज़रूरत नहीं है और इन्हें बंद कर दिया गया है. Swift एक्सटेंशन SDK टूल को शामिल करने या इस्तेमाल करने पर, कंपाइलर चेतावनी दी जाएगी. साथ ही, फ़रवरी 2024 से हम Swift एक्सटेंशन को पूरी तरह से रिलीज़ करना बंद कर देंगे.

★ ध्यान दें: Swift एक्सटेंशन के मौजूदा या पहले रिलीज़ किए गए वर्शन अब भी काम करेंगे. हालांकि, हमारा सुझाव है कि आप अपने ऐप्लिकेशन को मुख्य मॉड्यूल से स्विफ़्ट एपीआई इस्तेमाल करने के लिए माइग्रेट करें, ताकि आपको सुधार मिलते रहें. साथ ही, बदलावों और नई सुविधाओं का फ़ायदा मिल सके.

इस बदलाव के लिए अहम तारीखें

अक्टूबर 2023 में

Swift एक्सटेंशन SDK टूल को मुख्य SDK टूल के साथ मर्ज कर दिया गया है और फिर उन्हें मुख्य SDK टूल के तौर पर हटा दिया गया है. इस बदलाव के बारे में बताने वाले वर्शन 10.17.0 के लिए प्रॉडक्ट की जानकारी देखें.

अब मुख्य SDK टूल से सीधे Swift एक्सटेंशन SDK API का इस्तेमाल किया जा सकता है. हालांकि, अगला मेजर वर्शन रिलीज़ होने तक, एक्सटेंशन SDK टूल का इस्तेमाल किया जा सकेगा. हालांकि, इस्तेमाल किए जाने पर, SDK टूल के इस्तेमाल पर रोक लगाने की चेतावनी दी जाएगी.

फ़रवरी 2024 की शुरुआत से

हम Swift एक्सटेंशन के नए वर्शन रिलीज़ करना बंद कर देंगे. साथ ही, हम Firebase के Package.swift से Swift एक्सटेंशन हटा देंगे. पुराने वर्शन काम करते रहेंगे, लेकिन अपडेट नहीं मिलेंगे.

मुख्य मॉड्यूल से स्विफ़्ट-नेटिव एपीआई इस्तेमाल करने के लिए माइग्रेट करने का तरीका

अगर Swift एक्सटेंशन SDK टूल का इस्तेमाल नहीं किया जा रहा है, तो आपको कुछ करने की ज़रूरत नहीं है. अगर स्विफ़्ट एक्सटेंशन SDK टूल का इस्तेमाल किया जाता है, तो अपने प्रोजेक्ट में ये बदलाव करें.

फ़ाइल फ़ोल्डर में बदलाव

Swift पैकेज मैनेजर

Firebase को 10.17.0 के बाद के वर्शन पर अपडेट करने के बाद, अपने टारगेट की सेटिंग के 'सामान्य' टैब में फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किए गए कॉन्टेंट सेक्शन पर जाएं. इसके बाद, Swift एक्सटेंशन SDK टूल (जैसे कि FirebaseFirestoreSwift) हटाएं.

CocoaPods

Firebase को 10.17.0 और इसके बाद के वर्शन पर अपडेट करने के बाद, Podfile पर जाएं और अपने टारगेट के लिए फ़्रेमवर्क सेक्शन जोड़ने के लिए, अपने प्रोजेक्ट की डिपेंडेंसी से जुड़ी लाइन हटा दें. साथ ही, Swift एक्सटेंशन SDK (जैसे कि पॉड FirebaseFirestoreSwift) हटाएं. इसके बाद, pod install कमांड को फिर से चलाएं.

ज़िप डिस्ट्रिब्यूशन और कार्थेज

Firebase को 10.17.0 के बाद के वर्शन पर अपडेट करने के बाद, अपने प्रोजेक्ट में मौजूद किसी भी Swift एक्सटेंशन xcframeworks को हटा दें (जैसे कि FirebaseFirestoreSwift.xcframework).

सोर्स कोड में हुए बदलाव

पहले इस्तेमाल किए गए सभी Swift एक्सटेंशन SDK टूल के लिए, ये कार्रवाइयां करें:

Swift एक्सटेंशन SDK टूल से जुड़े सभी इंपोर्ट स्टेटमेंट मिटाएं. अगर मुख्य SDK टूल को अलग से इंपोर्ट नहीं किया गया था, तो आपको लाइन के आखिर में मौजूद Swift को मिटाकर, Swift एक्सटेंशन इंपोर्ट की जगह मुख्य SDK टूल से इंपोर्ट करने की सुविधा को इंपोर्ट करना होगा.
अगर आपने किसी भी Swift एक्सटेंशन के SDK टूल टाइप का रेफ़रंस देने के लिए, Swift के साफ़-मॉड्यूल नेमपैसिंग का इस्तेमाल किया है, तो आपको उनकी जगह मुख्य SDK टूल का इस्तेमाल करना होगा. उदाहरण के लिए, FirebaseFirestoreSwift.QueryPredicate का नाम बदलकर FirebaseFirestore.QueryPredicate करना होगा.