مرجع واجهة سطر الأوامر في Firebase

توفّر واجهة سطر الأوامر Firebase(GitHub) مجموعة متنوعة من الأدوات لإدارة مشاريع Firebase وعرضها ونشرها.

قبل استخدام واجهة سطر الأوامر Firebase، عليك إعداد مشروع Firebase.

إعداد واجهة سطر الأوامر أو تعديلها

تثبيت واجهة سطر الأوامر Firebase

يمكنك تثبيت واجهة سطر الأوامر Firebase باستخدام طريقة تتوافق مع نظام التشغيل ومستوى خبرتك و/أو حالة الاستخدام. بغض النظر عن طريقة تثبيت واجهة سطر الأوامر، يمكنك الوصول إلى الوظائف نفسها والأمر firebase.

Windows macOS Linux

Windows

يمكنك تثبيت واجهة سطر الأوامر Firebase لنظام التشغيل Windows باستخدام أحد الخيارَين التاليَين:

الخيار	الوصف	محتوى مقترَح لـ...
standalone binary	نزِّل الملف الثنائي المستقل لسطر الأوامر (CLI). بعد ذلك، يمكنك الوصول إلى الملف التنفيذي لفتح نافذة سطر أوامر يمكنك فيها تنفيذ الأمر `firebase`.	المطوّرون الجدد المطوّرون الذين لا يستخدمون أو لا يعرفون Node.js
npm	استخدِم npm (أداة إدارة حِزم Node) لتثبيت واجهة سطر الأوامر وتفعيل الأمر `firebase` المتاح على مستوى العالم.	المطوّرون الذين يستخدمون Node.js

ملف ثنائي مستقل

لتنزيل وتشغيل الملف الثنائي لواجهة سطر الأوامر Firebase، اتّبِع الخطوات التالية:

نزِّل Firebase ملفًا ثنائيًا لواجهة سطر الأوامر لنظام التشغيل Windows.
يمكنك الوصول إلى الملف الثنائي لفتح نافذة يمكنك فيها تنفيذ الأمر firebase.
تابِع تسجيل الدخول واختبِر واجهة سطر الأوامر.

npm

لاستخدام npm (أداة إدارة حِزم Node) لتثبيت واجهة سطر الأوامر Firebase، اتّبِع الخطوات التالية:

ثبِّت Node.js باستخدام nvm-windows (أداة إدارة إصدارات Node). يؤدي تثبيت Node.js إلى تثبيت أدوات الأوامر npm تلقائيًا.

ملاحظة: تتطلّب واجهة سطر الأوامر Firebase الإصدار 18.0.0 من Node.js أو إصدارًا أحدث. قد تتطلّب بعض ميزات Firebase إصدارات معيّنة من Node.js، لذا راجِع صفحة "بدء الاستخدام" لكل منتج من منتجات Firebase لمعرفة أي متطلبات معيّنة بشأن Node.js.
ثبِّت Firebase CLI من خلال npm عن طريق تنفيذ الأمر التالي:
```
npm install -g firebase-tools
```
يتيح هذا الأمر استخدام الأمر firebase المتاح على مستوى العالم.

ملاحظة: إذا تعذّر تنفيذ الأمر npm install -g firebase-tools، قد تحتاج إلى تغيير أذونات npm.
تابِع تسجيل الدخول واختبِر واجهة سطر الأوامر.

نظام التشغيل macOS أو Linux

يمكنك تثبيت واجهة سطر الأوامر Firebase لنظام التشغيل macOS أو Linux باستخدام أحد الخيارَين التاليَين:

الخيار	الوصف	محتوى مقترَح لـ...
نص التثبيت التلقائي	نفِّذ أمرًا واحدًا يرصد نظام التشغيل تلقائيًا، ثم نزِّل أحدث إصدار من واجهة سطر الأوامر، ثم فعِّل الأمر `firebase` المتاح على مستوى العالم.	المطوّرون الجدد المطوّرون الذين لا يستخدمون أو لا يعرفون Node.js عمليات النشر المبرمَجة في بيئة التكامل المستمر/التسليم المستمر
standalone binary	نزِّل الملف الثنائي المستقل لسطر الأوامر (CLI). بعد ذلك، يمكنك ضبط وتشغيل الملف الثنائي بما يتناسب مع سير عملك.	سير عمل قابل للتخصيص بالكامل باستخدام واجهة سطر الأوامر
npm	استخدِم npm (أداة إدارة حِزم Node) لتثبيت واجهة سطر الأوامر وتفعيل الأمر `firebase` المتاح على مستوى العالم.	المطوّرون الذين يستخدمون Node.js

نص برمجي للتثبيت التلقائي

لتثبيت واجهة سطر الأوامر Firebase باستخدام نص التثبيت التلقائي، اتّبِع الخطوات التالية:

نفِّذ أمر cURL التالي:
```
curl -sL https://firebase.tools | bash
```
يكتشف هذا النص البرمجي تلقائيًا نظام التشغيل لديك، ثم ينزّل أحدث إصدار من واجهة سطر الأوامر Firebase، ثم يفعّل الأمر firebase المتاح على مستوى العالم.

ملاحظة: إذا واجهت مشاكل في الأذونات عند التثبيت على نظام التشغيل MacOS أو Linux، قد تحتاج إلى استخدام sudo لمنح النص البرمجي الأذونات المطلوبة: sudo curl -sL https://firebase.tools | bash
تابِع تسجيل الدخول واختبِر واجهة سطر الأوامر.

للاطّلاع على المزيد من الأمثلة والتفاصيل حول النص البرمجي للتثبيت التلقائي، يُرجى الرجوع إلى الرمز المصدر للنص البرمجي على firebase.tools.

ملف ثنائي مستقل

لتنزيل وتشغيل الرمز الثنائي لواجهة سطر الأوامر Firebase المخصّصة لنظام التشغيل، اتّبِع الخطوات التالية:

نزِّل ملف Firebase الثنائي لواجهة سطر الأوامر لنظام التشغيل: macOS | Linux
(اختياري) إعداد الأمر firebase المتاح على مستوى العالم
1. اجعل الملف الثنائي قابلاً للتنفيذ عن طريق تشغيل chmod +x ./firebase_tools.
2. أضِف مسار الملف الثنائي إلى PATH.
ملاحظة: إذا اخترت عدم إعداد الأمر firebase، عليك الوصول إلى الملف الثنائي في كل مرة تريد فيها تنفيذ أمر Firebase لواجهة سطر الأوامر.
تابِع تسجيل الدخول واختبِر واجهة سطر الأوامر.

npm

لاستخدام npm (أداة إدارة حِزم Node) لتثبيت واجهة سطر الأوامر Firebase، اتّبِع الخطوات التالية:

ثبِّت Node.js باستخدام nvm (أداة إدارة إصدارات Node).
يؤدي تثبيت Node.js إلى تثبيت أدوات الأوامر npm تلقائيًا.

