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

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

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

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

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

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

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

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

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

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

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

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

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

  1. تنزيل القيمة الثنائية لواجهة سطر الأوامر Firebase لـ نظام التشغيل Windows:

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

  3. المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر

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

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

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

  2. ثبِّت واجهة سطر الأوامر Firebase من خلال npm من خلال تنفيذ الأمر التالي:

    npm install -g firebase-tools

    يفعِّل هذا الأمر الأمر firebase المتاح عالميًا.

  3. المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر

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

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

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

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

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

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

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

  1. شغِّل أمر cURL التالي:

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

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

  2. المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر

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

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

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

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

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

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

  3. المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر

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

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

  1. ثبِّت Node.js باستخدام nvm (مدير إصدارات العقدة).
    يتم تثبيت 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

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

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

firebase init

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

  • اختَر منتجات 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 وخيارات أداة 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 production (المنشورة) لمحاكاة 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 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 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 وa groupB:

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

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');

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

إعداد المهام المسبقة للنشر وما بعد النشر

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

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

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

ضمن النصوص البرمجية التي يتم تشغيلها في عناصر الجذب قبل النشر وما بعد النشر، ينطبق ما يلي: المتغيرات البيئية المتاحة وهي:

  • $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

مرجع الطلب

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

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

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

الطلب الوصف
إدارة مشاريع Firebase
projects:addfirebase لإضافة موارد Firebase إلى مشروع Google Cloud حالي.
projects:إنشاء ينشئ مشروع Google Cloud جديدًا، ثم يضيف موارد Firebase إلى للمشروع الجديد.
projects:list يسرد جميع مشاريع Firebase التي يمكنك الوصول إليها.
إدارة تطبيقات Firebase (لنظامي التشغيل iOS وAndroid والويب)
apps:إنشاء ينشئ تطبيقًا جديدًا في 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 طلبات

الطلب الوصف
توزيع التطبيق:توزيع \
--التطبيق 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_ID
--الموقع الجغرافي REGION 		يسترد تفاصيل محددة، بما في ذلك عنوان URL العام للواجهة الخلفية.
apphosting:backends:list \
--مشروع PROJECT_ID 		لاسترداد قائمة بجميع الخلفيات النشطة المرتبطة بمشروع.
firebase apphosting:backends:delete \ BACKEND_ID
--المشروع PROJECT_ID
--الموقع الجغرافي REGION 		لحذف واجهة خلفية من المشروع.
apphosting:secrets:set \
KEY --مشروع PROJECT_ID
--location REGION --data-file Data file		 تخزين المواد السرية في Secret Manager بشكل اختياري، يمكنك تقديم مسار الملف الذي يمكن من خلاله قراءة البيانات السرية. تم الضبط على _ للقراءة البيانات السرية من المدخلات القياسية.
apphosting:secrets:grantaccess \
KEY --مشروع PROJECT_ID BACKEND_ID
--الموقع الجغرافي REGION 		يمنح واجهة خلفية حساب الخدمة إلى المفتاح السري المقدم حتى يمكن الوصول إليه من خلال App Hosting في وقت الإصدار أو التشغيل
apphosting:secrets:describe \
KEY --مشروع PROJECT_ID 		يحصل على البيانات الوصفية للسر وإصداراته.
firebase apphosting:secrets:access \
KEY[@version]
--المشروع PROJECT_ID 		للوصول إلى قيمة سرية محدّدة المفتاح السرّي وإصداره. تتيح هذه السياسة الوصول إلى أحدث إصدار تلقائيًا.

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

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

Cloud Firestore طلبات

الطلب الوصف
firestore:مواقع

يمكنك سرد المواقع الجغرافية المتاحة لقاعدة بيانات "Cloud Firestore".

firestore:databases:إنشاء 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:حذف DATABASE_ID

يجب حذف قاعدة بيانات في مشروع Firebase.
firestore:مؤشرات

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

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

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

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

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

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

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

Cloud Functions for Firebase طلبات

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

Extensions طلبات

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

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 Host:sites:delete \
SITE_ID

يؤدي هذا الإجراء إلى حذف موقع "Hosting" الإلكتروني المحدّد.

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

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

firebase Host:sites:get \
SITE_ID

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

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

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

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

لا يتم نشر هذا الأمر في القناة.
firebase Host:channel:delete \
CHANNEL_ID

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

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

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

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

firebase Host:channel:list يسرد جميع القنوات (بما في ذلك القناة "المباشرة") في الموقع الإلكتروني التلقائي على Hosting
firebase Host:channel:open \
CHANNEL_ID		 يؤدي إلى فتح متصفح للوصول إلى عنوان URL الخاص بالقناة المحددة أو عرض عنوان URL إذا تعذّر الفتح في متصفّح
استنساخ النُسخ
firebase meet:clone \
SOURCE_SITE_ID:SOURCE_CHANNEL_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

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

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

firebase meet: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:الملف الشخصي ينشئ ملف تعريف للعمليات على قاعدة بيانات المشروع النشط. بالنسبة لمزيد من التفاصيل، يُرجى الرجوع إلى أنواع عمليات Realtime Database.
database:push لإرسال البيانات الجديدة إلى قائمة في موقع محدد في المنطقة النشطة قاعدة بيانات المشروع. الحصول على الإدخال من ملف أو STDIN أو سطر أوامر الوسيطة.
database:إزالة حذف جميع البيانات في موقع محدد ضمن المشروع النشط قاعدة البيانات.
database:set لاستبدال جميع البيانات في موقع محدد في المشروع النشط قاعدة البيانات. يتم الحصول على الإدخال من ملف أو STDIN أو وسيطة سطر أوامر.
database:update إجراء تحديث جزئي في موقع محدد داخل الجهاز قاعدة بيانات المشروع. الحصول على الإدخال من ملف أو STDIN أو سطر أوامر الوسيطة.

Remote Config طلبات

الطلب الوصف
remoteconfig:versions:list \
--limit NUMBER_OF_VERSIONS		 يسرد أحدث عشر إصدارات من النموذج. يُرجى التحديد 0 لعرض جميع النُسخ الحالية، أو بشكل اختياري لتمرير خيار --limit للحد من عدد التي يتم عرضها.
remoteconfig:get \
--v، الإصدار_number VERSION_NUMBER
--o، الناتج FILENAME		 الحصول على النموذج حسب الإصدار (يتم استخدام أحدث إصدار تلقائيًا) وتخرج مجموعات المعلمات والمعلمات وأسماء الشروط الإصدار في جدول. اختياريًا، يمكنك كتابة الإخراج إلى ملف محدد باستخدام -o, FILENAME.
remoteconfig:rollback \
--v، version_number VERSION_NUMBER
--القوة		 إعادة نموذج واحد (Remote Config) إلى إصدار سابق محدّد أو يتم تعيينها افتراضيًا على الإصدار السابق المباشر (الإصدار الحالي -1). ما لم يتم تمرير --force، ستظهر رسالة الطلب Y/N. قبل العودة إلى الإصدار السابق.