توفّر واجهة سطر الأوامر (CLI) في Firebase (GitHub) مجموعة متنوعة من الأدوات لإدارة مشاريع Firebase وعرضها ونشرها.
قبل استخدام واجهة سطر الأوامر في Firebase، يجب إعداد مشروع Firebase.
إعداد واجهة سطر الأوامر أو تحديثها
تثبيت واجهة سطر الأوامر (CLI) في Firebase
يمكنك تثبيت واجهة سطر الأوامر في Firebase باستخدام طريقة تتوافق مع نظام التشغيل
ومستوى الخبرة و/أو حالة الاستخدام. بغض النظر عن طريقة تثبيت واجهة سطر الأوامر، يمكنك الوصول إلى الوظائف نفسها والأمر firebase.
Windows
يمكنك تثبيت واجهة سطر الأوامر (CLI) في "Firebase" لنظام التشغيل Windows باستخدام أحد الخيارات التالية:
| الخيار | الوصف | مُقترَحة لـ... |
|---|---|---|
| standalone binary | نزِّل الملف الثنائي المستقل لواجهة سطر الأوامر. بعد ذلك، يمكنك الوصول إلى الملف القابل للتنفيذ لفتح واجهة يمكنك من خلالها تشغيل الأمر firebase.
|
المطوّرون الجدد المطوّرون الذين لا يستخدمون Node.js أو ليسوا على دراية بها |
| npm | استخدِم npm (أداة إدارة حِزم Node) لتثبيت واجهة سطر الأوامر وتفعيل الأمر firebase المتاح بشكل عام.
|
المطوّرون الذين يستخدمون Node.js |
برنامج ثنائي مستقل
لتنزيل الملف الثنائي لـ Firebase CLI وتشغيله، اتّبِع الخطوات التالية:
يمكنك الوصول إلى الملف الثنائي لفتح واجهة يمكنك من خلالها تشغيل الأمر
firebase.انتقِل إلى تسجيل الدخول واختبار واجهة سطر الأوامر.
npm
لاستخدام npm (أداة إدارة حِزم Node) لتثبيت واجهة سطر الأوامر (CLI) في Firebase، اتّبِع الخطوات التالية:
ثبِّت Node.js باستخدام nvm-windows (مدير إصدارات Node). يؤدي تثبيت Node.js إلى تثبيت أدوات سطر أوامر
npmتلقائيًا.ثبِّت واجهة سطر أوامر Firebase من خلال
npmعبر تنفيذ الأمر التالي:npm install -g firebase-tools
يؤدي هذا الأمر إلى تفعيل الأمر
firebaseالمتاح عالميًا.انتقِل إلى تسجيل الدخول واختبار واجهة سطر الأوامر.
نظام التشغيل macOS أو Linux
يمكنك تثبيت واجهة سطر الأوامر (CLI) في "Firebase" على أجهزة macOS أو Linux باستخدام أحد الخيارات التالية:
| الخيار | الوصف | مُقترَحة لـ... |
|---|---|---|
| نص التثبيت البرمجي التلقائي | يمكنك تشغيل أمر واحد يرصد نظام التشغيل تلقائيًا،
وينزّل أحدث إصدار من واجهة سطر الأوامر، ثم يفعّل الأمر
firebase المتاح على مستوى العالم.
|
المطوّرون الجدد المطوّرون الذين لا يستخدمون Node.js أو ليسوا على دراية به عمليات النشر المبرمَجة في بيئة CI/CD |
| standalone binary | نزِّل الملف الثنائي المستقل لواجهة سطر الأوامر. بعد ذلك، يمكنك ضبط الملف الثنائي وتشغيله بما يناسب سير عملك. | سير عمل قابل للتخصيص بالكامل باستخدام واجهة سطر الأوامر |
| npm | استخدِم npm (أداة إدارة حِزم Node) لتثبيت واجهة سطر الأوامر وتفعيل الأمر firebase المتاح بشكل عام.
|
المطوّرون الذين يستخدمون Node.js |
نص برمجي للتثبيت التلقائي
لتثبيت واجهة سطر الأوامر (CLI) في Firebase باستخدام نص التثبيت التلقائي، اتّبِع الخطوات التالية:
نفِّذ أمر cURL التالي:
curl -sL https://firebase.tools | bash
يرصد هذا النص البرمجي نظام التشغيل تلقائيًا، وينزّل أحدث إصدار من واجهة سطر الأوامر (CLI) في Firebase، ثم يفعّل الأمر
firebaseالمتاح على مستوى العالم.انتقِل إلى تسجيل الدخول واختبار واجهة سطر الأوامر.
لمزيد من الأمثلة والتفاصيل حول نص التثبيت التلقائي، يُرجى الرجوع إلى الرمز المصدر للنص على firebase.tools.
برنامج ثنائي مستقل
لتنزيل الملف الثنائي لواجهة سطر الأوامر في "Firebase" وتشغيله على نظام التشغيل الخاص بك، يُرجى اتّباع الخطوات التالية:
نزِّل الملف الثنائي لواجهة سطر الأوامر (CLI) في Firebase لنظام التشغيل لديك: macOS | Linux
(اختياري) يمكنك إعداد الأمر
firebaseالمتاح عالميًا.- اجعل الملف الثنائي قابلاً للتنفيذ من خلال تشغيل
chmod +x ./firebase_tools. - أضِف مسار الملف الثنائي إلى PATH.
- اجعل الملف الثنائي قابلاً للتنفيذ من خلال تشغيل
انتقِل إلى تسجيل الدخول واختبار واجهة سطر الأوامر.
npm
لاستخدام npm (أداة إدارة حِزم Node) لتثبيت واجهة سطر أوامر Firebase،
يُرجى اتّباع الخطوات التالية:
ثبِّت Node.js باستخدام nvm (مدير إصدارات Node).
يؤدي تثبيت Node.js إلى تثبيت أدوات سطر الأوامرnpmتلقائيًا.ثبِّت واجهة سطر أوامر Firebase من خلال
npmعبر تنفيذ الأمر التالي:npm install -g firebase-tools
يؤدي هذا الأمر إلى تفعيل الأمر
firebaseالمتاح عالميًا.انتقِل إلى تسجيل الدخول واختبار واجهة سطر الأوامر.
تسجيل الدخول واختبار واجهة سطر الأوامر في "Firebase"
بعد تثبيت واجهة سطر الأوامر، عليك المصادقة. بعد ذلك، يمكنك تأكيد المصادقة من خلال إدراج مشاريع Firebase.
سجِّل الدخول إلى Firebase باستخدام حساب Google من خلال تشغيل الأمر التالي:
firebase login
يربط هذا الأمر جهازك المحلي بمنصة Firebase ويمنحك إمكانية الوصول إلى مشاريع Firebase.
اختبِر ما إذا تم تثبيت واجهة سطر الأوامر بشكل صحيح ويمكنها الوصول إلى حسابك من خلال عرض مشاريع Firebase. نفِّذ الأمر التالي:
firebase projects:list
يجب أن تكون القائمة المعروضة مماثلة لمشاريع Firebase المدرَجة في وحدة تحكّم Firebase.
التحديث إلى أحدث إصدار من واجهة سطر الأوامر
بشكل عام، ننصحك باستخدام أحدث إصدار من واجهة سطر الأوامر في Firebase.
تعتمد طريقة تحديث إصدار CLI على نظام التشغيل وطريقة تثبيت CLI.
Windows
- ملف ثنائي مستقل: نزِّل الإصدار الجديد، ثم استبدِله على نظامك
- npm: شغِّل
npm install -g firebase-tools
macOS
نص التثبيت البرمجي التلقائي: شغِّل
curl -sL https://firebase.tools | upgrade=true bashملف ثنائي مستقل: نزِّل الإصدار الجديد، ثم استبدِله على نظامك.
npm: شغِّل
npm install -g firebase-tools
Linux
نص التثبيت البرمجي التلقائي: شغِّل
curl -sL https://firebase.tools | upgrade=true bashملف ثنائي مستقل: نزِّل الإصدار الجديد، ثم استبدِله على نظامك.
npm: شغِّل
npm install -g firebase-tools
إلغاء تثبيت واجهة سطر الأوامر (CLI) في Firebase
تعتمد طريقة إلغاء تثبيت واجهة سطر الأوامر على نظام التشغيل وطريقة تثبيت واجهة سطر الأوامر.
Windows
- ملف ثنائي مستقل: احذف الملف الثنائي
firebase.exeالذي نزّلته. - npm: شغِّل
npm uninstall -g firebase-tools
macOS
النص البرمجي للتثبيت التلقائي: شغِّل
curl -sL https://firebase.tools | uninstall=true bashملف ثنائي مستقل: احذف الملف الثنائي
firebaseالذي نزّلته. إذا أضفت موقعه الجغرافي إلى متغيّر البيئةPATH، تأكَّد من إزالته.npm: شغِّل
npm uninstall -g firebase-tools
Linux
النص البرمجي للتثبيت التلقائي: شغِّل
curl -sL https://firebase.tools | uninstall=true bashملف ثنائي مستقل: احذف الملف الثنائي
firebaseالذي نزّلته. إذا أضفت موقعه الجغرافي إلى متغيّر البيئةPATH، تأكَّد من إزالته.npm: شغِّل
npm uninstall -g firebase-tools
استخدام واجهة سطر الأوامر مع أنظمة التكامل المستمر
ننصحك بالمصادقة باستخدام "بيانات الاعتماد التلقائية للتطبيق" عند استخدام واجهة سطر الأوامر مع أنظمة CI.
(يُنصح به) استخدام "بيانات الاعتماد التلقائية للتطبيق"
ستكتشف واجهة سطر الأوامر (CLI) في Firebase "بيانات الاعتماد التلقائية للتطبيق" وتستخدمها في حال ضبطها. أبسط طريقة لمصادقة واجهة سطر الأوامر في CI والبيئات الأخرى التي لا تتضمّن واجهة مستخدم رسومية هي إعداد بيانات الاعتماد التلقائية للتطبيق.
(الإصدار القديم) استخدام FIREBASE_TOKEN
يمكنك بدلاً من ذلك المصادقة باستخدام FIREBASE_TOKEN. هذا الإجراء أقل أمانًا من "بيانات الاعتماد التلقائية للتطبيق"، ولم يعُد يُنصح به.
على جهاز يتضمّن متصفّحًا، ثبِّت واجهة سطر أوامر Firebase.
ابدأ عملية تسجيل الدخول من خلال تنفيذ الأمر التالي:
firebase login:ci
انتقِل إلى عنوان URL المقدَّم، ثم سجِّل الدخول باستخدام حساب Google.
اطبع رمزًا مميزًا جديدًا لإعادة التحميل. لن تتأثر جلسة واجهة سطر الأوامر الحالية.
خزِّن الرمز المميّز الناتج بطريقة آمنة ولكن يمكن الوصول إليها في نظام CI.
استخدِم هذا الرمز المميّز عند تشغيل أوامر
firebase. يمكنك استخدام أي من الخيارين التاليين:الخيار 1: تخزين الرمز المميّز كمتغيّر البيئة
FIREBASE_TOKEN. وسيستخدم نظامك الرمز المميّز تلقائيًا.الخيار 2: نفِّذ جميع أوامر
firebaseباستخدام العلامة--token TOKENفي نظام CI.
هذا هو ترتيب الأولوية لتحميل الرمز المميّز: العلامة، متغيّر البيئة، مشروع Firebase المطلوب.
إعداد مشروع Firebase
تتطلّب العديد من المهام الشائعة التي يتم تنفيذها باستخدام واجهة سطر الأوامر، مثل النشر في مشروع Firebase، توفُّر دليل مشروع. يمكنك إنشاء دليل مشروع
باستخدام الأمر firebase init. عادةً ما يكون دليل المشروع هو نفسه دليل جذر التحكّم بالمصدر، وبعد تشغيل firebase init، يحتوي الدليل على ملف إعداد firebase.json.
لبدء مشروع Firebase جديد، نفِّذ الأمر التالي من داخل دليل تطبيقك:
firebase init
يوجّهك الأمر firebase init خلال عملية إعداد دليل مشروعك وبعض منتجات Firebase. أثناء إعداد المشروع، تطلب منك واجهة سطر الأوامر (CLI) في Firebase
إكمال المهام التالية:
اختَر مشروع Firebase تلقائيًا.
تربط هذه الخطوة دليل المشروع الحالي بمشروع Firebase لكي يتم تنفيذ الأوامر الخاصة بالمشروع (مثل
firebase deploy) على مشروع Firebase المناسب.يمكن أيضًا ربط عدة مشاريع على Firebase (مثل مشروع مرحلي ومشروع إنتاج) بدليل المشروع نفسه.
اختَر منتجات Firebase لإعدادها في مشروع Firebase.
تطلب منك هذه الخطوة ضبط إعدادات ملفات معيّنة للمنتجات أو الميزات المحدّدة. لمزيد من التفاصيل حول عمليات الضبط هذه، يُرجى الرجوع إلى مستندات المنتج المحدّد (على سبيل المثال، Hosting أو Authentication). يُرجى العِلم أنّه يمكنك دائمًا تشغيل
firebase initلاحقًا لإعداد المزيد من منتجات Firebase.
في نهاية عملية الإعداد، ينشئ Firebase تلقائيًا الملفَين التاليَين في جذر دليل تطبيقك على الجهاز:
ملف إعداد
firebase.jsonيسرد إعدادات مشروعكملف
.firebasercيخزّن الأسماء البديلة لمشروعك
ملف firebase.json
ينشئ الأمر firebase init ملف إعداد firebase.json في جذر دليل مشروعك.
يُعدّ ملف firebase.json مطلوبًا
لنشر مواد العرض باستخدام واجهة سطر أوامر Firebase لأنّه يحدّد
الملفات والإعدادات من دليل المشروع التي يتم نشرها في
مشروع Firebase (مثل إعدادات Hosting وإعدادات
مقدّم خدمة Authentication وقواعد الأمان وإعدادات Cloud Functions).
بما أنّه يمكن تحديد بعض الإعدادات في دليل المشروع أو في وحدة تحكّم Firebase، تأكَّد من حلّ أي تعارضات محتملة في عملية النشر.
يمكنك ضبط معظم خيارات Firebase Hosting
مباشرةً في ملف firebase.json. ومع ذلك، بالنسبة إلى خدمات Firebase الأخرى التي يمكن نشرها باستخدام واجهة سطر أوامر Firebase، ينشئ الأمر firebase init ملفات محدّدة يمكنك من خلالها تحديد إعدادات هذه الخدمات، مثل ملف index.js لـ Cloud Functions. يمكنك أيضًا إعداد أدوات الربط قبل النشر أو بعده في ملف firebase.json.
ملف firebase.json التالي هو مثال شامل يعرض
خيارات الإعداد للعديد من خدمات Firebase. ويوضّح أيضًا ميزات مثل Cloud Functions متعددة قواعد الرموز البرمجية، وإعداد Local Emulator Suite، ونموذج Remote Config. يُرجى العِلم أنّ ملف firebase.json لأي مشروع معيّن سيحتوي فقط على إعدادات خدمات Firebase التي تم ضبطها لهذا المشروع تحديدًا (على سبيل المثال، Firebase Hosting وCloud Functions فقط). وتؤدي إضافة مفتاح $schema إلى تفعيل عملية التحقّق والإكمال التلقائي في العديد من أدوات تعديل الرموز.
{
"$schema": "https://raw.githubusercontent.com/firebase/firebase-tools/master/schema/firebase-config.json",
"hosting": {
"public": "public",
"ignore": [
"firebase.json",
"**/.*",
"**/node_modules/**"
],
"cleanUrls": true,
"trailingSlash": false
},
"apphosting": {
"backendId": "my-app",
"rootDir": "backend",
"ignore": [
"firebase.json",
"**/.*",
"**/node_modules/**"
]
},
"firestore": {
"rules": "firestore.rules",
"indexes": "firestore.indexes.json"
},
"storage": {
"rules": "storage.rules"
},
"database": {
"rules": "database.rules.json"
},
"dataconnect": {
"source": "dataconnect",
"location": "us-central1"
},
"functions": [
{
"source": "functions",
"codebase": "default",
"ignore": [
"**/.*",
"**/node_modules/**"
],
"predeploy": [
"npm --prefix \"$RESOURCE_DIR\" run lint",
"npm --prefix \"$RESOURCE_DIR\" run build"
]
}
],
"emulators": {
"auth": {
"port": 9099
},
"functions": {
"port": 5001
},
"firestore": {
"port": 8080
},
"hosting": {
"port": 5000
},
"storage": {
"port": 9199
},
"ui": {
"enabled": true,
"port": 4000
},
"singleProjectMode": true
},
"extensions": {
"my-storage-resizer": "firebase/storage-resize-images@^0.1.0"
},
"auth": {
"providers": {
"anonymous": true,
"emailPassword": true,
"googleSignIn": {
"oAuthBrandDisplayName": "My App",
"supportEmail": "support@myapp.com"
}
}
},
"remoteconfig": {
"template": "remoteconfig.template.json"
}
}
على الرغم من استخدام firebase.json تلقائيًا، يمكنك تمرير علامة --config PATH لتحديد ملف إعداد بديل.
ضبط قواعد بيانات Cloud Firestore متعددة
عند تشغيل firebase init، سيحتوي ملف firebase.json على مفتاح firestore واحد يتوافق مع قاعدة البيانات التلقائية لمشروعك، كما هو موضّح في المثال السابق.
إذا كان مشروعك يحتوي على قواعد بيانات Cloud Firestore متعددة، يمكنك تعديل ملف
firebase.json لربط ملفات مصدر فهرس قاعدة البيانات وCloud Firestore Security Rules المختلفة
بكل قاعدة بيانات. عدِّل الملف باستخدام مصفوفة JSON،
مع إدخال واحد لكل قاعدة بيانات.
"firestore": [
{
"database": "(default)",
"rules": "firestore.default.rules",
"indexes": "firestore.default.indexes.json"
},
{
"database": "ecommerce",
"rules": "firestore.ecommerce.rules",
"indexes": "firestore.ecommerce.indexes.json"
}
],
Cloud Functions ملف سيتم تجاهله عند النشر
عند نشر الدالة، تحدّد واجهة سطر الأوامر تلقائيًا
قائمة بالملفات في دليل functions لتجاهلها. يمنع هذا
نشر الملفات الدخيلة في الواجهة الخلفية والتي يمكن أن
تزيد من حجم بيانات النشر.
في ما يلي قائمة الملفات التي يتم تجاهلها تلقائيًا، وتظهر بتنسيق JSON:
"ignore": [
".git",
".runtimeconfig.json",
"firebase-debug.log",
"firebase-debug.*.log",
"node_modules"
]
إذا أضفت قيمًا مخصّصة لـ ignore في firebase.json، تأكَّد من الاحتفاظ بقائمة الملفات المعروضة في القائمة السابقة (أو إضافتها إذا لم تكن موجودة).
إدارة الأسماء البديلة للمشاريع
يمكنك ربط عدة مشاريع على Firebase بدليل المشروع نفسه.
على سبيل المثال، قد تحتاج إلى استخدام مشروع Firebase واحد للتنظيم وآخر للإنتاج. باستخدام بيئات مشاريع مختلفة، يمكنك التحقّق من التغييرات
قبل نشرها في بيئة الإنتاج. يتيح لك الأمر firebase use التبديل بين الأسماء المستعارة
بالإضافة إلى إنشاء أسماء مستعارة جديدة.
إضافة اسم مستعار للمشروع
عند اختيار مشروع Firebase أثناء إعداد
المشروع، يتم تلقائيًا تعيين الاسم المستعار default
للمشروع. ومع ذلك، للسماح بتنفيذ الأوامر الخاصة بالمشروع على مشروع Firebase مختلف مع استخدام نفس دليل المشروع، نفِّذ الأمر التالي من داخل دليل مشروعك:
firebase use --add
يطلب منك هذا الأمر اختيار مشروع آخر على Firebase وتعيينه
كاسم مستعار. تتم كتابة عمليات تعيين الأسماء البديلة في ملف .firebaserc داخل
دليل مشروعك.
استخدام الأسماء البديلة للمشروع
لاستخدام الأسماء البديلة المخصّصة لمشاريع Firebase، نفِّذ أيًا من الأوامر التالية من داخل دليل مشروعك.
| الأوامر | الوصف |
|---|---|
firebase use |
عرض قائمة بالأسماء المستعارة المحدّدة لدليل مشروعك |
firebase use \ |
يوجّه جميع الأوامر لتنفيذها على مشروع Firebase المحدّد.
تستخدم واجهة سطر الأوامر هذا المشروع باعتباره "المشروع النشط". |
firebase use --clear |
لمحو المشروع النشط
شغِّل |
firebase use \ |
لإزالة اسم مستعار من دليل المشروع |
يمكنك إلغاء المشروع النشط من خلال تمرير
العلامة --project مع أي أمر في واجهة سطر الأوامر. على سبيل المثال، يمكنك ضبط واجهة سطر الأوامر لتنفيذها على مشروع Firebase الذي تم تعيين الاسم المستعار staging له. إذا أردت تنفيذ أمر واحد على مشروع Firebase الذي
عيّنت له الاسم المستعار prod، يمكنك تنفيذ الأمر
على سبيل المثال.
التحكّم في المصدر والأسماء البديلة للمشاريع
بشكل عام، يجب التحقّق من ملف .firebaserc في نظام التحكّم في المصدر
للسماح لفريقك بمشاركة الأسماء البديلة للمشروع. ومع ذلك، بالنسبة إلى مشاريع البرامج مفتوحة المصدر أو النماذج الأولية، يجب بشكل عام عدم تسجيل ملف .firebaserc.
إذا كان لديك مشروع تطوير مخصّص لاستخدامك فقط، يمكنك إما تمرير العلامة --project مع كل أمر أو تشغيل firebase use PROJECT_ID بدون تعيين اسم مستعار لمشروع Firebase.
عرض مشروع Firebase واختباره على الجهاز
يمكنك عرض مشروع Firebase واختباره على عناوين URL مستضافة محليًا قبل
نشره في مرحلة الإنتاج. إذا أردت اختبار ميزات محدّدة فقط، يمكنك استخدام
قائمة قيم مفصولة بفاصلة في علامة ضمن الأمر firebase serve.
نفِّذ الأمر التالي من جذر دليل المشروع على الجهاز إذا أردت تنفيذ أي من المهام التالية:
- عرض المحتوى الثابت لتطبيقك المستضاف على Firebase
- تستخدم Cloud Functions لإنشاء محتوى ديناميكي لـ Firebase Hosting وتريد استخدام دوال HTTP الإنتاجية (المنشورة) لمحاكاة Hosting على عنوان URL محلي.
firebase serve --only hosting
محاكاة مشروعك باستخدام دوال HTTP المحلية
نفِّذ أيًا من الأوامر التالية من دليل المشروع لمحاكاة مشروعك باستخدام دوال HTTP المحلية.
لمحاكاة دوال HTTP والاستضافة للاختبار على عناوين URL المحلية، استخدِم أيًا من الأوامر التالية:
firebase serve
firebase serve --only functions,hosting // uses a flag
لمحاكاة دوال HTTP فقط، استخدِم الأمر التالي:
firebase serve --only functions
الاختبار من أجهزة محلية أخرى
يستجيب "firebase serve" تلقائيًا للطلبات الواردة من "localhost" فقط. وهذا يعني أنّه سيكون بإمكانك الوصول إلى المحتوى المستضاف من متصفّح الويب على جهاز الكمبيوتر، ولكن ليس من الأجهزة الأخرى على شبكتك. إذا أردت إجراء الاختبار من
أجهزة محلية أخرى، استخدِم العلامة --host، على النحو التالي:
firebase serve --host 0.0.0.0 // accepts requests to any host
النشر في مشروع Firebase
تُدير واجهة سطر الأوامر (CLI) في Firebase عملية نشر الرموز البرمجية ومواد العرض في مشروع Firebase، بما في ذلك:
- إصدارات جديدة من مواقعك الإلكترونية على Firebase Hosting
- Cloud Functions for Firebase جديد أو معدَّل أو حالي
- المخططات والموصّلات الجديدة أو المعدَّلة في "Firebase SQL Connect"
- Security Rules لـ Firebase Realtime Database
- Security Rules لـ Cloud Storage for Firebase
- Security Rules لـ Cloud Firestore
- فهارس Cloud Firestore
- إعدادات "Authentication"
للنشر في مشروع Firebase، نفِّذ الأمر التالي من دليل مشروعك:
firebase deploy
يمكنك إضافة تعليق إلى كل عملية نشر. سيظهر هذا التعليق مع معلومات النشر الأخرى في صفحة Firebase Hosting الخاصة بمشروعك. على سبيل المثال:
firebase deploy -m "Deploying the best new feature ever."
عند استخدام الأمر firebase deploy، يُرجى مراعاة ما يلي:
لنشر الموارد من دليل مشروع، يجب أن يحتوي دليل المشروع على ملف
firebase.json. يتم إنشاء هذا الملف تلقائيًا من خلال الأمرfirebase init.تنشئ أداة
firebase deployتلقائيًا إصدارًا لجميع الموارد القابلة للنشر في دليل مشروعك. لنشر خدمات أو ميزات معيّنة في Firebase، استخدِم النشر الجزئي.
نشر خدمات Firebase محدّدة
إذا أردت نشر خدمات أو ميزات محدّدة فقط في Firebase، يمكنك استخدام
قائمة قيم مفصولة بفاصلة في علامة ضمن الأمر firebase deploy. على سبيل المثال،
ينشر الأمر التالي محتوى Firebase Hosting وCloud Storage Security Rules.
firebase deploy --only hosting,storage
يسرد الجدول التالي الخدمات والميزات المتاحة للنشر الجزئي. تتوافق الأسماء في العلامات مع المفاتيح في ملف إعدادات firebase.json.
| بنية الإبلاغ | الخدمة أو الميزة التي تم نشرها |
|---|---|
--only auth |
إعدادات موفّر خدمة Authentication |
--only database |
Firebase Realtime Database Security Rules |
--only dataconnect |
مخططات وموصّلات Firebase SQL Connect |
--only firestore |
Cloud Firestore Security Rules وفهارس لجميع قواعد البيانات التي تم ضبطها |
--only functions |
Cloud Functions for Firebase |
--only hosting |
المحتوى باللغة Firebase Hosting |
--only storage |
Cloud Storage for Firebase Security Rules |
تعارضات في النشر لـ "Security Rules"
بالنسبة إلى Firebase Realtime Database وCloud Storage for Firebase وCloud Firestore، يمكنك تحديد Security Rules إما في دليل مشروع على جهاز المستخدم أو في وحدة تحكّم Firebase.
هناك خيار آخر لتجنُّب تعارضات النشر، وهو استخدام النشر الجزئي وتحديد Security Rules فقط في وحدة تحكّم Firebase.
إعداد مهام نصية قبل النشر وبعده
يمكنك ربط نصوص shell البرمجية بالأمر firebase deploy لتنفيذ
مهام ما قبل النشر أو ما بعد النشر. على سبيل المثال، يمكن أن يترجم نص برمجي قبل النشر رمز TypeScript إلى JavaScript، ويمكن أن يرسل خطاف بعد النشر إشعارًا للمشرفين بشأن عمليات نشر محتوى الموقع الإلكتروني الجديد إلى Firebase Hosting.
لإعداد عمليات الربط قبل النشر أو بعده، أضِف نصوص Bash البرمجية إلى ملف إعداد firebase.json. يمكنك تحديد نصوص برمجية مختصرة مباشرةً في ملف firebase.json، أو يمكنك الإشارة إلى ملفات أخرى في دليل مشروعك.
على سبيل المثال، النص البرمجي التالي هو تعبير firebase.json لمهمة ما بعد النشر التي ترسل رسالة Slack عند النشر بنجاح إلى Firebase Hosting.
"hosting": {
// ...
"postdeploy": "./messageSlack.sh 'Just deployed to Firebase Hosting'",
"public": "public"
}
يوجد ملف النص البرمجي messageSlack.sh في دليل المشروع ويبدو
على النحو التالي:
curl -X POST -H 'Content-type: application/json' --data '{"text":"$1"}'
\https://SLACK_WEBHOOK_URLيمكنك إعداد عناصر الجذب predeploy وpostdeploy لأي من
مواد العرض التي يمكنك نشرها. يُرجى العِلم أنّ تشغيل firebase deploy
يؤدي إلى تفعيل جميع مهام ما قبل النشر وما بعده المحدّدة في ملف
firebase.json. لتشغيل المهام المرتبطة بخدمة Firebase معيّنة فقط، استخدِم أوامر النشر الجزئي.
تطبع كل من الخطافات predeploy وpostdeploy الإخراج المعياري وتدفقات الأخطاء للنصوص البرمجية إلى المحطة الطرفية. في حالات تعذُّر النقل، يُرجى مراعاة ما يلي:
- إذا تعذّر إكمال خطاف ما قبل النشر على النحو المتوقّع، يتم إلغاء عملية النشر.
- في حال تعذّر عملية النشر لأي سبب، لن يتم تفعيل عناصر الجذب بعد النشر.
متغيّرات البيئة
في النصوص البرمجية التي يتم تشغيلها في predeploy وpostdeploy hooks، تتوفر متغيرات البيئة التالية:
-
$GCLOUD_PROJECT: رقم تعريف المشروع النشط -
$PROJECT_DIR: الدليل الجذري الذي يحتوي على ملفfirebase.json $RESOURCE_DIR: (للنصوص البرمجيةhostingوfunctionsفقط) موقع الدليل الذي يحتوي على موارد Hosting أو Cloud Functions التي سيتم نشرها
حصص النشر
من الممكن (على الرغم من أنّه من غير المحتمل) أن تتجاوز حصة تحدّ من معدّل أو حجم عمليات نشر Firebase. على سبيل المثال، عند نشر أعداد كبيرة جدًا من الدوال، قد تظهر لك رسالة الخطأ HTTP 429 Quota. لحلّ هذه المشاكل، جرِّب
استخدام النشر الجزئي.
العودة إلى إصدار سابق من عملية النشر
يمكنك التراجع عن عملية نشر Firebase Hosting من صفحة Firebase Hosting في مشروعك من خلال اختيار الإجراء تراجع للإصدار المحدّد.
لا يمكن الرجوع إلى إصدارات سابقة من Security Rules في Firebase Realtime Database أو Cloud Storage for Firebase أو Cloud Firestore.
مرجع الأوامر
يصف هذا القسم الأوامر المتاحة لحالات الاستخدام والمنتجات التالية:
- أوامر إدارة واجهة سطر الأوامر
- طلبات إدارة المشاريع
- النشر والتطوير المحلي
- أوامر App Distribution
- أوامر App Hosting
- أوامر Authentication (إدارة المستخدمين)
- أوامر Cloud Firestore
- أوامر Cloud Functions for Firebase
- أوامر Crashlytics
- أوامر Extensions
- Extensions طلبات تخصّ الناشر
- أوامر Hosting
- أوامر Realtime Database
- أوامر Remote Config
- أوامر SQL Connect
في الجداول التالية، يعرض عمود "الأمر" الوسيطات والعلامات المطلوبة أو المقترَحة لكل أمر، مع وسيطات اختيارية بين قوسين مربعين ([...]). يحتوي عمود "الوصف" على معلومات تفصيلية حول الأمر بالإضافة إلى أي علامات اختيارية إضافية.
تتوفّر العلامات الإضافية التالية عند تشغيل أي أمر:
--help: لطباعة جميع الوسيطات المطلوبة والاختيارية وأي علامات متاحة (وقيمها التلقائية)
--debug: لطباعة مخرجات السجلّ المطوَّليُرجى العِلم أنّه في حال ضبط متغيّر البيئة
DEBUGفي بيئتك (على سبيل المثال،export DEBUG=true)، ستعمل واجهة سطر الأوامر Firebase كما لو أنّك أرسلت العلامة--debugمع كل أمر.
أوامر المشرف في واجهة سطر الأوامر
| الأوامر | الوصف |
|---|---|
help
|
عرض معلومات المساعدة حول واجهة سطر الأوامر أو أوامر معيّنة |
init
|
اربط مشروع Firebase جديدًا وأعدّه في الدليل الحالي.
ينشئ هذا الأمر ملف إعداد firebase.json
في الدليل الحالي.
|
login
|
مصادقة واجهة سطر الأوامر باستخدام حساب Google يتطلب الوصول إلى متصفّح ويب.
لتسجيل الدخول إلى واجهة سطر الأوامر في البيئات البعيدة التي لا تسمح بالوصول إلى |
login:ci
|
متوقّف نهائيًا.
بدلاً من ذلك، يمكنك استخدام "بيانات الاعتماد التلقائية للتطبيق" مع حساب خدمة Google Cloud (GOOGLE_APPLICATION_CREDENTIALS).
يمكنك إنشاء رمز مميّز للمصادقة لاستخدامه في البيئات غير التفاعلية. |
login:add
|
سجِّل الدخول إلى حساب Google إضافي. |
login:list
|
عرض قائمة بجميع حسابات Google التي تمت مصادقتها |
login:use \
|
اضبط حساب Google النشط. |
logout
|
سجِّل الخروج من حساب Google من واجهة سطر الأوامر. |
open
|
افتح متصفحًا لموارد المشروع ذات الصلة. |
projects:list
|
عرض قائمة بجميع مشاريع Firebase التي يمكنك الوصول إليها |
use
|
اضبط مشروع Firebase النشط لواجهة سطر الأوامر (CLI). |
أوامر إدارة المشاريع
| الأوامر | الوصف |
|---|---|
| إدارة مشاريع Firebase | |
projects:addfirebase
|
يمكنك إضافة إعدادات خاصة بـ Firebase وتفعيل خدمات خاصة بـ Firebase في مشروع Google Cloud حالي. |
projects:create
|
أنشئ مشروعًا جديدًا على Google Cloud، ثم أضِف الإعدادات الخاصة بـ Firebase وفعِّل الخدمات الخاصة بـ Firebase في المشروع الجديد. |
projects:list
|
عرض قائمة بجميع مشاريع Firebase التي يمكنك الوصول إليها |
| إدارة تطبيقات Firebase (على أجهزة iOS وAndroid والويب) | |
apps:create
|
أنشئ تطبيق Firebase جديدًا. |
apps:list
|
تعرض هذه الطريقة قائمة بجميع تطبيقات Firebase المسجّلة في مشروع Firebase النشط. |
apps:sdkconfig \
|
طباعة إعدادات Firebase لتطبيق Firebase المحدّد
إذا كانت واجهة سطر الأوامر تعمل في وضع غير تفاعلي:
يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
| إدارة تجزئات شهادات SHA (على Android فقط) | |
apps:android:sha:create \
|
أضِف تجزئة شهادة SHA المحدّدة إلى تطبيق Firebase Android المحدّد. |
apps:android:sha:delete \
|
يؤدي هذا الإجراء إلى حذف شهادة SHA المحدّدة (التي يتم تحديدها من خلال SHA_ID
من apps:android:sha:list) من تطبيق Android المحدّد على Firebase.
|
apps:android:sha:list \
|
تعرض هذه الطريقة قائمة بجميع تجزئات شهادات SHA لتطبيق Firebase Android المحدّد. |
النشر والتطوير على الجهاز
تتيح لك هذه الأوامر نشر مشروع Firebase الخاص بك والتفاعل معه.
| الأوامر | الوصف |
|---|---|
deploy
|
يمكنك نشر الرمز البرمجي ومواد العرض من دليل مشروعك إلى مشروع Firebase النشط.
يتطلّب هذا الأمر ملف إعداد |
serve
|
شغِّل خادمًا محليًا لاختبار إعدادات Firebase Hosting و/أو Cloud Functions HTTP المحلي (على سبيل المثال، باستخدام
يتطلّب هذا الأمر ملف إعداد |
App Distribution طلب
| الأوامر | الوصف |
|---|---|
appdistribution:distribute \
|
تحميل الملف الثنائي المحدّد للإصدار (.apk أو
.aab أو .ipa) وإتاحته للمختبِرين
في تطبيق Firebase المحدّد
|
appdistribution:testers:add \
|
يمكنك إضافة مختبِر واحد أو أكثر (محدّد كـ EMAILS مفصول بمسافة) إلى مشروع Firebase النشط. في حال إسقاط السمة EMAILS، يجب تمرير السمة يؤدي هذا الأمر إلى إضافة المختبِرين غير المدرَجين في المشروع فقط، ولا يؤدي إلى إزالة المختبِرين الحاليين أو استبدالهم. يتيح هذا الأمر استخدام العلامات الاختيارية التالية:
|
appdistribution:testers:remove \
|
إزالة المختبِرين (المحدّدين على أنّهم EMAILS مفصولون بمسافة) من
مشروع Firebase النشط في حال حذف السمة EMAILS، يجب تمرير السمة يتيح هذا الأمر استخدام العلامات الاختيارية التالية:
|
appdistribution:testers:list
|
عرض قائمة بالمختبِرين في مشروع Firebase النشط |
appdistribution:groups:create \
|
إنشاء مجموعة مختبِرين باستخدام السمة DISPLAY_NAME المحدّدة والسمة GROUP_ALIAS الاختيارية
في حال حذف GROUP_ALIAS، يتم إنشاء اسم مستعار تلقائيًا من DISPLAY_NAME. |
appdistribution:groups:delete \
|
حذف مجموعة المختبِرين التي تحمل الاسم المستعار المحدّد |
appdistribution:groups:list
|
تعرض هذه الصفحة قائمة بجميع مجموعات المختبِرين في مشروع Firebase النشط. |
App Hosting طلب
| الأوامر | الوصف |
|---|---|
apphosting:backends:create \
|
يمكنك إنشاء مجموعة الموارد المُدارة المرتبطة بقاعدة رموز برمجية واحدة تتضمّن خلفية "App Hosting". يتيح هذا الأمر استخدام العلامات الاختيارية (ولكن يُنصح بها) التالية:
يتيح هذا الأمر أيضًا استخدام العلامات الاختيارية التالية:
إذا كانت واجهة سطر الأوامر تعمل في وضع غير تفاعلي، يجب توفير كلّ من
|
apphosting:backends:get \
|
استرداد التفاصيل، بما في ذلك عنوان URL المتاح للجميع، لخدمة الخلفية App Hosting المحدّدة
إذا كانت هناك مناطق متعددة تحتوي على خلفية بالسمة BACKEND_ID المحدّدة، تسجّل واجهة سطر الأوامر تحذيرًا وتطبع أول خلفية مطابقة (يُرجى العِلم أنّ هذا الأمر لا يتيح استخدام العلامة |
apphosting:backends:list
|
عرض قائمة بجميع الخلفيات النشطة في App Hosting في مشروع Firebase النشط |
apphosting:backends:delete \
|
حذف الخلفية المحدّدة في App Hosting
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ الإجراءات. لتخطّي
طلب التأكيد (مطلوب في وضع التفاعل)، مرِّر
العلامات التالية:
إذا كانت هناك مناطق متعددة تحتوي على خلفية تتضمّن
BACKEND_ID المحدّد، ستطلب منك واجهة سطر الأوامر في الوضع التفاعلي
اختيار الخلفيات المطلوب حذفها، وستتعذّر العملية في حال تمرير |
apphosting:rollouts:create \
|
إنشاء عملية طرح يتم تفعيلها يدويًا لخدمة الخلفية App Hosting المحدّدة يتيح هذا الأمر استخدام العلامات الاختيارية التالية، المتنافية. إذا لم يتم توفير أي منهما، ستطلب منك واجهة سطر الأوامر الاختيار من قائمة الفروع. في الوضع غير التفاعلي، يجب توفير أحد هذين العلامتين.
إذا كانت هناك عدة مناطق تحتوي على خلفية تتضمّن السمة BACKEND_ID المحدّدة، سيتعذّر تنفيذ هذا الأمر في كل من الوضعَين التفاعلي وغير التفاعلي (يُرجى العِلم أنّ هذا الأمر لا يتيح استخدام العلامة |
apphosting:secrets:set \
|
يمكنك إنشاء رمز سرّي أو تعديله في Google Cloud Secret Manager باستخدام SECRET_NAME المحدّد. يتيح هذا الأمر استخدام العلامة الاختيارية (ولكن يُنصح بها) التالية:
يتيح هذا الأمر أيضًا استخدام العلامة الاختيارية التالية:
إذا كانت واجهة سطر الأوامر تعمل في وضع التفاعل، يمكنك تمرير
|
apphosting:secrets:grantaccess \
|
يمكنك منح أذونات للبيانات السرية المحدّدة لمجموعة من عناوين البريد الإلكتروني الخاصة بالمستخدمين أو المجموعات أو حساب خدمة في الخلفية. ويمكن بعد ذلك الوصول إلى البيانات السرية من خلال App Hosting في وقت الإنشاء أو التشغيل.
يمكنك تمرير قيمة واحدة أو أكثر من قيم SECRET_NAME، مع الفصل بينها بفاصلة. يجب تحديد إما منح إذن الوصول إلى مجموعة من عناوين البريد الإلكتروني الخاصة بالمستخدمين أو المجموعات:
امنح إذن الوصول إلى حساب خدمة في الخلفية:
|
apphosting:secrets:revokeaccess \
|
يمكنك إبطال أذونات الوصول إلى البيانات السرية المحدّدة من مجموعة من عناوين البريد الإلكتروني للمستخدمين أو المجموعات أو من حساب خدمة في الخلفية.
يمكنك تمرير قيمة واحدة أو أكثر من قيم SECRET_NAME، مع الفصل بينها بفاصلة. يجب تحديد إما إبطال إذن الوصول من مجموعة من عناوين البريد الإلكتروني لمستخدمين أو مجموعات:
إبطال إمكانية الوصول من حساب خدمة في الخلفية:
|
apphosting:secrets:describe \
|
استرداد البيانات الوصفية والإصدارات لاسم الرمز السرّي المحدّد |
apphosting:secrets:access \
|
يمكنك الوصول إلى قيمة الرمز السرّي لاسم الرمز السرّي المحدّد في
الإصدار المحدّد.
في حال حذف [@VERSION]، يتم تلقائيًا الوصول إلى أحدث إصدار.
|
أوامر Authentication (إدارة المستخدمين)
| الأوامر | الوصف |
|---|---|
auth:export \
|
يمكنك تصدير حسابات المستخدمين في مشروع Firebase النشط إلى ملف JSON أو CSV. لمزيد من التفاصيل، يُرجى الاطّلاع على صفحة auth:import وauth:export. |
auth:import \
|
استيراد حسابات المستخدمين من ملف JSON أو CSV إلى مشروع Firebase النشط لمزيد من التفاصيل، يُرجى الاطّلاع على صفحة auth:import وauth:export. |
Cloud Firestore طلب
| الأوامر | الوصف |
|---|---|
firestore:locations
|
عرض المواقع الجغرافية المتاحة لمثيلات قاعدة بيانات Cloud Firestore في مشروع Firebase النشط تعرَّف على المواقع الجغرافية المتاحة لكل من الإصدار العادي وإصدار Enterprise والتوافق مع MongoDB. |
firestore:databases:create \
|
إنشاء مثيل قاعدة بيانات Cloud Firestore المحدّد (في الوضع الأصلي)
في الموقع الجغرافي المحدّد
يتيح هذا الأمر استخدام العلامات الاختيارية التالية:
|
firestore:databases:list |
عرض قائمة بجميع مثيلات قاعدة بيانات Cloud Firestore في مشروع Firebase النشط |
firestore:databases:get \
|
استرداد إعدادات قاعدة البيانات لمثيل قاعدة بيانات Cloud Firestore المحدّد
يتضمّن الجدول الناتج |
firestore:databases:update \
|
تعديل إعدادات قاعدة البيانات لمثيل قاعدة البيانات Cloud Firestore المحدّد يجب تحديد علامة واحدة على الأقل (تحتفظ العلامات المحذوفة بإعداداتها الحالية). يتيح هذا الأمر استخدام العلامات التالية:
|
firestore:databases:delete \
|
حذف مثيل قاعدة بيانات Cloud Firestore المحدّد
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ الإجراءات. لتخطّي
طلب التأكيد (مطلوب في الوضع غير التفاعلي)، مرِّر
العلامة |
firestore:indexes
|
إدراج جميع الفهارس لمثيل قاعدة بيانات Cloud Firestore يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
firestore:delete \
|
حذف المستندات في مسار قاعدة البيانات المحدّد (PATH) من مثيل قاعدة بيانات Cloud Firestore
يجب استخدام السمة PATH ما لم يتم تمرير السمة يُرجى العِلم أنّ حذف بيانات Cloud Firestore باستخدام واجهة سطر الأوامر (CLI) يؤدي إلى تحمُّل تكاليف القراءة والحذف. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة فهم فوترة Cloud Firestore. يتيح هذا الأمر استخدام العلامات الاختيارية التالية:
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ الإجراءات. لتخطّي
طلب التأكيد (مطلوب في وضع التفاعل)، مرِّر
العلامات التالية: |
Cloud Functions for Firebase طلب
لمزيد من المعلومات، يُرجى الاطّلاع على مستندات إعداد البيئة.
| الأوامر | الوصف |
|---|---|
functions:config:export
|
تصدير الإعدادات القديمة لوقت تشغيل يتيح هذا الأمر استخدام العلامات الاختيارية التالية:
|
functions:delete \
|
حذف دالة واحدة أو أكثر من الدوال المحدّدة من مشروع Firebase النشط
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ الإجراءات. لتخطّي
طلب التأكيد (مطلوب في وضع التفاعل)، مرِّر
العلامات التالية: |
functions:list
|
تعرض هذه الأداة قائمة بجميع الدوال المنشورة في مشروع Firebase النشط. |
functions:log
|
قراءة السجلّات من جميع Cloud Functions المنشورة في مشروع Firebase النشط |
functions:secrets:access \
|
يمكنك الوصول إلى قيمة الرمز السرّي لاسم الرمز السرّي المحدّد في
الإصدار المحدّد.
في حال حذف [@VERSION]، يتم تلقائيًا الوصول إلى أحدث إصدار.
|
functions:secrets:destroy \
|
تدمير واجهة برمجة التطبيقات السرّية المحدّدة في الإصدار المحدّد
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ أي إجراء، ويتم تأكيدها تلقائيًا في الوضع غير التفاعلي بدون |
functions:secrets:get \
|
استرداد البيانات الوصفية والإصدارات لاسم الرمز السرّي المحدّد |
functions:secrets:prune
|
تدمير جميع الرموز السرية غير المستخدَمة في مشروع Firebase النشط |
functions:secrets:set \
|
إنشاء أو تعديل السرّ المحدّد |
functions:shell
|
ابدأ واجهة تفاعلية محلية لاختبار الدوال. |
functions:config:clone \
|
متوقّف نهائيًا.
يكون هذا الخيار غير مفعَّل تلقائيًا. لاستخدام هذا الأمر، عليك أولاً تشغيل
|
functions:config:get
|
متوقّف نهائيًا.
استرداد قيم الإعدادات الحالية لمشروع Firebase النشط Cloud Functions. |
functions:config:set \
|
متوقّف نهائيًا.
يكون هذا الخيار غير مفعَّل تلقائيًا. لاستخدام هذا الأمر، عليك أولاً تشغيل
|
functions:config:unset \
|
متوقّف نهائيًا.
يكون هذا الخيار غير مفعَّل تلقائيًا. لاستخدام هذا الأمر، عليك أولاً تشغيل
|
Crashlytics طلب
| الأوامر | الوصف |
|---|---|
crashlytics:mappingfile:generateid \
|
أنشِئ معرِّف ملف فريدًا في ملف موارد Android (XML) المحدّد. |
crashlytics:mappingfile:upload \
|
يتم تحميل ملف ربط (TXT) متوافق مع Proguard لتطبيق Firebase المحدّد، وربطه بمعرّف ملف الربط المُعلن عنه في ملف موارد Android (XML) المحدّد. |
crashlytics:setup \
|
يمكنك إعداد Crashlytics لتطبيق الويب المحدّد على Firebase، بما في ذلك تفعيل واجهات برمجة التطبيقات المطلوبة وضبط إعدادات القياس عن بُعد. |
crashlytics:sourcemap:upload \
|
البحث بشكل متكرر عن ملفات خرائط المصدر ( يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
crashlytics:symbols:upload \
|
أنشئ ملف رموز متوافقًا مع Crashlytics لحالات تعطُّل مكتبة Android المجمّعة من رموز برمجية أصلية (على سبيل المثال، Android NDK أو إصدارات Android من Unity أو Flutter) وحمِّله إلى خوادم Firebase.
يتوافق هذا الأمر مع Android فقط. بالنسبة إلى ملفات dSYM لنظام التشغيل iOS، استخدِم النص البرمجي |
Extensions طلب
| الأوامر | الوصف |
|---|---|
ext
|
عرض معلومات حول كيفية استخدام أوامر Firebase Extensions
عرض قائمة بنُسخ الإضافات المثبَّتة في المشروع النشط |
ext:configure \
|
أعِد ضبط قيم مَعلمات نسخة الإضافة في ملف بيان الإضافة. |
ext:info \
|
طباعة معلومات تفصيلية عن إضافة معيّنة |
ext:install \
|
أضِف مثيلاً جديدًا لإضافة إلى ملف بيان الإضافة. |
ext:sdk:install \
|
ثبِّت حزم تطوير البرامج (SDK) لتحديد الإضافات في الدوال. |
ext:list
|
تعرض هذه الطريقة قائمة بجميع نُسخ الإضافات المثبَّتة في مشروع Firebase.
اطبع معرّف المثيل لكل إضافة. |
ext:uninstall \
|
أزِل نسخة الإضافة من ملف بيان الإضافة. |
ext:update \
|
يمكنك تحديث نسخة من الإضافة إلى أحدث إصدار (أو إلى إصدار UPDATE_SOURCE المنشور المحدّد) في ملف بيان الإضافة. يُرجى العِلم أنّه بالنسبة إلى UPDATE_SOURCE، لا يمكن استخدام المسارات المحلية وعناوين URL.
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ الإجراءات. يمكنك
تمرير |
ext:export
|
تصدير جميع نُسخ الإضافات المثبّتة من مشروعك إلى ملف بيان الإضافة |
Extensions طلبات للناشر
| الأوامر | الوصف |
|---|---|
ext:dev:init
|
تهيئة قاعدة رموز برمجية هيكلية لإضافة جديدة في الدليل الحالي |
ext:dev:list \
|
طباعة قائمة بجميع الإضافات التي حمّلها ناشر معيّن |
ext:dev:register
|
غير مفعَّلة:
لم يعُد من الممكن تسجيل معرّفات جديدة للملفات الشخصية للناشرين. |
ext:dev:deprecate \
|
إيقاف نهائي
لإصدارات الإضافات التي تتطابق مع الإصدار المحدّد
يمكن أن يكون شرط الإصدار إصدارًا واحدًا (مثل 1.0.0)
أو نطاقًا من الإصدارات (مثل >1.0.0).
في حال عدم تقديم شرط إصدار، يتم إيقاف جميع إصدارات هذه الإضافة نهائيًا. |
ext:dev:undeprecate \
|
إلغاء إيقاف
إصدارات الإضافات التي تتطابق مع دالة الإصدار
يمكن أن يكون شرط الإصدار إصدارًا واحدًا (مثل 1.0.0)
أو نطاقًا من الإصدارات (مثل >1.0.0).
|
ext:dev:upload \
|
تحميل إصدار جديد من الإضافة |
ext:dev:usage \
|
عرض عدد عمليات التثبيت ومقاييس الاستخدام للإضافات التي حمّلها ناشر |
Hosting طلب
| الأوامر | الوصف |
|---|---|
hosting:disable
|
إيقاف عرض زيارات Firebase Hosting لموقع إلكتروني باللغة Hosting سيعرض عنوان URL الخاص بالموقع الإلكتروني Hosting رسالة "لم يتم العثور على الموقع الإلكتروني" بعد تنفيذ هذا الأمر. يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ الإجراءات. لتخطّي
طلب التأكيد (مطلوب في وضع التفاعل)، مرِّر
العلامات التالية: |
| إدارة مواقع إلكترونية عددها Hosting | |
hosting:sites:create \
|
إنشاء موقع إلكتروني جديد على "Hosting" باستخدام SITE_ID المحدّد إذا كانت واجهة سطر الأوامر تعمل في وضع غير تفاعلي، تكون السمة SITE_ID مطلوبة. يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
hosting:sites:delete \
|
حذف موقع Hosting الإلكتروني المحدّد
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ الإجراءات. لتخطّي
طلب التأكيد (مطلوب في وضع التفاعل)، مرِّر
العلامات التالية: |
hosting:sites:get \
|
استرداد التفاصيل حول موقع Hosting المحدّد
يتضمّن ناتج الجدول رقم تعريف الموقع الإلكتروني وعنوان URL التلقائي ورقم تعريف تطبيق الويب في Firebase (إذا كان مرتبطًا). لا يتم تضمين البيانات الوصفية الإضافية (مثل ما إذا كان الموقع الإلكتروني هو |
hosting:sites:list
|
عرض قائمة بجميع مواقع Hosting الإلكترونية في مشروع Firebase النشط |
| إدارة قنوات المعاينة | |
hosting:channel:create \
|
إنشاء قناة معاينة جديدة لموقع إلكتروني على Hosting باستخدام CHANNEL_ID المحدّد
إذا كانت واجهة سطر الأوامر تعمل في وضع غير تفاعلي، تكون السمة CHANNEL_ID مطلوبة. يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
hosting:channel:delete \
|
لحذف قناة المعاينة المحدّدة لا يمكنك حذف قناة مباشرة لموقع إلكتروني. يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ الإجراءات. لتخطّي
طلب التأكيد (مطلوب في وضع التفاعل)، مرِّر
العلامات التالية: |
hosting:channel:deploy \
|
يمكنك نشر محتوى وإعدادات Hosting في قناة المعاينة المحدّدة.
يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
hosting:channel:list
|
تتيح هذه الطريقة عرض قائمة بجميع القنوات (بما في ذلك القناة "المباشرة") لموقع إلكتروني على Hosting. يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
hosting:channel:open \
|
فتح متصفّح على عنوان URL للقناة المحدّدة أو عرض عنوان URL إذا تعذّر فتحه في متصفّح إذا كانت واجهة سطر الأوامر تعمل في وضع غير تفاعلي، تكون السمة CHANNEL_ID مطلوبة. يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
| استنساخ الإصدارات | |
hosting:clone \
|
استنسِخ أحدث إصدار تم نشره على قناة "المصدر" المحدّدة إلى قناة "الهدف" المحدّدة. ينشر هذا الأمر أيضًا في القناة "المستهدَفة" المحدّدة. إذا لم تكن القناة "المستهدَفة" متوفّرة بعد، ينشئ هذا الأمر قناة معاينة جديدة في الموقع الإلكتروني "المستهدَف" Hosting قبل النشر في القناة. |
hosting:clone \
|
استنسِخ الإصدار المحدّد إلى القناة "المستهدَفة" المحدّدة. ينشر هذا الأمر أيضًا في القناة "المستهدَفة" المحدّدة. إذا لم تكن القناة "المستهدَفة" متوفّرة بعد، ينشئ هذا الأمر قناة معاينة جديدة في الموقع الإلكتروني "المستهدَف" Hosting قبل النشر في القناة. يمكنك العثور على VERSION_ID في لوحة بيانات Hosting ضمن وحدة تحكّم Firebase. |
Realtime Database طلب
يُرجى العِلم أنّه يمكنك إنشاء مثيل Realtime Database الأولي التلقائي في وحدة تحكّم Firebase أو باستخدام سير العمل العام في firebase init أو سير العمل المحدّد في firebase init database.
بعد إنشاء النُسخ، يمكنك إدارتها كما هو موضّح في إدارة نُسخ معيّنة والتفاعل معها باستخدام واجهة سطر الأوامر.
| الأوامر | الوصف |
|---|---|
database:get \
|
استرداد البيانات في الموقع الجغرافي المحدّد لقاعدة البيانات (PATH) لمثيل Realtime Database وعرض البيانات بتنسيق JSON يتيح إمكانية الاستعلام عن البيانات المفهرَسة. يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
database:instances:create \
|
أنشئ مثيل Realtime Database باستخدام DATABASE_NAME المحدّد في الموقع الجغرافي المحدّد. يتيح هذا الأمر استخدام العلامة الاختيارية (ولكن يُنصح بها) التالية:
لا يمكنك استخدام هذا الأمر لإنشاء مثيل Realtime Database التلقائي لمشروع Firebase النشط. إذا لم يتضمّن المشروع أي مثيلات حالية لـ Realtime Database، سيُطلب منك تشغيل مسار |
database:instances:list
|
عرض قائمة بجميع مثيلات Realtime Database في مشروع Firebase النشط يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
database:profile
|
إنشاء ملف شخصي للعمليات لمثيل Realtime Database
يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
database:push \
|
إرسال بيانات جديدة إلى قائمة في الموقع الجغرافي المحدّد لقاعدة البيانات (PATH) في مثيل Realtime Database
يتم أخذ الإدخال من ملف (INFILE) أو STDIN أو العلامة
يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
database:remove \
|
حذف جميع البيانات في الموقع الجغرافي المحدّد لقاعدة البيانات (PATH) في مثيل Realtime Database يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ الإجراءات. لتخطّي
طلب التأكيد (مطلوب في وضع التفاعل)، مرِّر
العلامات التالية: |
database:set \
|
استبدال جميع البيانات في الموقع الجغرافي المحدّد لقاعدة البيانات (PATH) في مثيل Realtime Database.
يتم أخذ الإدخال من ملف (INFILE) أو STDIN أو العلامة
يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ الإجراءات. لتخطّي
طلب التأكيد (مطلوب في وضع التفاعل)، مرِّر
العلامات التالية: |
database:update \
|
إجراء تعديل جزئي في الموقع الجغرافي المحدّد لقاعدة البيانات (PATH) في مثيل Realtime Database
يتم أخذ الإدخال من ملف (INFILE) أو STDIN أو العلامة
يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ الإجراءات. لتخطّي
طلب التأكيد (مطلوب في وضع التفاعل)، مرِّر
العلامات التالية: |
Remote Config طلب
يتم تناول هذه الأوامر وحالات استخدامها بمزيد من التفصيل في مقالة تعديل Remote Config آليًا.
| الأوامر | الوصف |
|---|---|
remoteconfig:versions:list
|
أدرِج جميع إصدارات نموذج Remote Config. يتيح هذا الأمر استخدام العلامة الاختيارية التالية:
|
remoteconfig:get \
|
استرداد تفاصيل نموذج "Remote Config" في الإصدار المحدّد يتيح هذا الأمر استخدام العلامات الاختيارية (ولكن يُنصح بها) التالية:
|
remoteconfig:rollback \
|
العودة إلى الإصدار السابق المحدّد من نموذج "Remote Config" يتيح هذا الأمر استخدام العلامة الاختيارية (ولكن يُنصح بها) التالية:
تعرض واجهة سطر الأوامر رسالة تأكيد قبل اتخاذ الإجراءات. لتخطّي
طلب التأكيد (مطلوب في وضع التفاعل)، مرِّر
العلامات التالية: |
remoteconfig:experiments:list
|
عرض قائمة بجميع تجارب Remote Config في مشروع Firebase النشط يتيح هذا الأمر استخدام العلامات الاختيارية التالية:
|
remoteconfig:experiments:get \
|
استرداد تفاصيل تجربة "Remote Config" المحدّدة
يتضمّن الجدول اسم مورد التجربة واسمها المعروض وحالتها ( |
remoteconfig:experiments:delete \
|
حذف تجربة Remote Config المحدّدة
تعرض واجهة سطر الأوامر طلب تأكيد قبل اتخاذ الإجراء ولا تتيح استخدام العلامة |
remoteconfig:rollouts:list
|
عرض قائمة بجميع عمليات طرح Remote Config في مشروع Firebase النشط يتيح هذا الأمر استخدام العلامات الاختيارية التالية:
|
remoteconfig:rollouts:get \
|
استرداد تفاصيل عملية طرح Remote Config المحدّدة |
remoteconfig:rollouts:delete \
|
حذف عملية طرح Remote Config المحدّدة
تعرض واجهة سطر الأوامر طلب تأكيد قبل اتخاذ الإجراء ولا تتيح استخدام العلامة |
SQL Connect طلب
يتم تناول هذه الأوامر وحالات استخدامها بمزيد من التفصيل في دليل مرجع واجهة سطر أوامر SQL Connect.
| الأوامر | الوصف |
|---|---|
dataconnect:services:list
|
عرض قائمة بجميع خدمات SQL Connect المنشورة في مشروع Firebase النشط |
dataconnect:sql:diff
|
عرض الاختلافات بين مخطط SQL Connect محلي ومخطط قاعدة بيانات Cloud SQL يتيح هذا الأمر استخدام العلامات الاختيارية التالية:
|
dataconnect:sql:migrate
|
انقل مخطط قاعدة بيانات Cloud SQL لمطابقة مخطط SQL Connect المحلي. يتيح هذا الأمر استخدام العلامات الاختيارية التالية:
في الوضع التفاعلي، تعرض واجهة سطر الأوامر طلب تأكيد قبل
اتخاذ الإجراء. في الوضع غير التفاعلي، يتم تشغيل عمليات النقل غير المدمّرة
تلقائيًا، بينما يتم إلغاء التغييرات المدمّرة ما لم يتم تمرير
|
dataconnect:sql:grant \
|
يتم منح SQL_ROLE المحدّد (أحد الخيارات التالية: يتيح هذا الأمر استخدام العلامات الاختيارية التالية:
|
dataconnect:sdk:generate
|
إنشاء حِزم تطوير برامج (SDK) مكتوبة لموصّلات SQL Connect يتيح هذا الأمر استخدام العلامات الاختيارية التالية:
|