ملاحظة: تتطلّب واجهة سطر الأوامر Firebase الإصدار 18.0.0 من Node.js أو إصدارًا أحدث. قد تتطلّب بعض ميزات Firebase إصدارات معيّنة من Node.js، لذا راجِع صفحة "بدء الاستخدام" لكل منتج من منتجات Firebase لمعرفة أي متطلبات معيّنة بشأن Node.js.
ثبِّت Firebase CLI من خلال npm عن طريق تنفيذ الأمر التالي:
```
npm install -g firebase-tools
```
يتيح هذا الأمر استخدام الأمر firebase المتاح على مستوى العالم.

ملاحظة: إذا تعذّر تنفيذ الأمر npm install -g firebase-tools، قد تحتاج إلى تغيير أذونات npm.
تابِع تسجيل الدخول واختبِر واجهة سطر الأوامر.

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

سجِّل الدخول إلى Firebase باستخدام حسابك على Google من خلال تنفيذ الأمر التالي:
```
firebase login
```
يربط هذا الأمر جهازك المحلي بخدمة Firebase ويمنحك إذن الوصول إلى مشاريعك على Firebase.

ملاحظة: يفتح الأمر firebase login صفحة ويب تتصل بـ localhost على جهازك. إذا كنت تستخدم جهازًا بعيدًا ولا يمكنك الوصول إلى localhost، شغِّل الأمر مع العلامة --no-localhost.
ملاحظة: يمكنك أيضًا استخدام واجهة سطر الأوامر Firebase مع أنظمة التكامل المستمر.
اختبِر أنّ أداة سطر الأوامر مثبّتة بشكلٍ صحيح ويمكنها الوصول إلى حسابك من خلال إدراج مشاريعك على Firebase. نفِّذ الأمر التالي:
```
firebase projects:list
```
يجب أن تكون القائمة المعروضة هي نفسها مشاريع Firebase المُدرَجة في وحدة تحكّم Firebase.

التحديث إلى أحدث إصدار من واجهة سطر الأوامر

بشكل عام، من الأفضل استخدام أحدث إصدار من Firebase CLI.

تعتمد طريقة تعديل إصدار واجهة سطر الأوامر على نظام التشغيل وطريقة تثبيت واجهة سطر الأوامر.

نظام التشغيل Windows

ملف ثنائي مستقل: نزِّل الإصدار الجديد، ثم استبدِله على نظامك
npm: شغِّل npm install -g firebase-tools

‫macOS

نص التثبيت التلقائي: شغِّل curl -sL https://firebase.tools | upgrade=true bash

ملاحظة: إذا واجهت مشاكل في الأذونات عند التثبيت على نظام التشغيل MacOS أو Linux، قد تحتاج إلى استخدام sudo لمنح النص البرمجي الأذونات المطلوبة: sudo curl -sL https://firebase.tools | upgrade=true bash
الحزمة الثنائية المستقلة: نزِّل الإصدار الجديد، ثم استبدِله على نظامك
npm: شغِّل npm install -g firebase-tools

Linux

نص التثبيت التلقائي: شغِّل curl -sL https://firebase.tools | upgrade=true bash

ملاحظة: إذا واجهت مشاكل في الأذونات عند التثبيت على نظام التشغيل MacOS أو Linux، قد تحتاج إلى استخدام sudo لمنح النص البرمجي الأذونات المطلوبة: sudo curl -sL https://firebase.tools | upgrade=true bash
الحزمة الثنائية المستقلة: نزِّل الإصدار الجديد، ثم استبدِله على نظامك
npm: شغِّل npm install -g firebase-tools

إلغاء تثبيت واجهة سطر الأوامر Firebase

تعتمد طريقة إلغاء تثبيت واجهة سطر الأوامر على نظام التشغيل وطريقة تثبيتها.

نظام التشغيل Windows

برنامج ثنائي مستقل: احذف البرنامج الثنائي firebase.exe الذي نزّلته.
npm: شغِّل npm uninstall -g firebase-tools

‫macOS

نص التثبيت التلقائي: شغِّل curl -sL https://firebase.tools | uninstall=true bash

ملاحظة: إذا واجهت مشاكل في الأذونات عند إلغاء التثبيت على نظام التشغيل MacOS أو Linux، قد تحتاج إلى استخدام sudo لمنح النص البرمجي الأذونات المطلوبة: sudo 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

ملاحظة: إذا واجهت مشاكل في الأذونات عند إلغاء التثبيت على نظام التشغيل MacOS أو Linux، قد تحتاج إلى استخدام sudo لمنح النص البرمجي الأذونات المطلوبة: sudo curl -sL https://firebase.tools | uninstall=true bash
برنامج ثنائي مستقل: احذف البرنامج الثنائي firebase الذي نزّلته. إذا أضفت موقعه الجغرافي إلى متغيّر البيئة PATH، احرص على إزالته.
npm: شغِّل npm uninstall -g firebase-tools

استخدام واجهة سطر الأوامر مع أنظمة التكامل المستمر

ننصحك بالمصادقة باستخدام بيانات الاعتماد التلقائية للتطبيق عند استخدام واجهة سطر الأوامر مع أنظمة التكامل المستمر.

(يُنصح به) استخدام بيانات الاعتماد التلقائية للتطبيق

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

(قديم) استخدِم `FIREBASE_TOKEN`

يمكنك بدلاً من ذلك إثبات ملكية حسابك باستخدام FIREBASE_TOKEN. هذه الطريقة أقل أمانًا من بيانات الاعتماد التلقائية للتطبيق، ولم يعُد يُنصح بها.

على جهاز مزوّد بمتصفّح، ثبِّت Firebase CLI.
ابدأ عملية تسجيل الدخول بتنفيذ الأمر التالي:
```
firebase login:ci
```
انتقِل إلى عنوان URL المقدَّم، ثم سجِّل الدخول باستخدام حساب Google.
اطبع رمزًا مميزًا لإعادة التحميل جديدًا. لن تتأثر جلسة واجهة سطر الأوامر الحالية.
خزِّن الرمز المميز الناتج بطريقة آمنة ولكن يمكن الوصول إليها في نظام التكامل المستمر.
استخدِم هذا الرمز المميّز عند تنفيذ أوامر firebase. يمكنك استخدام أحد الخيارَين التاليَين:
- الخيار 1: تخزين الرمز المميّز كمتغيّر بيئة FIREBASE_TOKEN سيستخدم نظامك الرمز المميّز تلقائيًا.
- الخيار 2: نفِّذ جميع أوامر firebase باستخدام العلامة --token TOKEN في نظام التكامل المستمر.
  في ما يلي ترتيب الأولوية لتحميل الرمز المميّز: العلامة ومتغيّر البيئة ومشروع Firebase المطلوب.

إعداد مشروع Firebase

