Firebase را به پروژه جاوا اسکریپت خود اضافه کنید

برای استفاده از Firebase JavaScript SDK در برنامه وب خود یا به عنوان یک کلاینت برای دسترسی کاربر نهایی، به عنوان مثال، در یک برنامه دسکتاپ Node.js یا IoT، این راهنما را دنبال کنید.

مرحله ۱ : یک پروژه Firebase ایجاد کنید و برنامه خود را ثبت کنید

قبل از اینکه بتوانید Firebase را به برنامه جاوا اسکریپت خود اضافه کنید، باید یک پروژه Firebase ایجاد کنید و برنامه خود را در آن پروژه ثبت کنید. وقتی برنامه خود را در Firebase ثبت می‌کنید، یک شیء پیکربندی Firebase دریافت خواهید کرد که برای اتصال برنامه خود به منابع پروژه Firebase خود از آن استفاده خواهید کرد.

برای کسب اطلاعات بیشتر در مورد پروژه‌های فایربیس و بهترین شیوه‌ها برای افزودن برنامه‌ها به پروژه‌ها، به بخش «درک پروژه‌های فایربیس» مراجعه کنید.

اگر از قبل پروژه جاوا اسکریپت ندارید و فقط می‌خواهید یکی از محصولات فایربیس را امتحان کنید، می‌توانید یکی از نمونه‌های شروع سریع ما را دانلود کنید.

مرحله 2 : نصب SDK و مقداردهی اولیه Firebase

این صفحه دستورالعمل‌های راه‌اندازی API ماژولار Firebase JS SDK را شرح می‌دهد که از فرمت ماژول جاوا اسکریپت استفاده می‌کند.

این گردش کار از npm استفاده می‌کند و به module bundlerها یا ابزارهای چارچوب جاوا اسکریپت نیاز دارد، زیرا API ماژولار برای کار با module bundlerها بهینه شده است تا کدهای بلااستفاده را حذف کرده (tree-shaking) و اندازه SDK را کاهش دهد.

  1. نصب فایربیس با استفاده از npm:

    npm install firebase

  2. Firebase را در برنامه خود مقداردهی اولیه کنید و یک شیء Firebase App ایجاد کنید:

    import { initializeApp } from 'firebase/app';

// TODO: Replace the following with your app's Firebase configuration
const firebaseConfig = {
  //...
};

const app = initializeApp(firebaseConfig);

    یک برنامه Firebase یک شیء شبیه کانتینر است که پیکربندی مشترک را ذخیره می‌کند و احراز هویت را در سرویس‌های Firebase به اشتراک می‌گذارد. پس از مقداردهی اولیه یک شیء برنامه Firebase در کد خود، می‌توانید سرویس‌های Firebase را اضافه کرده و شروع به استفاده از آنها کنید.

    اگر برنامه شما شامل ویژگی‌های پویا مبتنی بر رندر سمت سرور (SSR) است، باید مراحل دیگری را انجام دهید تا مطمئن شوید که پیکربندی شما در طول رندر سمت سرور و رندر سمت کلاینت پایدار می‌ماند. در منطق سرور خود، رابط FirebaseServerApp را پیاده‌سازی کنید تا مدیریت جلسه برنامه خود را با service workerها بهینه کنید.

مرحله 3 : در برنامه خود به Firebase دسترسی پیدا کنید

سرویس‌های فایربیس (مانند Cloud Firestore ، Authentication ، Realtime Database ، Remote Config و موارد دیگر) برای وارد کردن در زیربسته‌های جداگانه در دسترس هستند.

مثال زیر نشان می‌دهد که چگونه می‌توانید از Cloud Firestore Lite SDK برای بازیابی لیستی از داده‌ها استفاده کنید.

import { initializeApp } from 'firebase/app';
import { getFirestore, collection, getDocs } from 'firebase/firestore/lite';
// Follow this pattern to import other Firebase services
// import { } from 'firebase/<service>';

// TODO: Replace the following with your app's Firebase configuration
const firebaseConfig = {
  //...
};

const app = initializeApp(firebaseConfig);
const db = getFirestore(app);

// Get a list of cities from your database
async function getCities(db) {
  const citiesCol = collection(db, 'cities');
  const citySnapshot = await getDocs(citiesCol);
  const cityList = citySnapshot.docs.map(doc => doc.data());
  return cityList;
}

مرحله ۴ : برای کاهش حجم از یک module bundler (webpack/Rollup) استفاده کنید

کیت توسعه نرم‌افزار وب فایربیس (Firebase Web SDK) به گونه‌ای طراحی شده است که با بسته‌های ماژول (module bundlers) کار کند تا هرگونه کد استفاده نشده (tree-shaking) را حذف کند. ما اکیداً توصیه می‌کنیم از این رویکرد برای برنامه‌های تولیدی استفاده کنید. ابزارهایی مانند Angular CLI ، Next.js ، Vue CLI یا Create React App به طور خودکار بسته‌بندی ماژول را برای کتابخانه‌هایی که از طریق npm نصب شده و به کدبیس شما وارد شده‌اند، مدیریت می‌کنند.

برای اطلاعات بیشتر به راهنمای ما در مورد استفاده از بسته‌های ماژول با Firebase مراجعه کنید.

سرویس‌های فایربیس موجود برای وب

اکنون که برای استفاده از Firebase آماده شده‌اید، می‌توانید هر یک از سرویس‌های Firebase موجود در زیر را در برنامه وب خود اضافه و استفاده کنید.

دستورات زیر نحوه وارد کردن کتابخانه‌های Firebase که به صورت محلی با npm نصب شده‌اند را نشان می‌دهد. برای گزینه‌های جایگزین واردات، به مستندات کتابخانه‌های موجود مراجعه کنید.

منطق هوش مصنوعی فایربیس قبلاً با بسته firebase/vertexai « هوش مصنوعی ورتکس در فایربیس » نامیده می‌شد.

مراحل بعدی

آشنایی با فایربیس: