أثناء تطوير تطبيق ويب باستخدام Firebase، قد تواجه مفاهيم غير مألوفة أو جوانب تحتاج فيها إلى مزيد من المعلومات لاتخاذ القرارات الصحيحة لمشروعك. تهدف هذه الصفحة إلى الإجابة عن هذه الأسئلة أو توجيهك إلى المراجع لمعرفة المزيد.
إذا كانت لديك أسئلة حول موضوع لم تتناوله هذه الصفحة، يُرجى زيارة أحد منتدياتنا الإلكترونية. سنعدّل أيضًا هذه الصفحة بمواضيع جديدة بشكل دوري، لذا يُرجى زيارتها من حين لآخر لمعرفة ما إذا أضفنا الموضوع الذي تريد الاطّلاع عليه.
إصدارات حزمة تطوير البرامج (SDK): إصدارات تستخدم مساحات الأسماء وإصدارات تتألف من وحدات
توفّر Firebase واجهتَي برمجة تطبيقات لتطبيقات الويب:
- JavaScript - namespaced. هذه هي واجهة JavaScript التي حافظت عليها Firebase لسنوات عديدة وهي مألوفة لمطوّري تطبيقات الويب الذين لديهم تطبيقات Firebase قديمة. بما أنّ namespaced API لا تستفيد من الدعم المستمر للميزات الجديدة، يجب أن تستخدم معظم التطبيقات الجديدة modular API بدلاً منها.
- JavaScript - وحدات تستند حزمة SDK هذه إلى نهج معياري يوفّر حجمًا أصغر لحزمة SDK وكفاءة أكبر مع أدوات إنشاء JavaScript الحديثة، مثل webpack أو Rollup.
تتكامل واجهة برمجة التطبيقات هذه بشكل جيد مع أدوات الإنشاء التي تزيل الرموز البرمجية غير المستخدَمة في تطبيقك، وهي عملية تُعرف باسم "إزالة الرموز البرمجية غير المستخدَمة". تستفيد التطبيقات التي تم إنشاؤها باستخدام حزمة SDK هذه من تقليل حجمها بشكل كبير. على الرغم من أنّ واجهة namespaced API متاحة كوحدة، إلا أنّها لا تتضمّن بنية وحدات صارمة ولا توفّر الدرجة نفسها من تقليل الحجم.
على الرغم من أنّ معظم واجهة برمجة التطبيقات المستندة إلى الوحدات تتّبع الأنماط نفسها التي تتّبعها واجهة برمجة التطبيقات المستندة إلى مساحة الاسم،
يختلف تنظيم الرمز البرمجي. بشكل عام، تكون واجهة برمجة التطبيقات namespaced API موجّهة نحو نمط مساحة الاسم والخدمة، بينما تكون واجهة برمجة التطبيقات modular API موجّهة نحو الدوال المنفصلة. على سبيل المثال، يتم استبدال تسلسل النقاط في namespaced API، مثل
firebaseApp.auth()، في modular API بدالة getAuth() واحدة
تأخذ firebaseApp وتعرض مثيل Authentication.
وهذا يعني أنّ تطبيقات الويب التي تم إنشاؤها باستخدام namespaced API تتطلّب إعادة تصميم للاستفادة من تصميم التطبيقات المستند إلى الوحدات. يُرجى الاطّلاع على دليل الترقية لمزيد من التفاصيل.
JavaScript: واجهة برمجة تطبيقات نموذجية للتطبيقات الجديدة
إذا كنت بصدد بدء عملية دمج جديدة مع Firebase، يمكنك تفعيل modular API عند إضافة حزمة تطوير البرامج (SDK) وإعدادها.
أثناء تطوير تطبيقك، تذكَّر أنّ الرمز البرمجي سيتم تنظيمه بشكل أساسي حول الدوال. في واجهة برمجة التطبيقات modular API، يتم تمرير الخدمات كوسيطة أولى، ثم تستخدم الدالة تفاصيل الخدمة لتنفيذ بقية المهام. على سبيل المثال:
import { getAuth, onAuthStateChanged } from "firebase/auth";
const auth = getAuth(firebaseApp);
onAuthStateChanged(auth, user => {
// Check for user status
});
لمزيد من الأمثلة والتفاصيل، يمكنك الاطّلاع على الأدلة الخاصة بكل فئة منتج، بالإضافة إلى المستندات المرجعية لواجهة برمجة التطبيقات (API) المستندة إلى الوحدات.
طرق إضافة حزم تطوير البرامج (SDK) للويب إلى تطبيقك
توفّر Firebase مكتبات JavaScript لمعظم منتجات Firebase، بما في ذلك Remote Config وFCM والمزيد. تعتمد طريقة إضافة حِزم تطوير البرامج (SDK) لمنصة Firebase إلى تطبيق الويب على الأدوات التي تستخدمها مع تطبيقك (مثل حزمة الوحدات).
يمكنك إضافة أي من المكتبات المتاحة إلى تطبيقك من خلال إحدى الطرق المتوافقة:
- npm (لحِزم الوحدات)
- شبكة توصيل المحتوى (CDN)
للحصول على تعليمات مفصّلة حول الإعداد، يُرجى الاطّلاع على مقالة إضافة Firebase إلى تطبيق JavaScript. يحتوي الجزء المتبقي من هذا القسم على معلومات لمساعدتك في الاختيار من بين الخيارات المتاحة.
npm
يتيح لك تنزيل حزمة npm في Firebase (التي تتضمّن حِزم المتصفّح وNode.js) الحصول على نسخة محلية من حزمة تطوير البرامج (SDK) في Firebase، والتي قد تكون مطلوبة للتطبيقات التي لا تعمل على المتصفّح، مثل تطبيقات Node.js أو React Native أو Electron. يتضمّن التنزيل حِزم Node.js وReact Native كخيار لبعض الحِزم. تُعدّ حِزم Node.js ضرورية لخطوة العرض من جهة الخادم (SSR) في أُطر عمل SSR.
يوفّر استخدام npm مع حزمة وحدات مثل webpack أو Rollup خيارات تحسين لإزالة الرموز البرمجية غير المستخدَمة وتطبيق polyfills مستهدَفة، ما يمكن أن يقلّل بشكل كبير من حجم تطبيقك. قد يؤدي تنفيذ هذه الميزات إلى إضافة بعض التعقيد إلى الإعدادات وسلسلة الإنشاء، ولكن يمكن أن تساعد أدوات CLI السائدة في التخفيف من ذلك. وتشمل هذه الأدوات Angular وReact وVue وNext وغيرها.
وباختصار:
- توفير تحسين قيّم لحجم التطبيق
- تتوفّر أدوات فعّالة لإدارة الوحدات
- مطلوب للعرض من جهة الخادم (SSR) باستخدام Node.js
شبكة توصيل المحتوى (CDN)
إنّ إضافة المكتبات المخزَّنة على شبكة توصيل المحتوى (CDN) في Firebase هي طريقة بسيطة لإعداد حزمة تطوير البرامج (SDK) قد تكون مألوفة للعديد من المطوّرين. باستخدام شبكة توصيل المحتوى (CDN) لإضافة حِزم تطوير البرامج (SDK)، لن تحتاج إلى أداة إنشاء، وقد تكون سلسلة الإنشاء أبسط وأسهل في التعامل معها مقارنةً بحِزم الوحدات. إذا لم تكن مهتمًا بشكل خاص بحجم تطبيقك المثبّت وليس لديك متطلبات خاصة مثل الترجمة من مصدر إلى مصدر من TypeScript، فقد تكون شبكة توصيل المحتوى (CDN) خيارًا جيدًا.
وباختصار:
- مألوفة وبسيطة
- مناسب عندما لا يكون حجم التطبيق مصدر قلق كبير
- هذا الخيار مناسب إذا كان موقعك الإلكتروني لا يستخدم أدوات إنشاء.
إصدارات حزمة تطوير البرامج (SDK) لمنصة Firebase على الويب
يمكن استخدام حزمة تطوير البرامج (SDK) للويب من Firebase في كلّ من تطبيقات المتصفّح وNode. ومع ذلك، لا تتوفّر عدة منتجات في بيئات Node. اطّلِع على قائمة البيئات المتوافقة.
توفّر بعض حزم تطوير البرامج (SDK) للمنتجات خيارات منفصلة للمتصفّح وNode، ويتم توفير كلّ منها بتنسيقَي ESM وCJS، كما توفّر بعض حزم تطوير البرامج (SDK) للمنتجات خيارات Cordova أو React Native. تم ضبط حزمة تطوير البرامج (SDK) للويب لتوفير الخيار الصحيح استنادًا إلى إعدادات الأدوات أو البيئة، ولا تتطلّب الاختيار اليدوي في معظم الحالات. تم تصميم جميع صيغ حزمة تطوير البرامج (SDK) للمساعدة في إنشاء تطبيقات الويب أو تطبيقات العملاء التي تتيح للمستخدمين النهائيين الوصول إليها، مثل تطبيقات Node.js لأجهزة الكمبيوتر المكتبي أو تطبيقات إنترنت الأشياء. إذا كان هدفك هو إعداد إذن وصول إداري من بيئات مميّزة (مثل الخوادم)، استخدِم Firebase Admin SDK بدلاً من ذلك.
رصد البيئة باستخدام أدوات التجميع وأُطر العمل
عند تثبيت حزمة تطوير البرامج (SDK) للويب من Firebase باستخدام npm، يتم تثبيت إصدارَي JavaScript وNode.js. توفّر الحزمة ميزة رصد البيئة بالتفصيل لتفعيل الحِزم المناسبة لتطبيقك.
إذا كان الرمز البرمجي يستخدم عبارات require في Node.js، ستعثر حزمة تطوير البرامج (SDK) على الحزمة الخاصة بـ Node. وإلا، يجب ضبط إعدادات الحزمة بشكل صحيح لرصد حقل نقطة الدخول الصحيح في ملف package.json (على سبيل المثال، main أو browser أو module). إذا واجهت أخطاء أثناء التشغيل في حزمة تطوير البرامج (SDK)، تأكَّد من ضبط الحزمة لإعطاء الأولوية للنوع الصحيح من الحزمة لبيئتك.
مزيد من المعلومات عن عنصر إعدادات Firebase
لإعداد Firebase في تطبيقك، عليك تقديم إعدادات Firebase الخاصة بتطبيقك. يمكنك الحصول على عنصر إعدادات Firebase في أي وقت.
لا ننصح بتعديل عنصر الإعداد يدويًا، خاصةً "خيارات Firebase" المطلوبة التالية:
apiKeyوprojectIdوappID. إذا تم إعداد تطبيقك بقيم غير صالحة أو غير متوفّرة لـ "خيارات Firebase" المطلوبة هذه، قد يواجه مستخدمو تطبيقك مشاكل خطيرة. يُستثنى من ذلكauthDomain، والذي يمكن تعديله باتّباع أفضل الممارسات لاستخدام signInWithRedirect.إذا فعّلت Google Analytics في مشروع Firebase، سيحتوي عنصر الإعدادات على الحقل
measurementId. يمكنك الاطّلاع على مزيد من المعلومات حول هذا الحقل في صفحة البدء في استخدام Analytics.في حال تفعيل Google Analytics أو Realtime Database بعد إنشاء تطبيق الويب على Firebase، تأكَّد من تعديل عنصر إعدادات 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
المكتبات المتاحة
خيارات الإعداد الإضافية
تأخير تحميل حِزم تطوير البرامج (SDK) لمنصة Firebase (من شبكة توصيل المحتوى)
يمكنك تأخير تضمين حِزم تطوير البرامج (SDK) لمنصة Firebase إلى أن يتم تحميل الصفحة بالكامل. إذا كنت تستخدم نصوص CDN البرمجية لـ modular API مع <script type="module">،
فهذا هو الإعداد التلقائي. إذا كنت تستخدم نصوص CDN البرمجية ذات مساحة الاسم كوحدة، أكمِل الخطوات التالية لتأجيل التحميل:
أضِف علامة
deferإلى كل علامةscriptلحِزم تطوير البرامج (SDK) في Firebase، ثم أجِّل بدء 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 مختلف. أو قد ترغب في مصادقة مشروع واحد مع إبقاء مشروع ثانٍ غير مصادق عليه.
تتيح لك حزمة تطوير البرامج (SDK) لـ JavaScript Firebase إعداد واستخدام عدة مشاريع على 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();
تشغيل خادم ويب محلي للتطوير
إذا كنت بصدد إنشاء تطبيق ويب، تتطلّب بعض أجزاء حزمة تطوير البرامج (SDK) لـ Firebase JavaScript عرض تطبيق الويب من خادم بدلاً من نظام الملفات المحلي. يمكنك استخدام Firebase CLI لتشغيل خادم محلي.
إذا سبق لك إعداد Firebase Hosting لتطبيقك، من المحتمل أنّك أكملت عدة خطوات من الخطوات أدناه.
لعرض تطبيق الويب، ستستخدم واجهة سطر الأوامر Firebase، وهي أداة سطر أوامر.
يمكنك الانتقال إلى مستندات واجهة سطر الأوامر (CLI) في Firebase للتعرّف على كيفية تثبيت واجهة سطر الأوامر أو التحديث إلى الإصدار الأخير.
إعداد مشروع Firebase. نفِّذ الأمر التالي من جذر دليل التطبيق على الجهاز:
firebase init
ابدأ تشغيل الخادم المحلي للتطوير. نفِّذ الأمر التالي من جذر دليل التطبيق على الجهاز:
firebase serve
مراجع مفتوحة المصدر لحِزم Firebase JavaScript SDK
تتيح Firebase تطوير البرامج المفتوحة المصدر، ونشجّع على تقديم المساهمات والملاحظات من المنتدى.
حِزم Firebase JavaScript SDK
يتم تطوير معظم حِزم Firebase JavaScript SDK كمكتبات مفتوحة المصدر في مستودع Firebase GitHub العام.
نماذج البدء السريع
تحتفظ Firebase بمجموعة من نماذج البدء السريع لمعظم واجهات برمجة تطبيقات Firebase على الويب. يمكنك العثور على أدلة البدء السريع هذه في مستودع البدء السريع العلني في Firebase على GitHub. يمكنك استخدام أدلة البدء السريع هذه كأمثلة على الرموز البرمجية لاستخدام حِزم تطوير البرامج (SDK) من Firebase.