পরীক্ষামূলক Dart SDK ব্যবহার করা শুরু করুন

Cloud Functions for Firebase-এ এক্সপেরিমেন্টাল Dart সাপোর্ট আপনাকে Flutter ও Dart-এর সাহায্যে ফুল-স্ট্যাক অ্যাপ তৈরি করতে দেয়। নতুন Firebase Admin Dart SDK-এর মাধ্যমে অন্যান্য Firebase পরিষেবার সাথে যোগাযোগ করুন।

Dart ফাংশন ব্যবহার শুরু করতে, এই গাইডে দেওয়া সেট-আপ সংক্রান্ত টাস্কগুলি সম্পূর্ণ করুন এবং তারপরে Dart HTTP এবং কল করা যায় এমন ফাংশন এক্সপ্লোর করা চালিয়ে যান।

সতর্কতা: এই ফিচারটি পরীক্ষামূলক এবং কোনও বিজ্ঞপ্তি ছাড়াই পরিবর্তন হতে পারে।

পূর্বশর্ত

• Dart SDK 3.9 বা তার পরের যেকোনও ভার্সন
• Firebase CLI (ভার্সন 15.15.0 বা তার পরবর্তী যেকোনও ভার্সন)

--version ফ্ল্যাগ সহ Cloud Functions for Firebase-এ Dart-কে সাপোর্ট করে এমন Firebase CLI-এর ভার্সন আপনার কাছে আছে কিনা তা চেক করুন:

 `firebase --version`

মনে রাখবেন: আপনি যেকোনও Firebase প্রোজেক্টের মাধ্যমে স্থানীয়ভাবে ফাংশন এমুলেট করতে পারবেন, তবে ফাংশন ডিপ্লয় করতে, আপনার প্রোজেক্টকে অবশ্যই Blaze প্রাইসিং প্ল্যানে থাকতে হবে। Cloud Functions-এর দাম দেখুন।

Firebase CLI-তে এক্সপেরিমেন্ট চালু করুন

firebase experiments:enable dartfunctions

আপনার প্রোজেক্ট শুরু করুন

1. রান করুন:

   firebase init functions
   

2. ভাষা হিসেবে Dart বেছে নিন।

3. "আপনি কি এখন ডিপেন্ডেন্সি ইনস্টল করতে চান?" জিজ্ঞাসা করা হলে, "হ্যাঁ" উত্তর দিন।

আপনার ফাংশন কোড দেখুন

functions/bin/server.dart-এ (বা আপনার এন্ট্রি পয়েন্টে) জেনারেট করা কোড দেখুন। এই কোডটি একটি সাধারণ HTTP ফাংশন প্রদর্শন করে।

মনে রাখবেন, স্যাম্পেল কোড HttpsOptions কনস্ট্রাক্টরের মাধ্যমে helloWorld ফাংশনের জন্য ইনস্ট্যান্সের সর্বাধিক সংখ্যা ১০-এ সেট করে। আপনি রানটাইম বিকল্প সেট করুন থেকে রানটাইম বিকল্প সম্পর্কে আরও জানতে পারবেন।

স্থানীয়ভাবে পরীক্ষা করুন

firebase emulators:start

Local Emulator Suite বুট আপ হয়ে গেলে, আপনি functions http function initialized (http://127.0.0.1:5001/<url>)-এর মতো লগ লাইন দেখতে পাবেন। আপনার লোকাল এমুলেট করা Dart ফাংশন কল করতে, আপনার ব্রাউজারে সেই URL লোড করুন।

আপনি Dart কোড এডিট করলে, Firebase Local Emulator Suite পরিবর্তন শনাক্ত করবে এবং অটোমেটিক আপনার ফাংশন রিলোড করবে।

মনে রাখবেন: এই পরীক্ষামূলক রিলিজে Dart-এর জন্য শুধুমাত্র HTTP ট্রিগার ( onRequest ) এবং HTTP কল করা যায় এমন (onCall) ট্রিগার কাজ করে। অন্যান্য ট্রিগার ইমুলেটরে রান করা যেতে পারে, তবে ডিপ্লয় করা যাবে না। আরও তথ্যের জন্য সীমাবদ্ধতা দেখুন।

ডিপ্লয় করুন

firebase deploy --only functions

Dart-এর জন্য ডিপ্লয়মেন্ট প্রসেস Node.js বা Python ফাংশনের থেকে আলাদা। Cloud Build-এ তৈরি করার জন্য আপনার সোর্স কোড আপলোড করার পরিবর্তে, Firebase CLI আপনার ডেভেলপমেন্ট মেশিনে একটি Dart কম্পাইল স্টেপ রান করে এবং জেনারেট করা বাইনারি সরাসরি Cloud Run ফাংশনে আপলোড করে।

ডেপ্লয়মেন্ট সম্পূর্ণ হলে, আপনি Function URL (hello-world(us-central1)): https://hello-world-<random-hash>.<region>.run.app-এর মতো একটি লগ লাইন দেখতে পাবেন

আপনার নতুন ডিপ্লয় করা Dart ফাংশন কল করতে, আপনার ব্রাউজারে সেই URL লোড করুন।

পরবর্তী ধাপ

• সর্বনিম্ন ইনস্ট্যান্সের মতো কনফিগারেশন বিকল্প সেট করুন।
• HTTP ফাংশন এবং কল করা যায় এমন ফাংশন সম্পর্কে আরও জানুন।
• Dart Functions codelab Dart Functions codelab অনুসরণ করুন
• আপনার ফাংশন থেকে Cloud Firestore-এর মতো অন্যান্য Firebase পরিষেবার সাথে ইন্টার‍্যাক্ট করতে এক্সপেরিমেন্টাল Dart Admin SDK ব্যবহার করুন
• onRequest HTTP ফাংশন ছাড়াও, আপনি onCall স্যাম্পেল বা onCallস্ট্রিমিং সহ স্যাম্পেল ব্যবহার করে দেখতে পারেন যাতে সরাসরি আপনার অ্যাপ থেকে ফাংশন কল করা যায় (কলিং পদ্ধতি সংক্রান্ত বিশেষ সীমাবদ্ধতা মনে রাখবেন)।

সীমাবদ্ধতা

• onCall ট্রিগার ডিপ্লয় করা যেতে পারে, কিন্তু ক্লায়েন্ট SDK থেকে httpsCallable-এর মতো পদ্ধতি ব্যবহার করে কল করা যাবে না, যা নাম দিয়ে ফাংশন শনাক্ত করে। পরিবর্তে আপনি httpsCallableFromURL-এর মতো পদ্ধতি ব্যবহার করতে পারেন এবং আপনার ফাংশনের সম্পূর্ণ Cloud Run URL পাস করতে পারেন।
• Firestore ট্রিগারের মতো অন্যান্য ট্রিগার লোকাল ইমুলেটর সুইটে রান করা যেতে পারে, কিন্তু ডেপ্লয় করা যাবে না।
• এক্সপেরিমেন্টাল রিলিজের সময় Firebase কনসোল Dart ফাংশন দেখায় না। পরিবর্তে, আপনি Cloud কনসোল-এর Cloud Run ফাংশন পৃষ্ঠায় Dart ফাংশন দেখতে পারেন।

Dart ফাংশন নিয়ে কাজ করার সময় কোনও সমস্যা দেখতে পেলে, পরীক্ষামূলক Dart SDK উন্নত ও প্রসারিত করতে আমাদের সাহায্য করার জন্য টিমকে রিপোর্ট পাঠান।