تتطلّب العديد من المهام الشائعة التي يتم تنفيذها باستخدام واجهة سطر الأوامر، مثل النشر في مشروع Firebase، دليل مشروع. يمكنك إنشاء دليل مشروع باستخدام الأمر firebase init. عادةً ما يكون دليل المشروع هو الدليل نفسه الذي يضم جذر نظام التحكّم بالمصادر، وبعد تشغيل firebase init، سيحتوي الدليل على ملف إعداد firebase.json.

لبدء مشروع جديد على Firebase، نفِّذ الأمر التالي من داخل دليل تطبيقك:

firebase init

تساعدك الخطوة firebase init في إعداد دليل مشروعك وبعض منتجات Firebase. أثناء إعداد المشروع، يطلب منك Firebase CLI إكمال المهام التالية:

اختَر مشروعًا تلقائيًا على Firebase.

تربط هذه الخطوة دليل المشروع الحالي بمشروع Firebase، ما يتيح تنفيذ الأوامر الخاصة بالمشروع (مثل firebase deploy) على مشروع Firebase المناسب.

من الممكن أيضًا ربط عدة مشاريع في Firebase (مثل مشروع تجريبي ومشروع إنتاج) بدليل المشروع نفسه.
اختَر منتجات Firebase المطلوبة لإعدادها في مشروعك على Firebase.

تطلب منك هذه الخطوة ضبط إعدادات لملفات معيّنة للمنتجات المحدّدة. لمزيد من التفاصيل حول عمليات الإعداد هذه، راجِع مستندات المنتج المعنيّ (على سبيل المثال، Hosting). يُرجى العِلم أنّه يمكنك تشغيل firebase init في وقت لاحق لإعداد المزيد من منتجات Firebase.

في نهاية عملية الإعداد، ينشئ Firebase تلقائيًا الملفَين التاليَين في جذر دليل تطبيقك على الجهاز:

ملف إعداد firebase.json يتضمّن قائمة بإعدادات مشروعك
ملف .firebaserc يخزّن أسماءك المستعارة للمشروع.

الملف `firebase.json`

ينشئ الأمر firebase init ملف إعداد firebase.json في جذر دليل مشروعك.

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

يمكنك ضبط معظم خيارات Firebase Hosting مباشرةً في ملف firebase.json. ومع ذلك، بالنسبة إلى خدمات Firebase الأخرى التي يمكن نشرها باستخدام Firebase CLI، ينشئ الأمر firebase init ملفات محدّدة يمكنك فيها تحديد إعدادات هذه الخدمات، مثل ملف index.js لخدمة Cloud Functions. يمكنك أيضًا إعداد خطافات ما قبل النشر أو ما بعد النشر في ملف firebase.json.

في ما يلي مثال على ملف firebase.json يتضمّن الإعدادات التلقائية في حال اختيار Firebase Hosting وCloud Firestore وCloud Functions for Firebase (مع تحديد خيارات مصدر TypeScript وlint) أثناء عملية الإعداد.

{
  "hosting": {
    "public": "public",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ]
  },
  "firestore": {
      "rules": "firestore.rules",
      "indexes": "firestore.indexes.json"
  },
  "functions": {
    "predeploy": [
      "npm --prefix \"$RESOURCE_DIR\" run lint",
      "npm --prefix \"$RESOURCE_DIR\" run build"
    ]
  }
}

