إضافة Firebase إلى مشروع JavaScript

اتّبِع هذا الدليل لاستخدام حزمة تطوير البرامج (SDK) Firebase JavaScript في تطبيق الويب أو كمستخدِم لخدمة الوصول إلى المستخدم النهائي، على سبيل المثال، في تطبيق Node.js لأجهزة الكمبيوتر المكتبي أو تطبيق إنترنت الأشياء.

الخطوة 1: إنشاء مشروع على Firebase وتسجيل تطبيقك

قبل أن تتمكّن من إضافة Firebase إلى تطبيق JavaScript، عليك إنشاء مشروع على Firebase وتسجيل تطبيقك في هذا المشروع. عند تسجيل تطبيقك في Firebase، ستحصل على عنصر إعدادات Firebase الذي ستستخدمه لربط تطبيقك بموارد مشروعك على Firebase.

انتقِل إلى مقالة فهم مشاريع Firebase للاطّلاع على مزيد من المعلومات حول مشاريع Firebase وأفضل الممارسات لإضافة التطبيقات إلى المشاريع.

إذا لم يكن لديك مشروع JavaScript وأردت تجربة أحد منتجات Firebase، يمكنك تنزيل أحد عيّنات البدء السريع.

الخطوة 2: تثبيت حزمة تطوير البرامج (SDK) وإعداد Firebase

توضّح هذه الصفحة تعليمات الإعداد لواجهة برمجة التطبيقات المكوّنة من وحدات لحزمة تطوير البرامج (SDK) لبرنامج Firebase باستخدام JavaScript، والتي تستخدم تنسيق وحدة JavaScript.

يستخدم سير العمل هذا أداة npm ويتطلّب حِزم وحدات أو أدوات إطار عمل JavaScript لأنّ واجهة برمجة التطبيقات المُجمَّعة محسَّنة للعمل مع حِزم الوحدات لإزالة الرموز البرمجية غير المستخدَمة (إزالة العناصر غير الضرورية) وتقليل حجم حزمة تطوير البرامج (SDK).

  1. ثبِّت Firebase باستخدام npm:

    npm install firebase
  2. اضبط إعدادات Firebase في تطبيقك وأنشئ عنصر تطبيق Firebase:

    import { initializeApp } from 'firebase/app';
    
    // TODO: Replace the following with your app's Firebase project configuration
    const firebaseConfig = {
      //...
    };
    
    const app = initializeApp(firebaseConfig);

    تطبيق Firebase هو عنصر يشبه الحاوية يخزّن الإعدادات الشائعة ويشارك المصادقة في جميع خدمات Firebase. بعد إعداد كائن تطبيق Firebase في الرمز، يمكنك إضافة خدمات Firebase وبدء استخدامها.

    إذا كان تطبيقك يتضمّن ميزات ديناميكية تستند إلى العرض من جهة الخادم (SSR)، عليك اتّخاذ بعض الخطوات الإضافية لضمان استمرار الإعدادات في جميع عمليات العرض من جهة الخادم وعمليات العرض من جهة العميل. في منطق الخادم، نفِّذ واجهة FirebaseServerApp لتحسين إدارة الجلسات في تطبيقك باستخدام مهام الخدمة.

الخطوة 3: الوصول إلى Firebase في تطبيقك

تتوفّر خدمات Firebase (مثل Cloud Firestore وAuthentication وRealtime Database Remote Config والمزيد) لاستيرادها ضمن حزم فرعية individual .

يوضّح المثال أدناه كيف يمكنك استخدام 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 project 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;
}

الخطوة 4: استخدام أداة تجميع الوحدات (webpack/Rollup) لتقليل الحجم

تم تصميم حزمة تطوير برامج الويب Firebase للعمل مع وحدات تجميع الوحدات لإزالة أي رموز غير مُستخدَمة (اهتزاز الشجرة). نوصي بشدة باستخدام هذا النهج في تطبيقات الإنتاج. تتعامل أدوات مثل Angular CLI أو Next.js أو Vue CLI أو Create React App تلقائيًا مع تجميع الوحدات للمكتبات التي تم تثبيتها من خلال npm ويتم استيرادها إلى قاعدة الرموز البرمجية.

اطّلِع على دليلنا استخدام حِزم الوحدات مع Firebase للحصول على مزيد من المعلومات.

خدمات Firebase المتاحة للويب

بعد الانتهاء من إعداد استخدام Firebase، يمكنك البدء في إضافة أيٍّ من خدمات Firebase المتاحة التالية واستخدامها في تطبيق الويب.

توضّح الأوامر التالية كيفية استيراد مكتبات Firebase المثبَّتة على الجهاز باستخدام npm. للحصول على خيارات استيراد بديلة، يُرجى الاطّلاع على مستندات المكتبات المتاحة.

الخطوات التالية

مزيد من المعلومات عن Firebase: