एक्सपेरिमेंट के तौर पर उपलब्ध Dart SDK का इस्तेमाल शुरू करना

Cloud Functions for Firebase में Dart के लिए एक्सपेरिमेंट के तौर पर उपलब्ध सहायता की मदद से, Flutter और Dart का इस्तेमाल करके फ़ुल-स्टैक ऐप्लिकेशन बनाए जा सकते हैं. नए Firebase Admin Dart SDK की मदद से, Firebase की अन्य सेवाओं के साथ कम्यूनिकेट करें.

Dart फ़ंक्शन का इस्तेमाल शुरू करने के लिए, इस गाइड में दिए गए सेटअप टास्क पूरे करें. इसके बाद, Dart एचटीटीपी और कॉल किए जा सकने वाले फ़ंक्शन के बारे में जानें.

चेतावनी: यह सुविधा एक्सपेरिमेंट के तौर पर उपलब्ध है. इसमें बिना किसी सूचना के बदलाव किया जा सकता है.

ज़रूरी शर्तें

• Dart SDK 3.9 या इसके बाद का वर्शन
• Firebase सीएलआई (वर्शन 15.15.0 या इसके बाद का वर्शन)

देखें कि आपके पास Firebase सीएलआई का ऐसा वर्शन हो जो Cloud Functions for Firebase में Dart के साथ काम करता हो. इसके लिए, --version फ़्लैग का इस्तेमाल करें:

 `firebase --version`

ध्यान दें: किसी भी Firebase प्रोजेक्ट के साथ, फ़ंक्शन को स्थानीय तौर पर एम्युलेट किया जा सकता है. हालांकि, फ़ंक्शन को डिप्लॉय करने के लिए, आपका प्रोजेक्ट ब्लेज़ प्लान पर होना चाहिए. Cloud Functions की कीमत देखें.

Firebase सीएलआई में एक्सपेरिमेंट चालू करें

firebase experiments:enable dartfunctions

अपना प्रोजेक्ट शुरू करना

1. रन:

   firebase init functions
   

2. अपनी भाषा के तौर पर Dart चुनें.

3. "क्या आपको डिपेंडेंसी अभी इंस्टॉल करनी हैं?" पूछे जाने पर, "हां" जवाब दें.

फ़ंक्शन कोड देखना

functions/bin/server.dart में जनरेट किया गया कोड या एंट्री पॉइंट देखें. यह कोड, एक आसान एचटीटीपी फ़ंक्शन दिखाता है.

ध्यान दें कि सैंपल कोड, HttpsOptions कंस्ट्रक्टर का इस्तेमाल करके, helloWorld फ़ंक्शन के लिए इंस्टेंस की ज़्यादा से ज़्यादा संख्या को 10 पर सेट करता है. रनटाइम के विकल्प सेट करें में जाकर, रनटाइम के विकल्पों के बारे में ज़्यादा जानें.

लोकल तौर पर टेस्ट करना

firebase emulators:start

Local Emulator Suite के चालू होने के बाद, आपको functions http function initialized (http://127.0.0.1:5001/<url>) जैसी लॉग लाइन दिखेगी. अपने ब्राउज़र में उस यूआरएल को लोड करें, ताकि स्थानीय तौर पर एम्युलेट किए गए Dart फ़ंक्शन को कॉल किया जा सके.

Dart कोड में बदलाव करने पर, Firebase Local Emulator Suite बदलाव का पता लगा लेगा और आपके फ़ंक्शन को अपने-आप फिर से लोड कर देगा.

ध्यान दें: एक्सपेरिमेंट के तौर पर उपलब्ध इस रिलीज़ में, Dart के लिए सिर्फ़ एचटीटीपी ट्रिगर ( onRequest ) और एचटीटीपी कॉलेबल (onCall) ट्रिगर काम करते हैं. अन्य ट्रिगर एम्युलेटर में चलाए जा सकते हैं, लेकिन उन्हें डिप्लॉय नहीं किया जा सकता. ज़्यादा जानकारी के लिए, सीमाएं देखें.

डिप्लॉय करें

firebase deploy --only functions

Dart के लिए डिप्लॉयमेंट की प्रोसेस, Node.js या Python फ़ंक्शन से अलग होती है. Cloud Build में सोर्स कोड अपलोड करने के बजाय, Firebase सीएलआई आपकी डेवलपमेंट मशीन पर Dart कंपाइल स्टेप चलाता है. साथ ही, जनरेट की गई बाइनरी को सीधे Cloud Run फ़ंक्शन पर अपलोड करता है.

डिप्लॉयमेंट पूरा होने पर, आपको Function URL (hello-world(us-central1)): https://hello-world-<random-hash>.<region>.run.app जैसी लॉग लाइन दिखेगी

नए Dart फ़ंक्शन को कॉल करने के लिए, उस यूआरएल को अपने ब्राउज़र में लोड करें.

अगले चरण

• कम से कम इंस्टेंस जैसे कॉन्फ़िगरेशन विकल्प सेट करें.
• एचटीटीपी फ़ंक्शन और कॉल किए जा सकने वाले फ़ंक्शन के बारे में ज़्यादा जानें.
• Dart फ़ंक्शन कोडलैब Dart फ़ंक्शन कोडलैब को फ़ॉलो करें
• अपने फ़ंक्शन से Cloud Firestore जैसी अन्य Firebase सेवाओं के साथ इंटरैक्ट करने के लिए, एक्सपेरिमेंट के तौर पर उपलब्ध Dart Admin SDK का इस्तेमाल करें
• onRequest एचटीटीपी फ़ंक्शन के अलावा, onCall सैंपल या स्ट्रीमिंग के साथ onCall सैंपल को आज़माया जा सकता है. इससे सीधे अपने ऐप्लिकेशन से फ़ंक्शन कॉल किए जा सकते हैं. हालांकि, कॉल करने के तरीके से जुड़ी खास सीमा का ध्यान रखें.

सीमाएं

• onCall ट्रिगर को डिप्लॉय किया जा सकता है. हालांकि, इसे क्लाइंट एसडीके से कॉल नहीं किया जा सकता. इसके लिए, httpsCallable जैसे तरीकों का इस्तेमाल किया जा सकता है. ये तरीके, फ़ंक्शन को नाम से पहचानते हैं. इसके बजाय, httpsCallableFromURL जैसे तरीकों का इस्तेमाल किया जा सकता है. साथ ही, अपने फ़ंक्शन का पूरा Cloud Run यूआरएल पास किया जा सकता है.
• Firestore ट्रिगर जैसे अन्य ट्रिगर, लोकल एमुलेटर सुइट में चलाए जा सकते हैं. हालांकि, उन्हें डिप्लॉय नहीं किया जा सकता.
• Firebase कंसोल, एक्सपेरिमेंट के तौर पर रिलीज़ किए गए Dart फ़ंक्शन नहीं दिखाता. इसके बजाय, Dart फ़ंक्शन को Cloud कंसोल के Cloud Run फ़ंक्शन पेज पर देखा जा सकता है.

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