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

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

قبل استخدام Firebase CLI، عليك إعداد مشروع على Firebase.

إعداد سطر الأوامر (CLI) أو تعديله

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

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

Windows macOS Linux

Windows

يمكنك تثبيت Firebase CLI لنظام التشغيل Windows باستخدام أحد الخيارين التاليين:

الخيار الوصف محتوى مقترَح...
ملف ثنائي مستقل نزِّل الملف الثنائي المستقل لسطر الأوامر. بعد ذلك، يمكنك الوصول إلى الملف التنفيذي لفتح وحدة تحكّم يمكنك من خلالها تنفيذ الأمر firebase. المطوّرون الجدد

المطوّرون الذين لا يستخدمون Node.js أو ليسوا على دراية به
npm استخدِم npm ‏ (مدير حِزم Node) لتثبيت واجهة سطر الأوامر وتفعيل الأمر firebase المتاح على مستوى العالم. المطوّرون الذين يستخدِمون Node.js

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

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

  1. نزِّل ملف Firebase CLI الثنائي لنظام التشغيل Windows.

  2. يمكنك الوصول إلى الملف الثنائي لفتح وحدة تحكّم يمكنك من خلالها تنفيذ الأمر firebase.

  3. واصِل تسجيل الدخول واختبار واجهة سطر الأوامر.

npm

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

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

  2. ثبِّت Firebase CLI من خلال npm عن طريق تنفيذ الأمر التالي:

    npm install -g firebase-tools

    يُفعّل هذا الأمر طلب firebase المتاح على مستوى العالم.

  3. واصِل تسجيل الدخول واختبار واجهة سطر الأوامر.

macOS أو Linux

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

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

المطوّرون الذين لا يستخدمون Node.js أو ليسوا على دراية به

عمليات النشر المبرمَجة في بيئة CI/CD
ملف ثنائي مستقل نزِّل الملف الثنائي المستقل لسطر الأوامر. بعد ذلك، يمكنك ضبط الملف الثنائي وتشغيله بما يناسب سير عملك. مهام سير عمل قابلة للتخصيص بالكامل باستخدام واجهة سطر الأوامر
npm استخدِم npm ‏ (مدير حِزم Node) لتثبيت واجهة سطر الأوامر وتفعيل الأمر firebase المتاح على مستوى العالم. المطوّرون الذين يستخدِمون Node.js

نص التثبيت التلقائي

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

  1. نفِّذ الأمر cURL التالي:

    curl -sL https://firebase.tools | bash

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

  2. واصِل تسجيل الدخول واختبار واجهة سطر الأوامر.

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

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

لتنزيل وتشغيل الملف الثنائي لوحدة تحكم Firebase CLI المخصّصة لنظام التشغيل، اتّبِع الخطوات التالية:

  1. نزِّل Firebase ثنائي واجهة برمجة التطبيقات لنظام التشغيل: macOS | Linux

  2. (اختياري) يمكنك إعداد الأمر firebase المتاح على مستوى العالم.

    1. اجعل الملف الثنائي قابلاً للتنفيذ من خلال تشغيل chmod +x ./firebase_tools.
    2. أضِف مسار الملف الثنائي إلى ملف PATH.

  3. واصِل تسجيل الدخول واختبار واجهة سطر الأوامر.

npm

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

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

  2. ثبِّت Firebase CLI من خلال npm عن طريق تنفيذ الأمر التالي:

    npm install -g firebase-tools

    يُفعّل هذا الأمر طلب firebase المتاح على مستوى العالم.

  3. واصِل تسجيل الدخول واختبار واجهة سطر الأوامر.

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

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

  1. سجِّل الدخول إلى Firebase باستخدام حسابك على Google من خلال تنفيذ العبارة التالية:

    firebase login

    يربط هذا الأمر جهازك المحلي بـ Firebase ويمنحك إذن الوصول إلى مشاريعك على Firebase.

  2. تحقَّق من تثبيت واجهة برمجة التطبيقات بشكلٍ صحيح ووصولها إلى حسابك من خلال إدراج مشاريعك على Firebase. نفِّذ الأمر التالي:

    firebase projects:list

    يجب أن تكون القائمة المعروضة مطابقة لمشاريع Firebase المدرَجة في وحدة تحكُّم Firebase.

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

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

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

Windows

نظام التشغيل 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

استخدام سطر الأوامر مع أنظمة التطوير المتداخل (CI)

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

  1. على جهاز مزوّد بمتصفّح، ثبِّت Firebase CLI.

  2. ابدأ عملية تسجيل الدخول من خلال تنفيذ الأمر التالي:

    firebase login:ci

  3. يُرجى الانتقال إلى عنوان URL المقدَّم، ثم تسجيل الدخول باستخدام حساب Google.

  4. اطبع رمزًا مميزًا جديدًا لإعادة التحميل. ولن تتأثر جلسة CLI الحالية.

  5. تخزين الرمز المميّز للإخراج بطريقة آمنة يمكن الوصول إليها في نظام التطوير المتكامل (CI)

  6. استخدِم هذا الرمز المميّز عند تنفيذ أوامر firebase. يمكنك استخدام أحد الخيارين التاليين:

    • الخيار 1: تخزين الرمز المميّز كمتغيّر بيئة FIREBASE_TOKEN سيستخدم نظامك الرمز المميّز تلقائيًا.

    • الخيار 2: يمكنك تنفيذ جميع أوامر firebase باستخدام الخيار --token TOKEN في نظام التطوير المتكامل (CI).
      في ما يلي ترتيب الأولوية لتحميل الرمز المميّز: العلامة ومتغيّر البيئة ومشروع Firebase المطلوب.