على الرغم من استخدام 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 \ PROJECT_ID\|ALIAS`	توجّه جميع الأوامر إلى مشروع Firebase المحدّد لتنفيذها. يستخدم واجهة سطر الأوامر هذا المشروع باعتباره "المشروع النشط" حاليًا.
`firebase use --clear`	يمحو المشروع النشط. نفِّذ الأمر `firebase use PROJECT_ID\|ALIAS` لضبط مشروع نشط جديد قبل تنفيذ أوامر أخرى من واجهة سطر الأوامر.
`firebase use \ --unalias PROJECT_ALIAS`	تزيل هذه السمة اسمًا مستعارًا من دليل مشروعك.

يمكنك إلغاء المشروع النشط حاليًا من خلال إضافة العلامة --project إلى أي أمر من أوامر واجهة سطر الأوامر. على سبيل المثال، يمكنك ضبط واجهة سطر الأوامر (CLI) لتنفيذ عملية على مشروع Firebase الذي خصّصت له الاسم المستعار staging. إذا أردت تنفيذ أمر واحد على مشروع Firebase الذي خصّصت له الاسم المستعار prod، يمكنك تنفيذ الأمر firebase deploy --project=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

تتولّى واجهة سطر الأوامر Firebase إدارة عملية نشر الرموز ومواد العرض في مشروعك على Firebase، بما في ذلك:

الإصدارات الجديدة من مواقعك الإلكترونية Firebase Hosting
Cloud Functions for Firebase جديد أو معدَّل أو حالي
مخططات وموصلات جديدة أو معدَّلة لـ Firebase Data Connect
قواعد Firebase Realtime Database
قواعد Cloud Storage for Firebase
قواعد Cloud Firestore
مؤشرات Cloud Firestore

لنشر تطبيقك في مشروع Firebase، نفِّذ الأمر التالي من دليل مشروعك:

firebase deploy

يمكنك اختياريًا إضافة تعليق إلى كل عملية نشر. سيظهر هذا التعليق مع معلومات النشر الأخرى في صفحة Firebase Hosting الخاصة بمشروعك. على سبيل المثال:

firebase deploy -m "Deploying the best new feature ever."

عند استخدام الأمر firebase deploy، يجب الانتباه إلى ما يلي:

لنشر الموارد من دليل مشروع، يجب أن يحتوي دليل المشروع على ملف firebase.json. يتم إنشاء هذا الملف تلقائيًا من خلال الأمر firebase init.
تنشئ firebase deploy تلقائيًا إصدارًا لجميع الموارد القابلة للنشر في دليل مشروعك. لنشر خدمات أو ميزات محدّدة من Firebase، يمكنك استخدام النشر الجزئي.

تعارضات النشر لقواعد الأمان

بالنسبة إلى Firebase Realtime Database وCloud Storage for Firebase وCloud Firestore، يمكنك تحديد قواعد الأمان إما في دليل المشروع المحلي أو في وحدة تحكّم Firebase.

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

حصص النشر

من المحتمل (وإن كان ذلك غير مرجّح) أن تتجاوز حصة تحدّ من معدّل أو حجم عمليات نشر Firebase. على سبيل المثال، عند نشر عدد كبير جدًا من الدوال، قد تتلقّى HTTP 429 Quotaرسالة خطأ. لحلّ هذه المشاكل، جرِّب استخدام عملية نشر جزئية.

التراجع عن عملية نشر

يمكنك التراجع عن عملية نشر Firebase Hosting من صفحة Firebase Hosting في مشروعك من خلال اختيار الإجراء تراجع للإصدار المطلوب.

لا يمكن حاليًا التراجع عن إصدارات قواعد الأمان الخاصة بـ Firebase Realtime Database أو Cloud Storage for Firebase أو Cloud Firestore.

نشر خدمات Firebase محدّدة

إذا كنت تريد نشر خدمات أو ميزات معيّنة من Firebase فقط، يمكنك استخدام قائمة مفصولة بفواصل في علامة ضمن الأمر firebase deploy. على سبيل المثال، ينشر الأمر التالي قواعد الأمان الخاصة بمحتوى Firebase Hosting وCloud Storage.

firebase deploy --only hosting,storage

يسرد الجدول التالي الخدمات والميزات المتاحة للنشر الجزئي. تتطابق الأسماء في العلامات مع المفاتيح في ملف الإعدادات firebase.json.

بنية العلامة	الخدمة أو الميزة التي تم نشرها
`--only hosting`	المحتوى باللغة Firebase Hosting
`--only database`	Firebase Realtime Database قواعد
`--only dataconnect`	مخططات وموصّلات Firebase Data Connect
`--only storage`	Cloud Storage for Firebase قواعد
`--only firestore`	Cloud Firestore القواعد و الفهارس لجميع قواعد البيانات التي تم ضبطها
`--only functions`	Cloud Functions for Firebase (يمكن استخدام إصدارات أكثر تحديدًا من هذا العلَم)

نشر دوال محدّدة

عند نشر الدوال، يمكنك استهداف دوال معيّنة. على سبيل المثال:

firebase deploy --only functions:function1

firebase deploy --only functions:function1,functions:function2

هناك خيار آخر وهو تجميع الدوال في مجموعات تصدير في ملف /functions/index.js. يتيح لك تجميع الدوال نشر دوال متعددة باستخدام أمر واحد.

على سبيل المثال، يمكنك كتابة الدالتين التاليتين لتعريف groupA وgroupB:

var functions = require('firebase-functions/v1');

exports.groupA = {
  function1: functions.https.onRequest(...),
  function2: functions.database.ref('\path').onWrite(...)
}
exports.groupB = require('./groupB');

في هذا المثال، يحتوي ملف functions/groupB.js منفصل على دوال إضافية تحدّد الدوال في groupB تحديدًا. على سبيل المثال:

var functions = require('firebase-functions/v1');

exports.function3 = functions.storage.object().onChange(...);
exports.function4 = functions.analytics.event('in_app_purchase').onLog(...);

في هذا المثال، يمكنك نشر جميع دوال groupA من خلال تنفيذ الأمر التالي من دليل مشروعك:

firebase deploy --only functions:groupA

أو يمكنك استهداف دالة معيّنة ضمن مجموعة من خلال تنفيذ الأمر التالي:

firebase deploy --only functions:groupA.function1,groupB.function4

حذف الدوال

يتوافق Firebase CLI مع الأوامر والخيارات التالية لحذف الدوال التي تم نشرها سابقًا:

لحذف جميع الدوال التي تتطابق مع الاسم المحدّد في جميع المناطق:
```
firebase functions:delete FUNCTION-1_NAME
```
لحذف دالة محدّدة تعمل في منطقة غير تلقائية:
```
firebase functions:delete FUNCTION-1_NAME --region REGION_NAME
```

حذف أكثر من دالة واحدة:

firebase functions:delete FUNCTION-1_NAME FUNCTION-2_NAME

لحذف مجموعة دوال محدّدة:
```
firebase functions:delete GROUP_NAME
```

تخطّي طلب التأكيد:

firebase functions:delete FUNCTION-1_NAME --force

إعداد مهام مستندة إلى نصوص برمجية قبل النشر وبعده

يمكنك ربط نصوص 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 الإخراج العادي وتدفّقات الأخطاء للنصوص البرمجية في الوحدة الطرفية. في حالات تعذّر النقل، يُرجى مراعاة ما يلي:

إذا تعذّر إكمال خطاف ما قبل النشر على النحو المتوقّع، يتم إلغاء عملية النشر.
في حال تعذّر عملية النشر لأي سبب، لن يتم تشغيل خطافات postdeploy.

متغيرات البيئة

في النصوص البرمجية التي يتم تشغيلها في خطافَي predeploy وpostdeploy، تتوفّر متغيرات البيئة التالية:

$GCLOUD_PROJECT: رقم تعريف المشروع النشط
$PROJECT_DIR: الدليل الجذر الذي يحتوي على ملف firebase.json
$RESOURCE_DIR: (لبرامج hosting وfunctions النصية فقط) موقع الدليل الذي يحتوي على موارد Hosting أو Cloud Functions التي سيتم نشرها

إدارة Realtime Database مثيلات متعددة

يمكن أن يتضمّن مشروع Firebase عدة Firebase Realtime Databaseمثيلات. تتفاعل أوامر واجهة سطر الأوامر (CLI) تلقائيًا مع مثيل قاعدة البيانات الافتراضي.

ومع ذلك، يمكنك التفاعل مع مثيل قاعدة بيانات غير تلقائي باستخدام العلامة --instance DATABASE_NAME. تتيح الأوامر التالية استخدام العلامة --instance:

firebase database:get
firebase database:profile
firebase database:push
firebase database:remove
firebase database:set
firebase database:update

مرجع الأوامر

أوامر إدارية لواجهة سطر الأوامر

الأمر	الوصف
مساعدة	تعرض هذه السمة معلومات المساعدة حول واجهة سطر الأوامر أو أوامر معيّنة.
init	يربط مشروعًا جديدًا على Firebase ويعدّه في الدليل الحالي. ينشئ هذا الأمر ملف إعداد `firebase.json` في الدليل الحالي.
login	تتم مصادقة واجهة سطر الأوامر باستخدام حسابك على Google. يجب أن يكون لديك إذن بالوصول إلى متصفّح ويب. لتسجيل الدخول إلى واجهة سطر الأوامر في البيئات البعيدة التي لا تسمح بالوصول إلى `localhost`، استخدِم العلامة `--no-localhost`.
login:ci	تنشئ هذه الطريقة رمزًا مميزًا للمصادقة لاستخدامه في البيئات غير التفاعلية.
logout	تسجيل الخروج من حسابك على Google من واجهة سطر الأوامر
فتح	يفتح متصفّحًا لعرض موارد المشروع ذات الصلة.
projects:list	تعرِض هذه الصفحة جميع مشاريع Firebase التي لديك إذن الوصول إليها.
الاستخدام	يضبط مشروع Firebase النشط لواجهة سطر الأوامر. تُستخدَم لإدارة أسماء المشاريع المستعارة.

أوامر إدارة المشاريع

الأمر	الوصف
إدارة مشاريع Firebase
projects:addfirebase	تضيف هذه السمة موارد Firebase إلى مشروع Google Cloud حالي.
projects:create	تُنشئ هذه السمة مشروع Google Cloud جديدًا، ثم تضيف موارد Firebase إلى المشروع الجديد.
projects:list	تعرِض هذه الصفحة جميع مشاريع Firebase التي لديك إذن الوصول إليها.
إدارة تطبيقات Firebase (iOS وAndroid والويب)
apps:create	تنشئ هذه السمة تطبيقًا جديدًا على Firebase في المشروع النشط.
apps:list	تعرِض هذه السمة تطبيقات Firebase المسجّلة في المشروع النشط.
apps:sdkconfig	تعرض هذه السمة إعدادات خدمات Google لتطبيق Firebase.
setup:web	*تم إيقاف هذه السمة نهائيًا. بدلاً من ذلك، استخدِم `apps:sdkconfig` وحدِّد `web` كمعلَمة النظام الأساسي.* تعرض هذه السمة إعدادات خدمات Google لتطبيق ويب على Firebase.
إدارة تجزئات شهادات SHA (على أجهزة Android فقط)
apps:android:sha:create \ `FIREBASE_APP_ID` `SHA_HASH`	تضيف هذه الطريقة تجزئة شهادة SHA المحدّدة إلى تطبيق Android المحدّد على Firebase.
apps:android:sha:delete \ `FIREBASE_APP_ID` `SHA_HASH`	تحذف هذه الطريقة تجزئة شهادة SHA المحدّدة من تطبيق Firebase Android المحدّد.
apps:android:sha:list \ `FIREBASE_APP_ID`	تعرض هذه الطريقة قوائم بتجزئة شهادات SHA لتطبيق Firebase Android المحدّد.

النشر والتطوير على الجهاز

تتيح لك هذه الأوامر نشر موقعك الإلكتروني Firebase Hosting والتفاعل معه.

الأمر	الوصف
نشر	ينشر هذا الأمر الرموز والأصول من دليل مشروعك إلى المشروع النشط. بالنسبة إلى Firebase Hosting، يجب توفير ملف إعداد `firebase.json`.
عرض	يبدأ خادم ويب محليًا باستخدام إعدادات Firebase Hosting. بالنسبة إلى Firebase Hosting، يجب توفير ملف إعداد `firebase.json`.

App Distribution أمر

الأمر	الوصف
appdistribution:distribute \ --app `FIREBASE_APP_ID`	يُتيح الإصدار للمختبِرين.
appdistribution:testers:add	تضيف هذه الطريقة مختبِرين إلى المشروع.
appdistribution:testers:remove	تتم إزالة المختبِرين من المشروع.

App Hosting أمر

الأمر	الوصف
apphosting:backends:create \ --project `PROJECT_ID` \ --location `REGION` --app `APP_ID`	تنشئ هذه السمة مجموعة الموارد المُدارة المرتبطة بقاعدة رموز برمجية واحدة تتضمّن خلفية App Hosting. يمكنك اختياريًا تحديد تطبيق حالي على Firebase Web باستخدام معرّف تطبيق Firebase.
apphosting:backends:get \ `BACKEND_ID` \ --project `PROJECT_ID` \ --location `REGION`	تعرض هذه الطريقة تفاصيل محدّدة، بما في ذلك عنوان URL العام، لخادم خلفي.
apphosting:backends:list \ --project `PROJECT_ID`	تعرض هذه الطريقة قائمة بجميع الخدمات الخلفية النشطة المرتبطة بمشروع.
firebase apphosting:backends:delete \ `BACKEND_ID` \ --project `PROJECT_ID` \ --location `REGION`	تحذف هذه الطريقة خلفية تطبيق من المشروع.
firebase apphosting:config:export \ --project `PROJECT_ID` \ --secrets `ENVIRONMENT_NAME`	تصدير الأسرار لاستخدامها في محاكاة التطبيق القيمة التلقائية هي الأسرار المخزّنة في `apphosting.yaml`، أو يتم استخدام `--secrets` لتحديد أي بيئة تحتوي على ملف `apphosting.ENVIRONMENT_NAME.yaml` مطابق.
firebase apphosting:rollouts:create \ `BACKEND_ID` \ --git_branch `BRANCH_NAME` \ --git_commit `COMMIT_ID`	تُنشئ هذه الطريقة طرحًا يتم تشغيله يدويًا. يمكنك اختياريًا تحديد آخر عملية تثبيت في فرع أو عملية تثبيت معيّنة. إذا لم يتم توفير أي خيارات، سيطلب منك اختيار فرع من قائمة الفروع.
apphosting:secrets:set `KEY` --project `PROJECT_ID` \ --location `REGION` \ --data-file `DATA_FILE_PATH`	تخزِّن مواد سرية في Secret Manager. يمكنك اختياريًا تقديم مسار ملف لقراءة بيانات سرية منه. يجب ضبطها على `_` لقراءة البيانات السرية من الإدخال العادي.
apphosting:secrets:grantaccess `KEY` `BACKEND_ID` \ --project `PROJECT_ID` \ --location `REGION`	يمنح هذا الحقل حساب خدمة الخلفية إذن الوصول إلى كلمة المرور المقدَّمة، ما يتيح لـ App Hosting الوصول إليها في وقت الإنشاء أو التشغيل.
apphosting:secrets:describe `KEY` \ --project `PROJECT_ID`	تعرض هذه الطريقة البيانات الوصفية لسرّ وإصداراته.
firebase apphosting:secrets:access \ `KEY[@version]` \ --project `PROJECT_ID`	تتيح هذه الطريقة الوصول إلى قيمة سرية معيّنة باستخدام المفتاح السرّي وإصداره. يتم ضبط الإعدادات التلقائية على الوصول إلى أحدث إصدار.

أوامر Authentication (إدارة المستخدمين)

الأمر	الوصف
auth:export	تصدير حسابات المستخدمين في المشروع النشط إلى ملف JSON أو CSV لمزيد من التفاصيل، يُرجى الرجوع إلى صفحة auth:import وauth:export.
auth:import	يستورد هذا الأمر حسابات المستخدمين من ملف JSON أو CSV إلى المشروع النشط. لمزيد من التفاصيل، يُرجى الرجوع إلى صفحة auth:import وauth:export.

Cloud Firestore أمر

الأمر	الوصف
firestore:locations	تعرض هذه السمة قائمة بالمواقع الجغرافية المتاحة لقاعدة بيانات Cloud Firestore.
firestore:databases:create `DATABASE_ID`	أنشئ مثيلاً لقاعدة البيانات في الوضع الأصلي في مشروعك على Firebase. يستخدِم الأمر العلامات التالية: --location <اسم المنطقة> لتحديد الموقع الجغرافي الذي سيتم فيه نشر قاعدة البيانات. يمكنك تشغيل الأمر firebase firestore:locations لعرض قائمة بالمواقع الجغرافية المتاحة. مطلوب --delete-protection <deleteProtectionState> للسماح بحذف قاعدة البيانات المحدّدة أو منع ذلك. القيمتان الصالحتان هما `ENABLED` أو `DISABLED`. القيمة التلقائية هي `DISABLED`. استخدِم --point-in-time-recovery <PITRState> لتحديد ما إذا كان سيتم تفعيل ميزة "الاسترداد في نقطة زمنية محددة". القيمتان الصالحتان هما `ENABLED` أو `DISABLED`. القيمة التلقائية هي `DISABLED`. اختياريّ.
firestore:databases:list	إدراج قواعد البيانات في مشروعك على Firebase
firestore:databases:get `DATABASE_ID`	الحصول على إعدادات قاعدة بيانات محدّدة في مشروعك على Firebase
firestore:databases:update `DATABASE_ID`	تعديل إعدادات قاعدة بيانات محدّدة في مشروعك على Firebase يجب توفير علامة واحدة على الأقل. يستخدِم الأمر العلامات التالية: --delete-protection <deleteProtectionState> للسماح بحذف قاعدة البيانات المحدّدة أو منع ذلك. القيمتان الصالحتان هما `ENABLED` أو `DISABLED`. القيمة التلقائية هي `DISABLED`. استخدِم --point-in-time-recovery <PITRState> لتحديد ما إذا كان سيتم تفعيل ميزة "الاسترداد في نقطة زمنية محددة". القيمتان الصالحتان هما `ENABLED` أو `DISABLED`. القيمة التلقائية هي `DISABLED`. اختياريّ.
firestore:databases:delete `DATABASE_ID`	احذف قاعدة بيانات في مشروعك على Firebase.
firestore:indexes	فهرسة القوائم لقاعدة بيانات في مشروعك على Firebase يستخدِم الأمر العلامة التالية: استخدِم الخيار --database `DATABASE_ID` لتحديد اسم قاعدة البيانات التي تريد عرض فهارسها. في حال عدم توفيرها، يتم إدراج الفهارس لقاعدة البيانات التلقائية.
firestore:delete	لحذف المستندات في قاعدة بيانات المشروع النشط باستخدام واجهة سطر الأوامر، يمكنك حذف جميع المستندات في مجموعة بشكل متكرر. يُرجى العِلم أنّ حذف بيانات Cloud Firestore باستخدام واجهة سطر الأوامر يؤدي إلى تحمّل تكاليف القراءة والحذف. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة فهم فوترة Cloud Firestore. يستخدِم الأمر العلامة التالية: --database `DATABASE_ID` لتحديد اسم قاعدة البيانات التي سيتم حذف المستندات منها. في حال عدم تحديدها، يتم حذف المستندات من قاعدة البيانات التلقائية. اختياريّ.

Cloud Functions for Firebase أمر

الأمر	الوصف
functions:config:clone	تستنسخ هذه السمة بيئة مشروع آخر إلى مشروع Firebase النشط.
functions:config:get	يتم استرداد قيم الإعدادات الحالية الخاصة بـ Cloud Functions للمشروع النشط.
functions:config:set	تخزِّن قيم إعدادات وقت التشغيل الخاصة بـ Cloud Functions للمشروع النشط.
functions:config:unset	تزيل هذه الطريقة القيم من إعدادات وقت التشغيل للمشروع النشط.
functions:log	يقرأ هذا الإذن السجلات من Cloud Functions التي تم نشرها.

لمزيد من المعلومات، يُرجى الرجوع إلى المستندات المتعلقة بإعداد البيئة.

Crashlytics أمر

الأمر	الوصف
crashlytics:mappingfile:generateid \ --resource-file=`PATH/TO/ANDROID_RESOURCE.XML`	تنشئ هذه السمة معرّفًا فريدًا لملف الربط في ملف موارد Android (XML) المحدّد.
crashlytics:mappingfile:upload \ --app=`FIREBASE_APP_ID` \ --resource-file=`PATH/TO/ANDROID_RESOURCE.XML` \ `PATH/TO/MAPPING_FILE.TXT`	تحميل ملف تحديد (TXT) متوافق مع Proguard لهذا التطبيق، وربطه بمعرّف ملف التحديد المحدّد في ملف موارد Android (XML) المحدّد
crashlytics:symbols:upload \ --app=`FIREBASE_APP_ID` \ `PATH/TO/SYMBOLS`	تُنشئ هذه السمة ملف رموز متوافقًا مع Crashlytics لأعطال المكتبة الأصلية على Android، ثم تحمّله إلى خوادم Firebase.

Data Connect أمر

يتم تناول هذه الأوامر وحالات استخدامها بمزيد من التفصيل في دليل مرجع واجهة سطر الأوامر Data Connect.

الأمر	الوصف
dataconnect:services:list	تعرض هذه الصفحة جميع خدمات Data Connect التي تم نشرها في مشروعك على Firebase.
dataconnect:sql:diff \ `SERVICE_ID`	بالنسبة إلى الخدمة المحدّدة، تعرض هذه السمة الاختلافات بين مخطط Data Connect محلي ومخطط قاعدة بيانات Cloud SQL.
dataconnect:sql:migrate \ --force \ `SERVICE_ID`	تنقل هذه السمة مخطط قاعدة بيانات Cloud SQL ليطابق مخطط Data Connect المحلي.
dataconnect:sql:grant\ --role=`ROLE` \ --email=`EMAIL` \ `SERVICE_ID`	يمنح دور SQL للمستخدم المحدّد أو عنوان البريد الإلكتروني لحساب الخدمة. بالنسبة إلى العلامة `--role`، يكون دور SQL الذي سيتم منحه أحد الأدوار التالية: `owner` أو `writer` أو `reader`. بالنسبة إلى العلامة `--email`، أدخِل عنوان البريد الإلكتروني للمستخدم أو حساب الخدمة الذي تريد منحه الدور.
dataconnect:sdk:generate	تنشئ حِزم SDK مكتوبة لموصلات Data Connect.

Extensions أمر

الأمر	الوصف
ext	تعرض هذه السمة معلومات حول كيفية استخدام أوامر Firebase Extensions. تعرض هذه السمة مثيلات الإضافة المثبَّتة في المشروع النشط.
ext:configure \ `EXTENSION_INSTANCE_ID`	تعيد هذه السمة ضبط قيم المَعلمات لنسخة إضافة في بيان الإضافة.
ext:info \ `PUBLISHER_ID/EXTENSION_ID`	تعرض هذه السمة معلومات مفصّلة عن إحدى الإضافات.
ext:install \ `PUBLISHER_ID/EXTENSION_ID`	تضيف هذه السمة مثيلاً جديدًا لإحدى الإضافات إلى بيان الإضافة.
ext:list	تعرض هذه السمة جميع مثيلات الإضافة المثبَّتة في مشروع Firebase. تعرض هذه السمة معرّف المثيل لكل إضافة.
ext:uninstall \ `EXTENSION_INSTANCE_ID`	يزيل هذا العنصر نسخة من إضافة من بيان الإضافة.
ext:update \ `EXTENSION_INSTANCE_ID`	تعدّل هذه السمة مثيلاً لإضافة إلى أحدث إصدار في بيان الإضافة.
ext:export	يصدِّر هذا الأمر جميع مثيلات الإضافات المثبَّتة من مشروعك إلى بيان الإضافة.

أوامر الناشرين Extensions

الأمر	الوصف
ext:dev:init	تهيئة قاعدة رموز هيكلية لإضافة جديدة في الدليل الحالي
ext:dev:list \ `PUBLISHER_ID`	تعرض هذه السمة قائمة بجميع الإضافات التي حمّلها أحد الناشرين.
ext:dev:register	تسجِّل هذه السمة مشروع Firebase كـ مشروع ناشر إضافات.
ext:dev:deprecate \ `PUBLISHER_ID/EXTENSION_ID` \ `VERSION_PREDICATE`	Deprecates إصدارات الإضافة التي تطابق شرط الإصدار. يمكن أن تكون أداة تحديد الإصدار إصدارًا واحدًا (مثل `1.0.0`)، أو نطاقًا من الإصدارات (مثل `>1.0.0`). في حال عدم توفير أداة تحديد الإصدار، سيتم إيقاف جميع إصدارات تلك الإضافة نهائيًا.
ext:dev:undeprecate \ `PUBLISHER_ID/EXTENSION_ID` \ `VERSION_PREDICATE`	إلغاء الإيقاف النهائي لإصدارات الإضافة التي تتطابق مع شرط الإصدار يمكن أن تكون أداة تحديد الإصدار إصدارًا واحدًا (مثل `1.0.0`)، أو نطاقًا من الإصدارات (مثل `>1.0.0`). في حال عدم توفير أداة تحديد الإصدار، سيتم إلغاء إيقاف جميع إصدارات تلك الإضافة.
ext:dev:upload \ `PUBLISHER_ID/EXTENSION_ID`	تحميل نسخة جديدة من إضافة
ext:dev:usage \ `PUBLISHER_ID`	تعرِض هذه الصفحة عدد عمليات التثبيت ومقاييس الاستخدام للإضافات التي حمّلها أحد الناشرين.

Hosting أمر

الأمر	الوصف
hosting:disable	يتوقف عن عرض زيارات Firebase Hosting لمشروع Firebase النشط. سيظهر في عنوان URL الخاص بمشروعك Hosting رسالة "لم يتم العثور على الموقع الإلكتروني" بعد تنفيذ هذا الأمر.
إدارة Hosting موقع إلكتروني
firebase hosting:sites:create \ `SITE_ID`	تنشئ هذه الدالة موقعًا إلكترونيًا جديدًا Hosting في مشروع Firebase النشط باستخدام `SITE_ID` المحدّد (اختياري) حدِّد تطبيقًا حاليًا على Firebase للربط بالموقع الإلكتروني الجديد من خلال تمرير العلامة التالية: `--app FIREBASE_APP_ID`
firebase hosting:sites:delete \ `SITE_ID`	يحذف هذا الأمر الموقع الإلكتروني Hosting المحدّد تعرض واجهة سطر الأوامر طلب تأكيد قبل حذف الموقع الإلكتروني. (اختياري) يمكنك تخطّي طلب التأكيد من خلال تمرير العلامات التالية: `-f` أو `--force`
firebase hosting:sites:get \ `SITE_ID`	تعرض هذه السمة معلومات عن Hosting الموقع الإلكتروني المحدّد
firebase hosting:sites:list	تعرِض هذه القائمة جميع مواقع Hosting لمشروع Firebase النشط.
إدارة قنوات الإصدارات التجريبية
firebase hosting:channel:create \ `CHANNEL_ID`	تنشئ هذه السمة قناة معاينة جديدة في الموقع الإلكتروني *الافتراضي* Hosting باستخدام `CHANNEL_ID` لا يتم نشر هذا الأمر في القناة.
firebase hosting:channel:delete \ `CHANNEL_ID`	يحذف قناة الإصدار التجريبي المحدّدة لا يمكنك حذف قناة البث المباشر الخاصة بموقع إلكتروني.
firebase hosting:channel:deploy \ `CHANNEL_ID`	ينشر محتوى Hosting وإعداداته في قناة المعاينة المحدّدة إذا لم تكن قناة المعاينة متوفّرة بعد، ينشئ هذا الأمر القناة في الموقع الإلكتروني *التلقائي* Hosting قبل نشرها في القناة.
firebase hosting:channel:list	تعرض هذه السمة جميع القنوات (بما في ذلك القناة "المباشرة") في الموقع الإلكتروني *التلقائي* Hosting
firebase hosting:channel:open \ `CHANNEL_ID`	يفتح متصفّحًا على عنوان URL الخاص بالقناة المحدّدة أو يعرض عنوان URL إذا لم يكن من الممكن فتحه في متصفّح
استنساخ الإصدار
firebase hosting:clone \ `SOURCE_SITE_ID`:`SOURCE_CHANNEL_ID` \ `TARGET_SITE_ID`:`TARGET_CHANNEL_ID`	تستنسخ هذه السمة أحدث إصدار تم نشره على قناة "المصدر" المحدّدة إلى قناة "الوجهة" المحدّدة ينشر هذا الأمر أيضًا إلى القناة "الهدف" المحدّدة. إذا لم تكن قناة "target" متوفّرة بعد، ينشئ هذا الأمر قناة معاينة جديدة في الموقع الإلكتروني "target" Hosting قبل النشر في القناة.
firebase hosting:clone \ `SOURCE_SITE_ID`:@`VERSION_ID` \ `TARGET_SITE_ID`:`TARGET_CHANNEL_ID`	تستنسخ هذه السمة الإصدار المحدّد إلى القناة "المستهدَفة" المحدّدة. ينشر هذا الأمر أيضًا إلى القناة "الهدف" المحدّدة. إذا لم تكن قناة "target" متوفّرة بعد، ينشئ هذا الأمر قناة معاينة جديدة في الموقع الإلكتروني "target" Hosting قبل النشر في القناة. يمكنك العثور على `VERSION_ID` في لوحة بيانات Hosting في وحدة تحكّم Firebase.

Realtime Database أمر

يُرجى العِلم أنّه يمكنك إنشاء مثيل Realtime Database التلقائي الأوّلي في وحدة تحكّم Firebase أو باستخدام سير العمل firebase init العام أو سير عمل firebase init database المحدّد.

بعد إنشاء النُسخ، يمكنك إدارتها كما هو موضّح في مقالة إدارة نُسخ متعددة من Realtime Database.

الأمر	الوصف
database:get	يجلب هذا الأمر البيانات من قاعدة بيانات المشروع النشط ويعرضها بتنسيق JSON. يتيح تنفيذ طلبات بحث على البيانات المفهرسة.
database:instances:create	تنشئ هذه الطريقة مثيلاً لقاعدة بيانات باسم مثيل محدّد. يقبل هذا الحقل الخيار `--location` لإنشاء قاعدة بيانات في منطقة محدّدة. للاطّلاع على أسماء المناطق التي يمكن استخدامها مع هذا الخيار، يُرجى الاطّلاع على مقالة اختيار مواقع جغرافية لمشروعك. إذا لم تتوفّر أي نسخة من قاعدة البيانات للمشروع الحالي، سيُطلب منك تنفيذ عملية `firebase init` لإنشاء نسخة.
database:instances:list	أدرِج جميع مثيلات قاعدة البيانات لهذا المشروع. يقبل الخيار `--location` لعرض قواعد البيانات في منطقة محدّدة. للاطّلاع على أسماء المناطق التي يمكن استخدامها مع هذا الخيار، يُرجى الاطّلاع على اختيار مواقع جغرافية لمشروعك.
database:profile	إنشاء ملف شخصي للعمليات في قاعدة بيانات المشروع النشط لمزيد من التفاصيل، راجِع أنواع عمليات Realtime Database.
database:push	يدفع بيانات جديدة إلى قائمة في موقع محدّد في قاعدة بيانات المشروع النشط. تتلقّى هذه السمة الإدخال من ملف أو STDIN أو وسيط سطر أوامر.
database:remove	يحذف هذا الإجراء جميع البيانات في موقع جغرافي محدّد ضمن قاعدة بيانات المشروع النشط.
database:set	يستبدل هذا الإجراء جميع البيانات في موقع جغرافي محدّد ضمن قاعدة بيانات المشروع النشط. تتلقّى هذه الدالة الإدخال من ملف أو STDIN أو وسيط سطر الأوامر.
database:update	تُجري هذه الطريقة تعديلاً جزئيًا في موقع محدّد ضمن قاعدة بيانات المشروع النشط. تتلقّى هذه السمة الإدخال من ملف أو STDIN أو وسيط سطر أوامر.

Remote Config أمر

الأمر	الوصف
remoteconfig:versions:list \ --limit `NUMBER_OF_VERSIONS`	تعرض هذه السمة آخر عشرة إصدارات من النموذج. حدِّد `0` لعرض جميع النُسخ الحالية، أو يمكنك اختياريًا تضمين الخيار `--limit` للحدّ من عدد النُسخ المعروضة.
remoteconfig:get \ --v, version_number `VERSION_NUMBER` --o, output `FILENAME`	تعرض هذه السمة النموذج حسب الإصدار (الإصدار الأحدث هو الإعداد التلقائي) وتعرض مجموعات المَعلمات والمَعلمات وأسماء الشروط والإصدار في جدول. يمكنك اختياريًا كتابة الإخراج إلى ملف محدّد باستخدام `-o, FILENAME`.
remoteconfig:rollback \ --v, version_number `VERSION_NUMBER` --force	تعود إلى إصدار سابق محدّد من نموذج Remote Config أو إلى الإصدار السابق مباشرةً (الإصدار الحالي -1). ما لم يتم تمرير `--force`، سيتم عرض الطلبات Y/N قبل المتابعة إلى عملية التراجع.
remoteconfig:experiments:list \ --filter `EXPRESSION` --pageSize `NUMBER` --pageToken `TOKEN`	تعرض هذه الطريقة جميع Remote Config التجارب الخاصة بمشروع، مع إمكانية الفلترة وعدد التجارب المطلوب عرضها في كل صفحة (القيمة التلقائية هي 10) ورمز الصفحة كإزاحة بدء للقائمة.
remoteconfig:experiments:get \ `EXPERIMENT_ID`	تعرض هذه الطريقة تفاصيل Remote Config التجربة المحدّدة.
remoteconfig:experiments:delete \ `EXPERIMENT_ID`	تحذف هذه الطريقة Remote Config التجربة المحدّدة.
remoteconfig:rollouts:list \ --filter `EXPRESSION` --pageSize `NUMBER` --pageToken `TOKEN`	تعرض هذه الطريقة جميع Remote Config عمليات الطرح لمشروع، مع إمكانية الفلترة وعدد عمليات الطرح المطلوب عرضها في كل صفحة (القيمة التلقائية هي 10) ورمز الصفحة كإزاحة بدء للقائمة.
remoteconfig:rollouts:get \ `ROLLOUT_ID`	تعرض هذه الطريقة تفاصيل Remote Config الإصدار المحدّد.
remoteconfig:rollouts:delete \ `ROLLOUT_ID`	يحذف عملية طرح Remote Config المحدّدة.

مرجع واجهة سطر الأوامر في Firebase تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

إعداد واجهة سطر الأوامر أو تعديلها

تثبيت واجهة سطر الأوامر Firebase

Windows

ملف ثنائي مستقل

npm

نظام التشغيل macOS أو Linux

نص برمجي للتثبيت التلقائي

ملف ثنائي مستقل

npm

تسجيل الدخول واختبار واجهة سطر الأوامر Firebase

التحديث إلى أحدث إصدار من واجهة سطر الأوامر

نظام التشغيل Windows

‫macOS

Linux

إلغاء تثبيت واجهة سطر الأوامر Firebase

نظام التشغيل Windows

‫macOS

Linux

استخدام واجهة سطر الأوامر مع أنظمة التكامل المستمر

(يُنصح به) استخدام بيانات الاعتماد التلقائية للتطبيق

(قديم) استخدِم FIREBASE_TOKEN

إعداد مشروع Firebase

الملف firebase.json

إعدادات قواعد بيانات Cloud Firestore المتعددة

Cloud Functions ملفات سيتم تجاهلها عند النشر

إدارة الأسماء المستعارة للمشاريع

إضافة اسم مستعار للمشروع

استخدام أسماء المشاريع المستعارة

التحكّم في المصدر وأسماء المشاريع المستعارة

عرض مشروع Firebase واختباره على جهازك

محاكاة مشروعك باستخدام دوال HTTP المحلية

الاختبار من أجهزة محلية أخرى

النشر في مشروع على Firebase

تعارضات النشر لقواعد الأمان

حصص النشر

التراجع عن عملية نشر

نشر خدمات Firebase محدّدة

نشر دوال محدّدة

حذف الدوال

إعداد مهام مستندة إلى نصوص برمجية قبل النشر وبعده

متغيرات البيئة

إدارة Realtime Database مثيلات متعددة

مرجع الأوامر

أوامر إدارية لواجهة سطر الأوامر

أوامر إدارة المشاريع

النشر والتطوير على الجهاز

App Distribution أمر

App Hosting أمر

أوامر Authentication (إدارة المستخدمين)

Cloud Firestore أمر

Cloud Functions for Firebase أمر

Crashlytics أمر

Data Connect أمر

Extensions أمر

أوامر الناشرين Extensions

Hosting أمر

Realtime Database أمر

Remote Config أمر

مرجع واجهة سطر الأوامر في Firebase

(قديم) استخدِم `FIREBASE_TOKEN`

الملف `firebase.json`