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

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

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

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

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

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

Windows macOS Linux

Windows

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

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

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

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

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

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

  2. افتح البرنامج الثنائي لفتح واجهة أوامر حيث يمكنك تشغيل firebase. الأمر.

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

دورة في الدقيقة

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

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

  2. ثبِّت واجهة سطر أوامر Firebase من خلال 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 الخاصة لنظام التشغيل الذي تستخدمه، اتّبع الخطوات التالية:

  1. تنزيل البرنامج الثنائي لواجهة سطر الأوامر Firebase لنظام التشغيل الخاص بك: نظام التشغيل macOS | نظام التشغيل Linux

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

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

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

npm

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

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

  2. ثبِّت واجهة سطر أوامر Firebase من خلال 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) بشكل كامل مع واجهة CI وغيرها من البيئات التي بلا واجهة مستخدم رسومية.

  1. على جهاز مزود بمتصفح، تثبيت واجهة سطر الأوامر Firebase

  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، شغِّل الأمر التالي من داخل دليل التطبيق:

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 واجهة سطر الأوامر لأنه يحدد الملفات والإعدادات من دليل مشروعك التي يتم نشرها مشروع على 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 وفحص الأخطاء) أثناء الإعداد.

{
  "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 الذي assignedassignedprod، يمكنك تنفيذ، على سبيل المثال، 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" عملية نشر الرموز البرمجية والأصول في 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 مع الأوامر والخيارات التالية حذف الدوال المنشورة سابقًا:

  • لحذف جميع الدوال التي تتطابق مع الاسم المحدّد في جميع المناطق: 

    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 تُنشئ رمزًا مميّزًا للمصادقة لاستخدامه في البيئات غير التفاعلية .
تسجيل الخروج تسجيل الخروج من واجهة برمجة التطبيقات من حسابك على 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 مطلوب ملف الإعداد.
خدمة بدء خادم ويب محلي باستخدام إعدادات Firebase Hosting بالنسبة إلى Firebase Hosting، يجب توفُّر ملف إعدادات firebase.json .

App Distribution الأوامر

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

App Hosting الأوامر

الأمر الوصف
apphosting:backends:إنشاء \
--مشروع PROJECT_ID \
--الموقع REGION --التطبيق 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: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_ID \
--الموقع الجغرافي REGION 		يمنح واجهة خلفية حساب الخدمة إلى المفتاح السري المقدم حتى يمكن الوصول إليه من خلال App Hosting في وقت الإصدار أو التشغيل
apphosting:secrets:describe KEY \
--project PROJECT_ID 		يحصل على البيانات الوصفية للسر وإصداراته.
firebase apphosting:secrets:access \
KEY[@version] \
--المشروع PROJECT_ID 		للوصول إلى قيمة سرية محدّدة المفتاح السرّي وإصداره. يتم الوصول تلقائيًا إلى أحدث إصدار.

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

الطلب الوصف
auth:export تصدير حسابات مستخدمي المشروع النشط إلى ملف JSON أو CSV للحصول على المزيد من التفاصيل، يُرجى الرجوع إلى صفحة auth:import وauth:export .
تفويض:استيراد لاستيراد حسابات المستخدمين من ملف JSON أو CSV إلى ملف مشروعك. لمزيد من التفاصيل، يُرجى الرجوع إلى auth:Import and 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:مؤشرات

أدرِج فهارس قاعدة بيانات في مشروع Firebase الخاص بك.

يأخذ الأمر العلامة التالية:

  • --database DATABASE_ID تحديد اسم قاعدة البيانات التي تريد سرد فهارسها. إذا لم يكن كذلك يتم سرد الفهارس لقاعدة البيانات الافتراضية.
firestore:حذف

لحذف المستندات في قاعدة بيانات المشروع النشط باستخدام واجهة برمجة التطبيقات، يمكنك حذف جميع المستندات في مجموعة بشكل متكرر.

يُرجى العِلم أنّ حذف بيانات Cloud Firestore باستخدام واجهة سطر الأوامر يؤدي إلى تحمُّل تكاليف القراءة والحذف. لمزيد من المعلومات، يُرجى مراجعة فهم فوترة Cloud Firestore

يأخذ الأمر العلامة التالية:

  • --database DATABASE_ID لتحديد اسم قاعدة البيانات التي يتم حذف المستندات منها. في حال حذف غير محدد، يتم حذف المستندات من قاعدة البيانات الافتراضية. هذه السمة اختيارية.

Cloud Functions for Firebase طلبات

الأمر الوصف
functions:config:clone يستنسخ بيئة مشروع آخر في Firebase النشط مشروعك.
دوال:الضبط:get يسترجع قيم الضبط الحالية لملف Cloud Functions للمشروع النشط.
الدوال:الضبط:set تخزين قيم تهيئة وقت تشغيل المشروع النشط Cloud Functions
functions:config:unset تزيل القيم من إعدادات وقت التشغيل للمشروع النشط.
الدوال:سجلّ تقرأ السجلات من 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:إلغاء التثبيت \
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 Host:sites:create \
SITE_ID

ينشئ موقعًا إلكترونيًا جديدًا على Hosting في مشروع Firebase النشط باستخدام تم تحديد SITE_ID

(اختياري) تحديد تطبيق ويب حالي على Firebase لربطه مع الموقع الجديد من خلال تمرير العلامة التالية: --app FIREBASE_APP_ID

firebase hosting:sites:delete \
SITE_ID

لحذف الموقع الإلكتروني Hosting المحدّد

يعرض CLI رسالة تأكيد قبل حذف الموقع الإلكتروني.

(اختياري) يمكنك تخطي طلب التأكيد من خلال تمرير العلامة التالية: -f أو --force

firebase Host:sites:get \
SITE_ID

استرجاع معلومات عن موقع Hosting الإلكتروني المحدّد
firebase Host:sites:list

يسرد جميع المواقع الإلكترونية البالغ عددها Hosting لمشروع Firebase النشط.

إدارة قنوات المعاينة
firebase hosting:channel:create \
CHANNEL_ID

لإنشاء قناة معاينة جديدة في default على Hosting موقع إلكتروني يستخدم CHANNEL_ID

لا يؤدي هذا الأمر إلى نشر التطبيق على القناة.
firebase hosting:channel:delete \
CHANNEL_ID

لحذف قناة المعاينة المحدّدة

لا يمكنك حذف القناة المباشرة لموقع.
firebase Host:channel:deploy \
CHANNEL_ID

تعمل هذه السياسة على نشر محتوى "Hosting" وإعداداته المحدّدة. معاينة القناة

في حالة عدم وجود قناة المعاينة بعد، فإن هذا الأمر ينشئ قناة في موقع Hosting التلقائي قبل نشره على القناة

firebase hosting:channel:list يسرد جميع القنوات (بما في ذلك القناة "المباشرة") في الموقع الإلكتروني التلقائي على Hosting
firebase Host: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

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

يتم نشر هذا الأمر أيضًا إلى "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
--القوة		 تؤدي هذه الدالة إلى الرجوع بنموذج Remote Config إلى إصدار سابق محدّد أو إلى الإصدار السابق مباشرةً (الإصدار الحالي -1) بشكل تلقائي. ما لم يتم تمرير --force، ستظهر رسالة الطلب Y/N. قبل العودة إلى الإصدار السابق.