بدء مشروع على Firebase

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

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

firebase init

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

  • اختَر منتجات Firebase المطلوبة لإعدادها في مشروعك على Firebase.

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

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

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

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

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

ملف firebase.json

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

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

يمكنك ضبط معظم خيارات Firebase Hosting مباشرةً في ملف firebase.json. ومع ذلك، بالنسبة إلى خدمات Firebase الأخرى التي يمكن نشرها باستخدام واجهة برمجة التطبيقات Firebase، يُنشئ الأمر 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 المحدّد
يستخدِم CLI هذا المشروع بصفته "المشروع النشط" حاليًا.
firebase use --clear يؤدي إلى محو المشروع النشط.

نفِّذ firebase use PROJECT_ID|ALIAS لإعداد مشروع نشط جديد قبل تنفيذ أوامر سطر الأوامر الأخرى.
firebase use \
--unalias PROJECT_ALIAS		 تزيل عنوانًا بديلاً من دليل مشروعك.

يمكنك إلغاء ما يتم استخدامه كمشروع نشط حاليًا من خلال تمرير العلامة --project مع أي أمر في سطر الأوامر. على سبيل المثال: يمكنك ضبط واجهة برمجة التطبيقات لتشغيلها على مشروع Firebase الذي تم إسناد العنوان الرمزي staging إليه. إذا كنت تريد تنفيذ أمر واحد في مشروع Firebase الذي assignedprodالاسم المعرِّف، يمكنك تنفيذ، على سبيل المثال، firebase deploy --project=prod.

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

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

إذا كان لديك مشروع تطوير مخصّص لاستخدامك فقط، يمكنك إمّا تمرير العلامة --project مع كلّ أمر أو تشغيل firebase use PROJECT_ID بدون منح عنوان بديل لمشروع Firebase.

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

يمكنك عرض مشروعك على Firebase واختباره على عناوين URL مستضافة محليًا قبل نشره في قناة الإصدار العلني. إذا كنت تريد اختبار ميزات محدّدة فقط، يمكنك استخدام قائمة مفصولة بفواصل في علامة على الأمر firebase serve.

نفِّذ الأمر التالي من جذر دليل المشروع المحلي إذا أردت تنفيذ أيّ من المهام التالية:

 
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 CLI عملية نشر الرموز البرمجية ومواد العرض في مشروعك على 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 مخرجات النصوص البرمجية العادية ورسائل الخطأ في وحدة التحكّم الطرفية. في حالات الفشل، يُرجى مراعاة ما يلي:

  • إذا تعذّر إكمال أحد أدوات الربط الخاصة بالنشر المُسبَق على النحو المتوقّع، يتم إلغاء عملية النشر.
  • إذا تعذّر النشر لأي سبب، لن يتم تنشيط عمليات الربط بعد النشر.

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

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

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

إدارة نُسخ متعددة من Realtime Database

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

ومع ذلك، يمكنك التفاعل مع مثيل قاعدة بيانات غير تلقائي باستخدام العلامة --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 تُستخدم لمنح إذن الوصول إلى واجهة برمجة التطبيقات (CLI) لحسابك على Firebase. يتطلب الوصول إلى متصفّح ويب.
لتسجيل الدخول إلى وحدة تحكّم سطر الأوامر في البيئات البعيدة التي لا تسمح بالوصول إلى localhost، استخدِم العلامة --no-localhost.
login:ci تُنشئ رمزًا مميّزًا للمصادقة لاستخدامه في البيئات غير التفاعلية.
logout تسجيل الخروج من واجهة برمجة التطبيقات من حسابك على Firebase
مفتوح يفتح متصفّحًا لموارد المشروع ذات الصلة.
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 المحدّدة إلى تطبيق Firebase لنظام التشغيل Android المحدّد.
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.
serve بدء خادم ويب محلي باستخدام إعدادات 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 من خلال معرّف تطبيق 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 <region name> لتحديد موقع نشر قاعدة البيانات تجدر الإشارة إلى أنّه يمكنك تشغيل 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 دليل CLI المرجعي.

الطلب الوصف
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		 توقّف نهائيًا عن استخدام إصدارات الإضافة التي تتطابق مع العبارة المحدّدة للإصدار.
يمكن أن يكون تعبير الإصدار عبارة عن إصدار واحد (مثل 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

نسخ أحدث إصدار تم نشره على قناة "المصدر" المحدّدة إلى قناة "الهدف" المحدّدة

يتم أيضًا نشر هذا الأمر على القناة "المستهدفة" المحدّدة. إذا كانت قناة "الاستهداف" غير متوفّرة بعد، ينشئ هذا الأمر قناة معاينة جديدة في الموقع الإلكتروني "الاستهداف" Hosting قبل نشرها في القناة.

firebase hosting:clone \
SOURCE_SITE_ID:@VERSION_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

نسخ الإصدار المحدّد إلى القناة "المستهدفة" المحدّدة

يتم أيضًا نشر هذا الأمر على القناة "المستهدفة" المحدّدة. إذا كانت قناة "الاستهداف" غير متوفّرة بعد، ينشئ هذا الأمر قناة معاينة جديدة في الموقع الإلكتروني "الاستهداف" 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 قبل المتابعة إلى التراجع.