Firebase ব্যবহার করে আপনি একটি ওয়েব অ্যাপ ডেভেলপ করছেন, তাই আপনার কাছে অপরিচিত ধারণা বা এমন ক্ষেত্র আসতে পারে যেখানে আপনার প্রোজেক্টের জন্য সঠিক সিদ্ধান্ত নিতে আরও তথ্যের প্রয়োজন। এই পৃষ্ঠার উদ্দেশ্য হল সেইসব প্রশ্নের উত্তর দেওয়া অথবা আরও জানার জন্য রিসোর্সের দিকে আপনাকে নির্দেশ করা।
এই পৃষ্ঠায় উল্লেখ করা হয়নি এমন কোনও বিষয় সম্পর্কে আপনার প্রশ্ন থাকলে, আমাদের কোনও একটি অনলাইন কমিউনিটি দেখুন। এছাড়াও, আমরা এই পৃষ্ঠায় সময় সময় নতুন বিষয় যোগ করব, তাই আপনি যে বিষয়ে জানতে চান সেটি যোগ করা হয়েছে কিনা তা দেখতে পরে আবার চেক করুন।
SDK ভার্সন: নেমস্পেস করা ও মডিউলার
Firebase ওয়েব অ্যাপের জন্য দুটি API সারফেস প্রদান করে:
- JavaScript - namespaced. এটি হল জাভাস্ক্রিপ্ট ইন্টারফেস যা Firebase বহু বছর ধরে বজায় রেখেছে এবং পুরনো Firebase অ্যাপ ব্যবহারকারী ওয়েব ডেভেলপারদের কাছে পরিচিত। namespaced API-তে নতুন ফিচার সংক্রান্ত সহায়তা পাওয়া যায় না, তাই বেশিরভাগ নতুন অ্যাপের ক্ষেত্রে modular API ব্যবহার করা উচিত।
- জাভাস্ক্রিপ্ট - মডিউলার। এই SDK মডিউলার অ্যাপ্রোচের উপর ভিত্তি করে তৈরি করা হয়েছে যা SDK-এর সাইজ কমায় এবং webpack বা Rollup-এর মতো আধুনিক জাভাস্ক্রিপ্ট বিল্ড টুলের সাহায্যে আরও বেশি দক্ষতা প্রদান করে।
মডুলার API বিল্ড টুলের সাথে ভালভাবে ইন্টিগ্রেট করে যা আপনার অ্যাপে ব্যবহার করা হচ্ছে না এমন কোড বাদ দেয়, এই প্রক্রিয়াটি "ট্রি-শেকিং" নামে পরিচিত। এই SDK-এর সাহায্যে তৈরি করা অ্যাপ অনেক কম সাইজের ফুটপ্রিন্ট থেকে সুবিধা পায়। namespaced API, মডিউল হিসেবে উপলভ্য হলেও, এর কোনও কঠোর মডিউলার স্ট্রাকচার নেই এবং এটি একই মাত্রায় সাইজ কমায় না।
যদিও বেশিরভাগ modular API, namespaced API-এর মতো একই প্যাটার্ন অনুসরণ করে,
কোডের সংগঠন আলাদা। সাধারণত, namespaced API
নেমস্পেস ও পরিষেবা প্যাটার্নের উপর ভিত্তি করে তৈরি করা হয়, অন্যদিকে modular API
আলাদা আলাদা ফাংশনের উপর ভিত্তি করে তৈরি করা হয়। যেমন, namespaced API-এর ডট-চেনিং, যেমন
firebaseApp.auth(), modular API-তে একটি getAuth() ফাংশন দ্বারা প্রতিস্থাপিত হয়
যা firebaseApp নেয় এবং একটি Authentication ইনস্ট্যান্স রিটার্ন করে।
এর অর্থ হল, মডিউলার অ্যাপ ডিজাইনের সুবিধা নিতে, namespaced API-এর মাধ্যমে তৈরি করা ওয়েব অ্যাপ রিফ্যাক্টর করতে হবে। আরও তথ্যের জন্য আপগ্রেড করার নির্দেশিকা দেখুন।
JavaScript - নতুন অ্যাপের জন্য modular API
আপনি Firebase-এর সাথে নতুন ইন্টিগ্রেশন শুরু করলে, SDK যোগ ও ইনিশিয়ালাইজ করার সময় modular API বেছে নিতে পারবেন।
অ্যাপ ডেভেলপ করার সময় মনে রাখবেন যে আপনার কোড মূলত ফাংশন-এর আশেপাশে সাজানো থাকবে। মডুলার API-তে, পরিষেবাগুলি প্রথম আর্গুমেন্ট হিসাবে পাস করা হয় এবং ফাংশনটি বাকি কাজ করার জন্য পরিষেবার বিবরণ ব্যবহার করে। যেমন:
import { getAuth, onAuthStateChanged } from "firebase/auth";
const auth = getAuth(firebaseApp);
onAuthStateChanged(auth, user => {
// Check for user status
});
আরও উদাহরণ ও বিবরণের জন্য, প্রতিটি প্রোডাক্ট এরিয়ার জন্য গাইড এবং মডিউলার API রেফারেন্স ডকুমেন্টেশন দেখুন।
আপনার অ্যাপে ওয়েব SDK যোগ করার উপায়
Firebase বেশিরভাগ Firebase প্রোডাক্টের জন্য জাভাস্ক্রিপ্ট লাইব্রেরি প্রদান করে, যার মধ্যে Remote Config, FCM এবং আরও অনেক কিছু অন্তর্ভুক্ত। আপনার ওয়েব অ্যাপে Firebase SDK কীভাবে যোগ করবেন তা নির্ভর করে আপনি অ্যাপের সাথে কী টুলিং ব্যবহার করছেন তার উপর (যেমন, মডিউল বান্ডলার)।
আপনি যেকোনও উপলভ্য লাইব্রেরি আপনার অ্যাপে যোগ করতে পারবেন, এর জন্য আপনাকে কাজ করে এমন পদ্ধতিগুলির মধ্যে একটি ব্যবহার করতে হবে:
- npm (মডিউল বান্ডলারের জন্য)
- CDN (কন্টেন্ট ডেলিভারি নেটওয়ার্ক)
সেট-আপ সংক্রান্ত বিস্তারিত নির্দেশাবলীর জন্য, আপনার JavaScript অ্যাপে Firebase যোগ করুন দেখুন। এই বিভাগের বাকি অংশে উপলভ্য বিকল্প থেকে বেছে নিতে আপনাকে সাহায্য করার জন্য তথ্য রয়েছে।
npm
Firebase npm প্যাকেজ (যার মধ্যে ব্রাউজার ও Node.js বান্ডেল, দুটিই অন্তর্ভুক্ত) ডাউনলোড করলে, আপনি Firebase SDK-এর একটি লোকাল কপি পাবেন, যা Node.js অ্যাপ, React Native বা Electron-এর মতো নন-ব্রাউজার অ্যাপ্লিকেশনের জন্য প্রয়োজন হতে পারে। ডাউনলোডে Node.js এবং React Native বান্ডেল অন্তর্ভুক্ত থাকে, যা কিছু প্যাকেজের জন্য বিকল্প হিসেবে কাজ করে। SSR ফ্রেমওয়ার্কের সার্ভার-সাইড রেন্ডারিং (SSR) ধাপের জন্য Node.js বান্ডেল প্রয়োজন।
webpack বা Rollup-এর মতো মডিউল বান্ডলারের সাথে npm ব্যবহার করলে, অব্যবহৃত কোড "ট্রি-শেক" করা এবং টার্গেট করা পলিফিল প্রয়োগ করার জন্য অপ্টিমাইজেশন বিকল্প পাওয়া যায়, যা আপনার অ্যাপের সাইজ ফুটপ্রিন্ট অনেক কমিয়ে দিতে পারে। এইসব ফিচার প্রয়োগ করলে, আপনার কনফিগারেশন এবং বিল্ড চেনে কিছু জটিলতা যোগ হতে পারে, তবে বিভিন্ন মূলধারার CLI টুল তা কমাতে সাহায্য করতে পারে। এইসব টুলের মধ্যে Angular, React, Vue, Next এবং অন্যান্য টুল অন্তর্ভুক্ত।
সংক্ষেপে:
- অ্যাপের সাইজ অপ্টিমাইজ করার জন্য মূল্যবান পরামর্শ দেয়
- মডিউল ম্যানেজ করার জন্য শক্তিশালী টুলিং উপলভ্য আছে
- Node.js-এর সাথে SSR-এর জন্য প্রয়োজন
CDN (কন্টেন্ট ডেলিভারি নেটওয়ার্ক)
Firebase-এর CDN-এ স্টোর করা লাইব্রেরি যোগ করা হল একটি সহজ SDK সেট-আপ পদ্ধতি যা অনেক ডেভেলপারের কাছে পরিচিত হতে পারে। SDK যোগ করার জন্য CDN ব্যবহার করলে, আপনার কোনও বিল্ড টুলের প্রয়োজন হবে না এবং আপনার বিল্ড চেইন মডিউল বান্ডলারের তুলনায় আরও সহজ এবং কাজ করার জন্য আরও সুবিধাজনক হতে পারে। আপনার অ্যাপের ইনস্টল করা সাইজ নিয়ে আপনি যদি বিশেষ চিন্তিত না হন এবং টাইপস্ক্রিপ্ট থেকে ট্রান্সপাইল করার মতো বিশেষ প্রয়োজনীয়তা না থাকে, তাহলে CDN একটি ভালো বিকল্প হতে পারে।
সংক্ষেপে:
- পরিচিত ও সহজ
- অ্যাপের সাইজ নিয়ে কোনও সমস্যা না থাকলে এটি উপযুক্ত
- আপনার ওয়েবসাইট বিল্ড টুল ব্যবহার না করলে এটি উপযুক্ত।
Firebase ওয়েব SDK ভেরিয়েন্ট
Firebase-এর ওয়েব SDK ব্রাউজার ও Node অ্যাপ্লিকেশন, দুটিতেই ব্যবহার করা যেতে পারে। তবে, Node এনভায়রনমেন্টে বেশ কিছু প্রোডাক্ট উপলভ্য নয়। কাজ করে এমন এনভায়রনমেন্টের তালিকা দেখুন।
কিছু প্রোডাক্ট SDK আলাদা ব্রাউজার ও Node ভেরিয়েন্ট প্রদান করে, যার প্রতিটি ESM ও CJS ফর্ম্যাটে প্রদান করা হয় এবং কিছু প্রোডাক্ট SDK এমনকি Cordova বা React Native ভেরিয়েন্টও প্রদান করে। আপনার টুলিং কনফিগারেশন বা এনভায়রনমেন্টের উপর ভিত্তি করে সঠিক ভেরিয়েন্ট প্রদান করার জন্য ওয়েব SDK কনফিগার করা হয় এবং বেশিরভাগ ক্ষেত্রে ম্যানুয়ালি বেছে নেওয়ার প্রয়োজন হয় না। সব SDK ভেরিয়েন্ট এমনভাবে ডিজাইন করা হয়েছে যাতে Node.js ডেস্কটপ বা IoT অ্যাপ্লিকেশনের মতো ব্যবহারকারীর অ্যাক্সেসের জন্য ওয়েব অ্যাপ বা ক্লায়েন্ট অ্যাপ তৈরি করতে সাহায্য করা যায়। আপনার লক্ষ্য যদি বিশেষ সুবিধা প্রাপ্ত এনভায়রনমেন্ট (যেমন সার্ভার) থেকে অ্যাডমিনিস্ট্রেটিভ অ্যাক্সেস সেট-আপ করা হয়, তাহলে Firebase Admin SDK ব্যবহার করুন।
বান্ডলার ও ফ্রেমওয়ার্কের মাধ্যমে এনভায়রনমেন্ট শনাক্তকরণ
npm ব্যবহার করে Firebase ওয়েব SDK ইনস্টল করলে, JavaScript এবং Node.js ভার্সন দুটিই ইনস্টল হয়ে যায়। আপনার অ্যাপ্লিকেশনের জন্য সঠিক বান্ডেল চালু করতে প্যাকেজটি বিস্তারিত পরিবেশ শনাক্তকরণ প্রদান করে।
আপনার কোড Node.js require স্টেটমেন্ট ব্যবহার করলে, SDK Node-নির্দিষ্ট বান্ডেল খুঁজে পায়। অন্যথায়, আপনার package.json ফাইলে (যেমন, main,
browser, বা module) সঠিক এন্ট্রি পয়েন্ট ফিল্ড শনাক্ত করার জন্য আপনার বান্ডলারের সেটিংস সঠিকভাবে কনফিগার করা থাকতে হবে। SDK-এর সাথে রানটাইম সমস্যা হলে, আপনার এনভায়রনমেন্টের জন্য সঠিক ধরনের বান্ডেলকে অগ্রাধিকার দেওয়ার জন্য আপনার বান্ডলার কনফিগার করা আছে কিনা তা চেক করে দেখুন।
Firebase কনফিগারেশন অবজেক্ট সম্পর্কে জানুন
আপনার অ্যাপে Firebase শুরু করতে, আপনাকে অ্যাপের Firebase কনফিগারেশন প্রদান করতে হবে। আপনি যেকোনও সময় আপনার Firebase কনফিগারেশন অবজেক্ট পেতে পারেন।
আমরা আপনার কনফিগ অবজেক্ট ম্যানুয়ালি এডিট করার সাজেশন দিই না, বিশেষ করে নিম্নলিখিত প্রয়োজনীয় "Firebase বিকল্প":
apiKey,projectIdএবংappID। আপনি যদি এই প্রয়োজনীয় "Firebase বিকল্প"-এর জন্য ভুল বা অনুপস্থিত ভ্যালু সহ আপনার অ্যাপ শুরু করেন, তাহলে আপনার অ্যাপের ব্যবহারকারীরা গুরুতর সমস্যার সম্মুখীন হতে পারেন। এর ব্যতিক্রম হলauthDomain, যা signInWithRedirect ব্যবহার করার পেশাদার পদ্ধতি অনুসরণ করে আপডেট করা যেতে পারে।আপনার Firebase প্রোজেক্টে Google Analytics চালু করলে, আপনার কনফিগারেশন অবজেক্টে
measurementIdফিল্ড থাকে। Analytics শুরু করা যাক পৃষ্ঠায় এই ফিল্ড সম্পর্কে আরও জানুন।আপনি Firebase ওয়েব অ্যাপ তৈরি করার পরে Google Analytics বা Realtime Database চালু করলে, আপনার অ্যাপে ব্যবহার করা Firebase কনফিগারেশন অবজেক্টটি সংশ্লিষ্ট কনফিগারেশন ভ্যালু (যথাক্রমে
measurementIdএবংdatabaseURL) দিয়ে আপডেট করা হয়েছে কিনা তা ভাল করে দেখে নিন। আপনি যেকোনও সময় আপনার Firebase কনফিগারেশন অবজেক্ট পেতে পারবেন।
সব পরিষেবা চালু করা আছে এমন কনফিগারেশন অবজেক্টের ফর্ম্যাট এখানে দেওয়া হল (এইসব ভ্যালু অটোমেটিক পূরণ করা হয়):
var firebaseConfig = { apiKey: "API_KEY", authDomain: "PROJECT_ID.firebaseapp.com", // The value of `databaseURL` depends on the location of the database databaseURL: "https://DATABASE_NAME.firebaseio.com", projectId: "PROJECT_ID", // The value of `storageBucket` depends on when you provisioned your default bucket (learn more) storageBucket: "", messagingSenderId: "SENDER_ID", appId: "APP_ID", // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field measurementId: "G-MEASUREMENT_ID", }; PROJECT_ID.firebasestorage.app
উপলভ্য লাইব্রেরি
অতিরিক্ত সেট-আপ বিকল্প
Firebase SDK (CDN থেকে) লোড হতে দেরি হওয়া
পুরো পৃষ্ঠা লোড না হওয়া পর্যন্ত আপনি Firebase SDK অন্তর্ভুক্ত করার প্রসেস পিছিয়ে দিতে পারেন। আপনি যদি <script type="module">-এর সাথে মডিউলার API CDN স্ক্রিপ্ট ব্যবহার করেন,
তাহলে এটি ডিফল্ট অ্যাকশন। আপনি যদি মডিউল হিসেবে নেমস্পেস করা CDN স্ক্রিপ্ট ব্যবহার করেন, তাহলে লোডিং পিছিয়ে দিতে এইসব ধাপ সম্পূর্ণ করুন:
Firebase SDK-এর জন্য প্রতিটি
scriptট্যাগে একটিdeferফ্ল্যাগ যোগ করুন, তারপর দ্বিতীয় স্ক্রিপ্ট ব্যবহার করে Firebase-এর ইনিশিয়ালাইজেশন স্থগিত করুন, যেমন:<script defer src="https://www.gstatic.com/firebasejs/8.10.1/firebase-app.js"></script> <script defer src="https://www.gstatic.com/firebasejs/8.10.1/firebase-auth.js"></script> <script defer src="https://www.gstatic.com/firebasejs/8.10.1/firebase-firestore.js"></script> // ... <script defer src="./init-firebase.js"></script>একটি
init-firebase.jsফাইল তৈরি করুন, তারপর ফাইলে নিম্নলিখিত তথ্য অন্তর্ভুক্ত করুন:// TODO: Replace the following with your app's Firebase configuration var firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig);
একটি অ্যাপে একাধিক Firebase প্রোজেক্ট ব্যবহার করা
বেশিরভাগ ক্ষেত্রে, আপনাকে শুধুমাত্র একটি ডিফল্ট অ্যাপে Firebase শুরু করতে হবে। আপনি সেই অ্যাপ থেকে দুটি সমতুল্য উপায়ে Firebase অ্যাক্সেস করতে পারেন:
Web
import { initializeApp } from "firebase/app"; import { getStorage } from "firebase/storage"; import { getFirestore } from "firebase/firestore"; // Initialize Firebase with a "default" Firebase project const defaultProject = initializeApp(firebaseConfig); console.log(defaultProject.name); // "[DEFAULT]" // Option 1: Access Firebase services via the defaultProject variable let defaultStorage = getStorage(defaultProject); let defaultFirestore = getFirestore(defaultProject); // Option 2: Access Firebase services using shorthand notation defaultStorage = getStorage(); defaultFirestore = getFirestore();
Web
// Initialize Firebase with a "default" Firebase project const defaultProject = firebase.initializeApp(firebaseConfig); console.log(defaultProject.name); // "[DEFAULT]" // Option 1: Access Firebase services via the defaultProject variable let defaultStorage = defaultProject.storage(); let defaultFirestore = defaultProject.firestore(); // Option 2: Access Firebase services using shorthand notation defaultStorage = firebase.storage(); defaultFirestore = firebase.firestore();
তবে, কখনও কখনও আপনাকে একই সাথে একাধিক Firebase প্রোজেক্ট অ্যাক্সেস করতে হতে পারে। যেমন, আপনি হয়ত একটি Firebase প্রোজেক্টের ডেটাবেস থেকে ডেটা পড়তে চান, কিন্তু অন্য একটি Firebase প্রোজেক্টে ফাইল স্টোর করতে চান। অথবা আপনি হয়ত একটি প্রোজেক্ট যাচাইকরণ করতে চান এবং দ্বিতীয় প্রোজেক্টটি যাচাইকরণ করতে চান না।
Firebase JavaScript SDK আপনাকে একই সময়ে একটি অ্যাপে একাধিক Firebase প্রোজেক্ট শুরু ও ব্যবহার করতে দেয়, যেখানে প্রতিটি প্রোজেক্ট নিজস্ব Firebase কনফিগারেশন তথ্য ব্যবহার করে।
Web
import { initializeApp, getApp } from "firebase/app"; import { getStorage } from "firebase/storage"; import { getFirestore } from "firebase/firestore"; // Initialize Firebase with a default Firebase project initializeApp(firebaseConfig); // Initialize Firebase with a second Firebase project const otherProject = initializeApp(otherProjectFirebaseConfig, "other"); console.log(getApp().name); // "[DEFAULT]" console.log(otherProject.name); // "otherProject" // Use the shorthand notation to access the default project's Firebase services const defaultStorage = getStorage(); const defaultFirestore = getFirestore(); // Use the otherProject variable to access the second project's Firebase services const otherStorage = getStorage(otherProject); const otherFirestore = getFirestore(otherProject);
Web
// Initialize Firebase with a default Firebase project firebase.initializeApp(firebaseConfig); // Initialize Firebase with a second Firebase project const otherProject = firebase.initializeApp(otherProjectFirebaseConfig, "other"); console.log(firebase.app().name); // "[DEFAULT]" console.log(otherProject.name); // "otherProject" // Use the shorthand notation to access the default project's Firebase services const defaultStorage = firebase.storage(); const defaultFirestore = firebase.firestore(); // Use the otherProject variable to access the second project's Firebase services const otherStorage = otherProject.storage(); const otherFirestore = otherProject.firestore();
ডেভেলপমেন্টের জন্য লোকাল ওয়েব সার্ভার রান করুন
আপনি কোনও ওয়েব অ্যাপ তৈরি করলে, Firebase JavaScript SDK-এর কিছু অংশের জন্য লোকাল ফাইল সিস্টেমের পরিবর্তে সার্ভার থেকে ওয়েব অ্যাপ পরিবেশন করতে হবে। আপনি লোকাল সার্ভার রান করতে Firebase CLI ব্যবহার করতে পারবেন।
আপনি যদি আগেই আপনার অ্যাপের জন্য Firebase Hosting সেট-আপ করে থাকেন, তাহলে আপনি হয়ত ইতিমধ্যেই নিচের কয়েকটি ধাপ সম্পূর্ণ করে ফেলেছেন।
আপনার ওয়েব অ্যাপ পরিষেবা দিতে, আপনি Firebase CLI, একটি কমান্ড-লাইন টুল ব্যবহার করবেন।
কীভাবে CLI ইনস্টল করবেন অথবা এর লেটেস্ট ভার্সনে আপডেট করবেন তা জানতে Firebase CLI ডকুমেন্টেশন দেখুন।
আপনার Firebase প্রোজেক্ট শুরু করুন। আপনার লোকাল অ্যাপ ডিরেক্টরির রুট থেকে নিম্নলিখিত কমান্ড রান করুন:
firebase init
ডেভেলপমেন্টের জন্য লোকাল সার্ভার চালু করুন। আপনার লোকাল অ্যাপ ডিরেক্টরির রুট থেকে নিম্নলিখিত কমান্ড রান করুন:
firebase serve
Firebase জাভাস্ক্রিপ্ট SDK-এর জন্য ওপেন সোর্স রিসোর্স
Firebase ওপেন সোর্স ডেভেলপমেন্টকে সমর্থন করে এবং আমরা কমিউনিটির অবদান ও মতামতকে উৎসাহিত করি।
Firebase JavaScript SDK
বেশিরভাগ Firebase জাভাস্ক্রিপ্ট SDK আমাদের পাবলিক Firebase GitHub রিপোজিটরিতে ওপেন সোর্স লাইব্রেরি হিসেবে ডেভেলপ করা হয়।
কুইকস্টার্ট স্যাম্পেল
Firebase, ওয়েব প্ল্যাটফর্মে বেশিরভাগ Firebase API-এর জন্য কুইকস্টার্ট স্যাম্পেলের একটি কালেকশন বজায় রাখে। আমাদের পাবলিক Firebase GitHub কুইকস্টার্ট রিপোজিটরিতে এই কুইকস্টার্টগুলি খুঁজুন। Firebase SDK ব্যবহার করার জন্য আপনি এইসব কুইকস্টার্টকে উদাহরণ কোড হিসেবে ব্যবহার করতে পারবেন।