يوفّر واجهة سطر الأوامر في Firebase (GitHub) مجموعة متنوعة من الأدوات لإدارة مشاريع Firebase وعرضها ونشرها.
قبل استخدام واجهة سطر الأوامر في Firebase، يمكنك إعداد مشروع Firebase.
إعداد واجهة سطر الأوامر أو تحديثه
تثبيت واجهة سطر الأوامر في Firebase
يمكنك تثبيت واجهة سطر الأوامر في Firebase باستخدام طريقة تتوافق مع نظام التشغيل و/أو مستوى الخبرة و/أو حالة الاستخدام. وبغض النظر عن طريقة تثبيت واجهة سطر الأوامر،
يمكنك الوصول إلى الوظائف نفسها والأمر firebase
.
نظام التشغيل Windows macOS نظام التشغيل Linux
نظام التشغيل Windows
يمكنك تثبيت واجهة سطر الأوامر في Firebase لنظام التشغيل Windows باستخدام أحد الخيارات التالية:
الخيار | الوصف | إجراءات مقترَحة لـ... |
---|---|---|
برنامج ثنائي مستقل | نزِّل البرنامج الثنائي المستقل لواجهة سطر الأوامر. بعد ذلك، يمكنك الوصول إلى الملف التنفيذي لفتح واجهة أوامر تتيح لك تنفيذ الأمر firebase .
|
المطوّرون الجُدد المطوِّرون الذين لا يستخدمون Node.js أو على دراية بها |
دقيقة في الدقيقة | استخدِم npm (أداة إدارة حزم العقدة) لتثبيت واجهة سطر الأوامر وتفعيل
أمر firebase المتاح عالميًا.
|
المطوّرون الذين يستخدمون Node.js |
برنامج ثنائي مستقل
لتنزيل البرنامج الثنائي لواجهة سطر الأوامر في Firebase وتشغيله، اتبع الخطوات التالية:
افتح البرنامج الثنائي لفتح واجهة مستخدم تتيح لك تنفيذ الأمر
firebase
.المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر
دورة في الدقيقة
لاستخدام npm
(مدير حزم العقدة) لتثبيت واجهة سطر الأوامر بنظام Firebase، اتّبِع الخطوات التالية:
ثبِّت Node.js باستخدام nvm-Windows (مدير إصدارات العقدة). يؤدي تثبيت Node.js إلى تثبيت أدوات أوامر
npm
تلقائيًا.ثبِّت واجهة سطر الأوامر لمنصّة Firebase من خلال
npm
من خلال تنفيذ الأمر التالي:npm install -g firebase-tools
يفعِّل هذا الأمر الأمر
firebase
المتاح عالميًا.المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر
نظام التشغيل macOS أو Linux
يمكنك تثبيت واجهة سطر الأوامر في Firebase لنظام التشغيل macOS أو Linux باستخدام أحد الخيارات التالية:
الخيار | الوصف | إجراءات مقترَحة لـ... |
---|---|---|
نص التثبيت التلقائي | شغِّل أمرًا واحدًا يكشف تلقائيًا عن نظام التشغيل، وينزِّل أحدث إصدار من واجهة سطر الأوامر، ثم يفعّل أمر firebase المتاح عالميًا.
|
المطوّرون الجُدد مطوّرو البرامج الذين لا يستخدمون Node.js أو على دراية بها عمليات النشر المبرمَجة في بيئة CI/CD |
برنامج ثنائي مستقل | نزِّل البرنامج الثنائي المستقل لواجهة سطر الأوامر. بعد ذلك، يمكنك إعداد البرنامج الثنائي وتشغيله بما يتناسب مع سير عملك. | عمليات سير عمل قابلة للتخصيص بالكامل باستخدام واجهة سطر الأوامر |
دقيقة في الدقيقة | استخدِم npm (أداة إدارة حزم العقدة) لتثبيت واجهة سطر الأوامر وتفعيل
أمر firebase المتاح عالميًا.
|
المطوّرون الذين يستخدمون Node.js |
تثبيت تلقائي للنص البرمجي
لتثبيت واجهة سطر الأوامر في Firebase باستخدام النص البرمجي للتثبيت التلقائي، اتّبِع الخطوات التالية:
شغِّل أمر cURL التالي:
curl -sL https://firebase.tools | bash
يرصد هذا النص البرمجي تلقائيًا نظام التشغيل، وينزّل أحدث إصدار من واجهة سطر الأوامر في Firebase، ثم يفعّل أمر
firebase
المتاح عالميًا.المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر
للاطّلاع على المزيد من الأمثلة والتفاصيل عن النص البرمجي للتثبيت التلقائي، يمكنك الرجوع إلى رمز مصدر النص البرمجي في firebase.tools.
برنامج ثنائي مستقل
لتنزيل البرنامج الثنائي وتشغيل واجهة سطر الأوامر الخاصة بـ Firebase والمخصص لنظام التشغيل لديك، اتبع الخطوات التالية:
يمكنك تنزيل البرنامج الثنائي لواجهة سطر الأوامر في Firebase لنظام التشغيل الخاص بك: macOS | Linux
(اختياري) يمكنك إعداد أمر
firebase
المتاح عالميًا.- اجعل البرنامج الثنائي قابلاً للتنفيذ من خلال تشغيل
chmod +x ./firebase_tools
. - أضِف مسار البرنامج الثنائي إلى PATH.
- اجعل البرنامج الثنائي قابلاً للتنفيذ من خلال تشغيل
المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر
دورة في الدقيقة
لاستخدام npm
(مدير حزم العقدة) لتثبيت واجهة سطر الأوامر بنظام Firebase، اتّبِع الخطوات التالية:
ثبِّت Node.js باستخدام nvm (مدير إصدارات العقدة).
يؤدي تثبيت Node.js إلى تثبيت أدوات أوامرnpm
تلقائيًا.ثبِّت واجهة سطر الأوامر لمنصّة Firebase من خلال
npm
من خلال تنفيذ الأمر التالي:npm install -g firebase-tools
يفعِّل هذا الأمر الأمر
firebase
المتاح عالميًا.المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر
سجِّل الدخول واختبِر واجهة سطر الأوامر (CLI) في Firebase.
بعد تثبيت واجهة سطر الأوامر، يجب إجراء المصادقة. بعد ذلك، يمكنك تأكيد المصادقة من خلال إدراج مشاريع Firebase.
سجّل الدخول إلى Firebase باستخدام حساب Google عن طريق تنفيذ الأمر التالي:
firebase login
يربط هذا الأمر جهازك المحلي بمنصة Firebase ويمنحك إذن الوصول إلى مشاريع Firebase.
تأكّد من تثبيت واجهة سطر الأوامر بشكل صحيح وأنّه يدخل إلى حسابك من خلال إدراج مشاريع Firebase. شغِّل الأمر التالي:
firebase projects:list
يجب أن تكون القائمة المعروضة مماثلة لمشاريع Firebase المدرَجة في وحدة تحكُّم Firebase.
التحديث إلى آخر إصدار من واجهة سطر الأوامر
وننصحك باستخدام أحدث إصدار من واجهة سطر الأوامر في Firebase بشكل عام.
تعتمد كيفية تحديث إصدار واجهة سطر الأوامر على نظام التشغيل وكيفية تثبيت واجهة سطر الأوامر.
شبابيك
- برنامج ثنائي مستقل: يمكنك تنزيل الإصدار الجديد، ثم استبداله على نظامك
- npm: تشغيل
npm install -g firebase-tools
نظام التشغيل macOS
- نص التثبيت التلقائي: تشغيل
curl -sL https://firebase.tools | upgrade=true bash
- برنامج ثنائي مستقل: يمكنك تنزيل الإصدار الجديد، ثم استبداله على النظام
- npm: تشغيل
npm install -g firebase-tools
Linux
- نص التثبيت التلقائي: تشغيل
curl -sL https://firebase.tools | upgrade=true bash
- برنامج ثنائي مستقل: يمكنك تنزيل الإصدار الجديد، ثم استبداله على النظام
- npm: تشغيل
npm install -g firebase-tools
استخدام واجهة سطر الأوامر مع أنظمة CI
يتطلّب واجهة سطر الأوامر في Firebase متصفّحًا لإكمال المصادقة، إلا أنّ واجهة سطر الأوامر تتوافق تمامًا مع واجهة CI وغيرها من البيئات التي بلا واجهة مستخدم رسومية.
على جهاز مزوّد بمتصفّح، عليك تثبيت واجهة سطر الأوامر في Firebase.
ابدأ عملية تسجيل الدخول من خلال تشغيل الأمر التالي:
firebase login:ci
انتقِل إلى عنوان URL المقدَّم، ثم سجِّل الدخول باستخدام حساب Google.
اطبع رمزًا مميزًا جديدًا لإعادة التحميل. لن تتأثر جلسة CLI الحالية.
خزِّن الرمز المميّز للإخراج بطريقة آمنة ولكن يسهل الوصول إليها في نظام CI.
استخدِم هذا الرمز المميّز عند تشغيل أوامر
firebase
. يمكنك استخدام أي من الطريقتين التاليتين:الخيار 1: تخزين الرمز المميّز كمتغيّر البيئة
FIREBASE_TOKEN
وسيستخدم نظامك الرمز المميّز تلقائيًا.الخيار 2: يمكنك تنفيذ جميع أوامر
firebase
باستخدام علامة--token TOKEN
في نظام CI.
هذا هو ترتيب الأسبقية لتحميل الرمز المميّز: العلامة ومتغيّرات البيئة ومشروع Firebase المطلوب.
إعداد مشروع Firebase
تتطلب العديد من المهام الشائعة التي يتم تنفيذها باستخدام واجهة سطر الأوامر، مثل النشر في مشروع Firebase، دليل المشروع. يمكنك إنشاء دليل مشروع
باستخدام الأمر firebase init
. عادةً ما يكون دليل المشروع هو الدليل نفسه الموجود في جذر عنصر التحكم في المصدر، وبعد تشغيل firebase init
، يحتوي الدليل على ملف إعداد firebase.json
.
لإعداد مشروع جديد في Firebase، شغِّل الأمر التالي من داخل دليل تطبيقك:
firebase init
يوجِّهك الأمر firebase init
خلال عملية إعداد دليل المشروع وبعض منتجات Firebase. أثناء تهيئة المشروع، يطلب منك واجهة سطر الأوامر
في Firebase إكمال المهام التالية:
اختَر منتجات Firebase التي تريد إعدادها في مشروع Firebase.
وتطلب منك هذه الخطوة ضبط عمليات ضبط لملفات محددة للمنتجات المحدّدة. لمعرفة المزيد من التفاصيل حول عمليات الضبط هذه، يمكنك الرجوع إلى مستندات المنتج المحدّد (على سبيل المثال، الاستضافة). يُرجى العِلم أنّه يمكنك دائمًا تشغيل
firebase init
لاحقًا لإعداد المزيد من منتجات Firebase.اختَر مشروعًا تلقائيًا في Firebase.
تربط هذه الخطوة دليل المشروع الحالي بمشروع Firebase بحيث يتم تشغيل الأوامر الخاصة بالمشروع (مثل
firebase deploy
) مقابل مشروع Firebase المناسب.من الممكن أيضًا ربط عدة مشاريع في Firebase (مثل مشروع مرحلي ومشروع إنتاج) بدليل المشروع نفسه.
في نهاية الإعداد، ينشئ Firebase تلقائيًا الملفين التاليَين في جذر دليل التطبيق المحلي:
ملف إعداد
firebase.json
يسرد إعدادات مشروعكملف
.firebaserc
يخزِّن الأسماء المستعارة لمشروعك.
الملف firebase.json
ينشئ الأمر firebase init
ملف إعداد firebase.json
في جذر دليل مشروعك.
يجب توفير الملف firebase.json
لنشر مواد العرض باستخدام واجهة سطر الأوامر في Firebase لأنّه يحدّد
الملفات والإعدادات من دليل المشروع التي سيتم نشرها في
مشروع Firebase. ونظرًا لأنه يمكن تحديد بعض الإعدادات في دليل المشروع أو وحدة تحكُّم Firebase، احرص على حل أي تعارضات محتملة بشأن عمليات النشر.
يمكنك ضبط معظم خيارات "استضافة Firebase"
مباشرةً في ملف firebase.json
. وبالنسبة إلى خدمات Firebase الأخرى التي يمكن نشرها باستخدام واجهة سطر الأوامر في Firebase، ينشئ الأمر firebase init
ملفات محدّدة يمكنك من خلالها ضبط إعدادات تلك الخدمات، مثل ملف index.js
لوظائف السحابة الإلكترونية. يمكنك أيضًا
إعداد عناصر الجذب المُسبقة أو النشرية في ملف firebase.json
.
في ما يلي مثال على ملف firebase.json
بالإعدادات التلقائية إذا اختَرت "استضافة Firebase" و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 وملفات مصدر فهرس قاعدة البيانات بكل قاعدة بيانات. عدّل الملف باستخدام صفيفة 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
لتجاهلها. يمنع ذلك نشر الملفات غير الضرورية في الخلفية والتي قد تزيد من حجم بيانات عملية النشر.
في ما يلي قائمة بالملفات التي يتم تجاهلها تلقائيًا والتي يتم عرضها بتنسيق JSON:
"ignore": [
".git",
".runtimeconfig.json",
"firebase-debug.log",
"firebase-debug.*.log",
"node_modules"
]
إذا أضفت قيمك المخصّصة لـ ignore
في firebase.json
، احرص على الاحتفاظ بقائمة الملفات الموضّحة أعلاه (أو إضافتها، إذا كانت مفقودة).
إدارة الأسماء المستعارة للمشروع
يمكنك ربط عدة مشاريع في Firebase بدليل المشروع نفسه.
على سبيل المثال، قد ترغب في استخدام مشروع Firebase
للإعداد المرحلي وآخر للإنتاج. باستخدام بيئات مشروع مختلفة، يمكنك التحقق من التغييرات قبل النشر إلى الإنتاج. يتيح لك الأمر firebase use
التبديل بين العناوين البديلة
وإنشاء عناوين بديلة جديدة.
إضافة اسم مستعار للمشروع
عند اختيار مشروع Firebase أثناء إعداد
المشروع، يتم تلقائيًا تخصيص
الاسم المستعار default
للمشروع. ومع ذلك، للسماح بتشغيل الأوامر الخاصة بالمشروع مع مشروع مختلف في Firebase مع الاستمرار في استخدام دليل المشروع نفسه، شغِّل الأمر التالي من داخل دليل المشروع:
firebase use --add
يطلب منك هذا الأمر اختيار مشروع آخر في Firebase وتعيين
المشروع كاسم مستعار. تتم كتابة تعيينات الأسماء المستعارة إلى ملف .firebaserc
داخل دليل مشروعك.
استخدام الأسماء المستعارة للمشروع
لاستخدام الأسماء المستعارة لمشروع Firebase التي تم تعيينها، شغِّل أيًا من الأوامر التالية من داخل دليل مشروعك.
الطلب | الوصف |
---|---|
firebase use |
عرض قائمة بالأسماء المستعارة المحددة حاليًا لدليل مشروعك |
firebase use \ |
يوجّه جميع الأوامر لتنفيذها في مشروع Firebase المحدّد.
يستخدم واجهة سطر الأوامر هذا المشروع باعتباره "المشروع النشط" حاليًا. |
firebase use --clear |
يؤدي هذا الإجراء إلى محو المشروع النشط.
شغِّل |
firebase use \ |
يزيل اسمًا مستعارًا من دليل المشروع. |
يمكنك إلغاء ما يُستخدم كمشروع نشط حاليًا من خلال تمرير علامة --project
باستخدام أي أمر CLI. على سبيل المثال: يمكنك ضبط واجهة سطر الأوامر
ليعمل مع مشروع في Firebase سبق لك تخصيص عنوان staging
إليه البديل. إذا كنت تريد تنفيذ أمر واحد على مشروع Firebase الذي
خصّصته لـ prod
البديل، يمكنك تشغيل
مثلاً.
التحكم في المصدر والأسماء المستعارة للمشروع
بشكل عام، عليك التحقّق من ملف .firebaserc
في عنصر التحكّم في المصدر للسماح لفريقك بمشاركة الأسماء المستعارة للمشروع. أمّا بالنسبة إلى المشاريع مفتوحة المصدر أو نماذج المبتدئين، فيجب عدم التحقق بشكل عام من ملف .firebaserc
.
إذا كان لديك مشروع تطوير مخصّص لك فقط، يمكنك إما تمرير
علامة --project
مع كل أمر، أو تشغيل
firebase use PROJECT_ID
بدون تعيين اسم مستعار
لمشروع Firebase.
عرض مشروع Firebase واختباره محليًا
يمكنك عرض مشروع Firebase واختباره على عناوين URL المُستضافة محليًا قبل نشره في قناة الإصدار العلني. إذا كنت تريد اختبار ميزات محدّدة فقط، يمكنك استخدام
قائمة مفصولة بفواصل في علامة ضمن الأمر firebase serve
.
قم بتشغيل الأمر التالي من جذر دليل المشروع المحلي إذا كنت تريد القيام بأي من المهام التالية:
- عرض المحتوى الثابت لتطبيقك المستضاف على Firebase.
- يمكنك استخدام دوال Cloud من أجل إنشاء محتوى ديناميكي لاستضافة Firebase وإذا كنت تريد استخدام وظائف HTTP للإنتاج (المنشور) لمحاكاة "الاستضافة" على عنوان 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
- وظائف السحابة الإلكترونية الجديدة أو المعدّلة أو الحالية لبرنامج Firebase
- قواعد قاعدة بيانات Firebase في الوقت الفعلي
- قواعد التخزين في السحابة الإلكترونية لبرنامج Firebase
- قواعد Cloud Firestore
- فهارس Cloud Firestore
للنشر إلى مشروع Firebase، شغِّل الأمر التالي من دليل المشروع:
firebase deploy
يمكنك اختياريًا إضافة تعليق إلى كل عملية من عمليات النشر. سيظهر هذا التعليق مع معلومات النشر الأخرى في صفحة "استضافة Firebase" الخاصة بمشروعك. على سبيل المثال:
firebase deploy -m "Deploying the best new feature ever."
عند استخدام الأمر firebase deploy
، يجب الانتباه لما يلي:
لنشر الموارد من دليل مشروع، يجب أن يحتوي دليل المشروع على ملف
firebase.json
. ويتم إنشاء هذا الملف تلقائيًا لك باستخدام الأمرfirebase init
.ينشئ
firebase deploy
تلقائيًا إصدارًا لجميع الموارد القابلة للنشر في دليل مشروعك. ولتفعيل خدمات أو ميزات Firebase محدَّدة، يمكنك استخدام النشر الجزئي.
تضاربات النشر لقواعد الأمان
بالنسبة إلى "قاعدة بيانات Firebase في الوقت الفعلي" وCloud Storage for Firebase وCloud Firestore، يمكنك تحديد قواعد الأمان إما في دليل المشروع المحلي أو في وحدة تحكُّم Firebase.
هناك خيار آخر لتجنُّب تعارض النشر، وهو استخدام النشر الجزئي وتحديد القواعد في وحدة تحكُّم Firebase فقط.
حصص النشر
ومن الممكن (على الرغم من عدم احتمال ذلك) تجاوز حصة تحدّ من
معدل أو حجم عمليات نشر Firebase. على سبيل المثال، قد تظهر لك رسالة خطأ HTTP 429 Quota
عند نشر عدد كبير جدًا من الدوال. لحل هذه المشاكل، جرِّب استخدام النشر الجزئي.
العودة إلى الإصدارات السابقة من عملية نشر
يمكنك العودة إلى الإصدار السابق من نشر "استضافة Firebase" من صفحة استضافة Firebase لمشروعك من خلال اختيار إجراء العودة للإصدار المطلوب.
لا يمكن حاليًا العودة إلى الإصدارات السابقة من قواعد الأمان في قاعدة بيانات Firebase في الوقت الفعلي أو Cloud Storage for Firebase أو Cloud Firestore.
تفعيل خدمات محددة في Firebase
إذا كنت تريد نشر ميزات أو خدمات معيّنة فقط في Firebase، يمكنك استخدام قائمة مفصولة بفواصل في علامة واردة في الأمر firebase deploy
. على سبيل المثال، ينشر الأمر التالي محتوى "استضافة Firebase" وقواعد أمان Cloud Storage.
firebase deploy --only hosting,storage
يسرد الجدول التالي الخدمات والميزات المتاحة للنشر الجزئي. تتوافق الأسماء الواردة في العلامات مع المفاتيح في ملف إعداد
firebase.json
.
الإبلاغ عن بنية | تم نشر خدمة أو ميزة |
---|---|
--only hosting |
استضافة المحتوى على Firebase |
--only database |
قواعد قاعدة بيانات Firebase في الوقت الفعلي |
--only storage |
قواعد التخزين في السحابة الإلكترونية لبرنامج Firebase |
--only firestore |
قواعد Cloud Firestore وفهارس جميع قواعد البيانات التي تم إعدادها |
--only functions |
وظائف السحابة الإلكترونية لبرنامج Firebase (يمكن استخدام إصدارات أكثر تحديدًا من هذه العلامة) |
نشر دوال محددة
عند نشر الدوال، يمكنك استهداف وظائف محددة. على سبيل المثال:
firebase deploy --only functions:function1
firebase deploy --only functions:function1,functions:function2
ويمكنك أيضًا تجميع الدوال في مجموعات تصدير ضمن ملف
/functions/index.js
. تسمح لك دوال التجميع بنشر
دوال متعددة باستخدام أمر واحد.
على سبيل المثال، يمكنك كتابة الدوال التالية لتحديد groupA
و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".
لإعداد عناصر الجذب المسبقة أو اللاحقة للنشر، أضِف نصوص bash البرمجية إلى ملف إعداد
firebase.json
. يمكنك تعريف
نصوص برمجية مختصرة في ملف firebase.json
مباشرةً، أو يمكنك الإشارة إلى
ملفات أخرى في دليل مشروعك.
على سبيل المثال، النص البرمجي التالي هو التعبير firebase.json
لمهمة postdeploy التي ترسل رسالة Slack عند النشر بنجاح إلى "استضافة Firebase".
"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
فقط) موقع الدليل الذي يحتوي على موارد الاستضافة أو موارد الوظائف السحابية المطلوب نشرها
إدارة مثيلات قاعدة بيانات في الوقت الفعلي متعددة
يمكن أن يحتوي مشروع Firebase على مثيلات قاعدة بيانات Firebase في الوقت الفعلي متعددة. تتفاعل أوامر واجهة سطر الأوامر (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 يتطلب ذلك الوصول إلى متصفّح ويب. لتسجيل الدخول إلى واجهة سطر الأوامر في البيئات البعيدة التي لا تسمح بالوصول إلى 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 لتطبيق Android المحدّد في Firebase. |
النشر والتطوير المحلي
تتيح لك هذه الأوامر نشر موقع استضافة Firebase والتفاعل معه.
الطلب | الوصف |
---|---|
النشر | يتم نشر الرموز والأصول من دليل المشروع إلى المشروع النشط. لاستضافة Firebase، يجب توفير ملف إعداد
firebase.json .
|
خدمة | لبدء خادم ويب محلي بإعدادات "استضافة Firebase".
لاستضافة Firebase، يجب توفير ملف إعداد
firebase.json . |
طلبات توزيع التطبيقات
الطلب | الوصف |
---|---|
توزيع التطبيق:توزيع \ --التطبيق FIREBASE_APP_ID |
إتاحة الإصدار للمختبِرين |
appdistribution:testers:add | إضافة مختبِرين إلى المشروع |
appdistribution:testers:remove | لإزالة المختبِرين من المشروع |
أوامر استضافة التطبيقات
الطلب | الوصف |
---|---|
apphosting:backends:create \ --مشروع PROJECT_ID --موقع REGION --تطبيق APP_ID |
تنشئ مجموعة من الموارد المُدارة المرتبطة بقاعدة رموز برمجية واحدة تتألّف من خلفية "استضافة التطبيقات". يمكنك تحديد تطبيق ويب حالي في 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 PROJECT_ID --location REGION --data-file Data file |
تخزين المواد السرية في Secret Manager يمكنك اختياريًا توفير
مسار ملف يمكنك من خلاله قراءة البيانات السرية. يمكنك ضبط القيمة على _ لقراءة
البيانات السرية من مصدر الإدخال العادي.
|
apphosting:secrets:grantaccess \ KEY --مشروع PROJECT_ID BACKEND_ID --موقع REGION |
يمنح حساب خدمة الخلفية إذن الوصول إلى المفتاح السرّي المقدَّم حتى يمكن الوصول إليه من خلال "استضافة التطبيقات" في وقت الإصدار أو التشغيل. |
apphosting:secrets:describe \ KEY --project PROJECT_ID |
يحصل على البيانات الوصفية للسر وإصداراته. |
firebase apphosting:secrets:access \ KEY[@version] --مشروع PROJECT_ID |
للوصول إلى قيمة سرية محدّدة المفتاح السرّي وإصداره. تتيح هذه السياسة الوصول إلى أحدث إصدار تلقائيًا. |
أوامر المصادقة (إدارة المستخدمين)
الطلب | الوصف |
---|---|
auth:export | يؤدي هذا الخيار إلى تصدير حسابات المستخدمين في المشروع النشط إلى ملف JSON أو CSV. لمزيد من التفاصيل، راجِع صفحة auth:import وauth:export. |
تفويض:استيراد | لاستيراد حسابات المستخدمين من ملف JSON أو CSV إلى المشروع النشط. لمزيد من التفاصيل، راجِع صفحة auth:import وauth:export. |
أوامر Cloud Firestore
الطلب | الوصف |
---|---|
firestore:مواقع |
سرد المواقع الجغرافية المتاحة لقاعدة بيانات Cloud Firestore |
firestore:databases:إنشاء DATABASE_ID |
يمكنك إنشاء مثيل قاعدة بيانات في الوضع الأصلي ضمن مشروع Firebase. يأخذ الأمر العلامات التالية:
|
firestore:databases:list |
إدراج قواعد البيانات في مشروع Firebase |
firestore:databases:get DATABASE_ID |
يمكنك الحصول على إعدادات قاعدة بيانات لقاعدة بيانات محدّدة في مشروعك على Firebase. |
firestore:databases:update DATABASE_ID |
يمكنك تعديل إعدادات قاعدة بيانات محدّدة في مشروعك على Firebase. مطلوب إبلاغ واحد على الأقل. يأخذ الأمر العلامات التالية:
|
firestore:databases:حذف DATABASE_ID |
يجب حذف قاعدة بيانات في مشروع Firebase. |
firestore:مؤشرات |
أدرِج فهارس قاعدة بيانات في مشروع Firebase الخاص بك. يأخذ الأمر العلامة التالية:
|
firestore:حذف |
لحذف المستندات من قاعدة بيانات المشروع النشط. وباستخدام واجهة سطر الأوامر، يمكنك حذف جميع المستندات في المجموعة بشكل متكرر. يُرجى العلم أنّ حذف بيانات Cloud Firestore باستخدام واجهة سطر الأوامر سيؤدي إلى تحمُّل تكاليف قراءة وحذف. لمزيد من المعلومات، يُرجى الاطّلاع على فهم الفوترة في Cloud Firestore. يأخذ الأمر العلامة التالية:
|
دوال السحابة الإلكترونية لأوامر Firebase
الطلب | الوصف |
---|---|
الدوال:config:clone | يستنسخ بيئة مشروع آخر في مشروع Firebase النشط. |
الدوال:الضبط:get | يسترد قيم الإعداد الحالية لدوال Cloud Functions في المشروع النشط. |
الدوال:الضبط:set | تخزين قيم إعداد وقت تشغيل دوال Cloud للمشروع النشط |
الدوال:الضبط:غير محدَّد | تتم إزالة القيم من إعدادات وقت تشغيل المشروع النشط. |
الدوال:سجلّ | يقرأ السجلات من دوال Cloud المنشورة. |
لمزيد من المعلومات، راجِع مستندات ضبط البيئة.
أوامر Crashlytics
الطلب | الوصف |
---|---|
crashlytics:mappingfile:generateid \ --resource-file=PATH/TO/ANDROID_RESOURCE.XML |
تنشئ هذه الدالة معرّفًا فريدًا لملف الربط في ملف XML محدّد لمورد Android. |
crashlytics:mappingfile:upload \ --app=FIREBASE_APP_ID \ --resource-file=PATH/TO/ANDROID_RESOURCE.XML \ PATH/TO/MAPPING_FILE.TXT |
تعمل هذه السياسة على تحميل ملف تعيين (TXT) متوافق مع Proguard لهذا التطبيق، وربطه بمعرّف ملف الربط المُعرَّف في ملف XML (XML) لمورد Android المحدّد. |
crashlytics:symbols:upload \ --app=FIREBASE_APP_ID \ PATH/TO/SYMBOLS |
تنشئ هذه الأداة ملف رموز متوافقًا مع Crashlytics لأعطال المكتبة الأصلية على نظام التشغيل Android وتحمّله إلى خوادم Firebase. |
أوامر الإضافات
الطلب | الوصف |
---|---|
إضافة | يعرض معلومات عن كيفية استخدام أوامر إضافات Firebase. يسرد النُسخ الافتراضية للإضافة التي تم تثبيتها في المشروع النشط. |
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:تصدير | يصدِّر هذا المنتج جميع مثيلات الإضافات المثبَّتة من مشروعك إلى بيان الإضافة. |
أوامر ناشر الإضافات
الطلب | الوصف |
---|---|
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:disable |
إيقاف عرض زيارات "استضافة Firebase" لمشروع Firebase النشط. سيعرض عنوان URL للاستضافة الخاص بمشروعك رسالة "لم يتم العثور على الموقع الإلكتروني" بعد تشغيل هذا الأمر. |
إدارة المواقع الإلكترونية المستضيفة | |
firebase Host:sites:create \ SITE_ID |
يتم إنشاء موقع استضافة إلكتروني جديد في مشروع Firebase النشط باستخدام
(اختياري) حدِّد تطبيق ويب حالي في Firebase لربطه
بالموقع الجديد من خلال تمرير العلامة التالية:
|
firebase Host:sites:delete \ SITE_ID |
يؤدي هذا الإجراء إلى حذف موقع الاستضافة الإلكتروني المحدّد. يعرض CLI رسالة تأكيد قبل حذف الموقع الإلكتروني. (اختياري) يمكنك تخطّي طلب التأكيد من خلال تمرير
العلامة التالية: |
firebase Host:sites:get \ SITE_ID |
استرداد معلومات عن موقع الاستضافة الإلكتروني المحدّد |
firebase Host:sites:list |
إدراج جميع مواقع الاستضافة لمشروع Firebase النشط |
إدارة قنوات المعاينة | |
firebase owner:channel:create \ CHANNEL_ID |
تنشئ قناة معاينة جديدة في الإعداد التلقائي لموقع الاستضافة الإلكتروني باستخدام السمة لا يتم نشر هذا الأمر في القناة. |
firebase Host:channel:delete \ CHANNEL_ID |
لحذف قناة المعاينة المحدّدة لا يمكنك حذف القناة المباشرة لموقع. |
firebase Host:channel:deploy \ CHANNEL_ID |
تنشر محتوى الاستضافة والإعدادات في قناة المعاينة المحدّدة. في حال عدم توفّر قناة المعاينة بعد، ينشئ هذا الأمر القناة في الموقع الإلكتروني للاستضافة التلقائي قبل نشرها على القناة. |
firebase Host:channel:list | إدراج جميع القنوات (بما في ذلك القناة "المباشرة") في الموقع الإلكتروني المستضاف تلقائي |
firebase Host:channel:open \ CHANNEL_ID |
يؤدي هذا الإجراء إلى فتح متصفّح للوصول إلى عنوان URL الخاص بالقناة المحدّدة أو عرض عنوان URL إذا تعذّر فتحه في متصفّح. |
استنساخ النُسخ | |
firebase record:clone \ SOURCE_SITE_ID:SOURCE_CHANNEL_ID \ TARGET_SITE_ID:TARGET_CHANNEL_ID |
يستنسخ أحدث إصدار تم نشره على قناة "المصدر" المحددة إلى القناة "المستهدفة" المحددة يتم أيضًا نشر هذا الأمر إلى قناة "الهدف" المحددة. في حال عدم توفّر القناة "المستهدفة" بعد، يُنشئ هذا الأمر قناة معاينة جديدة في موقع الاستضافة الإلكتروني "المستهدف" قبل نشره على القناة. |
firebase owner:clone \ SOURCE_SITE_ID:@VERSION_ID \ TARGET_SITE_ID:TARGET_CHANNEL_ID |
يستنسخ الإصدار المحدد إلى قناة "الهدف" المحددة يتم أيضًا نشر هذا الأمر إلى قناة "الهدف" المحددة. في حال عدم توفّر القناة "المستهدفة" بعد، يُنشئ هذا الأمر قناة معاينة جديدة في موقع الاستضافة الإلكتروني "المستهدف" قبل نشره على القناة. يمكنك العثور على |
أوامر قاعدة البيانات في الوقت الفعلي
يُرجى العِلم أنّه يمكنك إنشاء مثيل "قاعدة بيانات الوقت الفعلي" الأولي التلقائي في وحدة تحكُّم Firebase أو باستخدام سير العمل العام firebase init
أو مسار
firebase init database
المحدَّد.
بعد إنشاء المثيلات، يمكنك إدارتها كما هو موضَّح في مقالة إدارة مثيلات قاعدة بيانات في الوقت الفعلي متعدّدة.
الطلب | الوصف |
---|---|
database:get | يجلب البيانات من قاعدة بيانات المشروع النشط ويعرضها على شكل JSON. تتيح إجراء طلبات بحث في البيانات المفهرَسة. |
database:instances:create | تنشئ مثيل قاعدة بيانات باسم مثيل محدد. تتيح هذه الميزة
استخدام الخيار --location لإنشاء قاعدة بيانات في منطقة
محدّدة. لكي يتم استخدام أسماء المناطق مع هذا الخيار، يمكنك الاطّلاع على
اختيار المواقع الجغرافية لمشروعك.
إذا لم يتوفّر مثيل قاعدة بيانات للمشروع الحالي، سيُطلب منك
تشغيل مسار firebase init لإنشاء مثيل.
|
database:instances:list | أدرِج جميع مثيلات قاعدة البيانات لهذا المشروع. تقبل الخيار
--location لإدراج قواعد البيانات في منطقة
محدّدة. لكي تتمكّن من استخدام أسماء المناطق مع هذا الخيار، راجِع
اختيار المواقع الجغرافية لمشروعك. |
database:الملف الشخصي | ينشئ ملف تعريف للعمليات على قاعدة بيانات المشروع النشط. لمزيد من التفاصيل، راجِع أنواع عمليات قاعدة البيانات في الوقت الفعلي. |
database:push | لإرسال البيانات الجديدة إلى قائمة في موقع محدّد في قاعدة بيانات المشروع النشط. يتم الحصول على الإدخال من ملف أو STDIN أو وسيطة سطر أوامر. |
database:إزالة | يؤدي هذا الإجراء إلى حذف جميع البيانات في موقع محدّد ضمن قاعدة بيانات المشروع النشط. |
database:set | لاستبدال جميع البيانات في موقع محدد ضمن قاعدة بيانات المشروع النشط. يتم الحصول على الإدخال من ملف أو STDIN أو وسيطة سطر أوامر. |
database:update | يجري تعديلاً جزئيًا في موقع محدد ضمن قاعدة بيانات المشروع النشط. يتم الحصول على الإدخال من ملف أو STDIN أو وسيطة سطر أوامر. |
أوامر "الإعداد عن بُعد"
الطلب | الوصف |
---|---|
remoteconfig:versions:list \ --limit NUMBER_OF_VERSIONS |
يسرد أحدث عشر إصدارات من النموذج. حدِّد 0 لعرض جميع الإصدارات الحالية، أو يمكنك اختياريًا ضبط الخيار --limit للحدّ من عدد الإصدارات التي يتم عرضها. |
remoteconfig:get \ --v, version_number VERSION_NUMBER --o، المخرجات FILENAME |
تحصل على النموذج حسب الإصدار (يتم استخدام أحدث إصدار تلقائيًا)
وتُخرج مجموعات المَعلمات والمعلَمات وأسماء الشروط
والإصدار في جدول. وبشكلٍ اختياري، يمكنك كتابة الناتج في ملف محدّد باستخدام -o, FILENAME . |
remoteconfig:rollback \ --v، version_number VERSION_NUMBER --force |
يؤدي هذا الإجراء إلى إعادة نموذج "الإعداد عن بُعد" إلى رقم إصدار سابق محدّد
أو الضبط التلقائي على الإصدار السابق المباشر (الإصدار الحالي -1). ما لم يتم تجاوز --force ، ستظهر رسالة نعم/لا قبل المتابعة للعودة إلى الإصدار السابق. |