تحتفظ "استضافة Firebase" بعناوين URL في موقعك الإلكتروني التي تبدأ بـ /__. هذا النمط
توفر مساحة الاسم المحجوزة سهولة في استخدام منتجات Firebase الأخرى جنبًا إلى جنب مع
استضافة Firebase.
تتوفّر عناوين URL المحجوزة هذه عند النشر في Firebase.
(firebase deploy) أو عند تشغيل تطبيقك على خادم محلي
(firebase serve).
إضافة نصوص برمجية لعناوين URL المحجوزة
نظرًا لأنه يتم عرض استضافة Firebase عبر HTTP/2 عند نشرها، يمكنك تعزيز الأداء من خلال تحميل الملفات من المصدر نفسه. عرض استضافة Firebase الإصدار 8 من حزمة تطوير برامج JavaScript لمنصّة Firebase من عناوين URL خاصة تمّ تنسيقها على النحو التالي:
/__/firebase/JS_SDK_VERSION/FIREBASE_SDK_NAME.js
ننصح بشدة بتحميل المكتبات التي
التي تستخدمها في تطبيقك. على سبيل المثال، لتضمين المصادقة و
Cloud Firestore، أضِف النصوص البرمجية التالية في أسفل <body>
ولكن قبل استخدام أيٍ من خدمات Firebase:
<body>
<!-- Insert these scripts at the bottom of the HTML, but before you use any Firebase services -->
<!-- Firebase App (the core Firebase SDK) is always required and must be listed first -->
<script src="/__/firebase/8.10.1/firebase-app.js"></script>
<!-- Add Firebase products that you want to use -->
<script src="/__/firebase/8.10.1/firebase-auth.js"></script>
<script src="/__/firebase/8.10.1/firebase-firestore.js"></script>
</body>
الإعداد التلقائي لحزمة تطوير البرامج (SDK)
يُسهل ضبط حزمة SDK التلقائية إدارة بيئات متعددة (مثل كمطوري البرامج والتقسيم المرحلي والإنتاج) من قاعدة رموز برمجية واحدة. من خلال الاعتماد على عنوان URL لاستضافة المواقع الإلكترونية محجوزة، يمكنك نشر الرمز نفسه في عدة منصة مماثلة.
بالإضافة إلى استضافة حزم SDK نفسها، توفر مساحة الاسم المحجوزة أيضًا جميع الإعدادات اللازمة لإعداد حزمة تطوير البرامج (SDK) لمنصة Firebase المرتبط بموقع الاستضافة الإلكتروني. سيختلف هذا التكوين في Firebase يتم توفير إعداد حزمة تطوير البرامج (SDK) من خلال نص برمجي يمكنك تضمينه مباشرةً:
<!-- Load the Firebase SDKs before loading this file -->
<script src="/__/firebase/init.js"></script>
عند النشر في Firebase أو اختبار التطبيق محليًا، يتم استخدام هذا النص البرمجي تلقائيًا تعمل على إعداد حزمة تطوير البرامج (SDK) لJavaScript لمنصة Firebase مشروع Firebase نشط وإعداد حزمة تطوير البرامج (SDK).
إذا كنت تفضِّل التحكّم في عملية الإعداد بنفسك، استخدِم إعدادات Firebase تتوفر القيم أيضًا في شكل JSON:
fetch('/__/firebase/init.json').then(async response => {
firebase.initializeApp(await response.json());
});
حِزم تطوير البرامج (SDK) لـ Firebase JS المتاحة (من عناوين URL للاستضافة المحجوزة)
| منتج Firebase | مرجع المكتبة (عنوان URL محجوز) |
|---|---|
| حزمة Firebase الأساسية (مطلوبة) |
<script src="/__/firebase/8.10.1/firebase-app.js"></script> |
| إحصاءات Google | <script src="/__/firebase/8.10.1/firebase-analytics.js"></script> |
| فحص التطبيقات | <script src="/__/firebase/8.10.1/firebase-app-check.js"></script> |
| المصادقة | <script src="/__/firebase/8.10.1/firebase-auth.js"></script> |
| Cloud Firestore | <script src="/__/firebase/8.10.1/firebase-firestore.js"></script> |
| حزمة تطوير البرامج (SDK) الخاصة بإصدار Cloud Functions لبرنامج Firebase | <script src="/__/firebase/8.10.1/firebase-functions.js"></script> |
| عمليات تثبيت Firebase | <script src="/__/firebase/8.10.1/firebase-installations.js"></script> |
| المراسلة عبر السحابة الإلكترونية | <script src="/__/firebase/8.10.1/firebase-messaging.js"></script> وللحصول على أفضل تجربة في استخدام "المراسلة عبر السحابة الإلكترونية"، أضِف أيضًا حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصّة بخدمة "إحصاءات Google". |
| التخزين في السحابة الإلكترونية | <script src="/__/firebase/8.10.1/firebase-storage.js"></script> |
|
مراقبة الأداء
(إصدار تجريبي) |
<script src="/__/firebase/8.10.1/firebase-performance.js"></script> |
| قاعدة بيانات الوقت الفعلي | <script src="/__/firebase/8.10.1/firebase-database.js"></script> |
| الإعداد عن بُعد
(إصدار تجريبي) |
<script src="/__/firebase/8.10.1/firebase-remote-config.js"></script> وللحصول على أفضل تجربة باستخدام ميزة "الإعداد عن بُعد"، أضِف أيضًا حزمة تطوير البرامج (SDK) لمنصّة Firebase الخاصّة بخدمة "إحصاءات Google". |
| حزمة تطوير البرامج (SDK) لـ Firebase JavaScript (حزمة SDK كاملة) |
<script src="/__/firebase/8.10.1/firebase.js"></script> |
تطبيقات المساعدة في المصادقة
تستخدم مصادقة Firebase مساحة اسم لتوفير رموز JavaScript وHTML خاصة لإكمال المصادقة عبر بروتوكول OAuth. وهذا يتيح لكل مشروع في Firebase نطاق Firebase الفرعي، ما ساهم في زيادة أمان مصادقة Firebase.
بالإضافة إلى ذلك، يسمح لك ذلك باستخدام نطاقك الخاص في authDomain.
الخيار لـ firebase.initializeApp(). إذا كنت
ضبط نطاق خاص
لاستضافة Firebase، فيمكنك أيضًا تحديد النطاق المخصص (بدلاً من
النطاق الفرعي web.app أو firebaseapp.com) عند إعداد Firebase
حِزم تطوير البرامج (SDK). عرض
أفضل الممارسات لاستخدامsignInWithRedirect
لمعرفة المزيد من التفاصيل حول استخدام نطاق خاص.
عناوين URL المحجوزة ومشغّلو الخدمات
إذا كنت تنشئ تطبيق ويب تقدّميًا (PWA)، يمكنك إنشاء خدمة شخص لديه "احتياطي للتنقل" وتعرض عنوان URL محدّدًا بشكل تلقائي إذا لم يتطابق مع قائمة العناصر المخزّنة مسبقًا.
في حال استخدام Sw-precache يمكنك إضافة إعداد القائمة البيضاء الاحتياطي للتنقل الذي يستبعد مساحة الاسم المحجوزة:
{
navigateFallbackWhitelist: [/^(?!\/__).*/]
}
وتذكر بشكل عام أن مساحة الاسم للشرطة السفلية محجوزة استخدام Firebase وعدم اعتراض هذه الطلبات في خدمتك عامل.