مرجع سطر الأوامر

bazel [<startup options>] <command> [<args>]
أو
bazel [<startup options>] <command> [<args>] -- [<target patterns>]
يمكنك الاطّلاع على دليل المستخدم's للتعرّف على بنية الأنماط المستهدَفة.

بنية الخيار

يمكن تمرير الخيارات إلى Bazel بطرق مختلفة. يمكن تمرير الخيارات التي تتطلب قيمة إما بعلامة يساوي أو مسافة:

--<option>=<value>
--<option> <value>
تحتوي بعض الخيارات على نموذج قصير من حرف واحد، وفي هذه الحالة، يجب تمرير النموذج القصير بشرطة واحدة ومسافة.
-<short_form> <value>

يمكن تفعيل الخيارات المنطقية على النحو التالي:

--<option>
--<option>=[true|yes|1]
وإيقافها على النحو التالي:
--no<option>
--<option>=[false|no|0]

عادةً ما يتم ضبط خيارات Tristate على الوضع تلقائي بشكل تلقائي، ويمكن تفعيلها على النحو التالي:

--<option>=[true|yes|1]
أو فرض إيقافها على النحو التالي:
--no<option>
--<option>=[false|no|0]

الطلبات الصوتية

analyze-profile لتحليل بيانات الملف الشخصي.
aquery يحلّل الأهداف ويبحث عن الرسم البياني للإجراء.
build إنشاء الأهداف المحددة.
canonicalize-flags تعرض قائمة عناوين URL الأساسية خيارات مختلفة.
clean إزالة ملفات المخرجات وإيقاف الخادم اختياريًا.
coverage إنشاء تقرير تغطية الرمز لأهداف الاختبار المحدّدة.
cquery يحمّل الأهداف المحدّدة مع عمليات الضبط ويحلّلها ويبحث عنها.
dump تفريغ الحالة الداخلية لعملية الخادم.
fetch لجلب المستودعات الخارجية الأساسية إلى الأهداف.
help تساعد الصور المطبوعة في الطلبات أو الفهرس.
info يعرض معلومات عن وقت تشغيل خادم Bazel.
license يؤدي إلى طباعة ترخيص هذا البرنامج.
mobile-install يعمل على تثبيت الأهداف على الأجهزة الجوّالة.
modquery الاستعلام عن الرسم البياني للاعتمادية الخارجية على Bzlmod
print_action طباعة وسيطات سطر الأوامر لتجميع ملف.
query تنفيذ طلب رسم بياني للاعتمادية.
run يتم تشغيل الهدف المحدد.
shutdown يوقف خادم البازار.
sync مزامنة جميع المستودعات المحدَّدة في ملف مساحة العمل
test إنشاء أهداف الاختبار المحددة وتشغيلها.
version يطبع معلومات الإصدار للبازار.

خيارات بدء التشغيل

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
--[no]autodetect_server_javabase التلقائي: "true;true"
عند تمرير --noautodetect_server_javabase، لا يعود Bazel إلى JDK المحلي لتشغيل خادم البازل وبدلاً من ذلك يتم الخروج.
العلامات: affects_outputs، loses_incremental_state
--[no]batch التلقائي: "false;quot;
في حال ضبط الإعدادات، سيتم تشغيل Bazel كعملية عميل بدون خادم، بدلاً من وضع العميل/الخادم العادي. تم إيقاف هذا الموقع وستتم إزالته، يُفضّل إيقاف تشغيل الخادم بشكل صريح إذا كنت تريد تجنب ترك الخوادم.
العلامات: loses_incremental_state، bazel_internal_configuration، deprecated
--[no]batch_cpu_scheduling التلقائي: "false;quot;
على نظام التشغيل Linux فقط، يمكن استخدام 'batch' الجدولة في وحدة المعالجة المركزية (CPU) لشركة Blaze. تكون هذه السياسة مفيدة لأحمال العمل غير التفاعلية، ولكنها لا تريد تقليل قيمتها اللطيفة. الاطّلاع على 'man 2 sched_setscheduler'. إذا كان الإعداد "خطأ" غير مفعّل، لن يُجري Bazel استدعاء نظام.
العلامات: host_machine_resource_optimizations
--bazelrc=<path> التلقائي: عرض الوصف
موقع ملف .bazelrc للمستخدم يحتوي على قيم تلقائية لخيارات Bazel. يشير /dev/Empty إلى أنه سيتم تجاهل المزيد من "--bazelrc"، وهو أمر مفيد لإيقاف البحث عن ملف RC للمستخدم، على سبيل المثال في إصدارات الإصدار. ويمكن أيضًا تحديد هذا الخيار عدة مرات. على سبيل المثال، يجب قراءة "x-rc.rc" و"y.rc". 2) تم تجاهل z.rc بسبب /dev/Empty السابق. وفي حال عدم تحديدها، يستخدم Bazel ملف .bazelrc الأول الذي يعثر عليه في الموقعين التاليين: دليل مساحة العمل، ثم الدليل الرئيسي user@#99s. ملاحظة: ستحل دائمًا خيارات سطر الأوامر محل أي خيار في البازار.
العلامات: changes_inputs
--[no]block_for_lock التلقائي: "true;true"
عند مرور --noblock_for_lock، لا تنتظر Bazel حتى يكتمل تنفيذ الأمر، ولكن يتم الخروج على الفور بدلاً من ذلك.
العلامات: eagerness_to_exit
--[no]client_debug التلقائي: "false;quot;
في حال ضبط السياسة على"صحيح"، سجِّل معلومات تصحيح الأخطاء من البرنامج إلى stderr. لن يؤدي تغيير هذا الخيار إلى إعادة تشغيل الخادم.
العلامات: affects_outputs، bazel_monitoring
--connect_timeout_secs=<an integer> التلقائي: "30"
المدة الزمنية التي ينتظرها العميل لكل محاولة للاتصال بالخادم
العلامات: bazel_internal_configuration
--[no]expand_configs_in_place التلقائي: "true;true"
تم تغيير توسيع علامات -config لكي يتم تنفيذها في مكانها، على عكس توسيع نقطة ثابتة بين خيارات RC العادية وخيارات سطر الأوامر المحددة.
العلامات: no_op، deprecated
--failure_detail_out=<path> التلقائي: عرض الوصف
في حال ضبط السياسة، تحدِّد موقعًا جغرافيًا لكتابة رسالة failed_detail إذا كانت الخادم تواجه خطأً ولا يمكنها الإبلاغ عن ذلك عبر gRPC، كالمعتاد. بخلاف ذلك، سيكون الموقع الجغرافي ${OUTPUT_BASE}/failure_detail.rawproto.
العلامات: affects_outputs، loses_incremental_state
--[no]home_rc التلقائي: "true;true"
هل تريد البحث عن ملف بازار المنزل أم لا على $HOME/.bazelrc
العلامات: changes_inputs
--[no]idle_server_tasks التلقائي: "true;true"
تشغيل System.gc() عندما يكون الخادم غير نشِط لفترة قصيرة
العلامات: loses_incremental_state وhost_machine_resource_optimizations
--[no]ignore_all_rc_files التلقائي: "false;quot;
إيقاف جميع ملفات RC، بغض النظر عن قيم العلامات الأخرى التي تعمل على تعديل الملف الشخصي، حتى إذا كانت هذه العلامات متوفرة لاحقًا في قائمة خيارات بدء التشغيل
العلامات: changes_inputs
--io_nice_level={-1,0,1,2,3,4,5,6,7} التلقائي: "-1"
على نظام التشغيل Linux فقط، يمكنك تحديد المستوى من 0 إلى 7 لجدولة أفضل جهود الإدراج على نحو أفضل باستخدام استدعاء النظام sys_ioprio_set. 0 هي أعلى أولوية، و7 هي أدنى قيمة. قد يلتزم موعد الجدولة المتوقّع بالأولوية حتى 4. وفي حال ضبطها على قيمة سالبة، لن يُجري Bazel استدعاء النظام.
العلامات: host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer> التلقائي: "120"
الحد الأقصى للوقت الذي ينتظره العميل للاتصال بالخادم
العلامات: bazel_internal_configuration
--macos_qos_class=<a string> التلقائي: "default;default"
يضبط هذا الإعداد فئة خدمة جودة الخدمة لخادم Bazel عند التشغيل على نظام التشغيل macOS. لا تؤثّر هذه العلامة في جميع الأنظمة الأساسية الأخرى، ولكن يتم توفيرها لضمان مشاركة ملفات RC بينها بدون تغييرات. القيم المحتملة هي: تفاعل المستخدم، بدأه المستخدم، الإعداد التلقائي، الأداة المساعدة، الخلفية.
العلامات: host_machine_resource_optimizations
--max_idle_secs=<integer> التلقائي: "10800"
عدد الثواني التي ينتظر فيها خادم الإصدار من وضع الخمول قبل إيقاف التشغيل. يعني الصفر أنه لن يتم إيقاف الخادم مطلقًا. يتم ذلك فقط عند بدء تشغيل الخادم، ولن يؤدي تغيير هذا الخيار إلى إعادة تشغيل الخادم.
العلامات: eagerness_to_exit، loses_incremental_state
--output_base=<path> التلقائي: عرض الوصف
في حال ضبط هذه السياسة، تحدِّد موقع الإخراج الذي ستتم كتابة جميع النتائج إليه. وسيكون الموقع الجغرافي هو ${OUTPUT_ROOT}/_ Blaze_${USER}/${MD5_OF_WORKSPACE_ROOT}. ملاحظة: إذا اخترت خيارًا مختلفًا من استدعاء Bazel التالي لهذه القيمة، من المحتمل أن تبدأ خادم Bazel جديدًا. يبدأ Bazel خادمًا واحدًا بالضبط لكل قاعدة مخرجات محددة. تتوفّر عادةً قاعدة مخرجات واحدة لكل مساحة عمل، ولكن مع هذا الخيار، قد يكون لديك قواعد مخرجات متعددة لكل مساحة عمل، وبالتالي تنفيذ إصدارات متعددة للعميل نفسه على الجهاز نفسه بشكلٍ متزامن. اطّلِع على البازيلية 'مساعدة على إيقاف التشغيل' حول كيفية إيقاف خادم Bazel.
العلامات: affects_outputs، loses_incremental_state
--output_user_root=<path> التلقائي: عرض الوصف
الدليل الخاص بالمستخدم الذي تتم كتابة جميع مخرجات الإصدار فيه، ووفقًا للإعدادات التلقائية، تكون هذه إحدى وظائف $USER، ولكن من خلال تحديد ثابت، يمكن مشاركة مخرجات الإصدار بين المستخدمين المتعاونين.
العلامات: affects_outputs، loses_incremental_state
--[no]preemptible التلقائي: "false;quot;
في حال كان هذا صحيحًا، يمكن إيقاف الأمر في حال بدء أمر آخر.
العلامات: eagerness_to_exit
--server_jvm_out=<path> التلقائي: عرض الوصف
الموقع لكتابة مخرجات JVM&#39s الخاصة بالخادم. في حال ترك هذه السياسة بدون ضبط، يتم تلقائيًا ضبط الإعدادات على موقع جغرافي في الناتج_base.
العلامات: affects_outputs، loses_incremental_state
--[no]shutdown_on_low_sys_mem التلقائي: "false;quot;
في حال ضبط max_idle_secs وكان خادم الإصدار غير نشط لفترة من الوقت، عليك إيقاف الخادم عندما يكون النظام منخفضًا على ذاكرة الوصول العشوائي المجانية. نظام التشغيل Linux فقط.
العلامات: eagerness_to_exit، loses_incremental_state
--[no]system_rc التلقائي: "true;true"
ما إذا كنت تريد البحث عن بازار على مستوى النظام أم لا.
العلامات: changes_inputs
--[no]unlimit_coredumps التلقائي: "false;quot;
يتم رفع حد التفريغ الأساسي إلى الحد الصلب لجعل عمليات التفريغ الأساسية للخادم (بما في ذلك JVM) والعميل ممكنًا في ظل الظروف الشائعة. اكتسِب هذا العلَم في بازارك مرة واحدة ووانسيه لتخلّصك من التفريغ الأساسي عند حدوث حالة تؤدي إليه.
العلامات: bazel_internal_configuration
--[no]watchfs التلقائي: "false;quot;
إذا كان الأمر كذلك، يحاول Bazel استخدام خدمة مشاهدة الملفات على نظام التشغيل للتغييرات المحلية بدلاً من فحص كل ملف بحثًا عن تغيير.
العلامات: deprecated
في حال استخدام هذه السياسة، سيتم إنشاء روابط رمزية حقيقية على نظام التشغيل Windows بدلاً من نسخ الملفات. يتطلّب تفعيل وضع مطوّر برامج Windows والإصدار 1703 من Windows 10 أو إصدار أحدث.
العلامات: bazel_internal_configuration
--[no]workspace_rc التلقائي: "true;true"
هل تريد البحث عن ملف bazelrc في $workspace/.bazelrc
العلامات: changes_inputs
خيارات متنوعة، غير مصنّفة بطريقة أخرى:
تراكم --host_jvm_args=<jvm_arg> استخدامات متعددة
علامات لتمريرها إلى جهاز JVM ينفّذ بلايز
--host_jvm_debug
خيار ملائم لإضافة بعض علامات بدء تشغيل JVM الإضافية، التي تتسبب في انتظار JVM عند بدء التشغيل حتى تتصل من برنامج تصحيح أخطاء متوافق مع JDWP (مثل Eclipse) إلى المنفذ 5005.
التوسيع إلى:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
--host_jvm_profile=<profiler_name> التلقائي: ""
خيار ملائم لإضافة بعض علامات بدء تشغيل JVM الخاصة بالمستخدم أو برنامج تصحيح الأخطاء. يتضمّن Bazel قائمة بالقيم المعروفة التي تربطها بعلامات بدء تشغيل JVM غير المرمّزة، مع إمكانية البحث عن بعض المسارات الثابتة الترميز لملفات معيّنة.
--server_javabase=<jvm path> التلقائي: ""
مسار استخدام آلة جافا الافتراضية (JVM) في تنفيذ Bazel نفسها

الخيارات المتاحة في جميع الطلبات

الخيارات التي تتحكّم في تنفيذ الإصدار:
--experimental_oom_more_eagerly_threshold=<an integer> التلقائي: "100"
في حال تم ضبط هذه العلامة على قيمة أقل من 100، سيدخل البازل إلى OOM في حال استمرار مخالفة أكثر من هذه النسبة المئوية للمكوّن الإضافي (الكائن القديم) في ذاكرة التخزين المؤقت بعد اكتمال عمليتَي GC.
العلامات: host_machine_resource_optimizations
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range> التلقائي: "1048576"
الحد الأقصى لحجم ملفات stdout / stderr التي ستتم طباعتها في وحدة التحكم. -1 لا تتضمن أي حدود.
العلامات: execution
الخيارات التي تتيح للمستخدم ضبط النتائج المطلوبة، ما يؤثر في قيمتها بدلاً من تفعيلها:
تراكم --repo_env=<a 'name=value' assignment with an optional value part> استخدامات متعددة
يحدد متغيرات البيئة الإضافية التي ستكون متاحة فقط لقواعد المستودع. يُرجى ملاحظة أن قواعد المستودع ترى البيئة الكاملة على أي حال، ولكن يمكن بهذه الطريقة تمرير معلومات الضبط إلى المستودعات من خلال الخيارات بدون إلغاء الرسم البياني للإجراء.
العلامات: action_command_lines
الخيارات التي تؤثّر في مدى قوة تطبيق Bazel لمدخلات الإصدارات الصالحة (تعريفات القواعد ومجموعات العلامات وغيرها):
--[no]check_bzl_visibility التلقائي: "true;true"
في حال إيقاف هذه السياسة، يتم خفض ترتيب أخطاء bzl-impression في بياناتload() إلى تحذيرات.
العلامات: build_file_semantics
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.
--[no]enable_bzlmod التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، يتم تفعيل نظام إدارة تبعية Bzlmod بالأولوية على WORKSPACE. راجع https://bazel.build/docs/bzlmod لمزيد من المعلومات.
العلامات: loading_and_analysis
--[no]experimental_action_resource_set التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، تقبل ctx.actions.run() وctx.actions.run_shell() معلّمة resource_set للتنفيذ المحلي. وبخلاف ذلك، سيتم تلقائيًا ضبط حجم الذاكرة على 250 ميغابايت ووحدة معالجة البيانات واحدة.
العلامات: execution، build_file_semantics، experimental
--[no]experimental_allow_tags_propagation التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، سيتم نشر العلامات من هدف إلى إجراءات " #39; متطلبات التنفيذ"، وإلا لن يتم نشر العلامات. لمعرفة مزيد من التفاصيل، يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/8830.
العلامات: build_file_semantics، experimental
--[no]experimental_analysis_test_call التلقائي: "true;true"
في حال تم ضبط هذه السياسة على "صحيح"، ستتوفّر المكالمة المدمجة مع أداة test_test.
العلامات: loading_and_analysis، build_file_semantics، experimental
--[no]experimental_bzl_visibility التلقائي: "true;true"
في حال تفعيل هذه السياسة، يمكنك إضافة دالة"visible()" التي قد تطلبها ملفات .bzl أثناء التقييم من المستوى الأعلى لضبط إذن الوصول إليها من أجل تحميل بيانات().
العلامات: loading_and_analysis، experimental
--[no]experimental_cc_shared_library التلقائي: "false;quot;
في حال ضبطها على "صحيح"، ستتوفّر سمات القواعد وطرق واجهة برمجة التطبيقات Starlark المطلوبة للقاعدة cc_shared_library
العلامات: build_file_semantics وloading_and_analysis وexperimental
--[no]experimental_disable_external_package التلقائي: "false;quot;
في حال ضبطها على"صحيح"، لن تعود الحزمة //الخارجة التي تم إنشاؤها تلقائيًا متاحة. سيظل بإمكان Bazel تحليل الملف 'external/BUILD'، ولكن سيصل الأمر إلى وحدات الغلوب التي تصل إلى الخارج/ من الحزمة بدون اسم.
العلامات: loading_and_analysis، loses_incremental_state، experimental
--[no]experimental_enable_android_migration_apis التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، يتم تفعيل واجهات برمجة التطبيقات المطلوبة لإتاحة نقل بيانات Android Starlark.
العلامات: build_file_semantics
--[no]experimental_get_fixed_configured_action_env التلقائي: "false;quot;
في حال تفعيل هذه السياسة، ستعرض action.env أيضًا متغيّرات البيئة الثابتة المحدّدة من خلال ضبط الميزات.
العلامات: loading_and_analysis، experimental
--[no]experimental_google_legacy_api التلقائي: "false;quot;
في حال ضبطها على"صحيح"، يتم عرض عدد من الأجزاء التجريبية لواجهة برمجة تطبيقات Starlark المرتبطة برمز Google القديم.
العلامات: loading_and_analysis، experimental
--[no]experimental_lazy_template_expansion التلقائي: "true;true"
في حال ضبطها على "true"، تقبل ctx.actions.expand_template() معلّمة TemplateDict للتقييم المؤجّل لقيم الاستبدال.
العلامات: execution، build_file_semantics، experimental
--[no]experimental_platforms_api التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، يتم تفعيل عدد من واجهات برمجة التطبيقات Starlark المرتبطة بالمنصّات والتي يمكن الاستفادة منها في تصحيح الأخطاء.
العلامات: loading_and_analysis، experimental
--[no]experimental_repo_remote_exec التلقائي: "false;quot;
في حال تم ضبط هذه السياسة على"صحيح"، يكتسب مستودع_قاعدة البيانات بعض إمكانات التنفيذ عن بُعد.
العلامات: build_file_semantics، loading_and_analysis، experimental
--[no]experimental_sibling_repository_layout التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، تتمّ إضافة مستودعات غير رئيسية كروابط إلى المستودع الرئيسي في جذر التنفيذ. وهذا يعني أن جميع المستودعات عبارة عن عناصر فرعية مباشرة للدليل $إخراج_base/execution_root. ينتج عن هذا التأثير الجانبي لإخلاء $إخراج_base/execution_root/__primary__/external للدليل الحقيقي ومن المستوى الأعلى #39;external'.
العلامات: action_command_lines، bazel_internal_configuration، loading_and_analysis، loses_incremental_state، experimental
--[no]incompatible_always_check_depset_elements التلقائي: "true;true"
يمكنك التحقق من صحة العناصر التي تمت إضافتها إلى بروتوكولات المشاركة في جميع شركات الإنشاء. يجب أن تكون العناصر غير قابلة للتغيير، ولكن نسيت دالة الإنشاء Depset(direct=...) التحقق. يُرجى استخدام الخرافات بدلاً من القوائم في عناصر محدّدة. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/10313 للحصول على التفاصيل.
العلامات: build_file_semantics، incompatible_change
عندما يكون ذلك صحيحًا، لم يعُد تطبيق Bazel يعرض قائمة من link_context.library_to_link، ولكنه يعرض قائمة منفصلة بدلاً من ذلك.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_disable_starlark_host_transitions التلقائي: "false;quot;
في حال ضبطها على "صحيح"، لا يمكن ضبط سمات القاعدة: 'cfg = "host"'. يجب ضبط القواعد 'cfg = "exec"' بدلاً من ذلك.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_disable_target_provider_fields التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، يمكنك إيقاف إمكانية الوصول إلى مقدّمي الخدمات في العناصر 'target' العناصر عبر بنية الحقل. يمكنك استخدام بنية مفتاح المفتاح بدلاً من ذلك. على سبيل المثال، بدلاً من استخدام `ctx.attr.dep.my_info` للوصول إلى `my_info` من داخل دالة تنفيذ قاعدة، يمكنك استخدام `ctx.attr.dep[MyInfo]`. ويمكنك الاطّلاع على https://github.com/bazelbuild/bazel/issues/9014 لمعرفة التفاصيل.
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_disallow_empty_glob التلقائي: "false;quot;
في حال ضبطها على "صحيح"، تكون القيمة التلقائية للوسيطة "allow_empty" في glob() هي "خطأ".
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_disallow_legacy_javainfo التلقائي: "true;true"
تم إيقاف العمل به. No-op.
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_disallow_struct_provider_syntax التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، قد لا تعرِض دوال تنفيذ القاعدة بنية. وبدلاً من ذلك، يجب عرض قائمة بالمثيلات الخاصة بمقدّم الخدمة.
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_existing_rules_immutable_view التلقائي: "true;true"
في حال تم ضبط هذه السياسة على"صحيح"، تعرض دالة local.existing_rule وoriginal.existing_rule كائنات عرض غير قابلة للتغيير، خفيفة الوزن بدلاً من القوام القابلة للتغيير.
العلامات: build_file_semantics، loading_and_analysis، incompatible_change
--[no]incompatible_fix_package_group_reporoot_syntax التلقائي: "true;true"
في السمة package_group' ، يتم تغيير معنى القيمة "//..." للإشارة إلى جميع الحِزم في المستودع الحالي بدلاً من جميع الحِزم في أي مستودع. يمكنك استخدام القيمة الخاصة "public" بدلاً من "//..." للحصول على السلوك القديم. تتطلّب هذه العلامة تفعيل الميزة (-incompatible_package_group_has_public_syntax).
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_java_common_parameters التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، ستتم إزالة المعلّمتَين المخرجتَين _jar وhost_javabase في package_sources وhost_javabase معًا في المجمل.
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_new_actions_api التلقائي: "true;true"
في حال تم ضبط هذه السياسة على "صحيح"، تصبح واجهة برمجة التطبيقات لإنشاء الإجراءات متاحة فقط في "ctx.actions`، وليس في "ctx`".
العلامات: build_file_semantics وincompatible_change
--[no]incompatible_no_attr_license التلقائي: "true;true"
في حال ضبطها على "صحيح"، يتم إيقاف الدالة "attr.permissions`".
العلامات: build_file_semantics وincompatible_change
--[no]incompatible_no_implicit_file_export التلقائي: "false;quot;
في حال ضبط السياسة، تكون الملفات المصدر (مُستعمَل) خاصة بالحزمة ما لم يتم تصديرها صراحةً. يمكنك الاطّلاع على https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-impression.md
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_no_rule_outputs_param التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، يتم إيقاف المعلّمة `outputs` للدالة `rule()` Starlark.
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_package_group_has_public_syntax التلقائي: "true;true"
في سمة package_group'، يجب كتابة "الجميع"&&;;quot;private" لحِزم البيانات للإشارة إلى جميع الحِزم أو تلك التي لا تحتوي على حِزم على التوالي.
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_require_linker_input_cc_api التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، ستتطلب القاعدة create_linking_contexts linker_inputs بدلاً من libraries_to_link. سيتم أيضًا إيقاف العناصر القديمة من link_contextين ولن يتوفّر سوى link_inputs.
العلامات: build_file_semantics، loading_and_analysis، incompatible_change
--[no]incompatible_run_shell_command_string التلقائي: "true;true"
في حال ضبطها على "صحيح"، لن تقبل معلّمة الأمر action.run_shell سوى السلسلة
العلامات: build_file_semantics وincompatible_change
--[no]incompatible_stop_exporting_language_modules التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، لن تتوفّر وحدات معيّنة للغات معيّنة (مثل "cc_common`") في ملفات المستخدمين بتنسيق .bzl، ويمكن طلبها من مستودعات القواعد الخاصة بها فقط.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_struct_has_no_methods التلقائي: "false;quot;
لإيقاف طريقتَي الإنشاء to_json وto_proto، ما يؤدي إلى تلوّث مساحة اسم الحقل وبدلاً من ذلك، استخدِم json.encode أو json.encode_indent لبروتوكول JSON أو proto.encode_text للنص النصي.
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_top_level_aspects_require_providers التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، سيُحترم جانب المستوى الأعلى مقدّمي الخدمة المطلوبين، ولن يتم التشغيل إلا على الأهداف ذات المستوى الأعلى التي تتوافق قواعدها المُعلَنة مع مقدّمي الخدمات المُعلَن عنها عن طريقهم.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_unambiguous_label_stringification التلقائي: "true;true"
عندما يكون ذلك صحيحًا، سيعمل Bazel على ترميز التصنيف @//foo:bar إلى @//foo:bar، بدلاً من //foo:bar. ولا يؤثر هذا إلا في سلوك str() وعامل التشغيل % وهكذا. وبالتالي، لا يتغيّر سلوك repr(). يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/15916 لمزيد من المعلومات.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_use_cc_configure_from_rules_cc التلقائي: "false;quot;
عندما يكون ذلك صحيحًا، لن يسمح Bazel باستخدام cc_configure من @bazel_tools. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/10134 للحصول على التفاصيل وتعليمات نقل البيانات.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_visibility_private_attributes_at_definition التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، يتم التحقّق من إذن الوصول إلى سمات القاعدة الخاصة في ما يتعلّق بتعريف القاعدة، بدلاً من استخدام القاعدة.
العلامات: build_file_semantics، incompatible_change
--max_computation_steps=<a long integer> التلقائي: "0"
الحد الأقصى لعدد خطوات الحوسبة الجوّالة في Starlark التي يمكن تنفيذها باستخدام ملف BUILD (يعني صفرًا أنه ما مِن حد أقصى).
العلامات: build_file_semantics
--nested_set_depth_limit=<an integer> التلقائي: "3500"
الحد الأقصى لعمق الرسم البياني داخليًا لمجموعة محدّدة (المعروفة أيضًا باسم NestedSet)، وسيتعذّر بعدها إنشاء دالة depset().
العلامات: loading_and_analysis
الخيارات التي تؤدي إلى تفعيل عمليات تحسين وقت الإنشاء:
--[no]incompatible_do_not_split_linking_cmdline التلقائي: "true;true"
عندما يكون ذلك صحيحًا، لم يعد Bazel يعدِّل علامات سطر الأوامر المستخدمة في الربط، ولا يحدّد بشكلٍ انتقائي العلامات التي يتم نقلها إلى ملف المعلّمة وتلك التي لا يتم تغييرها. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7670 للحصول على التفاصيل.
العلامات: loading_and_analysis، incompatible_change
--[no]keep_state_after_build التلقائي: "true;true"
في حال اختيار القيمة "خطأ"، سيتجاهل "بليز" حالة الذاكرة من هذا الإصدار عند انتهاء الإصدار. لن تحقّق الإصدارات اللاحقة أي تزايد في هذا التصميم.
العلامات: loses_incremental_state
--skyframe_high_water_mark_threshold=<an integer> التلقائي: "85"
يمكنك الإبلاغ عن الإعدادات المتقدّمة في محرك Bazel&#39s الداخلي في إطار الإطار. وإذا اكتشف Bazel أنّ نسبة الاستخدام في نسبة العناصر المُجمَّعة التي تم الاحتفاظ بها لا تقل عن هذا الحدّ، سيؤدي ذلك إلى انخفاض حالة "إطار iframe" المؤقت غير الضرورية. قد يتيح لك تعديل هذه البيانات الحد من تأثير وقت الاصطدام الجداري للانتشار من خلال GC، عندما يكون (1) ناتجًا عن الاستهلاك حسب الحالة المركزية (GC)، و(2) أكثر تكلفة من إعادة تركيب الحالة عندما تكون هناك حاجة إليها.
العلامات: host_machine_resource_optimizations
--[no]track_incremental_state التلقائي: "true;true"
في حال الضبط على "خطأ"، لن يحافظ "بليز" على البيانات التي تسمح بإبطال الإصدارات وإعادة التقييم في الإصدارات المتزايدة من أجل توفير الذاكرة في هذا الإصدار. لن تحقّق الإصدارات اللاحقة أي تزايد في هذا التصميم. وستحتاج عادةً إلى تحديد "دفعة" عند ضبط هذه السياسة على "خطأ".
العلامات: loses_incremental_state
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]announce_rc التلقائي: "false;quot;
تحديد ما إذا كان سيتم الإعلان عن الخيارات المتاحة للمستخدمين حاليًا
العلامات: affects_outputs
--[no]attempt_to_print_relative_paths التلقائي: "false;quot;
عند طباعة جزء الموقع الجغرافي من الرسائل، جرِّب استخدام مسار مرتبط بدليل مساحة العمل أو أحد الأدلة المحدّدة في --package_path.
العلامات: terminal_output
--bes_backend=<a string> التلقائي: ""
يحدد هذا الإعداد نقطة نهاية خدمة إنشاء الحدث (BES) في النموذج [SCHEME://]HOST[:PORT]. الإعداد التلقائي هو إيقاف عمليات تحميل ملف BES. المخطَّطات المتوافقة هي grpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة). وإذا لم يتم تقديم مخطط، يفترض Bazel أنّه حصل على نقاط التقييم الإجمالية.
العلامات: affects_outputs
--[no]bes_check_preceding_lifecycle_events التلقائي: "false;quot;
يضبط هذا الحقل الحقل check_preceding_lifecycle_events_present في PublishBuildToolEventStreamRequest الذي يُخبر BES بالتحقق مما إذا كان قد تلقّى سابقًا أحداث InvocationActivityStarted وBuildEnqueued التي تتطابق مع حدث الأداة الحالي.
العلامات: affects_outputs
تراكم --bes_header=<a 'name=value' assignment> استخدامات متعددة
يمكنك تحديد عنوان في نموذج NAME=VALUE الذي سيتم تضمينه في طلبات BES. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
العلامات: affects_outputs
--bes_instance_name=<a string> التلقائي: عرض الوصف
يحدد اسم المثيل الذي يمكن لخدمة BES استخدامه لتحميل بيانات BEP. ويتم إعداد القيمة على "فارغة".
العلامات: affects_outputs
تراكم --bes_keywords=<comma-separated list of options> استخدامات متعددة
يحدد قائمة الكلمات الرئيسية للإشعار المطلوب إضافتها إلى المجموعة التلقائية من الكلمات الرئيسية التي يتم نشرها في BES ("command;name_namedmcalt;command_name> ", "protocol_name=BEP"). الإعداد التلقائي هو بدون ضبط.
العلامات: affects_outputs
--[no]bes_lifecycle_events التلقائي: "true;true"
يحدد هذا الإعداد ما إذا كان سيتم نشر أحداث مراحل نشاط BES. (يتم الضبط تلقائيًا على 'true').
العلامات: affects_outputs
--bes_oom_finish_upload_timeout=<An immutable length of time.> التلقائي: "10m"
يحدد هذا الإعداد المدة التي يجب أن تستغرقها خدمة Bazel حتى يكتمل تحميل بيانات BES/BEP أثناء عملية OOMing. تضمن هذه العلامة الإنهاء عند تلف آلة JC بشدة ولا يمكنها التقدم في أي سلسلة محادثات للمستخدمين.
العلامات: bazel_monitoring
--bes_outerr_buffer_size=<an integer> التلقائي: "10240&quot
يحدد هذا الإعداد الحجم الأقصى لـ stdout أو stderr ليتم تخزينه مؤقتًا في BEP، قبل الإبلاغ عنه كحدث تقدم. لا يتم الإبلاغ عن عمليات الكتابة الفردية في حدث واحد، حتى إذا كانت أكبر من القيمة المحدّدة حتى --bes_outerr_chunk_size.
العلامات: affects_outputs
--bes_outerr_chunk_size=<an integer> التلقائي: "1048576"
يحدد هذا الإعداد الحجم الأقصى لـ stdout أو stderr المُرسَل إلى BEP في رسالة واحدة.
العلامات: affects_outputs
--bes_proxy=<a string> التلقائي: عرض الوصف
الاتصال بخدمة Build Build من خلال خادم وكيل. لا يمكن استخدام هذه العلامة حاليًا إلا لإعداد مقبس نطاق Unix (unix:/path/to/socket).
--bes_results_url=<a string> التلقائي: ""
يحدد عنوان URL الأساسي حيث يمكن للمستخدم عرض المعلومات التي تم بثها إلى خلفية BES. سينتج عن Bazel عنوان URL المرفق بمعرف الاستدعاء في الوحدة الطرفية.
العلامات: terminal_output
--bes_timeout=<An immutable length of time.> التلقائي: "0;"
يحدد هذا الإعداد المدة التي يجب أن تستغرقها خدمة Bazel حتى يكتمل تحميل بيانات BES/BEP بعد اكتمال عملية الإصدار والاختبارات. المهلة الصالحة هي رقم طبيعي تتبعه وحدة: الأيام (د) والساعات (س) والدقائق (م) والثواني (ث) والملي ثانية (ملي ثانية). القيمة التلقائية هي '0&#39؛ ما يعني عدم وجود مهلة.
العلامات: affects_outputs
--build_event_binary_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، اكتب تمثيلاً ثنائيًا مفصولة بفواصل لتمثيل بروتوكول حدث الإصدار في ذلك الملف. يشير هذا الخيار إلى --bes_upload_mode=Way_for_upload_complete.
العلامات: affects_outputs
--[no]build_event_binary_file_path_conversion التلقائي: "true;true"
حوِّل المسارات في تمثيل الملف الثنائي لبروتوكول حدث الإصدار إلى معرّفات الموارد المنتظمة (URI) الصالحة عالميًا كلما أمكن، وإذا تم إيقافه، سيتم دائمًا استخدام مخطط //:uri uri.
العلامات: affects_outputs
--build_event_json_file=<a string> التلقائي: ""
إذا لم يكن فارغًا، اكتب تسلسل JSON لبروتوكول حدث الإصدار إلى ذلك الملف.
العلامات: affects_outputs
--[no]build_event_json_file_path_conversion التلقائي: "true;true"
حوِّل المسارات في تمثيل ملف json لبروتوكول حدث الإصدار إلى معرّفات موارد منتظمة (URI) صالحة عالميًا كلما أمكن، وإذا تم إيقافها، سيتم دائمًا استخدام مخطط //:uri uri.
العلامات: affects_outputs
--build_event_max_named_set_of_file_entries=<an integer> التلقائي: "-1"
الحد الأقصى لعدد الإدخالات في حدث واحد name_set_of_files، ويتم تجاهل القيم الأصغر من 2 ولا يتم إجراء تقسيم الأحداث. وتهدف هذه الخطوة إلى وضع حد أقصى لحجم الحدث في بروتوكول إنشاء الحدث، على الرغم من أنّه لا يتحكّم مباشرةً في حجم الحدث. ويكون إجمالي حجم الحدث دالة لبنية المجموعة، بالإضافة إلى أطوال الملفات ومعرّف الموارد المنتظم (URI)، والتي قد تعتمد بدورها على دالة التجزئة.
العلامات: affects_outputs
--[no]build_event_publish_all_actions التلقائي: "false;quot;
ما إذا كان يجب نشر كل الإجراءات.
العلامات: affects_outputs
--build_event_text_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، اكتب تمثيلاً نصيًا لبروتوكول حدث الإصدار إلى ذلك الملف
العلامات: affects_outputs
--[no]build_event_text_file_path_conversion التلقائي: "true;true"
حوِّل المسارات في تمثيل الملف النصي لبروتوكول حدث الإصدار إلى معرّفات موارد منتظمة (URI) صالحة عالميًا كلما أمكن، وفي حال إيقافها، سيتم دائمًا استخدام مخطط :// file.
--[no]experimental_announce_profile_path التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، أضِف مسار ملف JSON الشخصي إلى السجلّ.
العلامات: affects_outputs، bazel_monitoring
--[no]experimental_bep_target_summary التلقائي: "false;quot;
ما إذا كان سيتم نشر أحداث Targetملخّص
--[no]experimental_build_event_expand_filesets التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، وسِّع "مجموعات الملفات" في الملف BEP عند تقديم ملفات الإخراج.
العلامات: affects_outputs
في حال ضبط هذه السياسة على"صحيح"، يجب حلّ روابط الملفات المُجمَّعة النسبية في ملف BEP عند عرض ملفات الإخراج. يتطلب --experimental_build_event_expand_filesets.
العلامات: affects_outputs
--experimental_build_event_upload_max_retries=<an integer> التلقائي: "4"
الحد الأقصى لعدد المرات التي يجب على Bazel إعادة محاولة تحميل حدث إصدار فيها.
العلامات: bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.> التلقائي: "1;"
أولاً، الحد الأدنى للتأخير في حالات إعادة المحاولة الأسية في حال تعذّر تحميل الملف BEP (الأس: 1.6)
العلامات: bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string> التلقائي: عرض الوصف
يختار كيفية تحميل العناصر المُشار إليها في بروتوكول حدث الإصدار.
العلامات: affects_outputs
تراكم --experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, process_time, remote_queue, remote_setup, fetch, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, local_cpu_usage, system_cpu_usage, local_memory_usage, system_memory_usage, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper or unknown> استخدامات متعددة
يحدد مهام الملف الشخصي الإضافية التي سيتم تضمينها في الملف الشخصي.
العلامات: affects_outputs، bazel_monitoring
--[no]experimental_profile_include_primary_output التلقائي: "false;quot;
تتضمّن السمة الإضافية "out" . في أحداث الإجراءات التي تتضمّن المسار التنفيذي إلى الإخراج الأساسي للإجراء " #39;s".
العلامات: affects_outputs، bazel_monitoring
--[no]experimental_profile_include_target_label التلقائي: "false;quot;
يتضمّن تصنيفًا مستهدفًا في أحداث الإجراء&#39؛ بيانات الملف الشخصي بتنسيق JSON.
العلامات: affects_outputs، bazel_monitoring
--[no]experimental_stream_log_file_uploads التلقائي: "false;quot;
يمكن تحميل ملفات سجل السجلّ مباشرةً إلى وحدة التخزين عن بُعد بدلاً من كتابتها على القرص.
العلامات: affects_outputs
--experimental_workspace_rules_log_file=<a path> التلقائي: عرض الوصف
سجِّل أحداثًا معيّنة في قواعد Workspace في هذا الملف كنماذج مبدئية محدَّدة في WorkspaceEvent.
--[no]generate_json_trace_profile التلقائي: "auto;quot;
في حال تفعيل هذا الإعداد، ينشئ تطبيق Bazel الملف الشخصي ويكتبه بتنسيق JSON في ملف بقاعدة الإخراج. عرض الملف الشخصي عن طريق التحميل إلى chrome://ttracking. يكتب Bazel الملف الشخصي تلقائيًا لجميع أوامر الإصدار وتصميم طلبات البحث.
العلامات: affects_outputs، bazel_monitoring
--[no]heap_dump_on_oom التلقائي: "false;quot;
تحديد ما إذا كان سيتم إخراج تفريغ ذاكرة إلى أن يتم إلقاء OOM (بما في ذلك OOM (بسبب تعذُّر الوصول إلى OOM) بسبب --experimental_oom_more_eagerly_threshold). ستتم كتابة التفريغ إلى <output_base>/<invocation_id>he.pdump.hprof. ويحل هذا الخيار محل -XX:+HeapDumpOnOutOfMemoryError بشكل فعّال، وليس له أي تأثير لأنه تم اكتشاف OOM وإعادة توجيهه إلى Runtime#altt.
العلامات: bazel_monitoring
--[no]legacy_important_outputs التلقائي: "true;true"
استخدِم هذا الخيار لإيقاف إنشاء حقل القيمة_الإخراجة القديمة في الحدث TargetComplete. ويجب توفّر المخرجات المهمة. إلى Bazel إلى ResultStore.
العلامات: affects_outputs
--logging=<0 <= an integer <= 6> التلقائي: "3"
مستوى التسجيل.
العلامات: affects_outputs
--memory_profile=<a path> التلقائي: عرض الوصف
في حال الضبط، اكتب بيانات استخدام الذاكرة في الملف المحدّد في نهاية المرحلة، واستخدِم تصميم ذاكرة تخزين ثابت في السجل الرئيسي في نهاية الإصدار.
العلامات: affects_outputs، bazel_monitoring
--memory_profile_stable_heap_parameters=<two integers, separated by a comma> التلقائي: "1,0"
توليد ذاكرة الملف الشخصي في الذاكرة الثابتة في نهاية الإصدار. يجب أن يكون عددًا صحيحًا مفصولًا بفاصلة. وتكون المعلّمة الأولى هي عدد عناصر التحكّم بالبيانات التي يمكن تنفيذها. المعلّمة الثانية هي عدد الثواني التي يتم الانتظار خلالها بين GC.
العلامات: bazel_monitoring
--profile=<a path> التلقائي: عرض الوصف
في حال ضبط البرنامج، استخدِم الملف الشخصي باسم Bazel واكتب بياناتك في الملف المحدّد. استخدام الملف الشخصي لتحليل البازل لتحليل الملف الشخصي.
العلامات: affects_outputs، bazel_monitoring
--[no]slim_profile التلقائي: "true;true"
يتم تصغير حجم الملف الشخصي بتنسيق JSON من خلال دمج الأحداث إذا أصبح الملف الشخصي كبيرًا جدًا.
العلامات: affects_outputs، bazel_monitoring
--starlark_cpu_profile=<a string> التلقائي: ""
يكتب هذا الملف في الملف المحدد ملف pprof شخصي لاستخدام وحدة المعالجة المركزية (CPU) من خلال جميع سلاسل محادثات Starlark.
العلامات: bazel_monitoring
--tool_tag=<a string> التلقائي: ""
اسم أداة لإسناد هذه الدعوة إلى Bazel.
العلامات: affects_outputs، bazel_monitoring
تراكم --ui_event_filters=<Convert list of comma separated event kind to list of filters> استخدامات متعددة
يحدد الأحداث التي يتم عرضها في واجهة المستخدم. ويمكن إضافة أحداث إلى الأحداث التلقائية أو إزالتها منها باستخدام بادئة +/-، أو إلغاء المجموعة التلقائية بالكامل باستخدام التخصيص المباشر. تتضمن مجموعة أنواع الأحداث المتوافقة INFO وDEBUG وERROR وغيرها.
العلامات: terminal_output
خيارات متنوعة، لا يتم تصنيفها بأي طريقة أخرى:
تراكم --build_metadata=<a 'name=value' assignment> استخدامات متعددة
أزواج مفاتيح قيمة مخصَّصة لتوفيرها في حدث إصدار.
العلامات: terminal_output
--color=<yes, no or auto> التلقائي: "auto;quot;
يمكنك استخدام عناصر تحكّم طرفية لعرض النتائج بشكل ملوّن.
تراكم --config=<a string> استخدامات متعددة
تختار أقسام الضبط الإضافية من ملفات الملف الشخصي هنا، ولكل الخيارات <;command>، وتسحب أيضًا الخيارات من <command>:<config>، إذا كان هذا القسم موجودًا، وإذا لم يكن هذا القسم موجودًا في أي ملف .rc، سيتعذّر إتمامه مع حدوث خطأ. تتوفّر أقسام الضبط ومجموعات العلامات التي تساويها في ملفات إعداد ads/*.lbzerc.
--curses=<yes, no or auto> التلقائي: "auto;quot;
استخدِم عناصر تحكّم المؤشر الطرفية لتقليل مخرجات التمرير.
--[no]enable_platform_specific_config التلقائي: "false;quot;
في حال اختيار القيمة الصحيحة، تختار Bazel أسطر الإعدادات الخاصة بمضيف نظام التشغيل من ملفات Bazelrc. على سبيل المثال، إذا كان نظام التشغيل Host هو نظام التشغيل Linux وكنت تشغِّل إصدار Babel، سيختار Bazel الأسطر التي تبدأ بـ build:linux. معرّفات نظام التشغيل المتوافقة هي linux وmacos وWindows وfreebsd وopenbsd. يعادل تفعيل هذه العلامة استخدام --config=linux على نظام التشغيل Linux و --config=windows على نظام التشغيل Windows وغيرها.
تراكم --experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.> استخدامات متعددة
لضبط"بيانات اعتماد الاعتماد"في استخدامها لاسترداد بيانات الاعتماد للنطاق المقدَّم (النطاق). تحظى بيانات الاعتماد من "مساعدو المساعدة" بالأولوية على بيانات الاعتماد من <code&code>--google_default_credentials</code> أو `--google_credentials` أو &<code>.netrc</code>
--experimental_credential_helper_cache_duration=<An immutable length of time.> التلقائي: "30m"
لضبط المدة التي يتم خلالها تخزين بيانات اعتماد "أدوات مساعدة الاعتماد" مؤقتًا.
--experimental_credential_helper_timeout=<An immutable length of time.> التلقائي: "5;"
لضبط المهلة لمساعد بيانات الاعتماد. وسيتعذّر استدعاء بيانات اعتماد الوصول خلال هذه المهلة.
--[no]experimental_skymeld_ui التلقائي: "false;quot;
يعرض كلاً من مسارَي التحليل والتنفيذ عند تنفيذهما بشكلٍ متزامن.
العلامات: terminal_output
--[no]experimental_windows_watchfs التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، تم تفعيل دعم Windows التجريبي لنظام --watchfs. بخلاف ذلك، لا يعمل --watchfsis على نظام التشغيل Windows. احرص أيضًا على تفعيل -watchf.
--google_auth_scopes=<comma-separated list of options> التلقائي: "https://www.googleapis.com/auth/cloud-platform"
قائمة مفصولة بفواصل لنطاقات المصادقة في Google Cloud
--google_credentials=<a string> التلقائي: عرض الوصف
يحدد الملف للحصول على بيانات اعتماد المصادقة. يمكنك الاطّلاع على https://cloud.google.com/docs/authentication للحصول على التفاصيل.
--[no]google_default_credentials التلقائي: "false;quot;
ما إذا كان المطلوب استخدام بيانات الاعتماد التلقائية في &39;Google للتطبيقات لإجراء المصادقة. يمكنك الاطّلاع على https://cloud.google.com/docs/authentication للحصول على التفاصيل. هذه الميزة غير مفعّلة تلقائيًا.
--grpc_keepalive_time=<An immutable length of time.> التلقائي: عرض الوصف
يمكنك ضبط إشعارات البقاء على قيد الاتصال لاتصالات gRPC الصادرة. إذا تم ضبط الإعداد، يُرسِل Bazel إشعارات بعد هذه الفترة من عدم توفّر عمليات قراءة على الاتصال، إلا إذا كان هناك طلب gRPC واحد على الأقل في انتظار المراجعة. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. يتم إيقاف إشعارات البقاء على الوضع تلقائيًا. يجب التنسيق مع مالك الخدمة قبل تفعيل هذا الإعداد. على سبيل المثال، لضبط قيمة 30 ثانية على هذه العلامة، يجب إجراؤها على النحو التالي --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.> التلقائي: "20s"
يضبط هذا الإعداد مهلة الاحتفاظ بالبيانات لاتصالات gRPC الصادرة. في حال تفعيل إشعارات البقاء على الاتصال مع --grpc_keepalive_time، ستنتهي مهلة Bazel للاتصال إذا لم تتلقَ رد فحص الاتصال بعد هذا الوقت الكبير. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. في حال إيقاف إشعارات التحقّق من الاتصال، يتم تجاهل هذا الإعداد.
في حال ضبط هذه السياسة على "صحيح"، لن تسمح السياسة "ctx.actions.symlink`" بإعادة ربط الملف داخل دليل.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_remove_rule_name_parameter التلقائي: "true;true"
في حال الضبط على "صحيح"، لا يمكن استدعاء "القاعدة"&#39 باستخدام المعلّمة "name".
العلامات: loading_and_analysis، incompatible_change
--[no]progress_in_terminal_title التلقائي: "false;quot;
يمكنك عرض مستوى تقدُّم الأمر في عنوان الوحدة الطرفية. يفيدك الاطّلاع على أداء Bazel عند فتح علامات تبويب متعدّدة محطات.
--[no]show_progress التلقائي: "true;true"
يمكنك عرض رسائل مستوى التقدُّم أثناء عملية الإصدار.
--show_progress_rate_limit=<a double> التلقائي: "0.2"
الحد الأدنى لعدد الثواني بين رسائل التقدم في الإخراج.
--[no]show_timestamps التلقائي: "false;quot;
تضمين الطوابع الزمنية في الرسائل
--tls_certificate=<a string> التلقائي: عرض الوصف
حدِّد مسارًا لشهادة بروتوكول أمان طبقة النقل (TLS) موثوقة لتوقيع شهادات الخادم.
--tls_client_certificate=<a string> التلقائي: عرض الوصف
حدِّد شهادة عميل طبقة النقل الآمنة التي تريد استخدامها، وعليك أيضًا تقديم مفتاح عميل لتفعيل مصادقة العميل.
--tls_client_key=<a string> التلقائي: عرض الوصف
حدِّد مفتاح عميل طبقة النقل الآمنة الذي سيتم استخدامه، وعليك أيضًا تقديم شهادة عميل لتفعيل مصادقة العميل.
--ui_actions_shown=<an integer> التلقائي: "8;quot;
عدد الإجراءات المتزامنة المعروضة في شريط التقدّم التفصيلي، ويتم عرض كل إجراء في سطر منفصل. يعرض شريط التقدم دائمًا واحدًا على الأقل، ويتم ربط جميع الأرقام الأقل من 1 بـ 1.
العلامات: terminal_output
--[no]watchfs التلقائي: "false;quot;
على نظامَي التشغيل Linux/macOS: إذا كان هذا صحيحًا، يحاول Bazel استخدام خدمة مشاهدة ملفات نظام التشغيل للتغييرات المحلية، بدلاً من فحص كل ملف بحثًا عن تغيير. على نظام التشغيل Windows: هذه العلامة ليست تشغيلًا حاليًا ولكن يمكن تفعيلها مع --experimental_windows_watchfs. على أي نظام تشغيل: لا يتم تعريف السلوك إذا كانت مساحة العمل على نظام ملفات شبكة، ويتم تعديل الملفات على جهاز بعيد.

خيارات تحليل الملف الشخصي

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على "صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تؤثّر في مدى تطبيق Bazel لمدخلات صالحة لإنشاء الإصدارات (تعريفات القواعد ومجموعات العلامات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة"bazel_dep"المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--dump=<text or raw> [-d] التلقائي: الاطّلاع على الوصف
يتم تفريغ بيانات الملف الشخصي الكاملة إما بتنسيق يمكن للمستخدمين قراءته أو بتنسيق #39;text' أو بتنسيق متوافق مع النص البرمجي 'raw'.
العلامات: affects_outputs
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.

خيارات طلب البحث

يكتسب جميع الخيارات من إصدار.

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تؤثّر في مدى تطبيق Bazel لمدخلات صالحة لإنشاء الإصدارات (تعريفات القواعد ومجموعات العلامات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات ذات الصلة بمخرجات طلب البحث والدلالية:
--aspect_deps=<off, conservative or precise> التلقائي: "conserveative"
كيفية حل تبعيات العرض عندما يكون تنسيق الناتج واحدًا من {xml,proto,record}. 'off' تعني أنه لم يتم التعامل مع أي تبعيات للجانب، 'conserveative' (الإعداد التلقائي) تعني أن جميع تبعيات الجانب المُعلَن تمت إضافتها بغض النظر عما إذا تم منحها فئة قاعدة للاعتماديات المباشرة أو "#39;precise'" تعني أنه تتم إضافة هذه الجوانب التي من المحتمل أن تكون نشطة وفقًا لفئة القاعدة من التبعية المباشرة. لاحظ أن الوضع الدقيق يتطلب تحميل حِزم أخرى لتقييم هدف واحد، ما يجعله أبطأ من الأوضاع الأخرى. يُرجى العِلم أيضًا أنّ الوضع الدقيق ليس دقيقًا بالكامل، بل يتم اتّخاذ قرار بشأن احتساب جانب في مرحلة التحليل، وهو ما لا يتم تشغيله أثناء إعداد " #39;bazel query'".
العلامات: build_file_semantics
--[no]deduplicate_depsets التلقائي: "true;true"
يمكنك إزالة تكرار العناصر غير الخالية من أوراق البيانات لملف dep_set_of_files في الناتج النهائي على proto/textproto/json. ولا يؤدي ذلك إلى إزالة تكرار المجموعات الفرعية التي لا تشارك أحد الوالدين الفوري. لا يؤثّر ذلك في القائمة النهائية النهائية لعناصر إدخال الإجراءات.
العلامات: terminal_output
--[no]graph:factored التلقائي: "true;true"
إذا تم ضبط هذه السياسة على "صحيح"، سيتم دمج رسم بياني منشِئ &'عامل>&#39؛ أي أنه سيتم دمج العُقد المتماثلة طوبولوجيا معًا وربط تصنيفاتها. ينطبق هذا الخيار على --output=graph فقط.
العلامات: terminal_output
--graph:node_limit=<an integer> التلقائي: "512"
الحد الأقصى لطول سلسلة التصنيف لعقدة رسم بياني في الإخراج. سيتم اقتطاع التصنيفات الأطول، وتعني القيمة -1 عدم اقتطاعها. ينطبق هذا الخيار على --output=graph فقط.
العلامات: terminal_output
--[no]implicit_deps التلقائي: "true;true"
في حال تفعيل هذه الميزة، سيتم تضمين العناصر الضمنية في الرسم البياني للاعتمادية الذي يعمل عليه طلب البحث. الاعتمادية الضمنية هي تلك التي لم يتم تحديدها صراحةً في ملف BUILD، ولكن تمت إضافتها بواسطة البازل. بالنسبة إلى طلب البحث، يتحكم هذا الخيار في فلترة سلاسل الأدوات التي تم حلها.
العلامات: build_file_semantics
--[no]include_artifacts التلقائي: "true;true"
تتضمّن أسماء مدخلات الإجراءات ومخرجاتها في النتيجة (من المحتمل أن تكون كبيرة الحجم)
العلامات: terminal_output
--[no]include_aspects التلقائي: "true;true"
aquery, cquery: ما إذا كان مطلوبًا تضمين الإجراءات التي يتم إنشاؤها من خلال العرض الجانبي في الإخراج. طلب البحث: no-op (يتم تتبّع الجوانب دائمًا).
العلامات: terminal_output
--[no]include_commandline التلقائي: "true;true"
تتضمّن محتوى سطور أوامر الإجراءات في الناتج (من المحتمل أن يكون كبيرًا).
العلامات: terminal_output
--[no]include_file_write_contents التلقائي: "false;quot;
عليك تضمين محتوى الملف لإجراءَي Filewrite وSourceSymlinkManifest (من المحتمل أن يكونا كبيرين).
العلامات: terminal_output
--[no]include_param_files التلقائي: "false;quot;
أدرِج محتوى ملفات المعلّمات المستخدَمة في الأمر (يُحتمل أن يكون كبيرًا). ملاحظة: سيؤدي تفعيل هذه العلامة تلقائيًا إلى تفعيل العلامة "-include_commandline".
العلامات: terminal_output
--[no]incompatible_display_source_file_location التلقائي: "true;true"
"صحيح"يعرض تلقائيًا الهدف من الملف المصدر. إذا كان هذا صحيحًا، يتم عرض موقع السطر 1 من الملفات المصدر في مخرجات الموقع. لا تتوفّر هذه العلامة إلا لأغراض نقل البيانات.
العلامات: terminal_output، incompatible_change
--[no]incompatible_package_group_includes_double_slash التلقائي: "true;true"
في حال تفعيل هذا الإعداد، عند حذف السمة package_group's "الحزم"، لن يتم حذف السمة "//" البادئة.
العلامات: terminal_output، incompatible_change
--[no]infer_universe_scope التلقائي: "false;quot;
في حال ترك السياسة بدون ضبط و --universe_scope بدون ضبط، سيتم استنتاج قيمة --universe_scope في شكل قائمة بالأنماط المستهدَفة الفريدة في تعبير طلب البحث. تجدُر الإشارة إلى أن قيمة --universe_scope التي تم استنتاجها لتعبير طلب بحث تستخدم الدوال على مستوى الكون (مثل `allrdeps`) قد لا تكون ما تريده، لذا يجب استخدام هذا الخيار فقط إذا كنت تعرف ما تفعله. يمكنك الاطّلاع على https://bazel.build/reference/query#sky-query لمعرفة التفاصيل والأمثلة. في حال ضبط --universe_scope، سيتم تجاهل قيمة هذا الخيار's. ملاحظة: ينطبق هذا الخيار فقط على "طلب البحث" (أي ليس "cquery").
العلامات: loading_and_analysis
--[no]line_terminator_null التلقائي: "false;quot;
ما إذا كان سيتم إنهاء كل تنسيق باستخدام \0 بدلاً من السطر الجديد.
العلامات: terminal_output
--[no]nodep_deps التلقائي: "true;true"
في حال تفعيل هذه السياسة، سيتم تضمين سمات من "nodep"، في الرسم البياني الخاص بالاعتمادية الذي يعمل عليه طلب البحث. ومن الأمثلة الشائعة للسمة "nodep" ";;;;;;; كيف إنّ "> شغِّل مخرجات "معلومات إصدار اللغة" وتحليلها للحصول على معلومات عن جميع السمات ""nodep" في لغة الإصدار.
العلامات: build_file_semantics
--output=<a string> التلقائي: "text;text"
التنسيق الذي يجب طباعة نتائج طلب البحث به. القيم المسموح بها لطلب البحث هي: text وtextproto وproto وjsonproto.
العلامات: terminal_output
--[no]proto:default_values التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، يتم تضمين السمات التي لم يتم تحديد قيمتها صراحةً في ملف BUILD، وإلا سيتم حذفها. ينطبق هذا الخيار على --output=proto
العلامات: terminal_output
--[no]proto:definition_stack التلقائي: "false;quot;
تعبئة حقل pro_stack Proto الذي يسجّل كل مثيل القاعدة لحزمة استدعاء Starlark في الوقت الذي يتم فيه تحديد فئة القاعدة.
العلامات: terminal_output
--[no]proto:flatten_selects التلقائي: "true;true"
في حال تفعيل هذا الإعداد، يتم استنساخ السمات القابلة للضبط التي تم إنشاؤها من خلال Select(). بالنسبة إلى أنواع القوائم، يمثّل التمثيل مسطّحًا قائمة تتضمّن كل قيمة للخريطة المحدّدة مرة واحدة فقط. يتم تحويل أنواع الكميات إلى عناصر فارغة.
العلامات: build_file_semantics
--[no]proto:include_synthetic_attribute_hash التلقائي: "false;quot;
يمكنك حساب السمة $internal_attr_hash تعبئتها أو لا.
العلامات: terminal_output
--[no]proto:instantiation_stack التلقائي: "false;quot;
تعبئة حزمة استدعاء مثيل كل قاعدة. يُرجى العلم أنّ ذلك يتطلّب توفّر الحزمة
العلامات: terminal_output
--[no]proto:locations التلقائي: "true;true"
تحديد ما إذا كان سيتم إخراج معلومات الموقع الجغرافي في وضع Proto تمامًا.
العلامات: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> التلقائي: "all"
قائمة سمات مفصولة بفواصل لتضمينها. ويتم إعداد كل السمات تلقائيًا. اضبط على سلسلة فارغة لإخراج أي سمة. ينطبق هذا الخيار على --output=proto.
العلامات: terminal_output
--[no]proto:rule_inputs_and_outputs التلقائي: "true;true"
تحديد ما إذا كنت تريد تعبئة حقلي base_input وrule_output
العلامات: terminal_output
--[no]relative_locations التلقائي: "false;quot;
إذا كان هذا صحيحًا، سيكون موقع ملفات BUILD في xml ومخرجات Proto نسبيًا. وفقًا للإعدادات التلقائية، تكون بيانات الموقع الجغرافي مسارًا مطلقًا ولن تكون متسقة على جميع الأجهزة. ويمكنك ضبط هذا الخيار على "صحيح" للحصول على نتيجة متسقة على جميع الأجهزة.
العلامات: terminal_output
--[no]skyframe_state التلقائي: "false;quot;
بدون إجراء تحليل إضافي، يمكنك تفريغ الرسم البياني الحالي للإجراء من Skyframe. ملاحظة: تحديد هدف باستخدام -skyframe_state غير متاح حاليًا. لا تتوفر هذه العلامة إلا مع -output=proto أو --output=textproto.
العلامات: terminal_output
--[no]tool_deps التلقائي: "true;true"
طلب بحث: في حال إيقاف هذه الميزة، لن يتم تضمين الأهداف المتعلّقة بالاعتمادات على 'host configuration' أو 'execution'; المستهدَفة في الرسم البياني للاعتمادية الذي يعمل عليه طلب البحث. A 'host configuration';الارتباطية: مثل تلك الموجودة في أي من 'proto_library' القاعدة إلى مجمّع البروتوكول، يوجّه عادةً إلى أداة تم تنفيذها أثناء الإصدار بدلاً من جزء من نفس البرنامج #&39;target' طلب البحث: في حال الإيقاف، يتم استبعاد جميع الأهداف التي تم ضبطها والتي من خلال نقل مضيف أو تنفيذ من الاستهداف من المستوى الأعلى الذي اكتشف هذا الاستهداف الذي تم ضبطه. وهذا يعني أنّه إذا كان الاستهداف ذو المستوى الأعلى في إعدادات الاستهداف، لن يتم عرض سوى الأهداف التي تم ضبطها في الإعدادات المستهدفة. إذا كان هدف المستوى الأعلى في ضبط المضيف، لن يتم عرض سوى الاستهدافات التي تم ضبطها للمضيف. ولن يستبعد هذا الخيار سلاسل الأدوات التي تم حلّها.
العلامات: build_file_semantics
--universe_scope=<comma-separated list of options> التلقائي: ""
مجموعة من الأنماط المستهدفة مفصولة بفواصل (مضَافة وم طرحة). يمكن أن يتم تنفيذ طلب البحث في الكون المحدد عن طريق الإغلاق الانتقالي للأهداف المحدّدة. يُستخدَم هذا الخيار لطلبات البحث وcquery. بالنسبة إلى طلب البحث، إنّ الإدخال في هذا الخيار هو الأهداف التي تم إنشاء جميع الإجابات من خلالها، وبالتالي قد يؤثر هذا الخيار في الإعدادات وعمليات النقل. إذا لم يتم تحديد هذا الخيار، يتم افتراض أنّ أهداف المستوى الأعلى هي الأهداف التي تم تحليلها من تعبير طلب البحث. ملاحظة: بالنسبة إلى طلب البحث، قد يؤدي عدم تحديد هذا الخيار إلى تعطُّل الإصدار إذا كانت الأهداف التي يتم تحليلها من تعبير طلب البحث غير قابلة للإنشاء باستخدام خيارات المستوى الأعلى.
العلامات: loading_and_analysis
الخيارات المتعلقة بإخراج Bzlmod ودلالات الترميز:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة "bazel_dep" المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.
الخيارات التي تتحكّم في تنفيذ الإصدار:
تحديد ما إذا كان سيتم إجراء طلبات مباشرة لنظام الملفات لإنشاء أشجار رمزية
العلامات: loading_and_analysis وexecution وexperimental
--[no]experimental_remotable_source_manifests التلقائي: "false;quot;
تحديد ما إذا كان من الممكن اتخاذ إجراءات في بيان المصدر عن بُعد
العلامات: loading_and_analysis وexecution وexperimental
--[no]experimental_split_coverage_postprocessing التلقائي: "false;quot;
إذا كان الأمر كذلك، ستجري Bazel معالجة ما بعد التغطية لاختبارها في وقت جديد.
العلامات: execution
--[no]experimental_strict_fileset_output التلقائي: "false;quot;
إذا تم تفعيل هذا الخيار، ستتعامل مجموعات الملفات مع جميع عناصر الإخراج كملفات عادية. لن تمرِّر الأدلة أو تكون حساسة للروابط الرمزية.
العلامات: execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...> التلقائي: ""
يمكنك إضافة مفاتيح أو إزالتها من معلومات تنفيذ الإجراءات بناءً على تذكير الإجراء. لا ينطبق إلا على الإجراءات التي تدعم معلومات التنفيذ. وتتيح العديد من الإجراءات الشائعة استخدام معلومات التنفيذ، مثل Genrule وCppCompile وJavac وStarlarkAction وTestRunner. عند تحديد قيم متعددة، يكون هناك أهمية لترتيبها، لأن العديد من التعبيرات العادية قد تنطبق على رسالة التذكّر نفسها. البنية: "regex=[+-]key,regex=[+-]key،..." أمثلة: '.*=+x,.*=-y,.*=+z' يضيف 'x' و 'z' إلى 'y' من معلومات التنفيذ لكل الإجراءات. 'Genrule=+requirementss-x' يضيف 'يتطلب-x' إلى معلومات التنفيذ لجميع إجراءات Genrule. '(?!Genrule).*=-requireds-x' remove 'requirementss-x' من معلومات التنفيذ لكل الإجراءات غير المرتبطة بقاعدة Genrule.
العلامات: execution، affects_outputs، loading_and_analysis
--persistent_android_dex_desugar
تفعيل الإجراءات المستمرة في Android Dex and Deugar باستخدام العمّال.
التوسيع إلى:
--strategy=Desugar=worker
--strategy=DexBuilder=worker

العلامات: host_machine_resource_optimizations, execution
--persistent_android_resource_processor
تفعيل معالج موارد Android باستمرار باستخدام العاملين.
تتوسّع هذه الاستراتيجية إلى:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker.
--persistent_multiplex_android_dex_desugar
تفعيل إجراءات Android Dex متعددة الطلبات والسحب المتعددة باستخدام العمّال.
التوسيع إلى:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers

العلامات: host_machine_resource_optimizations, execution
--persistent_multiplex_android_resource_processor
تفعيل معالج موارد Android المتعدّدة المتعدد باستخدام العاملين.
تتوسّع هذه الاستراتيجية إلى:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers.
--persistent_multiplex_android_tools
تفعيل أدوات Android دائمة ومتعددة الإرسال (التكديس والإزالة ومعالجة الموارد).
التوسيع إلى:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar

العلامات: host_machine_resource_optimizations, execution
الخيارات التي تحدّد سلسلة الأدوات المستخدَمة لتنفيذ الإجراء:
--android_compiler=<a string> التلقائي: عرض الوصف
أداة التجميع المستهدفة في Android.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--android_crosstool_top=<a build target label> التلقائي: "//external:android/crosstool"
الموقع الجغرافي للعارض C++ الذي يتم استخدامه لإصدارات Android
العلامات: affects_outputs، changes_inputs، loading_and_analysis، loses_incremental_state
--android_grte_top=<a label> التلقائي: عرض الوصف
هدف Android grte_top.
العلامات: changes_inputs، loading_and_analysis، loses_incremental_state
--android_manifest_merger=<legacy, android or force_android> التلقائي: "android;quot"
يحدد دمج البيان المراد استخدامه مع قواعد android_binary. الإبلاغ للمساعدة في الانتقال إلى دمج بيان Android من عملية الدمج القديمة.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--android_platforms=<a build target label> التلقائي: ""
يضبط هذا الإعداد الأنظمة الأساسية التي يستخدمها android_binary. وإذا تم تحديد أنظمة أساسية متعددة، يكون البرنامج الثنائي عبارة عن ملفات APK للدهون تحتوي على برامج ثنائية أصلية لكل نظام أساسي مستهدف محدّد.
العلامات: changes_inputs، loading_and_analysis، loses_incremental_state
--android_sdk=<a build target label> التلقائي: "@bazel_tools//tools/android:sdk"
يُحدِّد هذا الإعداد نظام التشغيل Android SDK/النظام الأساسي الذي يُستخدم لإصدار تطبيقات Android.
العلامات: changes_inputs، loading_and_analysis، loses_incremental_state
--apple_compiler=<a string> التلقائي: عرض الوصف
العارض أبل المستهدف. يفيد في اختيار صيغ سلسلة من الأدوات (مثل xcode-الإصدار التجريبي).
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--apple_crosstool_top=<a build target label> التلقائي: "@bazel_tools//tools/cpp:toolchain"
تصنيف الحزمة على جميع الأدوات المراد استخدامها في قواعد Apple وObjc وتبعياتها
العلامات: loses_incremental_state، changes_inputs
--apple_grte_top=<a build target label> التلقائي: عرض الوصف
هدف grte_top من Apple.
العلامات: changes_inputs، loading_and_analysis، loses_incremental_state
--cc_output_directory_tag=<a string> التلقائي: ""
يحدد لاحقة لإضافتها إلى دليل الإعداد.
العلامات: affects_outputs، explicit_in_output_path
--compiler=<a string> التلقائي: عرض الوصف
المحوّل C++ الذي سيتم استخدامه لتجميع الهدف.
العلامات: loading_and_analysis، execution
--coverage_output_generator=<a build target label> التلقائي: "@bazel_tools//tools/test:lcov_merger"
موقع البرنامج الثنائي الذي يتم استخدامه لمعالجة تقارير التغطية الأولية في مرحلة ما بعد المعالجة. يجب أن تكون هذه المجموعة حاليًا مجموعة ملفات تحتوي على ملف ثنائي، وهو برنامج ثنائي. القيمة التلقائية هي '//tools/test:lcov_merger'.
العلامات: changes_inputs، affects_outputs، loading_and_analysis
--coverage_report_generator=<a build target label> التلقائي: "@bazel_tools//tools/test:تغطيةage_report_creator"
موقع البرنامج الثنائي الذي يتم استخدامه لإنشاء تقارير التغطية. يجب أن تكون هذه المجموعة حاليًا مجموعة ملفات تحتوي على ملف ثنائي، وهو برنامج ثنائي. ويتم ضبطه تلقائيًا على '//tools/test:تغطيةage_report_creator'.
العلامات: changes_inputs، affects_outputs، loading_and_analysis
--coverage_support=<a build target label> التلقائي: "@bazel_tools//tools/test:تغطيةage_support"
مكان ملفات الدعم المطلوبة على مدخلات كل إجراء اختبار يجمع تغطية الرمز. ويتم ضبطه تلقائيًا على '//tools/test:تغطيةage_support'.
العلامات: changes_inputs، affects_outputs، loading_and_analysis
--crosstool_top=<a build target label> التلقائي: "@bazel_tools//tools/cpp:toolchain"
تصنيف الحزمة على جميع الأدوات التي يمكن استخدامها لتجميع رمز C++
العلامات: loading_and_analysis، changes_inputs، affects_outputs
--custom_malloc=<a build target label> التلقائي: عرض الوصف
تحدِّد هذه العملية عملية تنفيذ مخصّص لبيانات المستخدم. يلغي هذا الإعداد سمات مالوك في قواعد الإصدار.
العلامات: changes_inputs، affects_outputs
تراكم --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> استخدامات متعددة
قائمة بالتعبيرات العادية المفصولة بفواصل، على أن يكون كل منها مسبوقًا اختياريًا بعلامة - (التعبير السلبي)، مع تخصيص (=) إلى قائمة تتضمّن استهدافات قيم القيود المفصولة بفواصل. إذا كان أحد الاستهدافات لا يتطابق مع أي تعبير سالب وكان تعبير واحد موجب على الأقل، سيتم تنفيذ دقة سلسلة الأدوات كما لو كان قد أعلن عن قيم القيود كقيود على التنفيذ. مثال: سيضيف //demo,-test=@platforms//cpus:x86_64 &'x86_64' إلى أي استهداف ضمن //demo باستثناء تلك التي يحتوي اسمها على 'test'.
العلامات: loading_and_analysis
--[no]experimental_enable_objc_cc_deps التلقائي: "true;true"
يسمح هذا الإعداد لقواعد objc_* بالاعتماد على cc_library ويتسبب في إنشاء أي تبعيات objc باستخدام -cpu مع ضبط "ios;ios_<--ios_cpu>" لأي قيم في --ios_multi_cpu.
العلامات: loading_and_analysis، incompatible_change
--[no]experimental_include_xcode_execution_requirements التلقائي: "false;quot;
في حال ضبط هذه السياسة، أضِف متطلّبات تنفيذ &"أبعاد:{x}:{version}"كل إجراء Xcode. إذا كان إصدار xcode يتضمّن تصنيفًا واصلًا، أضِف أيضًا مطلب التنفيذ &"أبعاد;sx-label:{version_label}".
العلامات: loses_incremental_state، loading_and_analysis، execution
--[no]experimental_prefer_mutual_xcode التلقائي: "true;true"
في حال كان هذا صحيحًا، استخدِم أحدث إصدار من Xcode المتاح محليًا وعن بُعد. وإذا كانت القيمة غير صحيحة، أو في حال عدم توفّر إصدارات مشتركة، استخدِم إصدار Xcode المحلي الذي تم اختياره من خلال xcode-select.
العلامات: loses_incremental_state
تراكم --extra_execution_platforms=<comma-separated list of options> استخدامات متعددة
المنصّات المتوفّرة كمنصّات تنفيذ لتنفيذ الإجراءات. يمكن تحديد المنصّات من خلال الاستهداف الدقيق أو كنمط هدف. وسيتم النظر في هذه الأنظمة الأساسية قبل تلك المُعلَنة في ملف WORKSPACE بواسطة record_execution_platforms().
العلامات: execution
تراكم --extra_toolchains=<comma-separated list of options> استخدامات متعددة
قواعد سلسلة الأدوات التي يجب أخذها في الاعتبار أثناء حلّ سلسلة الأدوات يمكن تحديد سلاسل الأدوات حسب الهدف الدقيق أو كنمط هدف. سيتم مراعاة سلاسل الأدوات هذه قبل تلك المُعلَنة في ملف WORKSPACE بواسطة record_toolchains().
العلامات: affects_outputs وchanges_inputs وloading_and_analysis
--grte_top=<a label> التلقائي: عرض الوصف
تصنيف في مكتبة libc تم تسجيل الدخول إليها يتم اختيار القيمة التلقائية من خلال سلسلة الأدوات المختلفة.
العلامات: action_command_lines، affects_outputs
--host_compiler=<a string> التلقائي: عرض الوصف
محول C++ للاستخدام لتجميع المضيف. ويتم تجاهل هذه السياسة إذا لم يتم ضبط "host_crosstool_top".
العلامات: loading_and_analysis، execution
--host_crosstool_top=<a build target label> التلقائي: عرض الوصف
يتم أيضًا استخدام الخيارَين --crosstool_top و-- المجمِّع تلقائيًا لضبط المضيف. في حال توفير هذه العلامة، يستخدم Bazel المعلَمة التلقائية libc ومُجمِّع الخاصية Crosstool_top المحددة.
العلامات: loading_and_analysis، changes_inputs، affects_outputs
--host_grte_top=<a label> التلقائي: عرض الوصف
في حال تحديد هذا الإعداد، يلغي دليل libc للمستوى الأعلى (--grte_top) لضبط المضيف.
العلامات: action_command_lines، affects_outputs
--host_platform=<a build target label> التلقائي: ""
تصنيف قاعدة النظام الأساسي التي تصف النظام المضيف.
العلامات: affects_outputs، changes_inputs، loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set التلقائي: "true;true"
في حال ضبط السياسة على "صحيح"، لن يسمح Bazel بتحديد extension_if_all_available فيFlag_sets(يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7008 للحصول على تعليمات نقل البيانات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features التلقائي: "true;true"
إذا كان الأمر كذلك، لن يفعِّل Bazel 'host' و 'nonhost' الميزات في سلسلة أدوات c++ (يمكنك الاطّلاع على https://github.com/bazelbuild/bazel/issues/7407 لمزيد من المعلومات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_enable_android_toolchain_resolution التلقائي: "false;quot;
يمكنك استخدام دقة سلسلة الأدوات لاختيار حزمة تطوير البرامج (SDK) لنظام التشغيل Android لقواعد Android (إصدار Starlark والإعلانات المدمجة مع المحتوى)
العلامات: loading_and_analysis وincompatible_change
--[no]incompatible_enable_apple_toolchain_resolution التلقائي: "false;quot;
استخدام دقة سلسلة الأدوات لاختيار حزمة تطوير البرامج (SDK) الخاصة بـ Apple لتطبيق قواعد التفاح (Starlark وNative)
العلامات: loading_and_analysis وincompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، لن يُعيد تطبيق Bazel استخدام سطر الأوامر في إجراء C++ لرابط سطر الأوامر في سطر الأوامر لـ lto (راجِع https://github.com/bazelbuild/bazel/issues/6791 للحصول على مزيد من المعلومات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، سيقدّم Bazel شكوى عند ضبط سمتَي cc_toolchain.cpu وcc_toolchain.المجمِّع (يمكنك الاطّلاع على https://github.com/bazelbuild/bazel/issues/7075 للحصول على تعليمات حول نقل البيانات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_remove_legacy_whole_archive التلقائي: "true;true"
إذا كان الأمر كذلك، لن تربط Bazel تبعيات المكتبة كأرشيف بالكامل تلقائيًا (راجِع https://github.com/bazelbuild/bazel/issues/7362 للحصول على تعليمات نقل البيانات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_require_ctx_in_configure_features التلقائي: "true;true"
إذا كانت إجابتك صحيحة، سيطلب Bazel المعلّمة 'ctx' المعلَمة إلى cc_common.configure_features (يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7793 للحصول على مزيد من المعلومات).
العلامات: loading_and_analysis، incompatible_change
--[no]interface_shared_objects التلقائي: "true;true"
يمكنك استخدام العناصر المشتركة للواجهة إذا كانت متوافقة مع سلسلة الأدوات. تتيح جميع سلاسل أدوات ELF هذا الإعداد حاليًا.
العلامات: loading_and_analysis، affects_outputs، affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
يحدد إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل iOS لاستخدامه في إنشاء تطبيقات iOS. إذا لم يتم تحديدها، فإنها تستخدم الإصدار التلقائي من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من 'xcode_version'.
العلامات: loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
يحدد إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل macOS لاستخدامه في إنشاء تطبيقات macOS. إذا لم يتم تحديدها، فإنها تستخدم الإصدار التلقائي من نظام التشغيل macOS SDK من 'xcode_version'.
العلامات: loses_incremental_state
--minimum_os_version=<a string> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل الذي تستهدفه حزمة التجميع
العلامات: loading_and_analysis، affects_outputs
--platform_mappings=<a relative path> التلقائي: ""
مكان ملف الربط الذي يصف النظام الأساسي الذي يجب استخدامه في حال عدم ضبط أي من الأنظمة أو العلامات التي يتم تحديدها عند توفّر النظام الأساسي. يجب أن يكون مرتبطًا بجذر مساحة العمل الرئيسية. ويتم الإعداد تلقائيًا على 'platform_mappings' (ملف مباشرةً ضمن جذر مساحة العمل).
العلامات: affects_outputs، changes_inputs، loading_and_analysis
--platforms=<a build target label> التلقائي: ""
تصنيفات قواعد النظام الأساسي التي تصف الأنظمة الأساسية المستهدفة للأمر الحالي.
العلامات: affects_outputs، changes_inputs، loading_and_analysis
--python2_path=<a string> التلقائي: عرض الوصف
متوقّف نهائيًا، وقد تم إيقافه بواسطة `--incompatible_use_python_toolchains`.
العلامات: no_op وdeprecated
--python3_path=<a string> التلقائي: عرض الوصف
متوقّف نهائيًا، وقد تم إيقافه بواسطة `--incompatible_use_python_toolchains`.
العلامات: no_op وdeprecated
--python_path=<a string> التلقائي: عرض الوصف
تمثّل المسار المطلق في لغة Python في تشغيل أهداف Python على المنصة الهدف. متوقّف؛ تم الإيقاف من قِبل --incompatible_use_python_toolchains.
العلامات: loading_and_analysis، affects_outputs
--python_top=<a build target label> التلقائي: عرض الوصف
تصنيف py_runtime الذي يمثّل مترجم Python الذي تم استدعاءه لتنفيذ أهداف Python على النظام الأساسي الهدف متوقّف؛ تم الإيقاف من قِبل --incompatible_use_python_toolchains.
العلامات: loading_and_analysis، affects_outputs
--target_platform_fallback=<a build target label> التلقائي: "@local_config_platform//:host"
تصنيف قاعدة نظام أساسي يجب استخدامها في حال عدم ضبط أي منصة مستهدفة وعدم تطابق عملية ربط النظام الأساسي مع مجموعة العلامات الحالية
العلامات: affects_outputs، changes_inputs، loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
يحدد هذا الإعداد إصدار حزمة تطوير البرامج (SDK) لنظام tvOS لاستخدامها في إنشاء تطبيقات tvOS. إذا لم يتم تحديدها، يتم استخدام الإصدار التلقائي من حزمة tvOS SDK من 'xcode_version'.
العلامات: loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
يحدد هذا الإعداد إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Watch المستخدَم لإنشاء تطبيقات ساعة OS. إذا لم يتم تحديدها، سيتم استخدام الإصدار التلقائي من حزمة SDK لنظام التشغيل WatchOS من 'xcode_version'.
العلامات: loses_incremental_state
--xcode_version=<a string> التلقائي: عرض الوصف
في حال تم تحديد هذه السمة، استخدِم Xcode من الإصدار المحدّد لتنفيذ إجراءات الإصدار ذات الصلة. إذا لم يتم تحديده، يتم استخدام الإصدار التلقائي للمنفِّذ Xcode.
العلامات: loses_incremental_state
--xcode_version_config=<a build target label> التلقائي: "@bazel_tools//tools/cpp:host_xcodes"
تصنيف قاعدة xcode_config المُستخدَمة لاختيار إصدار Xcode في إعدادات الإصدار
العلامات: loses_incremental_state، loading_and_analysis
الخيارات التي تتحكّم في ناتج الأمر:
--[no]apple_enable_auto_dsym_dbg التلقائي: "false;quot;
ما إذا كان يجب فرض إنشاء ملفات تصحيح الأخطاء (.dSYM) لإصدارات dbg.
العلامات: affects_outputs، action_command_lines
--[no]apple_generate_dsym التلقائي: "false;quot;
تحديد ما إذا كان سيتم إنشاء ملفات تصحيح الأخطاء ( .dSYM)
العلامات: affects_outputs، action_command_lines
في حال ضبط هذه السياسة على"صحيح"، أنشِئ مجموعات رمزية للملفات القابلة للتنفيذ لجميع الاستهدافات. وفي حال ضبطها على "خطأ"، يُرجى كتابة البيانات فقط عند الإمكان.
العلامات: affects_outputs
--[no]build_runfile_manifests التلقائي: "true;true"
إذا كانت القيمة صحيحة، يُرجى كتابة بيانات ملفات Run لجميع الأهداف. وإذا لم تكن متوفّرة، احذفها. وسيتعذّر تشغيل الاختبارات المحلية عند ضبطها على "خطأ".
العلامات: affects_outputs
--[no]build_test_dwp التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، سيتم تلقائيًا إنشاء ملف .dwp لهذا البرنامج الثنائي عند إجراء اختبارات C++ بشكل ثابت، وسيتم أيضًا إنشاء ملف بالامتداد .dwp أيضًا.
العلامات: loading_and_analysis، affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options> التلقائي: "p.h.h"
يضبط بادئات ملفات العناوين التي ينشئها cc_proto_library.
العلامات: affects_outputs، loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options> التلقائي: ".pb.cc"
يضبط بادئات الملفات المصدر التي ينشئها cc_proto_library.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info التلقائي: "false;quot;
تنفيذ إجراءات إضافية لإصدارات Java api البديلة في proto_library.
العلامات: affects_outputs، loading_and_analysis، experimental
--[no]experimental_proto_extra_actions التلقائي: "false;quot;
تنفيذ إجراءات إضافية لإصدارات Java api البديلة في proto_library.
العلامات: affects_outputs، loading_and_analysis، experimental
--[no]experimental_save_feature_state التلقائي: "false;quot;
حفظ حالة الخصائص المميّزة المطلوبة والمطلوبة كنتيجة للتجميع.
العلامات: affects_outputs، experimental
--fission=<a set of compilation modes> التلقائي: "no"
تحدد أوضاع التجميع التي تستخدم الأزمة بهدف تجميع C++ والروابط. يمكن أن تكون هذه الخوارزمية أيًا من {'fastbuild', 'dbg', 'opt'} أو القيم الخاصة 'yes' لتفعيل كل الأوضاع و 'no' لإيقاف جميع الأوضاع.
العلامات: loading_and_analysis، action_command_lines، affects_outputs
--[no]legacy_external_runfiles التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، أنشِئ مجموعات رمزية لمجلدات التشغيل للمستودعات الخارجية ضمن .runfiles/wsname/external/repo (بالإضافة إلى .runfiles/repo).
العلامات: affects_outputs
--[no]objc_generate_linkmap التلقائي: "false;quot;
يحدد هذا الإعداد ما إذا كان سيتم إنشاء ملف linklink.
العلامات: affects_outputs
--[no]save_temps التلقائي: "false;quot;
في حال ضبط هذه السياسة، سيتم حفظ النتائج المؤقتة من gcc. تتضمّن هذه الملفات ملفات .s (رمز التجميع) وملفات i. (التي تتم معالجتها مسبقًا C) وملفات .ii (C++ التي تمت معالجتها مسبقًا).
العلامات: affects_outputs
الخيارات التي تتيح للمستخدم ضبط النتائج المطلوبة ما يؤثر في قيمتها بدلاً من ظهورها:
تراكم --action_env=<a 'name=value' assignment with an optional value part> استخدامات متعددة
يحدد مجموعة من متغيرات البيئة المتاحة للإجراءات مع الإعداد المستهدف. يمكن تحديد المتغيرات حسب الاسم، وفي هذه الحالة سيتم الحصول على القيمة من بيئة الاستدعاء، أو من خلال زوج الاسم=القيمة الذي يضبط القيمة بشكل مستقل عن بيئة الاستدعاء. يمكن استخدام هذا الخيار عدة مرات، أما بالنسبة إلى الخيارات المتوفرة للمتغيّر نفسه، فتختلف عمليات الفوز الأخيرة وآخر الخيارات.
العلامات: action_command_lines
--android_cpu=<a string> التلقائي: "armeabi-v7a"
وحدة المعالجة المركزية (CPU) المستهدفة في Android
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--[no]android_databinding_use_androidx التلقائي: "false;quot;
إنشاء ملفات ربط بيانات متوافقة مع AndroidX. وتُستخدم هذه الطريقة فقط مع الإصدار 2 من ربط البيانات.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state، experimental
--[no]android_databinding_use_v3_4_args التلقائي: "false;quot;
استخدام الإصدار 2.3 من Android Databinding مع الوسيطة 3.4.0
العلامات: affects_outputs وloading_and_analysis وloses_incremental_state وexperimental
--android_dynamic_mode=<off, default or fully> التلقائي: "off;quot;
يحدد ما إذا كان سيتم ربط أقسام C++ لقواعد Android بشكل ديناميكي عندما لا ينشئ cc_binary مكتبة مشتركة بشكل صريح. 'default' يعني اختيار البازيل الاختيار بين الربط ديناميكيًا. 'full' يعني ربط جميع المكتبات ديناميكيًا. 'off' يعني ربط جميع المكتبات في الوضع الثابت الثابت.
العلامات: affects_outputs، loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> التلقائي: "alphabetical"
يحدد ترتيب البيان الذي تم تمريره إلى دمج البيان لبرامج Android الثنائية. تعني كلمة "ALPHABALAL" أنّ البيانات يتم ترتيبها حسب المسار المرتبط بالتنفيذ. يعني ALPHABETICAL_BY_CONFIGURATION أن البيانات مرتّبة حسب المسارات بالنسبة إلى دليل الضبط ضمن دليل الناتج. يُقصد ببروتوكول DEPENDENCY أنّه يتم ترتيب البيان مع كل بيان في مكتبة المكتبة قبل عرضها على البيانات التابعة لها.
العلامات: action_command_lines، execution
--[no]android_resource_shrinking التلقائي: "false;quot;
تفعيل تقليص الموارد لملفات android_binary APK التي تستخدم ProGuard.
العلامات: affects_outputs، loading_and_analysis
تراكم --apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst> استخدامات متعددة
حدِّد وضع Apple Bicode لإعداد خطوات تجميع الخطوات التي تستهدف بُنى الأجهزة. وتكون القيم بالشكل التالي: وفي حال توفّر هذا الوضع، يتم تطبيق وضع الرمز البريدي على هذه المنصة تحديدًا، وفي حال حذفه، يتم تطبيقه على جميع الأنظمة الأساسية. يجب أن يكون الوضع &#39؛none' أو 'embed_flags' أو 'embed'. قد يتم تقديم هذا الخيار عدة مرات.
العلامات: loses_incremental_state
--[no]build_python_zip التلقائي: "auto;quot;
إنشاء ملف zip python قابل للتنفيذ، وتفعيله على Windows، وإيقافه على الأنظمة الأساسية الأخرى
العلامات: affects_outputs
تراكم --catalyst_cpus=<comma-separated list of options> استخدامات متعددة
قائمة من البُنى التي تُستخدم لإنشاء برامج ثنائية على Apple Catalyst مفصولة بفواصل.
العلامات: loses_incremental_state، loading_and_analysis
--[no]collect_code_coverage التلقائي: "false;quot;
في حال حدَّدت العلامة التجارية، ستستخدم Bazel رمز الوسيلة (باستخدام لوحة البيانات بلا اتصال بالإنترنت حيثما أمكن) وستجمع معلومات التغطية أثناء الاختبارات. ولن تتأثر سوى الاستهدافات التي تتطابق مع --toolation_filter. يجب عادةً عدم تحديد هذا الخيار مباشرةً - 'bazelتغطية' يجب استخدام الأمر بدلاً من ذلك.
العلامات: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] التلقائية: "fastbuild"
حدِّد الوضع الذي سيتم استخدامه في البرنامج الثنائي. القيم: 'Fastbuild', 'dbg', 'opt'
العلامات: affects_outputs، action_command_lines، explicit_in_output_path
تراكم --conlyopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى Gcc عند تجميع ملفات المصدر C.
العلامات: action_command_lines، affects_outputs
تراكم --copt=<a string> استخدامات متعددة
خيارات إضافية لإدخالها إلى Gcc.
العلامات: action_command_lines، affects_outputs
--cpu=<a string> التلقائي: ""
وحدة المعالجة المركزية (CPU) المستهدفة
العلامات: changes_inputs، affects_outputs، explicit_in_output_path
--cs_fdo_absolute_path=<a string> التلقائي: عرض الوصف
يمكنك استخدام معلومات ملف CSFDO الشخصي لتحسين التجميع. حدِّد اسم المسار المطلق لملف ZIP الذي يحتوي على ملف الملف الشخصي أو ملف شخصي غير مُعدَّل أو ملف شخصي مُفهرس LLVM مُفهرس.
العلامات: affects_outputs
--cs_fdo_instrument=<a string> التلقائي: عرض الوصف
إنشاء برامج ثنائية باستخدام أداة FDO الحساسة الحسّاسة من حيث السياق باستخدام مجمِّع Clang/LLVM، يقبل أيضًا اسم الدليل الذي يتم بموجبه تفريغ ملفات الملف الشخصي الأولية في وقت التشغيل.
العلامات: affects_outputs
--cs_fdo_profile=<a build target label> التلقائي: عرض الوصف
الملف cs_fdo_profile الذي يمثّل الملف الشخصي الحساس للسياق الذي سيتم استخدامه في التحسين.
العلامات: affects_outputs
تراكم --cxxopt=<a string> استخدامات متعددة
خيار إضافي لتمريره إلى Gcc عند تجميع ملفات مصدر C++.
العلامات: action_command_lines، affects_outputs
تراكم --define=<a 'name=value' assignment> استخدامات متعددة
يحدد كل خيار --define مهمة لمتغيّر إصدار.
العلامات: changes_inputs، affects_outputs
--dynamic_mode=<off, default or fully> التلقائي: "default;default"
يحدد ما إذا كان سيتم ربط برامج C++ الثنائية بشكل ديناميكي. 'default' يعني أن Bazel سيختار الربط بشكل ديناميكي. 'full' يعني ربط جميع المكتبات ديناميكيًا. 'off' يعني ربط جميع المكتبات في الوضع الثابت الثابت.
العلامات: loading_and_analysis، affects_outputs
--[no]enable_fdo_profile_absolute_path التلقائي: "true;true"
في حال تم ضبط هذه السياسة، سيؤدي استخدام fdo_absolute_profile_path إلى حدوث خطأ.
العلامات: affects_outputs
--[no]enable_runfiles التلقائي: "auto;quot;
تفعيل شجرة رمز التشغيل لملفات التشغيل، وبشكل تلقائي، يتم إيقافها على نظام التشغيل Windows على أنظمة أساسية أخرى
العلامات: affects_outputs
تراكم --experimental_action_listener=<a build target label> استخدامات متعددة
تم إيقافها لصالح جوانب مختلفة. استخدِم action_listener لإرفاق إجراء إضافي مع إجراءات الإصدار الحالية.
العلامات: execution، experimental
--[no]experimental_android_compress_java_resources التلقائي: "false;quot;
ضغط موارد Java في ملفات APK
العلامات: affects_outputs وloading_and_analysis وexperimental
--[no]experimental_android_databinding_v2 التلقائي: "false;quot;
استخدام السمة Android bindbind v2
العلامات: affects_outputs وloading_and_analysis وloses_incremental_state وexperimental
--[no]experimental_android_resource_shrinking التلقائي: "false;quot;
تفعيل تقليص الموارد لملفات android_binary APK التي تستخدم ProGuard.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex التلقائي: "false;quot;
استخدام أداة rex لإعادة كتابة ملفات dex
العلامات: affects_outputs وloading_and_analysis وloses_incremental_state وexperimental
--experimental_objc_fastbuild_options=<comma-separated list of options> التلقائي: "-O0,-DDEBUG=1"
تستخدِم هذه السلاسل كخيارات مجمّع objc Fastbuild.
العلامات: action_command_lines
--[no]experimental_omitfp التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، استخدِم libunwind لتراجع استدعاء الدوال البرمجية وتجميعها باستخدام -fomit-frame-pointer و-fsync-unwind-tables.
العلامات: action_command_lines، affects_outputs، experimental
--[no]experimental_platform_in_output_dir التلقائي: "false;quot;
في حال اختيار هذا الإعداد، يتم استخدام النظام الأساسي المستهدف في اسم دليل الإخراج بدلاً من وحدة المعالجة المركزية (CPU).
العلامات: affects_outputs، experimental
--[no]experimental_use_llvm_covmap التلقائي: "false;quot;
في حال تحديد Bazel، ستُنشئ معلومات خريطة تغطية llvm-cov بدلاً من gcov عند تفعيل جمع_رمز_التغطية.
العلامات: changes_inputs، affects_outputs، loading_and_analysis، experimental
--fat_apk_cpu=<comma-separated list of options> التلقائي: "armeabi-v7a"
يؤدي ضبط هذا الخيار إلى تفعيل ملفات APK للدهون التي تحتوي على برامج ثنائية أصلية لكل البُنى المستهدَفة المحدّدة، مثل --fat_APK_cpu=x86,armeabi-v7a. إذا تم تحديد هذه العلامة، سيتم تجاهل --android_cpu في تبعيات قواعد android_binary.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--[no]fat_apk_hwasan التلقائي: "false;quot;
تحديد ما إذا كان سيتم إنشاء تقسيمات HWASAN.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--fdo_instrument=<a string> التلقائي: عرض الوصف
إنشاء برامج ثنائية باستخدام أداة FDO باستخدام مجمِّع Clang/LLVM، يقبل أيضًا اسم الدليل الذي يتم بموجبه تفريغ ملفات الملف الشخصي الأولية في وقت التشغيل.
العلامات: affects_outputs
--fdo_optimize=<a string> التلقائي: عرض الوصف
يمكنك استخدام معلومات الملف الشخصي لإدارة الأغذية والدواء لتحسين التجميع. حدِّد اسم ملف ZIP يحتوي على شجرة ملفات .gcda، أو ملف afdo يحتوي على ملف شخصي تلقائي، أو ملف شخصي LLVM. تقبل هذه العلامة أيضًا الملفات المحددة كتصنيفات (على سبيل المثال `//foo/bar:file.afdo` - قد تحتاج إلى إضافة توجيه "exports_files" إلى الحزمة المقابلة) والتصنيفات التي تشير إلى استهدافات "fdo_profile". ستحل قاعدة "fdo_profile" محل هذه العلامة.
العلامات: affects_outputs
--fdo_prefetch_hints=<a build target label> التلقائي: عرض الوصف
استخدام تلميحات الجلب المسبق لذاكرة التخزين المؤقت
العلامات: affects_outputs
--fdo_profile=<a build target label> التلقائي: عرض الوصف
الملف الشخصي fdo_profile الذي يمثّل الملف الشخصي الذي سيتم استخدامه للتحسين.
العلامات: affects_outputs
تراكم --features=<a string> استخدامات متعددة
سيتم تفعيل الميزات المعيّنة أو إيقافها بشكل تلقائي لجميع الحِزم. يؤدي تحديد -<feature> إلى إيقاف الميزة على المستوى العالمي. دائمًا ما تلغي الميزات السلبية الميزات الإيجابية. تُستخدَم هذه العلامة للسماح بطرح تغييرات تلقائية للميزات بدون إصدار Bazel.
العلامات: changes_inputs، affects_outputs
--[no]force_pic التلقائي: "false;quot;
في حال تفعيل هذه الميزة، تؤدي جميع مجمّعات C++ إلى إنشاء رمز مستقل عن الموضع ("-fPIC")، وتفضّل الروابط المكتبات المصمّمة مسبقًا بطريقة PIC بدلاً من المكتبات غير المزوّدة بتقنية PIC، وتنشئ الروابط روابط تنفيذية مستقلة عن الموضع ("-pie").
العلامات: loading_and_analysis، affects_outputs
تراكم --host_action_env=<a 'name=value' assignment with an optional value part> استخدامات متعددة
يحدد مجموعة متغيرات البيئة المتاحة للإجراءات التي تحتوي على إعدادات المضيف أو التنفيذ. يمكن تحديد المتغيرات حسب الاسم، وفي هذه الحالة سيتم الحصول على القيمة من بيئة الاستدعاء، أو من خلال زوج الاسم=القيمة الذي يضبط القيمة بشكل مستقل عن بيئة الاستدعاء. يمكن استخدام هذا الخيار عدة مرات، أما بالنسبة إلى الخيارات المتوفرة للمتغيّر نفسه، فتختلف عمليات الفوز الأخيرة وآخر الخيارات.
العلامات: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> التلقائي: "opt"
حدِّد الوضع الذي سيتم فيه استخدام الأدوات المُستخدَمة أثناء الإصدار. القيم: 'Fastbuild', 'dbg', 'opt'
العلامات: affects_outputs، action_command_lines
تراكم --host_conlyopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى Gcc عند تجميع ملفات المصدر C للأدوات المضيفة.
العلامات: action_command_lines، affects_outputs
تراكم --host_copt=<a string> استخدامات متعددة
خيارات إضافية لإدخال كلمة "مركز عملائي" إلى "أدوات المضيف".
العلامات: action_command_lines، affects_outputs
--host_cpu=<a string> التلقائي: ""
وحدة المعالجة المركزية (CPU) المضيفة
العلامات: changes_inputs، affects_outputs
تراكم --host_cxxopt=<a string> استخدامات متعددة
خيارات إضافية لإدخال كلمة "مركز عملائي" إلى "أدوات المضيف".
العلامات: action_command_lines، affects_outputs
--host_force_python=<PY2 or PY3> التلقائي: عرض الوصف
يلغي إصدار Python لضبط المضيف. يمكن أن تكون "PY2" أو &&;;PY3".
العلامات: loading_and_analysis، affects_outputs
تراكم --host_linkopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى مركز عملائي في حال الربط بأدوات المضيف.
العلامات: action_command_lines، affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل macOS المتوافق مع أهداف المضيف. إذا لم يتم تحديدها، استخدِم 'macos_sdk_version'.
العلامات: loses_incremental_state
تراكم --host_swiftcopt=<a string> استخدامات متعددة
خيارات إضافية للانتقال إلى swiftc لأدوات المضيف.
العلامات: action_command_lines، affects_outputs
--[no]incompatible_avoid_conflict_dlls التلقائي: "true;true"
في حال تفعيل هذا الإعداد، ستتم إعادة تسمية جميع مكتبات C++ الديناميكية المرتبطة (DLL) التي تم إنشاؤها بواسطة cc_library على نظام التشغيل Windows إلى name_{hash}.dll حيث يتم حساب التجزئة استنادًا إلى RepositoryName ومسار حزمة DLL'. يكون هذا الخيار مفيدًا عندما تكون لديك حزمة واحدة تعتمد على العديد من cc_library التي تحمل الاسم نفسه (مثل //foo/bar1:utils و //foo/bar2:utils).
العلامات: loading_and_analysis، affects_outputs، incompatible_change
--[no]incompatible_merge_genfiles_directory التلقائي: "true;true"
إذا كان هذا صحيحًا، يتم طي الدليل gfiles في دليل bin.
العلامات: affects_outputs، incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، تتم إزالة إعدادات القيود من @bazel_tools.
العلامات: affects_outputs، incompatible_change
--[no]instrument_test_targets التلقائي: "false;quot;
عند تفعيل التغطية، يتم تحديد ما إذا كنت تريد مراعاة قواعد اختبار قياس حالة التطبيق. وعند الضبط، يتم عرض قواعد الاختبار المضمّنة في --toolation_filter. وإلاّ، يتم دائمًا استبعاد قواعد الاختبار من أدوات التغطية.
العلامات: affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> التلقائي: "-/javatests[/:],-/test/java[/:]"
عند تفعيل التغطية، سيتم استخدام القواعد ذات الأسماء المضمنة من خلال الفلتر المستند إلى regex فقط. يتم استبعاد القواعد التي تبدأ بـ '-' بدلاً من ذلك. تجدر الإشارة إلى أنه لا يتم عرض سوى القواعد غير التجريبية ما لم يتم تفعيل --tool_test_targets.
العلامات: affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار iOS المتوافق مع أجهزة المحاكاة والأجهزة المستهدفة. إذا لم يتم تحديدها، استخدِم 'ios_sdk_version'.
العلامات: loses_incremental_state
تراكم --ios_multi_cpus=<comma-separated list of options> استخدامات متعددة
قائمة بتصميمات معمارية مفصولة بفواصل لإنشاء تطبيق ios. وتكون النتيجة برنامجًا ثنائيًا عامًا يحتوي على جميع البُنى المحدّدة.
العلامات: loses_incremental_state، loading_and_analysis
--[no]legacy_whole_archive التلقائي: "true;true"
تم إحلاله محل الإصدار --incompatible_remove_legacy_whole_archive (يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7362 لمزيد من التفاصيل). عند تفعيل هذا الإعداد، استخدِم --whole-archive لقواعد cc_binary التي تحتوي على رابط shared=True وlinkstatic=True أو '-static' في linkopts. وذلك لأغراض التوافق مع الأنظمة القديمة فقط. البديل الأفضل هو استخدام linklink=1 عند الحاجة.
العلامات: action_command_lines، affects_outputs، deprecated
تراكم --linkopt=<a string> استخدامات متعددة
خيار إضافي لتمرير البيانات إلى مركز عملائي عند الربط.
العلامات: action_command_lines، affects_outputs
تراكم --ltobackendopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى خطوة خلفية LTO (ضمن --features=thin_lto).
العلامات: action_command_lines، affects_outputs
تراكم --ltoindexopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى خطوة فهرسة LTO (ضمن --features=thin_lto).
العلامات: action_command_lines، affects_outputs
تراكم --macos_cpus=<comma-separated list of options> استخدامات متعددة
قائمة من البُنى التي تُنشئ تطبيقات ثنائية على نظام التشغيل Apple macOS مفصولة بفواصل.
العلامات: loses_incremental_state، loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل macOS المتوافق للأهداف. إذا لم يتم تحديدها، استخدِم 'macos_sdk_version'.
العلامات: loses_incremental_state
--[no]objc_debug_with_GLIBCXX التلقائي: "false;quot;
في حال ضبط السياسة وضبط وضع التجميع على 'dbg' ، حدِّد GLIBCXX_DEBUG وGLIBCXX_DEBUG_PEDANTIC وGLIBCPP_CONCEPT_checkS.
العلامات: action_command_lines
--[no]objc_enable_binary_stripping التلقائي: "false;quot;
تحديد ما إذا كان سيتم تنفيذ عمليات إزالة الرموز والرموز غير الصالحة على البرامج الثنائية المرتبطة. سيتم تنفيذ عمليات الإزالة الثنائية إذا تم تحديد كل من هذه العلامة و --compilation_mode=opt.
العلامات: action_command_lines
تراكم --objccopt=<a string> استخدامات متعددة
خيارات إضافية لإدخالها إلى "مركز عملائي" عند تجميع ملفات المصدر Purpose-C/C++.
العلامات: action_command_lines
تراكم --per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> استخدامات متعددة
خيارات إضافية للانتقال إلى GCC بشكل انتقائي عند تجميع ملفات معيّنة. يمكن تمرير هذا الخيار عدة مرات. البنية: regex_filter@option_1,option_2,...,option_n. حيث يشير regex_filter إلى قائمة تتضمن أنماط التعبير العادي واستبعادها (اطّلع أيضًا على --toolation_filter). يشير Option_1 إلى Option_n إلى خيارات سطر الأوامر العشوائية. إذا كان أحد الخيارات يحتوي على فاصلة، يجب اقتباسها شرطة مائلة للخلف. يمكن أن تحتوي الخيارات على @. يتم استخدام أول @ فقط لتقسيم السلسلة. مثال: يضيف --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 خيار سطر الأوامر -O0 إلى سطر الأوامر gcc لجميع ملفات cc في //foo/ باستثناء Bar.cc.
العلامات: action_command_lines، affects_outputs
تراكم --per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> استخدامات متعددة
خيارات إضافية للانتقال بشكل اختياري إلى خلفية LTO (ضمن --features=thin_lto) عند تجميع عناصر خلفية معيّنة. يمكن تمرير هذا الخيار عدة مرات. البنية: regex_filter@option_1,option_2,...,option_n. يشير الاختصار regex_filter إلى قائمة من أنماط التضمين العادية واستبعادها. يشير Option_1 إلى Option_n إلى خيارات سطر الأوامر العشوائية. إذا كان أحد الخيارات يحتوي على فاصلة، يجب اقتباسها شرطة مائلة للخلف. يمكن أن تحتوي الخيارات على @. يتم استخدام أول @ فقط لتقسيم السلسلة. مثال: يضيف --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 خيار سطر الأوامر -O0 إلى سطر الأوامر الخلفي لـ LTO لجميع ملفات o في //foo/ باستثناء Bar.o.
العلامات: action_command_lines، affects_outputs
--platform_suffix=<a string> التلقائي: عرض الوصف
يحدد لاحقة لإضافتها إلى دليل الإعداد.
العلامات: loses_incremental_state، affects_outputs، loading_and_analysis
--propeller_optimize=<a build target label> التلقائي: عرض الوصف
استخدِم معلومات الملف الشخصي للمحترفين لتحسين هدف الإصدار.يجب أن يحتوي الملف الشخصي للمعجب على ملفَين على الأقل، على أن يكون الملف الشخصي في حقل "نسخة إلى" وملفًا شخصيًا في ملف شخصي. تقبل هذه العلامة تصنيف إصدار يجب أن يشير إلى ملفات إدخال الملف الشخصي للدفع. على سبيل المثال، ملف BUILD الذي يحدّد التصنيف، في a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)يجب أن يتطابق التوجيه الذي يظهر مع الباصات أنّه يجب أن يكون وأن يكون بالإضافة إلى الحزمة متاحًا على الملف للسلع المُخزَّنة. يجب استخدام الخيار على النحو التالي: --propeller_optimize=//a/b:propeller_profile
العلامات: action_command_lines وaffects_outputs
--propeller_optimize_absolute_cc_profile=<a string> التلقائي: عرض الوصف
اسم المسار المطلق لملف cc_profile لإصدارات Propeller المحسّن.
العلامات: affects_outputs
--propeller_optimize_absolute_ld_profile=<a string> التلقائي: عرض الوصف
اسم المسار المطلق لملف ld_profile لإصدارات ProProler المحسّنة.
العلامات: affects_outputs
--run_under=<a prefix in front of command> التلقائي: عرض الوصف
بادئة لإدراجها قبل الملفات التنفيذية للأمرَين 'test' و 'run'. إذا كانت القيمة هي 'foo -bar'، وكان سطر أوامر التنفيذ هو 'test_binary -baz'، يكون سطر الأوامر النهائي هو 'foo -bar test_binary -baz'.ويمكن أن يكون هذا أيضًا تصنيفًا لهدف قابل للتنفيذ. بعض الأمثلة هي: 'valgrind','strace','strace -c', 'valgrind --quiet --num-callers=20', '//package:target',&33;//package:target',#39;//package:target',#39;//package:target'
العلامات: action_command_lines
--[no]share_native_deps التلقائي: "true;true"
في حال كان هذا صحيحًا، ستتم مشاركة المكتبات الأصلية التي تتضمّن وظائف متطابقة بين الأهداف المختلفة.
العلامات: loading_and_analysis وaffects_outputs
--[no]stamp التلقائي: "false;quot;
استخدِم الطوابع الثنائية بالتاريخ، واسم المستخدم، واسم المضيف، ومعلومات مساحة العمل، وما إلى ذلك.
العلامات: affects_outputs
--strip=<always, sometimes or never> التلقائي: "أحيانًا&quot
يحدد ما إذا كان سيتم إزالة البرامج الثنائية والمكتبات المشتركة (باستخدام "-Wl;---strip-debug"). تعني القيمة التلقائية 'أحيانًا##9
العلامات: affects_outputs
تراكم --stripopt=<a string> استخدامات متعددة
خيارات إضافية يتم تمريرها إلى شريط العناصر عند إنشاء برنامج '<name>.stripped' ثنائي.
العلامات: action_command_lines، affects_outputs
تراكم --swiftcopt=<a string> استخدامات متعددة
خيارات إضافية للانتقال إلى مجمّع Swift.
العلامات: action_command_lines
تراكم --tvos_cpus=<comma-separated list of options> استخدامات متعددة
قائمة من البُنى التي تُستخدَم لإنشاء برامج ثنائية على Apple tvOS.
العلامات: loses_incremental_state، loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل المتوافق مع التلفزيونات لمحاكيات الأجهزة والأجهزة المستهدفة. إذا لم يتم تحديدها، استخدِم 'tvos_sdk_version'.
العلامات: loses_incremental_state
تراكم --watchos_cpus=<comma-separated list of options> استخدامات متعددة
قائمة من البُنى التي تُستخدَم لإنشاء برامج ثنائية على نظام التشغيل Apple Watch.
العلامات: loses_incremental_state، loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل المتوافق مع ساعة المشاهدة للمحاكيات والأجهزة المستهدفة. إذا لم يتم تحديدها، استخدِم 'watchos_sdk_version'.
العلامات: loses_incremental_state
--xbinary_fdo=<a build target label> التلقائي: عرض الوصف
استخدِم معلومات الملف الشخصي في XbinaryFDO لتحسين التجميع. تحديد اسم الملف الشخصي التلقائي على مستوى البرنامج الثنائي عند استخدام الخيار مع --fdo_tool/--fdo_optimize/--fdo_profile، سيُطبَّق هذا الخيار دائمًا كما لو لم يتم تحديد xbinary_fdo مطلقًا.
العلامات: affects_outputs
الخيارات التي تؤثّر في مدى قوة تطبيق Bazel لمدخلات الإصدارات الصالحة (تعريفات القواعد ومجموعات العلامات وغيرها):
--auto_cpu_environment_group=<a build target label> التلقائي: ""
يمكنك تعريف البيئة_group لاستخدامها لربط قيم وحدة المعالجة المركزية (CPU) تلقائيًا بقيم target_environment.
العلامات: changes_inputs، loading_and_analysis، experimental
--[no]check_licenses التلقائي: "false;quot;
تحقَّق من أنّ قيود الترخيص التي تفرضها الحِزم التابعة لا تتعارض مع أوضاع توزيع الأهداف التي يتم إنشاؤها. ولا يتم التحقق من التراخيص تلقائيًا.
العلامات: build_file_semantics
--[no]check_visibility التلقائي: "true;true"
في حال إيقاف هذا الإعداد، يتم خفض ترتيب أخطاء مستوى الرؤية في العناصر التابعة المستهدفة إلى تحذيرات.
العلامات: build_file_semantics
--[no]desugar_for_android التلقائي: "true;true"
يمكنك إزالة رمز Java 8 بايت قبل إلغاء تحويله إلى نص.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--[no]desugar_java8_libs التلقائي: "false;quot;
تضمين مكتبات Java 8 المتوافقة في التطبيقات المخصّصة للأجهزة القديمة.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state، experimental
--[no]enforce_constraints التلقائي: "true;true"
التحقّق من البيئات المتوافقة مع كل استهداف والإبلاغ عن الأخطاء في حال كان أي هدف يتضمن تبعيات لا تتوافق مع البيئات نفسها
العلامات: build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs التلقائي: "false;quot;
يمكنك الإبلاغ للمساعدة في عملية الانتقال من عدم السماح بقواعد android_librarys التي لا تتضمّن srcs مع حذفات فرعية. يجب تنظيف المستودع ليتم طرحه تلقائيًا.
العلامات: eagerness_to_exit، loading_and_analysis
--[no]experimental_check_desugar_deps التلقائي: "true;true"
التحقّق جيدًا من مستوى الصواب الصحيح على مستوى برنامج Android الثنائي
العلامات: eagerness_to_exit، loading_and_analysis، experimental
--experimental_import_deps_checking=<off, warning or error> التلقائي: "off;quot;
عند تفعيل هذا الإعداد، تحقّق مما إذا كانت المهام التابعة لسمة aar_import مكتملة. يمكن أن يؤدي هذا التنفيذ إلى تلف الإصدار، أو يمكن أن يؤدي فقط إلى تحذيرات.
العلامات: loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default> التلقائي: "default;default"
في حال كان هذا صحيحًا، يتم التحقُّق من أن الاستهداف في Java يعلن بشكلٍ صريح عن جميع الأهداف المستخدمة مباشرةً على أنها اعتماديات.
العلامات: build_file_semantics، eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يمكنك التحقّق من الاختبار فقط بحثًا عن الاستهدافات الأساسية التي تمثل ملفات الإخراج من خلال البحث عن قاعدة الإنشاء فقط. ويتطابق هذا مع التحقّق من إذن الوصول.
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_disable_native_android_rules التلقائي: "false;quot;
في حال التفعيل، يتم إيقاف الاستخدام المباشر لقواعد Android الأصلية. يُرجى استخدام قواعد Android Starar على Android من https://github.com/bazelbuild/rules_android
العلامات: eagerness_to_exit وincompatible_change
--[no]incompatible_disable_native_apple_binary_rule التلقائي: "false;quot;
لا تتوفّر إمكانية التشغيل، ويتم الاحتفاظ بها هنا لتوفير التوافق مع الأنظمة القديمة.
العلامات: eagerness_to_exit، incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark التلقائي: "true;true"
في حال تفعيل هذه الميزة، عليك وضع معايير صارمة للتحقّق من صحة العناوين في واجهة برمجة التطبيقات Starlark
العلامات: loading_and_analysis وchanges_inputs وincompatible_change
--[no]incompatible_validate_top_level_header_inclusions التلقائي: "true;true"
إذا كان الأمر كذلك، ستتحقّق Bazel أيضًا من عمليات تضمين عناوين المستوى الأعلى (يمكنك الاطّلاع على https://github.com/bazelbuild/bazel/issues/10047 للحصول على مزيد من المعلومات).
العلامات: loading_and_analysis، incompatible_change
--[no]strict_filesets التلقائي: "false;quot;
في حال تفعيل هذا الخيار، يتم الإبلاغ عن مجموعات الملفات التي تتجاوز حدود الحزمة باعتبارها أخطاء. ولا تعمل هذه الميزة عند إيقاف check_fileset_dependenities_recursively.
العلامات: build_file_semantics، eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default> التلقائي: "error&quot&quot
ما لم يتم إيقاف السياسة، تتحقّق تلك المعلّمة من أن الاستهداف في proto_library تُعلن صراحةً عن جميع الأهداف المستخدَمة مباشرةً على أنها اعتماديات.
العلامات: build_file_semantics، eagerness_to_exit، incompatible_change
--strict_public_imports=<off, warn, error, strict or default> التلقائي: "off;quot;
ما لم يتم إيقاف السياسة، تتحقّق من أنّ الاستهداف في Proto_library يحدّد بشكلٍ صريح جميع الأهداف المستخدَمة في 'import public' على أنّها تم تصديرها.
العلامات: build_file_semantics، eagerness_to_exit، incompatible_change
--[no]strict_system_includes التلقائي: "false;quot;
في حال كان هذا صحيحًا، يجب أيضًا أن تتضمّن العناوين التي تم العثور عليها من خلال النظام المسارات (-isystem) لعرضها.
العلامات: loading_and_analysis، eagerness_to_exit
تراكم --target_environment=<a build target label> استخدامات متعددة
تعلن هذه البيئة المستهدفة في هذا الإصدار. يجب أن يكون مرجع تصنيف خاصًا بقاعدة "en;ronviation". وفي حال تحديدها، يجب أن تكون جميع أهداف المستوى الأعلى متوافقة مع هذه البيئة.
العلامات: changes_inputs
الخيارات التي تؤثّر في التوقيع على التصميم:
--apk_signing_method=<v1, v2, v1_v2 or v4> التلقائي: "v1_v2"
التنفيذ المطلوب استخدامه لتوقيع حِزم APK
العلامات: action_command_lines وaffects_outputs وloading_and_analysis
--[no]device_debug_entitlements التلقائي: "true;true"
في حال ضبط هذا الإعداد ولم يتم ضبط وضع التجميع، 'opt'، ستحتوي تطبيقات objc على استحقاقات تصحيح الأخطاء عند التوقيع.
العلامات: changes_inputs
--ios_signing_cert_name=<a string> التلقائي: عرض الوصف
اسم الشهادة لاستخدامها في توقيع iOS. في حال ترك هذه السياسة بدون ضبط، سيتم الرجوع إلى الملف الشخصي لإدارة الحسابات. قد تكون هذه هي القيمة المفضّلة لسلسلة مفاتيح الشهادة أو (سلسلة فرعية) من الاسم الشائع للشهادة، وفقًا لصفحة الشخص الموقَّع للترميز (معرّفات التوقيع).
العلامات: action_command_lines
يؤثّر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بإصدارات BUILD أو ملفات .bzl أو ملفات WORKSPACE:
--[no]incompatible_disallow_legacy_py_provider التلقائي: "true;true"
ستتم إزالة إمكانية التفعيل قريبًا.
العلامات: loading_and_analysis، incompatible_change
الخيارات التي تحكم سلوك بيئة الاختبار أو بيئة الاختبار:
--[no]allow_analysis_failures التلقائي: "false;quot;
في حال كان هذا صحيحًا، يؤدي تعذُّر تحليل هدف القاعدة إلى نشر مثيل " تحليلFailureInfo" لمنصّة "الهدف" التي تتضمّن وصف الخطأ، بدلاً من أن يؤدي إلى تعذّر إنشاء الإصدار.
العلامات: loading_and_analysis، experimental
--analysis_testing_deps_limit=<an integer> التلقائي: "2000"
يضبط هذا الإعداد الحد الأقصى لعدد التبعيات الانتقالية من خلال سمة قاعدة مع عملية نقل الإعداد for_analysis_testing. سيؤدي تجاوز هذا الحد إلى خطأ في القاعدة.
العلامات: loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure التلقائي: "false;quot;
في حال إخفاق إجراءات Dex2oat الفعلية، سيؤدي ذلك إلى تعطُّل الإصدار بدلاً من تنفيذ Dex2oat أثناء وقت التشغيل.
العلامات: loading_and_analysis، experimental
--[no]experimental_android_use_parallel_dex2oat التلقائي: "false;quot;
يمكنك استخدام dex2oat بالتوازي لمساعدتك على تسريع نظام التشغيل android_test.
العلامات: loading_and_analysis، host_machine_resource_optimizations، experimental
--[no]ios_memleaks التلقائي: "false;quot;
تفعيل التحقق من تسرُّبات الذاكرة في أهداف ios_test.
العلامات: action_command_lines
--ios_simulator_device=<a string> التلقائي: عرض الوصف
الجهاز الذي سيتم محاكاةه عند تشغيل تطبيق iOS في المحاكي، مثلاً 'iPhone 6&#39؛ يمكنك الحصول على قائمة بالأجهزة من خلال تشغيل 'xcrun simctl list devicestypes' على الجهاز الذي سيتم تشغيل المحاكي عليه.
العلامات: test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
إصدار iOS الذي سيتم تشغيله على المحاكي عند تشغيله أو اختباره يتم تجاهل هذه القاعدة لقواعد ios_test في حال تحديد جهاز مستهدف في القاعدة.
العلامات: test_runner
تراكم --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> استخدامات متعددة
يحدد هذا الإعداد عدد مرات تشغيل كل اختبار. وفي حال فشل أي من هذه المحاولات لأي سبب، سيُعتبر الاختبار بالكامل فاشلاً. عادةً ما تكون القيمة المحددة مجرد عدد صحيح. مثال: سوف تُجري --runs_per_test=3 جميع الاختبارات 3 مرات. البنية البديلة: regex_filter@runs_per_test. يشير يشير run_per_test إلى قيمة العدد الصحيح بينما يشير regex_filter إلى قائمة تتضمن أنماط التعبير العادي ويستثنيها (اطّلع أيضًا على --toolation_filter). مثال: يُجري --runs_per_test=//foo/.*,-//foo/bar/.*@3 جميع الاختبارات في //foo/ باستثناء تلك التي تقع ضمن foo/bar ثلاث مرات. يمكن تمرير هذا الخيار عدة مرات. وتكون الأولوية للوسيطة التي تم تجاوزها مؤخرًا والتي تتطابق مع البيانات. في حال عدم تطابق أي شيء، لن يتم إجراء الاختبار سوى مرة واحدة.
تراكم --test_env=<a 'name=value' assignment with an optional value part> استخدامات متعددة
يحدد متغيرات بيئة إضافية ليتم إدخالها في بيئة تشغيل الاختبار. يمكن تحديد المتغيرات حسب الاسم، وفي هذه الحالة، ستتم قراءة قيمتها من بيئة عميل Bazel أو بواسطة زوج الاسم=القيمة. يمكن استخدام هذا الخيار عدة مرات لتحديد عدة متغيرات. لا يتم استخدامه إلا باستخدام الأمر 'bazel test'.
العلامات: test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers> التلقائي: "-1"
إلغاء قيم مهلة الاختبار التلقائية لمهلة الاختبار (بالثواني) في حال تحديد قيمة عدد صحيح موجب، سيتم إلغاء جميع الفئات. إذا تم تحديد 4 أرقام صحيحة مفصولة بفواصل، ستُلغي المهلات القصيرة والمتوسطة والطويلة والأبدية (بهذا الترتيب). في أي من الخيارين، تخبر القيمة -1 بلاز باستخدام المهلات التلقائية لهذه الفئة.
--tvos_simulator_device=<a string> التلقائي: عرض الوصف
الجهاز الذي سيتم محاكاةه عند تشغيل تطبيق tvOS في المحاكي، مثلاً 'Apple TV 1080p' يمكنك الحصول على قائمة بالأجهزة من خلال تشغيل 'xcrun simctl list devicestypes' على الجهاز الذي سيتم تشغيل المحاكي عليه.
العلامات: test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
إصدار نظام التشغيل tvOS لتشغيله على المحاكي عند تشغيله أو اختباره
العلامات: test_runner
--watchos_simulator_device=<a string> التلقائي: عرض الوصف
الجهاز الذي يجب محاكاته عند تشغيل تطبيق ساعة نظام التشغيل في المحاكي، مثل 'Apple Watch - 38mm' يمكنك الحصول على قائمة بالأجهزة من خلال تشغيل 'xcrun simctl list devicestypes' على الجهاز الذي سيتم تشغيل المحاكي عليه.
العلامات: test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
إصدار نظام التشغيل الذي يتم تشغيله على جهاز المحاكاة عند تشغيله أو اختباره
العلامات: test_runner
--[no]zip_undeclared_test_outputs التلقائي: "true;true"
في حال كان هذا صحيحًا، ستتم أرشفة مخرجات الاختبار غير المعلَنة في ملف ZIP.
العلامات: test_runner
الخيارات المرتبطة بإخراج طلب البحث والدلالة:
--aspect_deps=<off, conservative or precise> التلقائي: "conserveative"
كيفية حل تبعيات العرض عندما يكون تنسيق الناتج واحدًا من {xml,proto,record}. 'off' تعني أنه لم يتم التعامل مع أي تبعيات للجانب، 'conserveative' (الإعداد التلقائي) تعني أن جميع تبعيات الجانب المُعلَن تمت إضافتها بغض النظر عما إذا تم منحها فئة قاعدة للاعتماديات المباشرة أو "#39;precise'" تعني أنه تتم إضافة هذه الجوانب التي من المحتمل أن تكون نشطة وفقًا لفئة القاعدة من التبعية المباشرة. لاحظ أن الوضع الدقيق يتطلب تحميل حِزم أخرى لتقييم هدف واحد، ما يجعله أبطأ من الأوضاع الأخرى. يُرجى العِلم أيضًا أنّ الوضع الدقيق ليس دقيقًا بالكامل، بل يتم اتّخاذ قرار بشأن احتساب جانب في مرحلة التحليل، وهو ما لا يتم تشغيله أثناء إعداد " #39;bazel query'".
العلامات: build_file_semantics
--[no]deduplicate_depsets التلقائي: "true;true"
يمكنك إزالة تكرار العناصر غير الخالية من أوراق البيانات لملف dep_set_of_files في الناتج النهائي على proto/textproto/json. ولا يؤدي ذلك إلى إزالة تكرار المجموعات الفرعية التي لا تشارك أحد الوالدين الفوري. لا يؤثّر ذلك في القائمة النهائية النهائية لعناصر إدخال الإجراءات.
العلامات: terminal_output
--[no]graph:factored التلقائي: "true;true"
إذا تم ضبط هذه السياسة على"صحيح"، سيتم دمج رسم بياني منشِئ &'عامل>&#39؛ أي أنه سيتم دمج العُقد المتماثلة طوبولوجيا معًا وربط تصنيفاتها. ينطبق هذا الخيار على --output=graph فقط.
العلامات: terminal_output
--graph:node_limit=<an integer> التلقائي: "512"
الحد الأقصى لطول سلسلة التصنيف لعقدة رسم بياني في الإخراج. سيتم اقتطاع التصنيفات الأطول، وتعني القيمة -1 عدم اقتطاعها. ينطبق هذا الخيار على --output=graph فقط.
العلامات: terminal_output
--[no]implicit_deps التلقائي: "true;true"
في حال تفعيل هذه الميزة، سيتم تضمين العناصر الضمنية في الرسم البياني للاعتمادية الذي يعمل عليه طلب البحث. الاعتمادية الضمنية هي تلك التي لم يتم تحديدها صراحةً في ملف BUILD، ولكن تمت إضافتها بواسطة البازل. بالنسبة إلى طلب البحث، يتحكم هذا الخيار في فلترة سلاسل الأدوات التي تم حلها.
العلامات: build_file_semantics
--[no]include_artifacts التلقائي: "true;true"
تتضمّن أسماء مدخلات الإجراءات ومخرجاتها في النتيجة (من المحتمل أن تكون كبيرة الحجم)
العلامات: terminal_output
--[no]include_aspects التلقائي: "true;true"
aquery, cquery: ما إذا كان مطلوبًا تضمين الإجراءات التي يتم إنشاؤها من خلال العرض الجانبي في الإخراج. طلب البحث: no-op (يتم تتبّع الجوانب دائمًا).
العلامات: terminal_output
--[no]include_commandline التلقائي: "true;true"
تتضمّن محتوى سطور أوامر الإجراءات في الناتج (من المحتمل أن يكون كبيرًا).
العلامات: terminal_output
--[no]include_file_write_contents التلقائي: "false;quot;
عليك تضمين محتوى الملف لإجراءَي Filewrite وSourceSymlinkManifest (من المحتمل أن يكونا كبيرين).
العلامات: terminal_output
--[no]include_param_files التلقائي: "false;quot;
أدرِج محتوى ملفات المعلّمات المستخدَمة في الأمر (يُحتمل أن يكون كبيرًا). ملاحظة: سيؤدي تفعيل هذه العلامة تلقائيًا إلى تفعيل العلامة "-include_commandline".
العلامات: terminal_output
--[no]incompatible_display_source_file_location التلقائي: "true;true"
"صحيح" يعرض تلقائيًا الهدف من الملف المصدر. إذا كان هذا صحيحًا، يتم عرض موقع السطر 1 من الملفات المصدر في مخرجات الموقع. لا تتوفّر هذه العلامة إلا لأغراض نقل البيانات.
العلامات: terminal_output، incompatible_change
--[no]incompatible_package_group_includes_double_slash التلقائي: "true;true"
في حال تفعيل هذا الإعداد، عند حذف السمة package_group's "الحزم"، لن يتم حذف السمة "//" البادئة.
العلامات: terminal_output، incompatible_change
--[no]infer_universe_scope التلقائي: "false;quot;
في حال ترك السياسة بدون ضبط و --universe_scope بدون ضبط، سيتم استنتاج قيمة --universe_scope في شكل قائمة بالأنماط المستهدَفة الفريدة في تعبير طلب البحث. تجدُر الإشارة إلى أن قيمة --universe_scope التي تم استنتاجها لتعبير طلب بحث تستخدم الدوال على مستوى الكون (مثل `allrdeps`) قد لا تكون ما تريده، لذا يجب استخدام هذا الخيار فقط إذا كنت تعرف ما تفعله. يمكنك الاطّلاع على https://bazel.build/reference/query#sky-query لمعرفة التفاصيل والأمثلة. في حال ضبط --universe_scope، سيتم تجاهل قيمة هذا الخيار's. ملاحظة: ينطبق هذا الخيار فقط على "طلب البحث" (أي ليس "cquery").
العلامات: loading_and_analysis
--[no]line_terminator_null التلقائي: "false;quot;
ما إذا كان سيتم إنهاء كل تنسيق باستخدام \0 بدلاً من السطر الجديد.
العلامات: terminal_output
--[no]nodep_deps التلقائي: "true;true"
في حال تفعيل هذه السياسة، سيتم تضمين سمات من "nodep"، في الرسم البياني الخاص بالاعتمادية الذي يعمل عليه طلب البحث. ومن الأمثلة الشائعة للسمة "nodep" ";;;;;;; كيف إنّ "> شغِّل مخرجات "معلومات إصدار اللغة" وتحليلها للحصول على معلومات عن جميع السمات ""nodep" في لغة الإصدار.
العلامات: build_file_semantics
--output=<a string> التلقائي: "text;text"
التنسيق الذي يجب طباعة نتائج طلب البحث به. القيم المسموح بها لطلب البحث هي: text وtextproto وproto وjsonproto.
العلامات: terminal_output
--[no]proto:default_values التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، يتم تضمين السمات التي لم يتم تحديد قيمتها صراحةً في ملف BUILD، وإلا سيتم حذفها. ينطبق هذا الخيار على --output=proto
العلامات: terminal_output
--[no]proto:definition_stack التلقائي: "false;quot;
تعبئة حقل pro_stack Proto الذي يسجّل كل مثيل القاعدة لحزمة استدعاء Starlark في الوقت الذي يتم فيه تحديد فئة القاعدة.
العلامات: terminal_output
--[no]proto:flatten_selects التلقائي: "true;true"
في حال تفعيل هذا الإعداد، يتم استنساخ السمات القابلة للضبط التي تم إنشاؤها من خلال Select(). بالنسبة إلى أنواع القوائم، يمثّل التمثيل مسطّحًا قائمة تتضمّن كل قيمة للخريطة المحدّدة مرة واحدة فقط. يتم تحويل أنواع الكميات إلى عناصر فارغة.
العلامات: build_file_semantics
--[no]proto:include_synthetic_attribute_hash التلقائي: "false;quot;
يمكنك حساب السمة $internal_attr_hash تعبئتها أو لا.
العلامات: terminal_output
--[no]proto:instantiation_stack التلقائي: "false;quot;
تعبئة حزمة استدعاء مثيل كل قاعدة. يُرجى العلم أنّ ذلك يتطلّب توفّر الحزمة
العلامات: terminal_output
--[no]proto:locations التلقائي: "true;true"
تحديد ما إذا كان سيتم إخراج معلومات الموقع الجغرافي في وضع Proto تمامًا.
العلامات: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> التلقائي: "all"
قائمة سمات مفصولة بفواصل لتضمينها. ويتم إعداد كل السمات تلقائيًا. اضبط على سلسلة فارغة لإخراج أي سمة. ينطبق هذا الخيار على --output=proto.
العلامات: terminal_output
--[no]proto:rule_inputs_and_outputs التلقائي: "true;true"
تحديد ما إذا كنت تريد تعبئة حقلي base_input وrule_output
العلامات: terminal_output
--[no]relative_locations التلقائي: "false;quot;
إذا كان هذا صحيحًا، سيكون موقع ملفات BUILD في xml ومخرجات Proto نسبيًا. وفقًا للإعدادات التلقائية، تكون بيانات الموقع الجغرافي مسارًا مطلقًا ولن تكون متسقة على جميع الأجهزة. ويمكنك ضبط هذا الخيار على "صحيح" للحصول على نتيجة متسقة على جميع الأجهزة.
العلامات: terminal_output
--[no]skyframe_state التلقائي: "false;quot;
بدون إجراء تحليل إضافي، يمكنك تفريغ الرسم البياني الحالي للإجراء من Skyframe. ملاحظة: تحديد هدف باستخدام -skyframe_state غير متاح حاليًا. لا تتوفر هذه العلامة إلا مع -output=proto أو --output=textproto.
العلامات: terminal_output
--[no]tool_deps التلقائي: "true;true"
طلب بحث: في حال إيقاف هذه الميزة، لن يتم تضمين الأهداف المتعلّقة بالاعتمادات على 'host configuration' أو 'execution'; المستهدَفة في الرسم البياني للاعتمادية الذي يعمل عليه طلب البحث. A 'host configuration';الارتباطية: مثل تلك الموجودة في أي من 'proto_library' القاعدة إلى مجمّع البروتوكول، يوجّه عادةً إلى أداة تم تنفيذها أثناء الإصدار بدلاً من جزء من نفس البرنامج #&39;target' طلب البحث: في حال الإيقاف، يتم استبعاد جميع الأهداف التي تم ضبطها والتي من خلال نقل مضيف أو تنفيذ من الاستهداف من المستوى الأعلى الذي اكتشف هذا الاستهداف الذي تم ضبطه. وهذا يعني أنّه إذا كان الاستهداف ذو المستوى الأعلى في إعدادات الاستهداف، لن يتم عرض سوى الأهداف التي تم ضبطها في الإعدادات المستهدفة. إذا كان هدف المستوى الأعلى في ضبط المضيف، لن يتم عرض سوى الاستهدافات التي تم ضبطها للمضيف. ولن يستبعد هذا الخيار سلاسل الأدوات التي تم حلّها.
العلامات: build_file_semantics
--universe_scope=<comma-separated list of options> التلقائي: ""
مجموعة من الأنماط المستهدفة مفصولة بفواصل (مضَافة وم طرحة). يمكن أن يتم تنفيذ طلب البحث في الكون المحدد عن طريق الإغلاق الانتقالي للأهداف المحدّدة. يُستخدَم هذا الخيار لطلبات البحث وcquery. بالنسبة إلى طلب البحث، إنّ الإدخال في هذا الخيار هو الأهداف التي تم إنشاء جميع الإجابات من خلالها، وبالتالي قد يؤثر هذا الخيار في الإعدادات وعمليات النقل. إذا لم يتم تحديد هذا الخيار، يتم افتراض أنّ أهداف المستوى الأعلى هي الأهداف التي تم تحليلها من تعبير طلب البحث. ملاحظة: بالنسبة إلى طلب البحث، قد يؤدي عدم تحديد هذا الخيار إلى تعطُّل الإصدار إذا كانت الأهداف التي يتم تحليلها من تعبير طلب البحث غير قابلة للإنشاء باستخدام خيارات المستوى الأعلى.
العلامات: loading_and_analysis
الخيارات التي تؤدي إلى تحسينات في وقت الإصدار:
--[no]collapse_duplicate_defines التلقائي: "false;quot;
عند التفعيل، ستتم إزالة القيم المكرّرة، في مرحلة مبكرة من الإصدار. يؤدي ذلك إلى تجنُّب فقدان ذاكرة التخزين المؤقت للتحليل غير ضروري لأنواع معيّنة من الإصدارات المكافئة.
العلامات: loading_and_analysis، loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar التلقائي: "false;quot;
يمكنك فلترة ProGuard ProgramJar لإزالة أي صفوف متوفّرة أيضًا في LibraryJar.
العلامات: action_command_lines
--[no]experimental_inmemory_dotd_files التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتم تمرير ملفات C++ .d في الذاكرة مباشرةً من عُقد الإصدار البعيدة بدلاً من كتابتها على القرص.
العلامات: loading_and_analysis، execution، affects_outputs، experimental
--[no]experimental_inmemory_jdeps_files التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتم تمرير ملفات الاعتمادية (.jdeps) التي تم إنشاؤها من التجميعات Java في الذاكرة مباشرةً من عُقد الإصدار البعيدة بدلاً من كتابتها على القرص.
العلامات: loading_and_analysis، execution، affects_outputs، experimental
--[no]experimental_objc_include_scanning التلقائي: "false;quot;
تحديد ما إذا كان مطلوبًا إجراء عملية فحص لتحقيق الهدف C/C++ .
العلامات: loading_and_analysis وexecution وchanges_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found التلقائي: "false;quot;
في حال تفعيل هذه الميزة، لا تنشئ ميزة pars_headers إجراء تجميع منفصل للرؤوس في حال العثور على مصدر يحمل الاسم الأساسي نفسه في الهدف نفسه.
العلامات: loading_and_analysis، affects_outputs
--[no]experimental_retain_test_configuration_across_testonly التلقائي: "false;quot;
عند تفعيل هذا الإعداد، لن يؤدي هذا إلى قطع إعداد الاختبار للقواعد التي تم وضع علامة testonly=1 عليها. تهدف هذه السياسة إلى الحدّ من مشاكل تعارض الإجراء عندما تعتمد القواعد غير التجريبية على قواعد cc_test. لا يتم تطبيق أي تأثير إذا كان --trim_test_configuration خطأ.
العلامات: loading_and_analysis، loses_incremental_state
--[no]experimental_starlark_cc_import التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يمكن استخدام إصدار Starlark من cc_import.
العلامات: loading_and_analysis، experimental
--[no]experimental_unsupported_and_brittle_include_scanning التلقائي: "false;quot;
تحديد ما إذا كان يمكن تضييق نطاق المدخلات إلى تجميع C/C++ عن طريق تحليل #include أسطر من ملفات الإدخال يمكن أن يؤدي ذلك إلى تحسين الأداء والتزايد عن طريق تقليل حجم أشجار الإدخال المجمّعة. ويمكن أيضًا أن يؤدي ذلك إلى إيقاف الإصدارات لأنّ الماسح الضوئي الذي يتضمّن تلك الأداة لا ينفّذ دلالات المعالج الأولي C بالكامل. وعلى وجه الخصوص، لا يفهم توجيهات #include الديناميكية ويتجاهل المنطق الشرطي المُسبق للمعالج. لذلك استخدمها على مسؤوليتك الشخصية. سيتم إغلاق أي مشاكل متعلقة بهذه العلامة التي تم تقديمها.
العلامات: loading_and_analysis، execution، changes_inputs
--[no]incremental_dexing التلقائي: "true;true"
يمكن تنفيذ معظم مهام العمل على سطح المكتب بشكل منفصل لكل ملف Jar.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--[no]objc_use_dotd_pruning التلقائي: "true;true"
في حال تم ضبط هذه السياسة، سيتم استخدام الملفات بالامتداد .d المنبّهة من قِبل المصدر.
العلامات: changes_inputs، loading_and_analysis
--[no]process_headers_in_dependencies التلقائي: "false;quot;
عند إنشاء هدف //a:a، تتم معالجة العناوين في جميع الأهداف التي //a:a تعتمد عليها (إذا تم تفعيل معالجة العناوين لسلسلة الأدوات).
العلامات: execution
--[no]trim_test_configuration التلقائي: "true;true"
عندما يكون الخيار مفعّلاً، سيتم محو الخيارات المتعلّقة بالاختبار تحت المستوى الأعلى من الإصدار. عندما تكون هذه العلامة نشطة، لا يمكن إنشاء الاختبارات كاعتماديات على القواعد غير التجريبية، ولكن التغييرات على الخيارات ذات الصلة بالاختبار لن تؤدي إلى إعادة تحليل القواعد غير التجريبية.
العلامات: loading_and_analysis، loses_incremental_state
--[no]use_singlejar_apkbuilder التلقائي: "true;true"
تم إيقاف هذا الخيار. وهو الآن غير متاح وستتم إزالته قريبًا.
العلامات: loading_and_analysis
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> التلقائي: "-;*"
يمكنك طباعة معلومات تصحيح الأخطاء أثناء حل سلسلة الأدوات. تستخدِم العلامة تعبيرًا عاديًا يتم التحقّق منه في أنواع سلاسل الأدوات والأهداف المحدّدة لمعرفة الأخطاء التي سيتم تصحيحها. قد يتم فصل التعبيرات المتعددة بفواصل، ثم يتم التحقق من كل regex بشكل منفصل. ملاحظة: نتيجة هذه العلامة معقّدة جدًا ومن المرجّح أن تكون مفيدة فقط للخبراء الذين يمكنهم حلّ سلسلة الأدوات.
العلامات: terminal_output
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
تراكم --flag_alias=<a 'name=value' flag alias> استخدامات متعددة
باستخدام اسم مختلَف لعلامة Starlark ويتم استخدام زوج واحد من المفاتيح والقيم في النموذج "<key>ISBNlt;value>" كوسيطة.
العلامات: changes_inputs
--[no]incompatible_default_to_explicit_init_py التلقائي: "false;quot;
تُغيّر هذه العلامة السلوك التلقائي بحيث لا يتم إنشاء ملفات __init__.py تلقائيًا في ملفات تنفيذ أهداف Python. وبشكل خاص، عندما يتم ضبط هدف py_binary أو py_test على قديمة_create_init إلى "quot;auto;quot; (الإعداد التلقائي)، يتم التعامل معه على أنه خطأ في حال ضبط هذه العلامة فقط. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/10076.
العلامات: affects_outputs، incompatible_change
--[no]incompatible_py2_outputs_are_suffixed التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، ستظهر الأهداف المُنشَأة في إعدادات Python 2 ضمن جذر ناتج يتضمّن اللاحقة '-py2&#39، بينما ستظهر الأهداف المُنشَأة في Python 3 في جذر لا يتضمّن لاحقة Python. وهذا يعني أنّ الرمز المميّز المريح لـ "bazel-bin" سيشير إلى استهدافات Python 3 بدلاً من Python 2. في حال تفعيل هذا الخيار، ننصحك أيضًا بتفعيل `--incompatible_py3_is_default`.
العلامات: affects_outputs وincompatible_change
--[no]incompatible_py3_is_default التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، سيتم تلقائيًا ضبط السياستَين "py_binary" و"py_test` التي لم يتم ضبطهما على "python_version" (أو "default_python_version") في PY3 بدلاً من PY2. في حال ضبط هذه العلامة، ننصحك أيضًا بضبط `--incompatible_py2_outputs_are_suffixed`.
العلامات: loading_and_analysis وaffects_outputs وincompatible_change
--[no]incompatible_use_python_toolchains التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، فإنّ قواعد Python الأصلية القابلة للتنفيذ ستستخدم وقت تشغيل Python الذي تحدّده سلسلة أدوات Python، بدلاً من وقت التشغيل الذي تحدّده العلامات القديمة مثل --python_top.
العلامات: loading_and_analysis، incompatible_change
--python_version=<PY2 or PY3> التلقائي: عرض الوصف
وضع الإصدار الرئيسي في Python، إما "PY2" أو "PY3"، ويُرجى العلم بأنّه يتم إلغاء هذا الإعداد باستخدام هدفَي "py_binary" و"py_test` (حتى إذا لم يحدّدا إصدارًا صريحًا)، لذلك ليس هناك عادةً سبب كافٍ لتوفير هذه العلامة.
العلامات: loading_and_analysis، affects_outputs، explicit_in_output_path
خيارات متنوعة، غير مصنّفة بطريقة أخرى:
--[no]cache_test_results [-t] التلقائية: "auto;quot;
في حال ضبط الإعدادات على 'auto'، يُعيد Bazel إجراء الاختبار في الحالات التالية فقط: (1) اكتشاف Bazel للتغييرات في الاختبار أو تبعياته، أو (2) وضع علامة على الاختبار بأنه خارجي، أو (3) طلب تنفيذ عدة اختبارات باستخدام --runs_per_test أو(4) تعذّر الاختبار في السابق. في حال ضبط الإعدادات على 'yes'، يخزِّن Bazel جميع نتائج الاختبار مؤقتًا باستثناء الاختبارات التي تم وضع علامة عليها باعتبارها خارجية. في حال ضبط الإعدادات على 'no'، لا يخزّن Bazel أي نتائج اختبار في ذاكرة التخزين المؤقت.
--[no]experimental_cancel_concurrent_tests التلقائي: "false;quot;
في حال كان هذا صحيحًا، ستلغي"بليز"الاختبارات بشكلٍ متزامن في أول عملية تشغيل ناجحة. ويكون هذا مفيدًا فقط جنبًا إلى جنب مع --runs_per_test_detects_flakes.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs التلقائي: "false;quot;
في حال اختيار قيم صحيحة، تجلب Bazel دليل بيانات التغطية بالكامل لكل اختبار أثناء إجراء التغطية.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_generate_llvm_lcov التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، ستتولّى تغطية النقرة الاجتماعية إنشاء تقرير LCOV.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_j2objc_header_map التلقائي: "true;true"
تحديد ما إذا كنت تريد إنشاء خريطة عنوان J2OBjC بالتوازي مع تحويل J2ObjC.
--[no]experimental_j2objc_shorter_header_path التلقائي: "false;quot;
تحديد ما إذا كان سيتم الإنشاء باستخدام مسار عنوان أقصر (يستخدِم "quot;_ios" بدلاً من &&;;j2objc")
العلامات: affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel> التلقائي: "javabuilder"
تفعيل مسارات تحليل منخفضة لتركيبات Java.
--[no]experimental_limit_android_lint_to_android_constrained_java التلقائي: "false;quot;
التقييد --experimental_run_android_lint_on_java_rules للمكتبات المتوافقة مع Android.
العلامات: affects_outputs
--[no]experimental_run_android_lint_on_java_rules التلقائي: "false;quot;
التحقق من صحة مصادر java_*.
العلامات: affects_outputs
--[no]explicit_java_test_deps التلقائي: "false;quot;
يمكنك تحديد الاعتمادية صراحةً على JUnit أو Hamcrest في اختبار java_test بدلاً من الحصول عليها عن طريق الخطأ من TestRunner's. لا تعمل هذه الخدمة حاليًا إلا مع البازلاء.
--host_java_launcher=<a build target label> التلقائي: عرض الوصف
مشغِّل Java الذي تستخدمه الأدوات التي يتم تنفيذها أثناء عملية الإنشاء.
تراكم --host_javacopt=<a string> استخدامات متعددة
خيارات إضافية للانتقال إلى JavaScript عند تصميم الأدوات التي يتم تنفيذها أثناء إنشاء الإضافة.
تراكم --host_jvmopt=<a string> استخدامات متعددة
خيارات إضافية لتمريرها إلى جهاز افتراضي جافا (VM) عند إنشاء الأدوات التي يتم تنفيذها أثناء الإصدار. ستتم إضافة هذه الخيارات إلى خيارات بدء تشغيل الجهاز الافتراضي (VM) لكل هدف java_binary.
--[no]incompatible_exclusive_test_sandboxed التلقائي: "false;quot;
في حال كان هذا صحيحًا، سيتم إجراء الاختبارات الحصرية باستخدام استراتيجية وضع الحماية. أضِف 'local'Tag لفرض إجراء اختبار حصري محليًا
العلامات: incompatible_change
--[no]incompatible_strict_action_env التلقائي: "false;quot;
إذا كان الأمر كذلك، سيستخدم Bazel بيئة بقيمة ثابتة PATH ولا يكتسب LD_LIBRARY_PATH. استخدم --action_env=ENV_VARIABLE إذا كنت تريد اكتساب متغيرات بيئة معينة من العميل، ولكن لاحظ أن ذلك يمكن أن يؤدي إلى منع التخزين المؤقت بين المستخدمين في حال استخدام ذاكرة تخزين مؤقت مشتركة.
العلامات: loading_and_analysis، incompatible_change
تراكم --j2objc_translation_flags=<comma-separated list of options> استخدامات متعددة
خيارات إضافية للانتقال إلى أداة J2OBjC.
--java_debug
تسبّب هذه الأداة الجهاز الافتراضي لاختبار Java في اختبار لغة JavaScript في انتظار الاتصال بالإنترنت من برنامج تصحيح الأخطاء المتوافق مع JDWP (مثل jdb)، قبل بدء الاختبار. تضمين -test_output=streamed.
التوسيع إلى:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps التلقائي: "true;true"
يمكنك إنشاء معلومات الاعتمادية (في الوقت الحالي، مسار الصف وقت التجميع) لكل هدف Java.
--[no]java_header_compilation التلقائي: "true;true"
اجمَع الملفات من المصدر مباشرةً.
--java_language_version=<a string> التلقائي: "8;quot;
إصدار لغة Java
--java_launcher=<a build target label> التلقائي: عرض الوصف
مشغّل Java للاستخدام عند إنشاء برامج ثنائية Java. إذا تم ضبط هذه العلامة على السلسلة الفارغة، سيتم استخدام مشغّل تطبيقات JDK. تلغي السمة "مشغّل التطبيقات"علامة التبويب هذه العلامة.
--java_runtime_version=<a string> التلقائي: "local;local_jdk"
إصدار وقت تشغيل Java
تراكم --javacopt=<a string> استخدامات متعددة
خيارات إضافية للانتقال إلى JavaScript.
تراكم --jvmopt=<a string> استخدامات متعددة
خيارات إضافية لتمريرها إلى جهاز افتراضي يعمل بنظام التشغيل Java. ستتم إضافة هذه الخيارات إلى خيارات بدء تشغيل الجهاز الافتراضي (VM) لكل هدف java_binary.
--legacy_main_dex_list_generator=<a build target label> التلقائي: عرض الوصف
يحدد برنامجًا ثنائيًا لاستخدامه لإنشاء قائمة بالفئات التي يجب أن تكون في المجموعة الرئيسية عند تجميع الشاشات المتعددة القديمة.
تراكم --plugin=<a build target label> استخدامات متعددة
المكوّنات الإضافية المراد استخدامها في الإصدار تعمل حاليًا مع java_plugin.
--proguard_top=<a build target label> التلقائي: عرض الوصف
يحدد إصدار ProGuard الذي يتم استخدامه لإزالة الرمز عند إنشاء برنامج ثنائي بلغة Java.
--proto_compiler=<a build target label> التلقائي: "@bazel_tools//tools/proto:protoc"
تصنيف مجمِّع النماذج الأولية
العلامات: affects_outputs، loading_and_analysis
--proto_toolchain_for_cc=<a build target label> التلقائي: "@bazel_tools//tools/proto:cc_toolchain"
تصنيف proto_lang_toolchain() الذي يصف طريقة تجميع Cpro+ protos
العلامات: affects_outputs وloading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> التلقائي: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"
يمكنك تصنيف proto_lang_toolchain() التي توضّح كيفية تجميع j2objc protos
العلامات: affects_outputs وloading_and_analysis
--proto_toolchain_for_java=<a build target label> التلقائي: "@bazel_tools//tools/proto:java_toolchain"
التصنيف "proto_lang_toolchain()" الذي يصف طريقة تجميع بيانات Java protos
العلامات: affects_outputs وloading_and_analysis
--proto_toolchain_for_javalite=<a build target label> التلقائي: "@bazel_tools//tools/proto:javalite_toolchain"
تصنيف proto_lang_toolchain() الذي يصف طريقة تجميع بيانات JavaLite Protos
العلامات: affects_outputs وloading_and_analysis
تراكم --protocopt=<a string> استخدامات متعددة
خيارات إضافية يمكن تمريرها إلى برنامج الترميز Protobuf.
العلامات: affects_outputs
--[no]runs_per_test_detects_flakes التلقائي: "false;quot;
في حال كان هذا صحيحًا، فإن أي جزء يتم فيه اجتياز عملية تشغيل/محاولة واحدة على الأقل وتعذّر تشغيل/محاولة واحدة على الأقل يحصل على حالة FLAKY.
--shell_executable=<a path> التلقائي: عرض الوصف
مسار مطلق إلى واجهة المستخدم التنفيذية التي سيستخدِمها Bazel. إذا لم يتم ضبط هذا الإعداد، ولكن تم ضبط متغيّر البيئة BAZEL_SH عند استدعاء Bazel الأول (بدء تشغيل خادم Bazel)، سيستخدم Bazel ذلك. إذا لم يتم ضبط أي من الإعدادين، سيستخدم Bazel مسارًا تلقائيًا ثابتًا وفقًا لنظام التشغيل على (Windows: c:/tools/msys64/usr/bin/bash.exe أو FreeBSD: /usr/local/bin/bash (جميع الأجهزة الأخرى: /bin/bash). تجدر الإشارة إلى أن استخدام واجهة غير متوافقة مع bash قد يؤدي إلى حدوث حالات إخفاق أو إخفاق في وقت التشغيل في البرامج الثنائية التي تم إنشاؤها.
العلامات: loading_and_analysis
تراكم --test_arg=<a string> استخدامات متعددة
يحدد الخيارات الإضافية والوسيطات التي يجب تمريرها إلى الملف التنفيذي للاختبار. يمكن استخدامها عدة مرات لتحديد وسيطات متعددة. وفي حال تنفيذ اختبارات متعددة، سيتلقّى كل اختبار منها وسيطات متطابقة. لا يتم استخدامه إلا باستخدام الأمر 'bazel test'.
--test_filter=<a string> التلقائي: عرض الوصف
يحدد هذا الإعداد فلتر لإعادة التوجيه إلى إطار عمل الاختبار. يُستخدم للحد من إجراء الاختبارات. لاحظ أن هذا لا يؤثر في الأهداف التي يتم إنشاؤها.
--test_result_expiration=<an integer> التلقائي: "-1"
تم إيقاف هذا الخيار وليس له أي تأثير.
--[no]test_runner_fail_fast التلقائي: "false;quot;
تتعذّر إعادة توجيه الخيار السريع إلى المشاركين في الاختبار. من المفترض أن يتوقف إجراء الاختبار عن العمل عند الفشل الأول.
--test_sharding_strategy=<explicit or disabled> التلقائي: "explicit"
حدِّد استراتيجية تجزئة الاختبار: 'explicit' لاستخدام التجزئة فقط في حال توفر السمة 'shard_count' BUILD. 'disabled' عدم استخدام تجزئة الاختبار مطلقًا.
--tool_java_language_version=<a string> التلقائي: "8;quot;
إصدار لغة Java المُستخدَمة لتنفيذ الأدوات اللازمة أثناء عملية الإنشاء
--tool_java_runtime_version=<a string> التلقائي: "remotejdk_11"
إصدار وقت تشغيل جافا المستخدم لتنفيذ الأدوات أثناء الإصدار
--[no]use_ijars التلقائي: "true;true"
في حال تفعيل هذا الإعداد، يؤدي التجميع عند تشغيل Java إلى استخدام جرارات للواجهة. وسيؤدي ذلك إلى تجميع البيانات بشكل أسرع، ولكن يمكن أن تختلف رسائل الخطأ.

خيارات الإصدار

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتحكّم في تنفيذ الإصدار:
--[no]check_up_to_date التلقائي: "false;quot;
يجب عدم تنفيذ عملية الإنشاء، وما عليك سوى التأكّد من أنّها حديثة. إذا كانت جميع الاستهدافات حديثة، تكتمل عملية الإنشاء بنجاح. وإذا كان يلزم تنفيذ أي خطوة، يتم الإبلاغ عن خطأ وتعذّر إتمام عملية الإصدار.
العلامات: execution
--dynamic_local_execution_delay=<an integer> التلقائي: "1000"
كم عدد الملي ثانية التي يجب تأخيرها خلال التنفيذ المحلي، إذا كان التنفيذ عن بُعد أسرع أثناء الإصدار مرة واحدة على الأقل؟
العلامات: execution، host_machine_resource_optimizations
تراكم --dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment> استخدامات متعددة
للاستراتيجيات المحلية، يجب استخدام طريقة الذاكرة المحدّدة. جارٍ تمرير 'local&#39؛ حيث يُجري الذاكرة المساعِدة الإعداد التلقائي لتذكيرات الذاكرة غير المحدَّدة. يتخذ [mnemonic=]local_strategy[,local_strategy،...]
العلامات: execution، host_machine_resource_optimizations
تراكم --dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment> استخدامات متعددة
الاستراتيجيات البعيدة لاستخدامها في عملية الذاكرة المحدّدة. جارٍ تمرير 'remote' نظرًا لأن الاختصار يساعد في ضبط التذكير التلقائي على الذاكرة غير المحدَّدة. يتخذ [mnemonic=]remote_strategy[,remote_strategy،...]
العلامات: execution، host_machine_resource_optimizations
--experimental_docker_image=<a string> التلقائي: ""
حدِّد اسم صورة الإرساء (مثل &"ubuntu:latest") التي يجب استخدامها لتنفيذ إجراء في وضع الحماية عند استخدام استراتيجية الإرساء، ولا يحتوي الإجراء نفسه مسبقًا على سمة صورة حاوية في خصائص Remote_execution_ انقر في وصف النظام الأساسي. يتم تمرير قيمة هذه العلامة حرفيًا إلى 'doker run'، وبالتالي فهي تتوافق مع البنية والآليات نفسها التي تستخدمها دالة الإرساء نفسها.
العلامات: execution
--[no]experimental_docker_use_customized_images التلقائي: "true;true"
في حال تفعيل هذا الإعداد، أدخِل المعرّف الفريد للمستخدم والمعرّف الحالي في صورة أداة الإرساء قبل استخدامه. ويكون هذا مطلوبًا إذا كانت الإصدارات أو الإصدارات التي تعتمدها تستند إلى اسم المستخدم والدليل الرئيسي داخل الحاوية. تكون هذه الميزة مفعّلة تلقائيًا، ولكن يمكنك إيقافها في حال لم تعمل ميزة تخصيص الصور تلقائيًا أو إذا كنت على دراية بأنّك لست بحاجة إليها.
العلامات: execution
--[no]experimental_dynamic_exclude_tools التلقائي: "true;true"
عند الإعداد، لا تخضع الاستهدافات التي يتم إنشاؤها &للأداة&quot، للتنفيذ الديناميكي. ومن غير المرجّح أن يتم إنشاء مثل هذه الأهداف بشكل تدريجي، وبالتالي لا تستحق إنفاق الدورات المحلية عليها.
العلامات: execution، host_machine_resource_optimizations
--experimental_dynamic_local_load_factor=<a double> التلقائي: "0"
تتحكّم في مقدار التحميل من التنفيذ الديناميكي الذي يتم وضعه على الجهاز المحلي. تعدّل هذه العلامة عدد الإجراءات في التنفيذ الديناميكي التي ستتم جدولتها بشكل متزامن. وهو يعتمد على عدد وحدات المعالجة المركزية (CPU) التي يسمح بها Blaze، والتي يمكن التحكّم فيها من خلال علامة --local_cpu_resources. إذا كانت هذه العلامة 0، تتم جدولة جميع الإجراءات محليًا على الفور. إذا كانت > 0، تكون قيمة الإجراءات المُجدوَلة محليًا محدودة بعدد وحدات المعالجة المركزية (CPU) المتاحة. إذا كانت قيمة الإجراء < 1، تُستخدم عامل التحميل لتقليل عدد الإجراءات المُجدوَلة محليًا عندما يكون عدد الإجراءات التي تنتظر الجدول مرتفعًا. ويؤدي ذلك إلى خفض الحمل على الجهاز المحلي في حالة الإصدار النظيف، حيث لا تساهم الجهاز المحلي كثيرًا.
العلامات: execution، host_machine_resource_optimizations
--experimental_dynamic_slow_remote_time=<An immutable length of time.> التلقائي: "0"
في حال استخدام >0، يجب تنفيذ مدة تنفيذ الإجراء ديناميكيًا فقط عن بُعد قبل أن نعطي الأولوية لتنفيذه محليًا لتجنُّب المهلات البعيدة. قد يؤدي ذلك إلى إخفاء بعض المشاكل على نظام التنفيذ عن بُعد. يُرجى عدم تفعيل هذه الميزة بدون رصد مشاكل التنفيذ عن بُعد.
العلامات: execution، host_machine_resource_optimizations
--[no]experimental_enable_docker_sandbox التلقائي: "false;quot;
تفعيل وضع الحماية المستند إلى شريط الإرساء لن يكون لهذا الخيار أي تأثير في حال عدم تثبيت الإرساء.
العلامات: execution
--experimental_persistent_javac
تفعيل برنامج تحويل لغة البرمجة Java المستمر والتجريبي.
توسيع نطاق العرض ليشمل:
--strategy=Javac=worker
--strategy=JavaIjar=local
--strategy=JavaDeployJar=local
--strategy=JavaSourceJar=local
--strategy=Turbine=local

العلامات: execution وhost_machine_resource_optimizations
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> التلقائي: "0"
إذا كانت القيمة 0، يمكنك حذف أشجار وضع الحماية فور اكتمال الإجراء (مما يتسبب في تأخير اكتمال الإجراء). إذا كانت القيمة أكبر من الصفر، يمكنك تنفيذ حذف مثل هذه الخيارات الثلاثة من خلال مجموعة سلاسل محادثات غير متزامنة بحجم 1 عندما يكون الإصدار قيد التشغيل ويزيد إلى الحجم المحدّد من خلال هذه العلامة عندما يكون الخادم في وضع عدم النشاط.
العلامات: host_machine_resource_optimizations، execution
--experimental_sandboxfs_path=<a string> التلقائي: "sandboxfs"
المسار إلى البرنامج الثنائي Sandboxfs الذي يتم استخدامه عندما تكون --experimental_use_sandboxfs صحيحة. إذا كان اسمًا بسيطًا، استخدِم أول برنامج ثنائي له ذلك الاسم في Path.
العلامات: host_machine_resource_optimizations، execution
--[no]experimental_split_xml_generation التلقائي: "true;true"
في حال تم ضبط هذه العلامة، ولم يؤدي إجراء اختبار إلى إنشاء ملف test.xml، سيستخدِم Bazel إجراءً منفصلاً لإنشاء ملف testm.xml الافتراضي الذي يحتوي على سجلّ الاختبار. وبخلاف ذلك، ينشئ Bazel ملف test.xml كجزء من إجراء الاختبار.
العلامات: execution
--experimental_total_worker_memory_limit_mb=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.> التلقائي: "0"
إذا كان هذا الحدّ الأقصى أكبر من الصفر، قد يتم قتل إذا تجاوز إجمالي استخدام الذاكرة لجميع العاملين الحدّ الأقصى.
العلامات: execution، host_machine_resource_optimizations
--[no]experimental_use_hermetic_linux_sandbox التلقائي: "false;quot;
في حال تم ضبط هذه السياسة على"صحيح"، لا تثبِّت جذرًا، بل يمكنك تثبيت ما تم توفيره باستخدام sandbox_add_mount_pair فقط. سيتم ربط ملفات الإدخال بوضع الحماية نهائيًا بدلاً من ربطها بشكل عشوائي من وضع الحماية. إذا كانت ملفات إدخال الإجراءات موجودة على نظام ملفات مختلف عن وضع الحماية، سيتم نسخ ملفات الإدخال بدلاً من ذلك.
العلامات: execution
--[no]experimental_use_sandboxfs التلقائي: "false;quot;
يمكنك استخدام Sandboxf لإنشاء الإجراءات' وتنفيذ الأدلة بدلاً من إنشاء شجرة الرموز الرمزية. إذا كانت المعلّمة "yes";;، يجب أن يكون البرنامج الثنائي الذي تقدّمه --experimental_sandboxfs_path صالحًا ومتوافقًا مع إصدار متوافق من Sandboxfs. إذا كانت &&;;quot;auto" قد لا تكون البرنامج الثنائي مفقودة أو غير متوافقة.
العلامات: host_machine_resource_optimizations، execution
--[no]experimental_use_windows_sandbox التلقائي: "false;quot;
استخدام وضع الحماية في نظام التشغيل Windows لتنفيذ الإجراءات. إذا كانت المعلّمة "yes;quot"، يجب أن يكون البرنامج الثنائي الذي توفّره --experimental_windows_sandbox_path صالحًا وأن يتوافق مع إصدار متوافق من Sandboxfs. إذا كانت &&;;quot;auto" قد لا تكون البرنامج الثنائي مفقودة أو غير متوافقة.
--experimental_windows_sandbox_path=<a string> التلقائي: "BazelSandbox.exe"
المسار إلى البرنامج الثنائي لوضع الحماية في نظام التشغيل Windows لاستخدامه عند ضبط --experimental_use_windows_sandbox. إذا كان اسمًا بسيطًا، استخدِم أول برنامج ثنائي له ذلك الاسم في Path.
--[no]experimental_worker_as_resource التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يتم اكتساب العاملين كموارد من ResourceManager.
العلامات: execution، host_machine_resource_optimizations
--[no]experimental_worker_cancellation التلقائي: "false;quot;
في حال تفعيل الإعداد، قد يرسل Bazel طلبات إلغاء إلى العاملين الذين يقدّمون الدعم.
العلامات: execution
--[no]experimental_worker_multiplex التلقائي: "true;true"
في حال تفعيل هذه الميزة، سيستخدم العاملون الذين يدعمون ميزة مضاعفة الإرسال التجريبية هذه الميزة.
العلامات: execution، host_machine_resource_optimizations
--[no]experimental_worker_multiplex_sandboxing التلقائي: "false;quot;
في حال تفعيل هذه السياسة، سيتم استخدام وضع الحماية المتعدد في وضع الحماية، وذلك باستخدام دليل وضع الحماية منفصل لكل طلب عمل. ولن يظهر في وضع الحماية سوى العاملين الذين لديهم &'supports-multix-sandboxing' متطلبات التنفيذ.
العلامات: execution
--[no]experimental_worker_strict_flagfiles التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، ستؤدي وسيطات الإجراءات للعاملين الذين لا يتبعون مواصفات العامل إلى حدوث خطأ. يجب أن تحتوي وسيطات العمل على وسيطة @flagfile واحدة تمامًا مثل آخر قائمة وسيطات لها.
العلامات: execution
--genrule_strategy=<comma-separated list of options> التلقائي: ""
حدِّد كيفية تنفيذ القواعد العامة. سيتم إيقاف هذه العلامة تدريجيًا. وبدلاً من ذلك، استخدِم --spawn_strategyportraitlt;value> للتحكّم في جميع الإجراءات أو للتحكّم في --strategy=Genruledmcalt;value> للتحكّم في القواعد الجينية فقط.
العلامات: execution
تراكم --high_priority_workers=<a string> استخدامات متعددة
استراتيجية تشغيل العاملين بأولوية عالية. عندما يتم تشغيل العاملين ذوي الأولوية العالية، يتم تقييد جميع العاملين الآخرين.
العلامات: execution
في حال ضبط هذه السياسة على "صحيح" و"-compatible_remote_symlinks" أيضًا، يُسمح باستخدام الروابط الرمزية في مخرجات الإجراء.
العلامات: execution، incompatible_change
في حال ضبط هذه السياسة على "صحيح"، سيمثّل Bazel الروابط الرمزية في مخرجات الإجراءات في بروتوكول التنفيذ/التخزين المؤقت عن بُعد. بخلاف ذلك، سيتم تتبُّع الروابط الرمزية لتمثيلها أو تمثيلها كملفات أو أدلة. راجِع #6631 لمزيد من التفاصيل.
العلامات: execution، incompatible_change
--[no]incompatible_sandbox_hermetic_tmp التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، سيتم تثبيت دليل فارغ مخصّص لكل نظام تشغيل في نظام التشغيل Linux، على أنّه .tmp بدلاً من مشاركته /tmp مع نظام الملفات المضيف. استخدم --sandbox_add_mount_pair=/tmp للاستمرار في رؤية المضيف's /tmp في جميع وضع الحماية.
العلامات: execution
--[no]internal_spawn_scheduler التلقائي: "false;quot;
خيار نائب حتى نتمكن من معرفة ما إذا تم تفعيل أداة جدولة النضج، أم لا.
العلامات: execution، host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> [-j] التلقائية: "auto;quot;
عدد المهام المتزامنة المطلوب تنفيذها. يحصل على عدد صحيح أو كلمة رئيسية (&&;quot;auto","HOST_CPUS","HOST_RAM";) اختياريًا، تليها عملية ([-|*]< العدد>) مثل "auto", "HOST_CPUS*.5" يجب أن تتراوح القيم بين 1 و5000. وقد تتسبب القيم التي تزيد عن 2500 في حدوث مشاكل في الذاكرة. "auto"تحسب قيمة تلقائية معقولة بناءً على موارد المضيف.
العلامات: host_machine_resource_optimizations، execution
--[no]keep_going [-k] التلقائية: "false"
يُرجى المتابعة قدر الإمكان بعد حدوث خطأ. في حين أنه لا يمكن تحليل الاستهداف الذي تعذّر الاستهداف وتلك التي تعتمد عليه، يمكن إجراء متطلبات أساسية أخرى لهذه الأهداف.
العلامات: eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> التلقائي: "auto;quot;
عدد سلاسل المحادثات المتوازية المطلوب استخدامها لمرحلة التحميل/التحليل.ويتم استخدام عدد صحيح أو كلمة رئيسية ("auto", "HOST_CPUS", "HOST_RAM") متبوعةً بعملية ([-|*]< العدد>) مثل. "auto", "HOST_CPUS*.5" "auto"تعيين إعداد تلقائي معقول بناءً على موارد المضيف. يجب أن تكون 1 على الأقل.
العلامات: bazel_internal_configuration
--[no]reuse_sandbox_directories التلقائي: "false;quot;
في حال تم ضبط هذه السياسة على "صحيح"، قد تتم إعادة استخدام الأدلة التي تم استخدامها من قِبَل الموظفين بدون استخدام وضع الحماية لتجنُّب تكاليف الإعداد غير الضرورية.
العلامات: host_machine_resource_optimizations، execution
--sandbox_base=<a string> التلقائي: ""
السماح لوضع الحماية بإنشاء أدلة وضع الحماية أسفل هذا المسار. حدِّد مسارًا على tmpfs (مثل /run/shm) لتحسين الأداء كثيرًا عندما يحتوي الإصدار / الاختبارات على العديد من ملفات الإدخال. ملاحظة: يجب توفّر مساحة كافية على ذاكرة الوصول العشوائي (RAM) ومساحة خالية في ملفات tmpfs للحفاظ على المخرجات والملفات المتوسطة التي تم إنشاؤها من خلال إجراءات التشغيل.
العلامات: host_machine_resource_optimizations، execution
--[no]sandbox_explicit_pseudoterminal التلقائي: "false;quot;
تفعيل إنشاء أسماء النطاقات المستعارة صراحةً للإجراءات في وضع الحماية تتطلب بعض توزيعات نظام التشغيل Linux ضبط معرِّف المجموعة للعملية 'tty' داخل وضع الحماية حتى تعمل أسماء النطاقات المستعارة. وإذا كان هذا يتسبب في حدوث مشاكل، يمكن إيقاف هذه العلامة لتفعيل استخدام مجموعات أخرى.
العلامات: execution
تراكم --sandbox_tmpfs_path=<an absolute path> استخدامات متعددة
بالنسبة إلى الإجراءات في وضع الحماية، يمكنك تثبيت دليل فارغ وقابل للكتابة على هذا المسار المطلق (في حال تجاهله من خلال تنفيذ وضع الحماية).
العلامات: host_machine_resource_optimizations، execution
--spawn_strategy=<comma-separated list of options> التلقائي: ""
تحديد كيفية تنفيذ إجراءات التكاثر تلقائيًا. تقبل قائمة الاستراتيجيات مفصولة بفواصل من الأولوية القصوى إلى الأولوية الدنيا. وبالنسبة إلى كل إجراء، يختار Bazel الاستراتيجية ذات الأولوية القصوى التي يمكنها تنفيذ الإجراء. وتكون القيمة التلقائية هي "remote;workers,sandboxed,local". يمكنك الاطّلاع على https://blog.bazel.build/2019/06/19/list-strategy.html للحصول على التفاصيل.
العلامات: execution
تراكم --strategy=<a '[name=]value1[,..,valueN]' assignment> استخدامات متعددة
حدِّد كيفية توزيع مجموعة من الإجراءات الأخرى المتعلّقة بالتكاثر. تقبل قائمة الاستراتيجيات مفصولة بفواصل من الأولوية القصوى إلى الأولوية الدنيا. وبالنسبة إلى كل إجراء، يختار Bazel الاستراتيجية ذات الأولوية القصوى التي يمكنها تنفيذ الإجراء. وتكون القيمة التلقائية هي "remote;workers,sandboxed,local". تلغي هذه العلامة القيم التي تم ضبطها من خلال "-spawn_strategy" (و--genrule_strategy) في حال استخدامها مع الترميز Genmnonic. يمكنك الاطّلاع على https://blog.bazel.build/2019/06/19/list-strategy.html للحصول على التفاصيل.
العلامات: execution
تراكم --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> استخدامات متعددة
يمكنك إلغاء استراتيجية التكاثر التي يجب استخدامها لتنفيذ إجراءات التكاثر التي لها أوصاف تُطابق فلتر regex_حدّدًا. راجع --per_file_copt للحصول على تفاصيل حول مطابقة regex_filter. ويتم استخدام أول regex_filter يطابق الوصف. يلغي هذا الخيار العلامات الأخرى لتحديد الاستراتيجية. مثال: --strategy_regexp=//foo.*\.cc,-//foo/bar=local يعني تنفيذ الإجراءات باستخدام الاستراتيجية المحلية إذا كانت الأوصاف تُطابق //foo.*.cc. ولكنها غير //foo/bar. مثال: سيتم تشغيل --strategy_regexpdmca#39;Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed 'Compiling //foo/bar/baz' with 'local' with, but عكسs the order will run it with 'sandboxed&sandboxed&#sandbox9'sandbox.
العلامات: execution
تراكم --worker_extra_flag=<a 'name=value' assignment> استخدامات متعددة
علامات الأوامر الإضافية التي سيتم تمريرها إلى عمليات التشغيل للموظفين بالإضافة إلى -- المستند_الدائم، والتي يتم تشغيلها باستخدام الترميز (على سبيل المثال --agent_extra_flag=Javac=--debug).
العلامات: execution، host_machine_resource_optimizations
تراكم --worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> استخدامات متعددة
عدد مثيلات عملية العامل (مثل العارض البرمجي لـ Java) المستمر الذي يمكن تشغيله إذا كنت تستخدم 'agent'. يمكن تحديدها كـ [name=value] لتقديم قيمة مختلفة لكل موظف في الذاكرة. يحصل على عدد صحيح أو كلمة رئيسية (&&;quot;auto","HOST_CPUS","HOST_RAM";) اختياريًا، تليها عملية ([-|*]< العدد>) مثل "auto", "HOST_CPUS*.5" 'auto' يحسب حسابًا تلقائيًا معقولاً استنادًا إلى سعة الجهاز. "=value";
العلامات: execution، host_machine_resource_optimizations
تراكم --worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> استخدامات متعددة
عدد طلبات العمل التي قد تتلقّاها عملية اتصال بمضاعفة الطلبات بالتوازي عند استخدام استراتيجيتَي 'workers' مع --experimental_workers_multix. يمكن تحديدها كـ [name=value] لتقديم قيمة مختلفة لكل موظف في الذاكرة. يحصل على عدد صحيح أو كلمة رئيسية (&&;quot;auto","HOST_CPUS","HOST_RAM";) اختياريًا، تليها عملية ([-|*]< العدد>) مثل "auto", "HOST_CPUS*.5" 'auto' يحسب حسابًا تلقائيًا معقولاً استنادًا إلى سعة الجهاز. "=value";
العلامات: execution، host_machine_resource_optimizations
--[no]worker_quit_after_build التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يتم فصل جميع العاملين بعد إتمام عملية الإنشاء.
العلامات: execution، host_machine_resource_optimizations
--[no]worker_sandboxing التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، سيتم تنفيذ العاملين في بيئة محمية.
العلامات: execution
--[no]worker_verbose التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يطبع تطبيق الرسائل المطوَّلة عند بدء تشغيل العاملين، ويتم إيقاف التشغيل...
الخيارات التي تضبط سلسلة الأدوات المستخدَمة لتنفيذ الإجراءات:
--[no]incompatible_disable_runtimes_filegroups التلقائي: "false;quot;
عدم توافق العمل العلامات: action_command_lines وloading_and_analysis وdeprecated وincompatible_change
--[no]incompatible_dont_emit_static_libgcc التلقائي: "true;true"
عدم توافق العمل العلامات: action_command_lines وloading_and_analysis وdeprecated وincompatible_change
خيار عدم العمل:
العلامات: action_command_lines وloading_and_analysis وdeprecated وincompatible_change
الخيارات التي تتحكّم في ناتج الأمر:
--[no]build التلقائي: "true;true"
نفِّذ عملية الإنشاء، وهذا هو السلوك المعتاد. يؤدي تحديد --nobuild إلى إيقاف الإصدار قبل تنفيذ إجراءات الإصدار وعرض صفر إذا تم الانتهاء من تحميل الحزمة والتحليل بنجاح، هذا الوضع مفيد لاختبار هذه المراحل.
العلامات: execution، affects_outputs
--[no]experimental_run_validations التلقائي: "true;true"
يمكنك استخدام --run_validations بدلاً من ذلك.
العلامات: execution، affects_outputs
--[no]experimental_use_validation_aspect التلقائي: "false;quot;
تنفيذ إجراءات التحقّق باستخدام ميزة"الجانب" (التوازي مع الاختبارات)
العلامات: execution، affects_outputs
تراكم --output_groups=<comma-separated list of options> استخدامات متعددة
قائمة بأسماء مجموعات الإخراج المفصولة بفواصل، على أن يكون كلٌّ منها مسبوقًا بعلامة "+" أو "-". تتم إضافة المجموعة التي تسبقها علامة "+" إلى المجموعة التلقائية لمجموعات الإخراج، بينما تتم إزالة المجموعة التي تسبقها المجموعة "-" من المجموعة التلقائية. في حال لم تكن هناك بادئة واحدة على الأقل، يتم حذف المجموعة التلقائية لمجموعات الإخراج. على سبيل المثال، تُنشئ --output_groups=+foo,+bar اتحاد المجموعة التلقائية وfoo والشريط، بينما يلغي -- --إخراج_groups=foo، الشريط التلقائي مثل هذه المجموعة فقط foo وشريط.
العلامات: execution، affects_outputs
--[no]run_validations التلقائي: "true;true"
تنفيذ إجراءات التحقّق كجزء من الإصدار يمكنك الاطّلاع على https://bazel.build/rules/rules#validation_actions
العلامات: execution, affects_outputs
الخيارات التي تتيح للمستخدم ضبط النتائج المطلوبة، ما يؤثر في قيمتها بدلاً من ظهورها:
تراكم --aspects=<comma-separated list of options> استخدامات متعددة
قائمة جوانب مفصولة بفواصل يتم تطبيقها على الأهداف ذات المستوى الأعلى. في القائمة، إذا حدّد بعض جوانب العرض أصحاب الخصائص المطلوبة المطلوبين من خلال provider_aspect_providers، سيتم تشغيل بعض_الجانب بعد كل جانب تمت الإشارة إليه قبل ذلك في قائمة الأوجه التي يستوفي فيها مقدّمو الخدمة المُعلَن عن الإعلانات بعض جوانب العرض المطلوبة. علاوةً على ذلك، سيتم تشغيل بعض_الجوانب بعد جميع جوانبها المطلوبة التي تحدّدها السمة. وبعد ذلك، سيتوفّر لدى بعض_المواصفات إمكانية الوصول إلى قيم هذه الجوانب. <bzl-file-label>%<aspect_name> مثلاً '//tools:my_def.bzl%my_aspect', حيث 'my_aspect' هو قيمة عالية المستوى من أدوات الملفات/my_def.bzl
--bep_maximum_open_remote_upload_files=<an integer> التلقائي: "-1"
الحد الأقصى لعدد الملفات المفتوحة المسموح بها أثناء تحميل العنصر BEP.
العلامات: affects_outputs
تتحكّم هذه العلامة في كيفية إدارة الروابط الرمزية (الروابط الرمزية التي تظهر في مساحة العمل بعد الإصدار). القيم المحتملة: عادي (تلقائي): سيتم إنشاء أو حذف كل نوع من الروابط الرمزية، كما هو محدد في الإصدار. نظيفة: سيتم حذف جميع الروابط الرمزية بدون شروط. تجاهل: سيتم ترك الروابط الرمزية بشكل منفرد. log_only: أنشئ رسائل السجلّ كما لو كانت 'normal' تم اجتيازها، ولكنها لا تُنفّذ أي عمليات لنظام الملفات (مفيدة للأدوات). تجدر الإشارة إلى أنه يمكن تأثُّر الروابط الرمزية فقط التي يتم إنشاء أسمائها من خلال القيمة الحالية "--symlink_prefix". وفي حال تغيير البادئة، سيتم ترك أي روابط رمزية موجودة مسبقًا بمفردها.
العلامات: affects_outputs
تتحكّم هذه العلامة في ما إذا كنّا سننشر حدث eventحدث ConconfienceSymlinksIdentities إلى BuildEventProtocol أم لا. وفي حال كانت القيمة صحيحة، سيتضمّن BuildEventProtocol إدخالاً لـSMSymlinksIdentified مع إدراج جميع رموز تسهيل الاستخدام التي تم إنشاؤها في مساحة العمل. وعند ضبط السياسة على "خطأ"، لن يُتاح الإدخال EnterSymlinksIdentified في BuildEventProtocol.
العلامات: affects_outputs
تراكم --experimental_multi_cpu=<comma-separated list of options> استخدامات متعددة
تم إيقاف العمل به. No-op.
العلامات: affects_outputs، experimental
--remote_download_minimal
عدم تنزيل أي نتائج إخراج عن بُعد إلى الجهاز المحلي. هذه العلامة عبارة عن اختصار لثلاثة علامات: --experimental_inmemory_jdeps_files، --experimental_inmemory_dotd_files و --remote_download_outputs=minimal.
التوسيع إلى:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=minimal

العلامات: affects_outputs
--remote_download_outputs=<all, minimal or toplevel> التلقائي: "all"
في حال ضبط السياسة على 'minimal' ولا يتم تنزيل أي مخرجات إصدار عن بُعد إلى الجهاز المحلي، باستثناء تلك التي تتطلّبها الإجراءات المحلية. في حال الضبط على 'toplevel' يتصرف مثل'minimal&#39؛ إلا أنه يؤدي أيضًا إلى تنزيل مخرجات أهداف المستوى الأعلى إلى الجهاز المحلي. يمكن أن يقلل كلا الخيارين من أوقات الإصدار إذا كانت هناك قيود على معدل نقل البيانات للشبكة.
العلامات: affects_outputs
بدلاً من تنزيل مخرجات الإصدار عن بُعد إلى الجهاز المحلي، يمكنك إنشاء روابط رمزية. يمكن تحديد هدف الروابط الرمزية في شكل سلسلة نموذج. قد تحتوي سلسلة النموذج هذه على {hash} و{size_ وحدات البايت} التي يتم توسيعها إلى تجزئة العنصر والحجم بالبايت، على التوالي. ويمكن أن تشير هذه الروابط الرمزية مثلاً إلى نظام ملفات FUSE الذي يحمِّل عناصر من CAS عند الطلب.
العلامات: affects_outputs
--remote_download_toplevel
يتم تنزيل النتائج عن بُعد لأهداف المستوى الأعلى على الجهاز المحلي فقط. هذه العلامة عبارة عن اختصار لثلاثة علامات: --experimental_inmemory_jdeps_files، --experimental_inmemory_dotd_files و-remote_download_outputs=toplevel.
التوسيع إلى:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel

العلامات: affects_outputs
البادئة التي يتم إلحاقها بأي من الرموز المميزة المناسبة التي يتم إنشاؤها بعد الإصدار. إذا تم حذف القيمة، تكون القيمة التلقائية هي اسم أداة الإصدار متبوعة بواصلة. في حال اجتياز عملية & تحذير: سيتم إيقاف الوظيفة الخاصة لـ '/' قريبًا. استخدِم --experimental_convenience_symlinks=ignore بدلاً من ذلك.
العلامات: affects_outputs
الخيارات التي تؤثّر في مدى قوة تطبيق Bazel لمدخلات الإصدارات الصالحة (تعريفات القواعد ومجموعات العلامات وغيرها):
--[no]experimental_docker_privileged التلقائي: "false;quot;
في حال تفعيل هذه الميزة، سيمرِّر Bazel العلامة --الخاصّة إلى 'doker run' عند تنفيذ الإجراءات. قد يكون هذا مطلوبًا من الإصدار الذي تستخدمه، ولكن قد يؤدي أيضًا إلى تقليل الدقة.
العلامات: execution
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
في حال ضبط هذه السياسة على"صحيح"، يتم ربط استهدافات الروابط الرمزية المحدّدة كإدخالات إجراءات في وضع الحماية. وتنطبق هذه الميزة فقط على قواعد تصحيح الأخطاء التي لا تنفّذ هذا الإجراء بمفردها، ويجب إزالتها بعد حلّ كل هذه القواعد.
العلامات: host_machine_resource_optimizations، execution
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs، experimental
--[no]incompatible_legacy_local_fallback التلقائي: "true;true"
في حال ضبط السياسة على "صحيح"، يتم تفعيل الإجراء الضمني القديم من وضع الحماية إلى الاستراتيجية المحلية. سيتم تلقائيًا ضبط هذه العلامة على "خطأ" لتصبح تلقائيًا القيمة "no-op". استخدِم --strategy أو --spawn_strategy أو --Dynamic_local_strategy لضبط الإجراءات الاحتياطية بدلاً من ذلك.
العلامات: execution، incompatible_change
تراكم --sandbox_add_mount_pair=<a single path or a 'source:target' pair> استخدامات متعددة
يمكنك إضافة زوج إضافي من المسارات للتثبيت في وضع الحماية.
العلامات: execution
تراكم --sandbox_block_path=<a string> استخدامات متعددة
بالنسبة إلى الإجراءات في وضع الحماية، يجب عدم السماح بالوصول إلى هذا المسار.
العلامات: execution
--[no]sandbox_default_allow_network التلقائي: "true;true"
السماح بالوصول إلى الشبكة بشكلٍ تلقائي للإجراءات، وقد لا يتوافق هذا مع جميع عمليات تنفيذ وضع الحماية.
--[no]sandbox_fake_hostname التلقائي: "false;quot;
تغيير اسم المضيف الحالي إلى 'localhost' للإجراءات في وضع الحماية.
العلامات: execution
--[no]sandbox_fake_username التلقائي: "false;quot;
تغيير اسم المستخدم الحالي إلى 'nobody' للإجراءات في وضع الحماية.
العلامات: execution
تراكم --sandbox_writable_path=<a string> استخدامات متعددة
بالنسبة إلى الإجراءات في وضع الحماية، يمكنك جعل الدليل الحالي قابلاً للكتابة في وضع الحماية (في حال تدعمه تنفيذ وضع الحماية، وإلا سيتم تجاهله).
العلامات: execution
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
--[no]incompatible_config_setting_private_default_visibility التلقائي: "false;quot;
في حال عدم التوافق_ar_force_setting_setting_visible=false، هذه القيمة عمليّة جديدة. بخلاف ذلك، إذا كانت هذه العلامة غير صحيحة، أي config_setting بدون سمة ظهور واضحة هو //impression:public. إذا كانت هذه العلامة صحيحة، يتّبع config_setting منطق مستوى الرؤية نفسه الذي تتبعه جميع القواعد الأخرى. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12933.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_enforce_config_setting_visibility التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، فرض قيود على إعداد config_setting. وفي حال اختيار القيمة "خطأ"، سيكون كل إعداد config_setting مرئيًا لكل هدف. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12932.
العلامات: loading_and_analysis، incompatible_change
الخيارات التي تحكم سلوك بيئة الاختبار أو بيئة الاختبار:
--[no]check_tests_up_to_date التلقائي: "false;quot;
لا أجرِ اختبارات، وما عليك سوى التأكّد من أنها حديثة. إذا كانت جميع نتائج الاختبارات محدَّثة، يتم إكمال الاختبار بنجاح. وإذا كان هناك حاجة إلى إنشاء أي اختبار أو تنفيذه، يتم الإبلاغ عن خطأ ولا يمكن إجراء الاختبار. يشير هذا الخيار إلى السلوك --check_up_to_date.
العلامات: execution
تراكم --flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> استخدامات متعددة
ستتم إعادة محاولة إجراء كل اختبار حسب العدد المحدّد من المرات في حال تعذّر اجتياز أي اختبار. يتم تصنيف الاختبارات التي تتطلب أكثر من محاولة واحدة لاجتيازها على أنها 'FLAKY' في ملخص الاختبار. عادةً ما تكون القيمة المحددة مجرد عدد صحيح أو السلسلة 'default'. إذا كان عددًا صحيحًا، سيتم تشغيل جميع الاختبارات حتى س مرة. إذا كانت &'default'، سيتم إجراء محاولة اختبار واحدة فقط للاختبارات العادية وثلاثة لاختبارات تم وضع علامة عليها صراحةً على أنها غير ثابتة من خلال القاعدة (السمة flaky=1). البنية البديلة: regex_filter@flaky_test_attempts. حيث يشير flaky_test_attempts إلى ما هو وارد أعلاه، ويشير regex_filter إلى قائمة تتضمّن أنماط التعبير العادي ويستبعدها (يُرجى الاطّلاع أيضًا على --runs_per_test). مثال: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 يؤدي إلى إزالة جميع الاختبارات في //foo/ باستثناء تلك التي تقع ضمن foo/bar ثلاث مرات. يمكن تمرير هذا الخيار عدة مرات. وتكون الأولوية للوسيطة التي تم تجاوزها مؤخرًا والتي تتطابق مع البيانات. إذا لم يتطابق أي شيء، سيكون السلوك كما لو كان 'default&#39؛ أعلاه.
العلامات: execution
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> التلقائي: "auto;quot;
الحد الأقصى لعدد مهام الاختبار المحلي التي سيتم تشغيلها بشكلٍ متزامن. يحصل على عدد صحيح أو كلمة رئيسية (&&;quot;auto","HOST_CPUS","HOST_RAM";) اختياريًا، تليها عملية ([-|*]< العدد>) مثل "auto", "HOST_CPUS*.5" 0 تعني الموارد المحلية الحدّ من عدد مهام الاختبار المحلي التي سيتم تشغيلها بشكلٍ متزامن. يعدّ ضبط هذه القيمة على قيمة "-jobs" غير فعّال.
العلامات: execution
--[no]test_keep_going التلقائي: "true;true"
عند إيقاف الإعداد، سيتم إيقاف الإصدار بالكامل. يتم تنفيذ جميع الاختبارات تلقائيًا، حتى في حال لم تنجح بعض الاختبارات.
العلامات: execution
--test_strategy=<a string> التلقائي: ""
يحدّد الاستراتيجية التي يجب استخدامها عند إجراء الاختبارات.
العلامات: execution
--test_tmpdir=<a path> التلقائي: عرض الوصف
يحدد الدليل المؤقت الأساسي لـ 'bazel test' للاستخدام.
الخيارات المتعلقة بإخراج Bzlmod ودلالات الترميز:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة"bazel_dep"المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]announce التلقائي: "false;quot;
تم إيقاف العمل به. بيئة مستقلة:
العلامات: affects_outputs
--[no]debug_spawn_scheduler التلقائي: "false;quot;
--[no]experimental_bep_target_summary التلقائي: "false;quot;
ما إذا كان سيتم نشر أحداث Targetملخّص
--[no]experimental_build_event_expand_filesets التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، وسِّع "مجموعات الملفات" في الملف BEP عند تقديم ملفات الإخراج.
العلامات: affects_outputs
في حال ضبط هذه السياسة على"صحيح"، يجب حلّ روابط الملفات المُجمَّعة النسبية في ملف BEP عند عرض ملفات الإخراج. يتطلب --experimental_build_event_expand_filesets.
العلامات: affects_outputs
--experimental_build_event_upload_max_retries=<an integer> التلقائي: "4"
الحد الأقصى لعدد المرات التي يجب على Bazel إعادة محاولة تحميل حدث إصدار فيها.
العلامات: bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.> التلقائي: "1;"
أولاً، الحد الأدنى للتأخير في حالات إعادة المحاولة الأسية في حال تعذّر تحميل الملف BEP (الأس: 1.6)
العلامات: bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string> التلقائي: عرض الوصف
يختار كيفية تحميل العناصر المُشار إليها في بروتوكول حدث الإصدار.
العلامات: affects_outputs
--[no]experimental_collect_local_sandbox_action_metrics التلقائي: "true;true"
عند التفعيل، يتم تسجيل إحصاءات التنفيذ (مثل وقت المستخدم والنظام) للإجراءات التي تم تنفيذها محليًا والتي تستخدِم وضع الحماية
العلامات: execution
--[no]experimental_docker_verbose التلقائي: "false;quot;
في حال تفعيل هذه الميزة، سيطبع Bazel المزيد من الرسائل المطوَّلة حول استراتيجية وضع الإرساء في الإرساء.
العلامات: execution
--[no]experimental_materialize_param_files_directly التلقائي: "false;quot;
في حال تحقيق ملفات وسائط، يمكنك إجراء ذلك من خلال الكتابة المباشرة على القرص.
العلامات: execution
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
--experimental_repository_resolved_file=<a string> التلقائي: ""
إذا كانت السياسة غير فارغة، اكتب قيمة Starlark باستخدام المعلومات التي تم حلّها لجميع قواعد مستودع Starlark التي تم تنفيذها.
العلامات: affects_outputs
--[no]experimental_stream_log_file_uploads التلقائي: "false;quot;
يمكن تحميل ملفات سجل السجلّ مباشرةً إلى وحدة التخزين عن بُعد بدلاً من كتابتها على القرص.
العلامات: affects_outputs
--explain=<a path> التلقائي: عرض الوصف
تعرض هذه الميزة نظام الإصدار لشرح كل خطوة تم تنفيذها من الإصدار. تتم كتابة التفسير في ملف السجلّ المُحدَّد.
العلامات: affects_outputs
--[no]legacy_important_outputs التلقائي: "true;true"
استخدِم هذا الخيار لإيقاف إنشاء حقل القيمة_الإخراجة القديمة في الحدث TargetComplete. ويجب توفّر المخرجات المهمة. إلى Bazel إلى ResultStore.
العلامات: affects_outputs
--[no]materialize_param_files التلقائي: "false;quot;
تكتب ملفات المعلمات المتوسطة لإخراج العرض التدرّجي حتى عند استخدام تنفيذ الإجراءات عن بُعد. يكون هذا الخيار مفيدًا عند تصحيح أخطاء الإجراءات. تتم الإشارة إلى ذلك باستخدام --subcommands و-verbose_failures.
العلامات: execution
--max_config_changes_to_show=<an integer> التلقائي: "3"
عند تجاهل ذاكرة التخزين المؤقت للتحليل بسبب تغيير في خيارات الإصدار، يتم عرض ما يصل إلى العدد المحدّد من أسماء الخيارات التي تم تغييرها. إذا كان الرقم الذي تم تقديمه هو -1، سيتم عرض جميع الخيارات التي تم تغييرها.
العلامات: terminal_output
--max_test_output_bytes=<an integer> التلقائي: "-1"
يحدد هذا الإعداد الحد الأقصى لحجم كل سجلّ اختبار يمكن إصداره عندما يكون --test_output هو 'errors' أو 'all'. وتُعدّ هذه الطريقة مفيدة لتجنّب إزعاج مخرجات الاختبار بإزعاج كثيرة. يتم تضمين رأس الاختبار في حجم السجلّ. لا تتضمّن القيم السلبية أي حدّ. النتيجة هي كل شيء أو لا شيء.
العلامات: test_runner، terminal_output، execution
--output_filter=<a valid Java regular expression> التلقائي: عرض الوصف
يعرض فقط تحذيرات القواعد التي تحمل اسمًا يتطابق مع التعبير العادي المقدَّم.
العلامات: affects_outputs
--progress_report_interval=<an integer in 0-3600 range> التلقائي: "0"
عدد الثواني المطلوب الانتظار خلالها بين تقريرين عن الوظائف التي لا تزال قيد التشغيل. تعني القيمة التلقائية 0 استخدام الخوارزمية المتزايدة 10:30:60.
العلامات: affects_outputs
--remote_print_execution_messages=<failure, success or all> التلقائي: "failure"
اختيار وقت طباعة رسائل التنفيذ عن بُعد القيم الصالحة هي "fail" أو "الطباعة" عند تعذُّر الطباعة إلا و"النجاح" للطباعة في حالات النجاح فقط و"الكل" للطباعة دائمًا.
العلامات: terminal_output
--[no]sandbox_debug التلقائي: "false;quot;
تفعيل ميزات تصحيح الأخطاء لميزة وضع الحماية. ويشمل ذلك أمرَين: أولاً، يتم ترك محتوى الجذر في وضع الحماية بدون لمس بعد الإصدار (وفي حال استخدام وضع الحماية، يتم ترك نظام الملفات مثبّتًا)، وثانيًا، يتم طباعة معلومات تصحيح أخطاء إضافية عند التنفيذ. ويمكن أن يساعد ذلك مطوّري البرامج على قواعد Bazel أو Starlark في حال تعذّر تصحيح الأخطاء بسبب عدم توفّر ملفات الإدخال.
العلامات: terminal_output
--show_result=<an integer> التلقائي: "1;"
اعرض نتائج الإصدار. بالنسبة إلى كل هدف، حدِّد ما إذا كان قد تم تحديثه أم لا، وإذا كان الأمر كذلك، حدِّد قائمة بملفات الإخراج التي تم إنشاؤها. الملفات المطبوعة هي سلاسل ملائمة للنسخ واللصق إلى واجهة المستخدم لتنفيذها. يتطلب هذا الخيار وسيطة عدد صحيح، وهي عدد الحدّ الأدنى للأهداف التي لا تتم طباعة معلومات النتيجة فوقها. ويؤدي الصفر إلى إيقاف الرسالة، بينما يتسبب MAX_INT في طباعة النتيجة دائمًا. الإعداد التلقائي هو واحد.
العلامات: affects_outputs
--[no]subcommands [-s] التلقائية: "false"
اعرض الأوامر الفرعية التي تم تنفيذها أثناء الإصدار. العلامات ذات الصلة: --execution_log_json_file, --execution_log_binary_file (لتسجيل الأوامر الفرعية إلى ملف بتنسيق متوافق مع الأداة).
العلامات: terminal_output
--test_output=<summary, errors, all or streamed> التلقائي: "summary"
يحدد وضع الإخراج المطلوب. القيم الصالحة هي 'summary' لعرض نتائج حالة الاختبار فقط، 'errors' لطباعة سجلات الاختبار كذلك للاختبارات التي تعذّر تنفيذها، و#39;all' لطباعة سجلات جميع الاختبارات و#39;streamed' إلى نتائج السجلّ لجميع الاختبارات في الوقت الفعلي (سيؤدي ذلك إلى فرض تنفيذ الاختبارات محليًا في كل مرة بغض النظر عن ذلك - بصرف النظر عن قيمة الاختبار - بصرف النظر عن ذلك).
العلامات: test_runner، terminal_output، execution
--test_summary=<short, terse, detailed, none or testcase> التلقائي: "short;quot;
يحدد تنسيق ملخص الاختبار المطلوب. القيم الصالحة هي 'short' لطباعة المعلومات فقط حول الاختبارات التي تم تنفيذها، و#39;tere' ، ولطباعة معلومات فقط عن الاختبارات غير الناجحة التي تم إجراؤها، و#39;detailed' لطباعة معلومات مفصّلة عن حالات الاختبار التي تعذّر اجتيازها، و#39;testcase' لطباعة ملخّص لنتيجة الاختبار هذه وعدم حذف معلومة واحدة و#9 وبلغت 39% عن أي حالة اختبارية
العلامات: terminal_output
--[no]verbose_explanations التلقائي: "false;quot;
تزيد الإسهاب من التفسيرات الصادرة في حال تفعيل "الشرح". ليس له أي تأثير في حالة عدم تفعيل-الشرح.
العلامات: affects_outputs
--[no]verbose_failures التلقائي: "false;quot;
في حال تعذّر تنفيذ أحد الأوامر، يُرجى طباعة سطر الأوامر بالكامل.
العلامات: terminal_output
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
تراكم --aspects_parameters=<a 'name=value' assignment> استخدامات متعددة
يحدد قيم معلّمات جوانب الأوامر. يتم تحديد كل قيمة معلّمة من خلال <param_name>ISBNlt;param_value> على سبيل المثال 'my_param=my_val ' حيث &&33;my_param' هي معلّمة لبعض الجوانب في قائمة-الجوانب أو مطلوبة من خلال جانب في القائمة. يمكن استخدام هذا الخيار عدة مرات. ومع ذلك، لا يُسمح بتخصيص قيم للمعلَمة نفسها أكثر من مرة.
العلامات: loading_and_analysis
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
في حال كان هذا الملف غير فارغ، يُرجى قراءة الملف المحدَّد بدلاً من ملف WORKSPACE
العلامات: changes_inputs
--target_pattern_file=<a string> التلقائي: ""
في حال ضبط هذه السياسة، سيقرأ الإصدار أنماطًا من الملف المذكور هنا، بدلاً من سطر الأوامر. خطأ في تحديد ملف هنا بالإضافة إلى أنماط سطر الأوامر.
العلامات: changes_inputs
خيارات التخزين المؤقت والتنفيذ عن بُعد:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
--[no]experimental_guard_against_concurrent_changes التلقائي: "false;quot;
إيقاف هذه الميزة لإيقاف التحقّق من وقت ملفات إدخال الإجراءات قبل تحميلها إلى ذاكرة التخزين المؤقت عن بُعد قد يعود سبب هذه المشكلة إلى حالات تأخير في كتابة ملفات Linux kernel، ما قد يؤدي إلى حالات موجبة خاطئة.
--experimental_remote_build_event_upload=<all or minimal> التلقائي: "all"
في حال الضبط على 'all'، يتم تحميل كل النتائج المحلية التي يشير إليها بروتوكول BEP إلى ذاكرة التخزين المؤقت عن بُعد. في حال الضبط على 'minimal'، لا يتم تحميل النتائج المحلية التي يشير إليها BEP إلى ذاكرة التخزين المؤقت البعيدة، باستثناء الملفات المهمة للمستهلكين في حالة BEP (مثل سجلات الاختبار والملف الشخصي للتوقيت). ويتم استخدام مخطط //:file لمسارات الملفات المحلية ومخطَّط // stream. ضبط تلقائي على 'all'
--[no]experimental_remote_cache_async التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، سيتم إجراء مؤتمر I/O لذاكرة التخزين المؤقت عن بُعد في الخلفية بدلاً من عقده كجزء من عملية النبات.
--[no]experimental_remote_cache_compression التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يُرجى ضغط كائن تخزين البيانات الثنائية الكبيرة أو فك ضغطه باستخدام zstd.
--experimental_remote_capture_corrupted_outputs=<a path> التلقائي: عرض الوصف
المسار المؤدي إلى دليل يتم فيه إخراج النتائج التالفة إليه.
--experimental_remote_downloader=<a string> التلقائي: عرض الوصف
معرّف موارد منتظم (URI) لنقطة نهاية واجهة برمجة التطبيقات البعيدة لمواد العرض، لاستخدامه كخادم وكيل للتنزيل عن بُعد. المخططات المعتمدة هي grpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX المحلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. يُرجى الاطّلاع على الرابط: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset_proto
--[no]experimental_remote_downloader_local_fallback التلقائي: "false;quot;
تحديد ما إذا كان من الممكن الرجوع إلى أداة التنزيل المحلية في حال تعذّر تنزيل أداة التنزيل عن بُعد.
--[no]experimental_remote_execution_keepalive التلقائي: "false;quot;
استخدام رسالة التحقّق من الاتصال لمكالمات التنفيذ عن بُعد
--experimental_remote_grpc_log=<a path> التلقائي: عرض الوصف
في حال تم تحديد مسار إلى ملف لتسجيل التفاصيل المتعلقة بمكالمة gRPC. يتكون هذا السجل من تسلسل من com.google.devtools.build.lib.remote.log.remoteExecutionLog.LogEntrys9fs مع كل رسالة مسبوقة بعلامة تشير إلى حجم رسالة Protobuf التسلسلية التالية، كما ننفّذها الطريقة LogLog.writeDelimitedTo(إخراجStream).
--[no]experimental_remote_mark_tool_inputs التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، سيضع Bazel علامة على الإدخالات كإدخالات للأداة التنفيذية عن بُعد. ويمكن استخدام هذا في تنفيذ العاملين الدائمين عن بُعد.
--[no]experimental_remote_merkle_tree_cache التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، سيتم تدوين حسابات شجرة ميركل لتحسين سرعة التحقّق من نتائج ذاكرة التخزين المؤقت عن بُعد. يتم التحكم في طباعة ذاكرة التخزين المؤقت في الذاكرة باستخدام --experimental_remote_merlick_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer> التلقائي: "1000"
عدد أشجار Mer وتتوفّر لتذكُّرها لتحسين سرعة التحقُّق من النتائج في ذاكرة التخزين المؤقت عن بُعد. ومع أنّ ذاكرة التخزين المؤقت يتم تشغيلها تلقائيًا وفقًا لطريقة معالجة Java& العديد من المراجع، قد تظهر أخطاء متعلّقة بالذاكرة إذا تم ضبطها على قيمة مرتفعة جدًا. إذا تم ضبطها على 0، يكون حجم ذاكرة التخزين المؤقت غير محدود. تختلف القيمة المثالية حسب حجم المشروع. القيمة التلقائية هي 1000.
--[no]incompatible_remote_build_event_upload_respect_no_cache التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، لا يتم تحميل النتائج التي يشير إليها بروتوكول BEP إلى ذاكرة التخزين المؤقت عن بُعد في حال تعذّر تخزين إجراء الإنشاء مؤقتًا عن بُعد.
--[no]incompatible_remote_downloader_send_all_headers التلقائي: "true;true"
ما إذا كان سيتم إرسال جميع قيم العنوان المتعدد القيم إلى أداة التنزيل عن بُعد بدلاً من القيمة الأولى فقط.
العلامات: incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root التلقائي: "false;quot;
في حال الضبط على "صحيح"، ترتبط مسارات الإخراج بجذر الإدخال بدلاً من دليل العمل.
العلامات: incompatible_change
--[no]incompatible_remote_results_ignore_disk التلقائي: "true;true"
في حال ضبطها على"صحيح"، لن يتم تطبيق --noremote_upload_local_results و-noremote_accept_cached على ذاكرة التخزين المؤقت على القرص. في حال استخدام ذاكرة تخزين مؤقت مجمّعة: --noremote_upload_local_results سيؤدي إلى كتابة نتائج في ذاكرة التخزين المؤقت على القرص، ولكن لا يتم تحميلها إلى ذاكرة التخزين المؤقت عن بُعد. --noremote_Accept_cached: سيؤدي ذلك إلى بحث Bazel عن النتائج في ذاكرة التخزين المؤقت على القرص، ولكن ليس في ذاكرة التخزين المؤقت عن بُعد. يمكن أن تؤدي إجراءات no-remote-exec إلى ذاكرة التخزين المؤقت على القرص. راجِع #8216 لمزيد من التفاصيل.
العلامات: incompatible_change
--[no]remote_accept_cached التلقائي: "true;true"
قبول نتائج الإجراء المخزنة عن بُعد.
--remote_bytestream_uri_prefix=<a string> التلقائي: عرض الوصف
اسم المضيف واسم النسخة الافتراضية المطلوب استخدامهما في معرّفات الموارد المنتظمة (URI) //stream. يمكن تحديد هذا الخيار عند تنفيذ الإصدارات باستخدام خادم وكيل، مما يؤدي إلى عدم تطابق قيم --remote_executor و--remote_instance_name مع الاسم الأساسي لخدمة التنفيذ عن بُعد. وعند عدم ضبطها تلقائيًا، سيتم ضبطها تلقائيًا على "${hostname}/${instance_name}".
--remote_cache=<a string> التلقائي: عرض الوصف
معرّف موارد منتظم (URI) لنقطة نهاية ذاكرة التخزين المؤقت المخططات المتاحة هي http وhttps وgrpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX محلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. حدِّد grpc:// أو http:// أو Unix: مخطط لإيقاف بروتوكول أمان طبقة النقل. يُرجى الاطّلاع على https://bazel.build/remote/caching
تراكم --remote_cache_header=<a 'name=value' assignment> استخدامات متعددة
حدِّد عنوانًا سيتم تضمينه في طلبات ذاكرة التخزين المؤقت: --remote_cache_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
تراكم --remote_default_exec_properties=<a 'name=value' assignment> استخدامات متعددة
يمكنك ضبط خصائص exe التلقائية المراد استخدامها كمنصة تنفيذ عن بُعد في حال عدم ضبط منصة تنفيذ من قبل exec_property.
العلامات: affects_outputs
--remote_default_platform_properties=<a string> التلقائي: ""
يمكنك ضبط خصائص النظام الأساسي التلقائية المطلوب ضبطها لواجهة برمجة التطبيقات للتنفيذ عن بُعد، إذا لم تكن منصة التنفيذ قد تم ضبطها عن بُعد. وستُستخدَم هذه القيمة أيضًا في حال اختيار النظام الأساسي المضيف كنظام أساسي للتنفيذ عن بُعد.
تراكم --remote_downloader_header=<a 'name=value' assignment> استخدامات متعددة
حدد عنوانًا سيتم تضمينه في طلبات التنزيل عن بُعد: --remote_downloader_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
تراكم --remote_exec_header=<a 'name=value' assignment> استخدامات متعددة
حدِّد عنوانًا سيتم تضمينه في طلبات التنفيذ: "remote_exec_header=Name=Value". يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
--remote_execution_priority=<an integer> التلقائي: "0"
الأولوية النسبية للإجراءات التي سيتم تنفيذها عن بُعد تعتمد دلال قيم الأولوية المحدّدة على الخادم.
--remote_executor=<a string> التلقائي: عرض الوصف
المضيف أو HOST:PORT لنقطة نهاية التنفيذ عن بُعد. المخططات المعتمدة هي grpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX المحلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. حدِّد grpc:// أو unix: مخطط لإيقاف بروتوكول أمان طبقة النقل.
تراكم --remote_header=<a 'name=value' assignment> استخدامات متعددة
تحديد عنوان سيتم تضمينه في الطلبات: --remote_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
--remote_instance_name=<a string> التلقائي: ""
القيمة التي يجب إدخالها كمثال example_name في واجهة برمجة التطبيقات للتنفيذ عن بُعد.
--[no]remote_local_fallback التلقائي: "false;quot;
ما إذا كان المطلوب الالتزام باستراتيجية التنفيذ المحلية المستقلة في حال تعذّر التنفيذ عن بُعد.
--remote_local_fallback_strategy=<a string> التلقائي: "local;quot"
لا تتوفّر إمكانية التشغيل يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7480 للحصول على التفاصيل.
--remote_max_connections=<an integer> التلقائي: "100"
الحد الأقصى لعدد الاتصالات المتزامنة إلى ذاكرة التخزين المؤقت/التنفيذ عن بُعد وتكون القيمة 100 تلقائيًا. ويعني ضبطها على 0 أنّه ما مِن قيود. بالنسبة إلى ذاكرة التخزين المؤقت عن بُعد في HTTP، يمكن لاتصال TCP واحد معالجة طلب واحد في كل مرة، لذا يمكن أن يتولى Bazel ما يصل إلى --remote_max_connections من الطلبات المتزامنة. في ما يتعلق بذاكرة التخزين المؤقت/المنفّذ عن بُعد لدى gRPC، يمكن عادةً أن تعالج قناة gRPC أكثر من 100 طلب متزامن، لذا يمكن أن يرسل Bazel حوالي طلبات متزامنة بين ---remote_max_connections * 100`.
العلامات: host_machine_resource_optimizations
--remote_proxy=<a string> التلقائي: عرض الوصف
الاتصال بذاكرة التخزين المؤقت عن بُعد من خلال خادم وكيل. لا يمكن استخدام هذه العلامة حاليًا إلا لإعداد مقبس نطاق Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer> التلقائي: "0"
الأولوية النسبية للإجراءات البعيدة المراد تخزينها في ذاكرة التخزين المؤقت عن بُعد. تعتمد دلال قيم الأولوية المحدّدة على الخادم.
--remote_retries=<an integer> التلقائي: "5"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح عابر. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
--remote_timeout=<An immutable length of time.> التلقائي: "60s"
الحد الأقصى لوقت انتظار التنفيذ عن بُعد وذاكرة التخزين المؤقت للمكالمات. وبالنسبة إلى ذاكرة التخزين المؤقت في REST، تكون هذه القيمة هي مهلة الاتصال ومهلة القراءة. يمكن استخدام الوحدات التالية: الأيام (د) والساعات (س) والدقائق (م) والثواني (ث) والملي ثانية (ملي ثانية). إذا تم حذف الوحدة، يتم تفسير القيمة بالثواني.
--[no]remote_upload_local_results التلقائي: "true;true"
تحميل نتائج الإجراءات التي تم تنفيذها محليًا إلى ذاكرة التخزين المؤقت عن بُعد
--[no]remote_verify_downloads التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، سيحتسب Bazel مجموع التجزئة لجميع عمليات التنزيل عن بُعد وسيتجاهل القيم المخزَّنة مؤقتًا عن بُعد في حال عدم تطابقها مع القيمة المتوقَّعة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
--auto_output_filter=<none, all, packages or subpackages> التلقائي: "none;quot;
في حال عدم تحديد --إخراج_فلتر، سيتم استخدام قيمة هذا الخيار لإنشاء فلتر تلقائيًا. القيم المسموح بها هي 'none' (فلترة أي شيء / عرض كل شيء) 'all' (فلترة كل شيء / عدم عرض أي شيء) 'packages' (تضمين مخرجات من القواعد المذكورة في الحِزم المذكورة في سطر الأوامر في Blaze)، و'subpackages' (مثل 'packages'packages&#sub9;). بالنسبة إلى 'packages' و 'subpackages' يتم التعامل مع القيم //java/foo و //javatests/foo كحزمة واحدة)&#39؛
--[no]build_manual_tests التلقائي: "false;quot;
فرض إنشاء الأهداف المستهدفة التي تم وضع علامة عليها، 'manual'. 'manual' يتم استبعاد معالجة الاختبارات. يفرض هذا الخيار إنشاءها (وليس تنفيذها).
--build_tag_filters=<comma-separated list of options> التلقائي: ""
يحدد قائمة علامات مفصولة بفواصل. يمكن أن يسبق كل علامة اختياريًا مسبوقة بالعلامة '-' لتحديد العلامات المستبعدة. وسيتم فقط إنشاء هذه الأهداف التي تحتوي على علامة واحدة مُضمَّنة على الأقل ولا تحتوي على أي علامات مستبعدة. لا يؤثر هذا الخيار في مجموعة الاختبارات التي يتم تنفيذها باستخدام الأمر 'test'، حيث تخضع هذه الخيارات لخيارات فلترة الاختبار، على سبيل المثال '--test_tag_filters'
--[no]build_tests_only التلقائي: "false;quot;
في حال تحديد السياسة، سيتم إنشاء القواعد *_test وtest_suite فقط، وسيتم تجاهل الأهداف الأخرى المحدّدة في سطر الأوامر. وسيتم تلقائيًا إنشاء كل ما تم طلبه.
--combined_report=<none or lcov> التلقائي: "none;quot;
يحدد هذا الإعداد نوع تقرير التغطية التراكمية المطلوب. وفي هذه المرحلة، يتم دعم LCOV فقط.
--[no]compile_one_dependency التلقائي: "false;quot;
جمّع اعتمادية واحدة من ملفات الوسيطة. ويُفيد ذلك في التحقّق من ملفات المصدر في IDE على سبيل المثال، من خلال إعادة إنشاء استهداف واحد يعتمد على الملف المصدر لرصد الأخطاء في أقرب وقت ممكن في دورة التعديل/الإنشاء/الاختبار. وتؤثر هذه الوسيطة في طريقة تفسير كل الوسيطات التي لا تتضمن علامة، وبدلاً من أن تكون استهدافات لإنشاءها، فهي أسماء ملفات مصدر. وبالنسبة إلى كل اسم ملف مصدر، يتم إنشاء هدف عشوائي يعتمد على ذلك.
--deleted_packages=<comma-separated list of package names> التلقائي: ""
قائمة بأسماء الحِزم المفصولة بفاصلة والتي يعتبرها نظام الإصدار غير موجودة، حتى إذا كانت مرئية في مكان ما على مسار الحزمة. استخدِم هذا الخيار عند حذف حزمة فرعية 'x/y' من حزمة حالية 'x&#39؛. على سبيل المثال، بعد حذف x/y/BUILD في برنامجك، قد يعترض نظام الإصدار إذا واجه تصنيفًا '//x:y/z&#39؛ إذا كان لا يزال يتم تقديمه من خلال إدخال package_path آخر. ويؤدي تحديد --delete_packages x/y إلى تجنُّب هذه المشكلة.
--[no]discard_analysis_cache التلقائي: "false;quot;
تجاهل ذاكرة التخزين المؤقت للتحليل بعد اكتمال مرحلة التحليل مباشرةً يقلل من استخدام الذاكرة بنسبة %10 تقريبًا، ولكنه يجعل الإصدارات المتزايدة بشكل أبطأ.
--disk_cache=<a path> التلقائي: عرض الوصف
مسار للاطّلاع على دليل حيث يمكن لتطبيق Bazel قراءة الإجراءات وإجراءاتها وكتابتها. في حال عدم توفّر الدليل، سيتم إنشاؤه.
--embed_label=<a one-line string> التلقائي: ""
تضمين تصنيف عنصر التحكّم في المصدر أو تصنيف الإصدار في برنامج ثنائي
--execution_log_binary_file=<a path> التلقائي: عرض الوصف
سجِّل تكاثر التنفيذ في هذا الملف كنماذج أوليّة ومحدّدة مسبقًا، وفقًا للسمة src/primary/protobuf/spawn.proto. تتم كتابة السجلّ أولاً بدون ترتيب، وفي نهاية الاستدعاء، يتم ترتيبه بترتيب ثابت (يمكن أن يكون وحدة المعالجة المركزية (CPU) وذاكرة مكثفة). العلامات ذات الصلة: --execution_log_json_file (تنسيق نص JSON))، و-experimental_execution_log_file (تنسيق Protobuf الثنائي غير المُرتَّب)، --subcommands (لعرض الأوامر الفرعية في المخرجات الطرفية).
--execution_log_json_file=<a path> التلقائي: عرض الوصف
سجِّل التغييرات التي يتم تنفيذها في هذا الملف كتمثيل json لنماذج Prown المفصولة بفواصل، وفقًا للسمة src/primary/protobuf/spawn.proto. تتم كتابة السجلّ أولاً بدون ترتيب، وفي نهاية الاستدعاء، يتم ترتيبه بترتيب ثابت (يمكن أن يكون وحدة المعالجة المركزية (CPU) وذاكرة مكثفة). العلامات ذات الصلة: العلامات ذات الصلة: --execution_log_binary_file (تنسيق Protobuf الثنائي) أو --experimental_execution_log_file (تنسيق Protobuf الثنائي غير المُرتَّب) --commands (لعرض الأوامر الفرعية في المخرجات الطرفية).
--[no]expand_test_suites التلقائي: "true;true"
عليك توسيع استهدافات test_suite إلى اختبارات الأقسام الخاصة بها قبل التحليل. عند تفعيل هذه العلامة (الإعداد التلقائي)، سيتم تطبيق أنماط الاستهداف السلبية على الاختبارات التي تنتمي إلى حزمة الاختبار، وإلا لن يتم تطبيقها. يكون إيقاف هذه العلامة مفيدًا عند تطبيق جوانب المستوى الأعلى على سطر الأوامر: وبعد ذلك، يمكن تحليل أهداف test_suite.
العلامات: loading_and_analysis
تراكم --experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.> استخدامات متعددة
لضبط"بيانات اعتماد الاعتماد"في استخدامها لاسترداد بيانات الاعتماد للنطاق المقدَّم (النطاق). تحظى بيانات الاعتماد من "مساعدو المساعدة" بالأولوية على بيانات الاعتماد من <code&code>--google_default_credentials</code> أو `--google_credentials` أو &<code>.netrc</code>
--experimental_credential_helper_cache_duration=<An immutable length of time.> التلقائي: "30m"
لضبط المدة التي يتم خلالها تخزين بيانات اعتماد "أدوات مساعدة الاعتماد" مؤقتًا.
--experimental_credential_helper_timeout=<An immutable length of time.> التلقائي: "5;"
لضبط المهلة لمساعد بيانات الاعتماد. وسيتعذّر استدعاء بيانات اعتماد الوصول خلال هذه المهلة.
--experimental_execution_log_file=<a path> التلقائي: عرض الوصف
سجِّل تكاثر التنفيذ في هذا الملف كنماذج أوليّة ومحدّدة مسبقًا، وفقًا للسمة src/primary/protobuf/spawn.proto. تمت كتابة هذا الملف بالترتيب الذي يتم به تربية النبات. العلامات ذات الصلة: --execution_log_binary_file (تنسيق Protobuf الثنائي) أو --execution_log_json_file (تنسيق النص json المطلوب) أو الأمر الأمر الفرعي (لعرض الأوامر الفرعية في المخرجات الطرفية).
--[no]experimental_execution_log_spawn_metrics التلقائي: "false;quot;
تضمين مقاييس التناسب في سجلّ النسلات التي تم تنفيذها.
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> التلقائي: ""
تم إيقافها لصالح جوانب مختلفة. فلاتر مجموعة من الأهداف لجدولة action_actions لإجراءات إضافية.
--[no]experimental_extra_action_top_level_only التلقائي: "false;quot;
تم إيقافها لصالح جوانب مختلفة. حدِّد جدولاً إجراءات إضافية_للأهداف ذات المستوى الأعلى فقط.
--[no]experimental_prioritize_local_actions التلقائي: "true;true"
في حال ضبط السياسة، يتم إعطاء الأولوية للإجراءات التي لا يمكن تنفيذها محليًا إلا في الحصول على الموارد، ويتم منح العوامل التي تُشغَّل ديناميكيًا الفرصة الثانية، وتكون الإجراءات المستقلة التي يتم تنفيذها ديناميكيًا أخيرًا.
العلامات: execution
--experimental_spawn_scheduler
تفعيل التنفيذ الديناميكي عن طريق تنفيذ الإجراءات محليًا وعن بُعد، بالتوازي ينشئ Bazel كل إجراء محليًا وعن بُعد ويختار الإجراء الذي يُكمل أولاً. إذا كان الإجراء متاحًا للعاملين، سيتم تنفيذ الإجراء المحلي في وضع العامل الدائم. لتفعيل التنفيذ الديناميكي في إجراء مخصّص واحد، استخدِم العلامتين "--internal_spawn_scheduler" و"--strategyportraitlt;mnemonic>=Dynamic` بدلاً من ذلك.
التوسيع إلى:
--internal_spawn_scheduler
--spawn_strategy=dynamic
--google_auth_scopes=<comma-separated list of options> التلقائي: "https://www.googleapis.com/auth/cloud-platform"
قائمة مفصولة بفواصل لنطاقات المصادقة في Google Cloud
--google_credentials=<a string> التلقائي: عرض الوصف
يحدد الملف للحصول على بيانات اعتماد المصادقة. يمكنك الاطّلاع على https://cloud.google.com/docs/authentication للحصول على التفاصيل.
--[no]google_default_credentials التلقائي: "false;quot;
ما إذا كان المطلوب استخدام بيانات الاعتماد التلقائية في &39;Google للتطبيقات لإجراء المصادقة. يمكنك الاطّلاع على https://cloud.google.com/docs/authentication للحصول على التفاصيل. هذه الميزة غير مفعّلة تلقائيًا.
--grpc_keepalive_time=<An immutable length of time.> التلقائي: عرض الوصف
يمكنك ضبط إشعارات البقاء على قيد الاتصال لاتصالات gRPC الصادرة. إذا تم ضبط الإعداد، يُرسِل Bazel إشعارات بعد هذه الفترة من عدم توفّر عمليات قراءة على الاتصال، إلا إذا كان هناك طلب gRPC واحد على الأقل في انتظار المراجعة. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. يتم إيقاف إشعارات البقاء على الوضع تلقائيًا. يجب التنسيق مع مالك الخدمة قبل تفعيل هذا الإعداد. على سبيل المثال، لضبط قيمة 30 ثانية على هذه العلامة، يجب إجراؤها على النحو التالي --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.> التلقائي: "20s"
يضبط هذا الإعداد مهلة الاحتفاظ بالبيانات لاتصالات gRPC الصادرة. في حال تفعيل إشعارات البقاء على الاتصال مع --grpc_keepalive_time، ستنتهي مهلة Bazel للاتصال إذا لم تتلقَ رد فحص الاتصال بعد هذا الوقت الكبير. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. في حال إيقاف إشعارات التحقّق من الاتصال، يتم تجاهل هذا الإعداد.
--[no]ignore_unsupported_sandboxing التلقائي: "false;quot;
لا تطبع تحذيرًا عندما لا يكون تنفيذ وضع الحماية متاحًا على هذا النظام.
--[no]incompatible_dont_use_javasourceinfoprovider التلقائي: "false;quot;
العلامات التجارية
العلامات: incompatible_change
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.> التلقائي: "HOST_CPUS"
حدِّد بشكلٍ صريح إجمالي عدد النوى المحلية لوحدة المعالجة المركزية المتوفّرة لدى Bazel للإنفاق على إجراءات الإصدار التي تم تنفيذها محليًا. يأخذ عددًا صحيحًا أو &&;; معلش_وحدة المعالجة المركزية (CPU)"، يليها اختياريًا [-|*]<؛> (على سبيل المثال HOST_CPUS*5. لاستخدام نصف وحدة المعالجة المركزية المتاحة لوحدة المعالجة المركزية (CPU).وفقًا للإعدادات التلقائية، ("HOST_CPUS")، سيبحث Bazel عن إعدادات النظام لتقدير عدد النوى المتاحة لوحدة المعالجة المركزية (CPU).
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.> التلقائي: "HOST_RAM*.67&quot
حدِّد صراحةً إجمالي ذاكرة الوصول العشوائي (RAM) للمضيف المحلي (بالميغابايت) المتاحة لشركة Bazel لإنفاقها على إجراءات الإصدار التي تم تنفيذها محليًا. يأخذ عددًا صحيحًا أو &&;;;; معلش_ذاكرة الوصول العشوائي&&;; وفيها خيار اختياري متبوعًا بـ [-|*]< العدد > (مثل HOST_RAM*.5 لاستخدام نصف ذاكرة الوصول العشوائي المتاحة). وفقًا للإعدادات التلقائية، ("HOST_RAM*.67")، سيبحث Bazel عن إعدادات النظام لتقدير حجم ذاكرة الوصول العشوائي المتاحة وسيستخدِم 67% منها.
--local_termination_grace_seconds=<an integer> التلقائي: "15&quot
حان وقت الانتظار بين إنهاء عملية محلية بسبب انتهاء المهلة وفرض إغلاقها.
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.
--package_path=<colon-separated list of options> التلقائي: "%workspace%"
قائمة مفصولة بفواصل من المكان الذي يجب البحث فيه عن الطرود. العناصر التي تبدأ بـ '%workspace%' نسبية إلى مساحة العمل المضمنة. في حال حذف الحقل أو تركه فارغًا، يكون الإعداد التلقائي هو الناتج 'bazel information default-package-path'.
--[no]show_loading_progress التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتسبب تطبيق Bazel في طباعة الرسائل &quot&تحميل الحِزمة:".
--test_lang_filters=<comma-separated list of options> التلقائي: ""
يحدد قائمة لغات الاختبار مفصولة بفواصل. يمكن أن تسبق كل لغة اختياريًا باستخدام '-' لتحديد اللغات المستبعَدة. ولن يتم العثور سوى على تلك الأهداف التجريبية المكتوبة باللغات المحدّدة. يجب أن يكون الاسم المستخدَم لكل لغة هو نفسه بادئة اللغة في القاعدة *_test، مثل واحد من 'cc', 'java', 'py' وما إلى ذلك. يؤثر هذا الخيار في سلوك --build_tests_only وأمر الاختبار.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous> التلقائي: ""
يحدد قائمة بأحجام الاختبارات مفصولة بفواصل. يمكن أن يسبق كل حجم اختياريًا باستخدام '-' لتحديد الأحجام المستبعدة. سيتم العثور على أهداف الاختبار هذه فقط التي تحتوي على حجم مُضمَّن واحد على الأقل ولا تحتوي على أي أحجام مستبعدة. يؤثر هذا الخيار في سلوك-build_tests_only وأمر الاختبار.
--test_tag_filters=<comma-separated list of options> التلقائي: ""
يحدد قائمة علامات الاختبار مفصولة بفواصل. يمكن أن يسبق كل علامة اختياريًا مسبوقة بالعلامة '-' لتحديد العلامات المستبعدة. سيتم العثور على أهداف الاختبار هذه التي تحتوي على علامة مضمّنة واحدة على الأقل ولا تحتوي على أي علامات مستبعدة. يؤثر هذا الخيار في سلوك-build_tests_only وأمر الاختبار.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal> التلقائي: ""
يُحدد قائمة مهلات الاختبار مفصولة بفواصل. يمكن أن تسبق كل مهلة بشكل اختياري مع '-' لتحديد المهلات المستبعدة. سيتم العثور على أهداف الاختبار هذه فقط التي تحتوي على مهلة واحدة على الأقل مُتضمَّنة ولا تحتوي على أي مهلات مستثناة. يؤثر هذا الخيار في سلوك-build_tests_only وأمر الاختبار.
--tls_certificate=<a string> التلقائي: عرض الوصف
حدِّد مسارًا لشهادة بروتوكول أمان طبقة النقل (TLS) موثوقة لتوقيع شهادات الخادم.
--tls_client_certificate=<a string> التلقائي: عرض الوصف
حدِّد شهادة عميل طبقة النقل الآمنة التي تريد استخدامها، وعليك أيضًا تقديم مفتاح عميل لتفعيل مصادقة العميل.
--tls_client_key=<a string> التلقائي: عرض الوصف
حدِّد مفتاح عميل طبقة النقل الآمنة الذي سيتم استخدامه، وعليك أيضًا تقديم شهادة عميل لتفعيل مصادقة العميل.
--workspace_status_command=<path> التلقائي: ""
تم استدعاء أمر في بداية الإصدار لتوفير معلومات الحالة حول مساحة العمل على شكل أزواج من المفاتيح/القيمة. يُرجى الاطلاع على "دليل المستخدم" للحصول على المواصفات الكاملة. يمكنك أيضًا الاطّلاع على أدوات/buildstamp/get_workspace_status للاطّلاع على مثال.
الخيارات التي تتحكّم في تنفيذ الإصدار:
--[no]check_up_to_date التلقائي: "false;quot;
يجب عدم تنفيذ عملية الإنشاء، وما عليك سوى التأكّد من أنّها حديثة. إذا كانت جميع الاستهدافات حديثة، تكتمل عملية الإنشاء بنجاح. وإذا كان يلزم تنفيذ أي خطوة، يتم الإبلاغ عن خطأ وتعذّر إتمام عملية الإصدار.
العلامات: execution
تحديد ما إذا كان سيتم إجراء طلبات مباشرة لنظام الملفات لإنشاء أشجار رمزية
العلامات: loading_and_analysis وexecution وexperimental
--[no]experimental_remotable_source_manifests التلقائي: "false;quot;
تحديد ما إذا كان من الممكن اتخاذ إجراءات في بيان المصدر عن بُعد
العلامات: loading_and_analysis وexecution وexperimental
--[no]experimental_split_coverage_postprocessing التلقائي: "false;quot;
إذا كان الأمر كذلك، ستجري Bazel معالجة ما بعد التغطية لاختبارها في وقت جديد.
العلامات: execution
--[no]experimental_split_xml_generation التلقائي: "true;true"
في حال تم ضبط هذه العلامة، ولم يؤدي إجراء اختبار إلى إنشاء ملف test.xml، سيستخدِم Bazel إجراءً منفصلاً لإنشاء ملف testm.xml الافتراضي الذي يحتوي على سجلّ الاختبار. وبخلاف ذلك، ينشئ Bazel ملف test.xml كجزء من إجراء الاختبار.
العلامات: execution
--[no]experimental_strict_fileset_output التلقائي: "false;quot;
إذا تم تفعيل هذا الخيار، ستتعامل مجموعات الملفات مع جميع عناصر الإخراج كملفات عادية. لن تمرِّر الأدلة أو تكون حساسة للروابط الرمزية.
العلامات: execution
--genrule_strategy=<comma-separated list of options> التلقائي: ""
حدِّد كيفية تنفيذ القواعد العامة. سيتم إيقاف هذه العلامة تدريجيًا. وبدلاً من ذلك، استخدِم --spawn_strategyportraitlt;value> للتحكّم في جميع الإجراءات أو للتحكّم في --strategy=Genruledmcalt;value> للتحكّم في القواعد الجينية فقط.
العلامات: execution
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> [-j] التلقائية: "auto;quot;
عدد المهام المتزامنة المطلوب تنفيذها. يحصل على عدد صحيح أو كلمة رئيسية (&&;quot;auto","HOST_CPUS","HOST_RAM";) اختياريًا، تليها عملية ([-|*]< العدد>) مثل "auto", "HOST_CPUS*.5" يجب أن تتراوح القيم بين 1 و5000. وقد تتسبب القيم التي تزيد عن 2500 في حدوث مشاكل في الذاكرة. "auto"تحسب قيمة تلقائية معقولة بناءً على موارد المضيف.
العلامات: host_machine_resource_optimizations، execution
--[no]keep_going [-k] التلقائية: "false"
يُرجى المتابعة قدر الإمكان بعد حدوث خطأ. في حين أنه لا يمكن تحليل الاستهداف الذي تعذّر الاستهداف وتلك التي تعتمد عليه، يمكن إجراء متطلبات أساسية أخرى لهذه الأهداف.
العلامات: eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> التلقائي: "auto;quot;
عدد سلاسل المحادثات المتوازية المطلوب استخدامها لمرحلة التحميل/التحليل.ويتم استخدام عدد صحيح أو كلمة رئيسية ("auto", "HOST_CPUS", "HOST_RAM") متبوعةً بعملية ([-|*]< العدد>) مثل. "auto", "HOST_CPUS*.5" "auto"تعيين إعداد تلقائي معقول بناءً على موارد المضيف. يجب أن تكون 1 على الأقل.
العلامات: bazel_internal_configuration
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...> التلقائي: ""
يمكنك إضافة مفاتيح أو إزالتها من معلومات تنفيذ الإجراءات بناءً على تذكير الإجراء. لا ينطبق إلا على الإجراءات التي تدعم معلومات التنفيذ. وتتيح العديد من الإجراءات الشائعة استخدام معلومات التنفيذ، مثل Genrule وCppCompile وJavac وStarlarkAction وTestRunner. عند تحديد قيم متعددة، يكون هناك أهمية لترتيبها، لأن العديد من التعبيرات العادية قد تنطبق على رسالة التذكّر نفسها. البنية: "regex=[+-]key,regex=[+-]key،..." أمثلة: '.*=+x,.*=-y,.*=+z' يضيف 'x' و 'z' إلى 'y' من معلومات التنفيذ لكل الإجراءات. 'Genrule=+requirementss-x' يضيف 'يتطلب-x' إلى معلومات التنفيذ لجميع إجراءات Genrule. '(?!Genrule).*=-requireds-x' remove 'requirementss-x' من معلومات التنفيذ لكل الإجراءات غير المرتبطة بقاعدة Genrule.
العلامات: execution، affects_outputs، loading_and_analysis
--persistent_android_dex_desugar
تفعيل الإجراءات المستمرة في Android Dex and Deugar باستخدام العمّال.
التوسيع إلى:
--strategy=Desugar=worker
--strategy=DexBuilder=worker

العلامات: host_machine_resource_optimizations, execution
--persistent_android_resource_processor
تفعيل معالج موارد Android باستمرار باستخدام العاملين.
تتوسّع هذه الاستراتيجية إلى:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker.
--persistent_multiplex_android_dex_desugar
تفعيل إجراءات Android Dex متعددة الطلبات والسحب المتعددة باستخدام العمّال.
التوسيع إلى:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers

العلامات: host_machine_resource_optimizations, execution
--persistent_multiplex_android_resource_processor
تفعيل معالج موارد Android المتعدّدة المتعدد باستخدام العاملين.
تتوسّع هذه الاستراتيجية إلى:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers.
--persistent_multiplex_android_tools
تفعيل أدوات Android دائمة ومتعددة الإرسال (التكديس والإزالة ومعالجة الموارد).
التوسيع إلى:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar

العلامات: host_machine_resource_optimizations, execution
--spawn_strategy=<comma-separated list of options> التلقائي: ""
تحديد كيفية تنفيذ إجراءات التكاثر تلقائيًا. تقبل قائمة الاستراتيجيات مفصولة بفواصل من الأولوية القصوى إلى الأولوية الدنيا. وبالنسبة إلى كل إجراء، يختار Bazel الاستراتيجية ذات الأولوية القصوى التي يمكنها تنفيذ الإجراء. وتكون القيمة التلقائية هي "remote;workers,sandboxed,local". يمكنك الاطّلاع على https://blog.bazel.build/2019/06/19/list-strategy.html للحصول على التفاصيل.
العلامات: execution
تراكم --strategy=<a '[name=]value1[,..,valueN]' assignment> استخدامات متعددة
حدِّد كيفية توزيع مجموعة من الإجراءات الأخرى المتعلّقة بالتكاثر. تقبل قائمة الاستراتيجيات مفصولة بفواصل من الأولوية القصوى إلى الأولوية الدنيا. وبالنسبة إلى كل إجراء، يختار Bazel الاستراتيجية ذات الأولوية القصوى التي يمكنها تنفيذ الإجراء. وتكون القيمة التلقائية هي "remote;workers,sandboxed,local". تلغي هذه العلامة القيم التي تم ضبطها من خلال "-spawn_strategy" (و--genrule_strategy) في حال استخدامها مع الترميز Genmnonic. يمكنك الاطّلاع على https://blog.bazel.build/2019/06/19/list-strategy.html للحصول على التفاصيل.
العلامات: execution
تراكم --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> استخدامات متعددة
يمكنك إلغاء استراتيجية التكاثر التي يجب استخدامها لتنفيذ إجراءات التكاثر التي لها أوصاف تُطابق فلتر regex_حدّدًا. راجع --per_file_copt للحصول على تفاصيل حول مطابقة regex_filter. ويتم استخدام أول regex_filter يطابق الوصف. يلغي هذا الخيار العلامات الأخرى لتحديد الاستراتيجية. مثال: --strategy_regexp=//foo.*\.cc,-//foo/bar=local يعني تنفيذ الإجراءات باستخدام الاستراتيجية المحلية إذا كانت الأوصاف تُطابق //foo.*.cc. ولكنها غير //foo/bar. مثال: سيتم تشغيل --strategy_regexpdmca#39;Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed 'Compiling //foo/bar/baz' with 'local' with, but عكسs the order will run it with 'sandboxed&sandboxed&#sandbox9'sandbox.
العلامات: execution
الخيارات التي تحدّد سلسلة الأدوات المستخدَمة لتنفيذ الإجراء:
--android_compiler=<a string> التلقائي: عرض الوصف
أداة التجميع المستهدفة في Android.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--android_crosstool_top=<a build target label> التلقائي: "//external:android/crosstool"
الموقع الجغرافي للعارض C++ الذي يتم استخدامه لإصدارات Android
العلامات: affects_outputs، changes_inputs، loading_and_analysis، loses_incremental_state
--android_grte_top=<a label> التلقائي: عرض الوصف
هدف Android grte_top.
العلامات: changes_inputs، loading_and_analysis، loses_incremental_state
--android_manifest_merger=<legacy, android or force_android> التلقائي: "android;quot"
يحدد دمج البيان المراد استخدامه مع قواعد android_binary. الإبلاغ للمساعدة في الانتقال إلى دمج بيان Android من عملية الدمج القديمة.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--android_platforms=<a build target label> التلقائي: ""
يضبط هذا الإعداد الأنظمة الأساسية التي يستخدمها android_binary. وإذا تم تحديد أنظمة أساسية متعددة، يكون البرنامج الثنائي عبارة عن ملفات APK للدهون تحتوي على برامج ثنائية أصلية لكل نظام أساسي مستهدف محدّد.
العلامات: changes_inputs، loading_and_analysis، loses_incremental_state
--android_sdk=<a build target label> التلقائي: "@bazel_tools//tools/android:sdk"
يُحدِّد هذا الإعداد نظام التشغيل Android SDK/النظام الأساسي الذي يُستخدم لإصدار تطبيقات Android.
العلامات: changes_inputs، loading_and_analysis، loses_incremental_state
--apple_compiler=<a string> التلقائي: عرض الوصف
العارض أبل المستهدف. يفيد في اختيار صيغ سلسلة من الأدوات (مثل xcode-الإصدار التجريبي).
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--apple_crosstool_top=<a build target label> التلقائي: "@bazel_tools//tools/cpp:toolchain"
تصنيف الحزمة على جميع الأدوات المراد استخدامها في قواعد Apple وObjc وتبعياتها
العلامات: loses_incremental_state، changes_inputs
--apple_grte_top=<a build target label> التلقائي: عرض الوصف
هدف grte_top من Apple.
العلامات: changes_inputs، loading_and_analysis، loses_incremental_state
--cc_output_directory_tag=<a string> التلقائي: ""
يحدد لاحقة لإضافتها إلى دليل الإعداد.
العلامات: affects_outputs، explicit_in_output_path
--compiler=<a string> التلقائي: عرض الوصف
المحوّل C++ الذي سيتم استخدامه لتجميع الهدف.
العلامات: loading_and_analysis، execution
--coverage_output_generator=<a build target label> التلقائي: "@bazel_tools//tools/test:lcov_merger"
موقع البرنامج الثنائي الذي يتم استخدامه لمعالجة تقارير التغطية الأولية في مرحلة ما بعد المعالجة. يجب أن تكون هذه المجموعة حاليًا مجموعة ملفات تحتوي على ملف ثنائي، وهو برنامج ثنائي. القيمة التلقائية هي '//tools/test:lcov_merger'.
العلامات: changes_inputs، affects_outputs، loading_and_analysis
--coverage_report_generator=<a build target label> التلقائي: "@bazel_tools//tools/test:تغطيةage_report_creator"
موقع البرنامج الثنائي الذي يتم استخدامه لإنشاء تقارير التغطية. يجب أن تكون هذه المجموعة حاليًا مجموعة ملفات تحتوي على ملف ثنائي، وهو برنامج ثنائي. ويتم ضبطه تلقائيًا على '//tools/test:تغطيةage_report_creator'.
العلامات: changes_inputs، affects_outputs، loading_and_analysis
--coverage_support=<a build target label> التلقائي: "@bazel_tools//tools/test:تغطيةage_support"
مكان ملفات الدعم المطلوبة على مدخلات كل إجراء اختبار يجمع تغطية الرمز. ويتم ضبطه تلقائيًا على '//tools/test:تغطيةage_support'.
العلامات: changes_inputs، affects_outputs، loading_and_analysis
--crosstool_top=<a build target label> التلقائي: "@bazel_tools//tools/cpp:toolchain"
تصنيف الحزمة على جميع الأدوات التي يمكن استخدامها لتجميع رمز C++
العلامات: loading_and_analysis، changes_inputs، affects_outputs
--custom_malloc=<a build target label> التلقائي: عرض الوصف
تحدِّد هذه العملية عملية تنفيذ مخصّص لبيانات المستخدم. يلغي هذا الإعداد سمات مالوك في قواعد الإصدار.
العلامات: changes_inputs، affects_outputs
تراكم --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> استخدامات متعددة
قائمة بالتعبيرات العادية المفصولة بفواصل، على أن يكون كل منها مسبوقًا اختياريًا بعلامة - (التعبير السلبي)، مع تخصيص (=) إلى قائمة تتضمّن استهدافات قيم القيود المفصولة بفواصل. إذا كان أحد الاستهدافات لا يتطابق مع أي تعبير سالب وكان تعبير واحد موجب على الأقل، سيتم تنفيذ دقة سلسلة الأدوات كما لو كان قد أعلن عن قيم القيود كقيود على التنفيذ. مثال: سيضيف //demo,-test=@platforms//cpus:x86_64 &'x86_64' إلى أي استهداف ضمن //demo باستثناء تلك التي يحتوي اسمها على 'test'.
العلامات: loading_and_analysis
--[no]experimental_enable_objc_cc_deps التلقائي: "true;true"
يسمح هذا الإعداد لقواعد objc_* بالاعتماد على cc_library ويتسبب في إنشاء أي تبعيات objc باستخدام -cpu مع ضبط "ios;ios_<--ios_cpu>" لأي قيم في --ios_multi_cpu.
العلامات: loading_and_analysis، incompatible_change
--[no]experimental_include_xcode_execution_requirements التلقائي: "false;quot;
في حال ضبط هذه السياسة، أضِف متطلّبات تنفيذ &"أبعاد:{x}:{version}"كل إجراء Xcode. إذا كان إصدار xcode يتضمّن تصنيفًا واصلًا، أضِف أيضًا مطلب التنفيذ &"أبعاد;sx-label:{version_label}".
العلامات: loses_incremental_state، loading_and_analysis، execution
--[no]experimental_prefer_mutual_xcode التلقائي: "true;true"
في حال كان هذا صحيحًا، استخدِم أحدث إصدار من Xcode المتاح محليًا وعن بُعد. وإذا كانت القيمة غير صحيحة، أو في حال عدم توفّر إصدارات مشتركة، استخدِم إصدار Xcode المحلي الذي تم اختياره من خلال xcode-select.
العلامات: loses_incremental_state
تراكم --extra_execution_platforms=<comma-separated list of options> استخدامات متعددة
المنصّات المتوفّرة كمنصّات تنفيذ لتنفيذ الإجراءات. يمكن تحديد المنصّات من خلال الاستهداف الدقيق أو كنمط هدف. وسيتم النظر في هذه الأنظمة الأساسية قبل تلك المُعلَنة في ملف WORKSPACE بواسطة record_execution_platforms().
العلامات: execution
تراكم --extra_toolchains=<comma-separated list of options> استخدامات متعددة
قواعد سلسلة الأدوات التي يجب أخذها في الاعتبار أثناء حلّ سلسلة الأدوات يمكن تحديد سلاسل الأدوات حسب الهدف الدقيق أو كنمط هدف. سيتم مراعاة سلاسل الأدوات هذه قبل تلك المُعلَنة في ملف WORKSPACE بواسطة record_toolchains().
العلامات: affects_outputs وchanges_inputs وloading_and_analysis
--grte_top=<a label> التلقائي: عرض الوصف
تصنيف في مكتبة libc تم تسجيل الدخول إليها يتم اختيار القيمة التلقائية من خلال سلسلة الأدوات المختلفة.
العلامات: action_command_lines، affects_outputs
--host_compiler=<a string> التلقائي: عرض الوصف
محول C++ للاستخدام لتجميع المضيف. ويتم تجاهل هذه السياسة إذا لم يتم ضبط "host_crosstool_top".
العلامات: loading_and_analysis، execution
--host_crosstool_top=<a build target label> التلقائي: عرض الوصف
يتم أيضًا استخدام الخيارَين --crosstool_top و-- المجمِّع تلقائيًا لضبط المضيف. في حال توفير هذه العلامة، يستخدم Bazel المعلَمة التلقائية libc ومُجمِّع الخاصية Crosstool_top المحددة.
العلامات: loading_and_analysis، changes_inputs، affects_outputs
--host_grte_top=<a label> التلقائي: عرض الوصف
في حال تحديد هذا الإعداد، يلغي دليل libc للمستوى الأعلى (--grte_top) لضبط المضيف.
العلامات: action_command_lines، affects_outputs
--host_platform=<a build target label> التلقائي: ""
تصنيف قاعدة النظام الأساسي التي تصف النظام المضيف.
العلامات: affects_outputs، changes_inputs، loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set التلقائي: "true;true"
في حال ضبط السياسة على "صحيح"، لن يسمح Bazel بتحديد extension_if_all_available فيFlag_sets(يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7008 للحصول على تعليمات نقل البيانات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features التلقائي: "true;true"
إذا كان الأمر كذلك، لن يفعِّل Bazel 'host' و 'nonhost' الميزات في سلسلة أدوات c++ (يمكنك الاطّلاع على https://github.com/bazelbuild/bazel/issues/7407 لمزيد من المعلومات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_enable_android_toolchain_resolution التلقائي: "false;quot;
يمكنك استخدام دقة سلسلة الأدوات لاختيار حزمة تطوير البرامج (SDK) لنظام التشغيل Android لقواعد Android (إصدار Starlark والإعلانات المدمجة مع المحتوى)
العلامات: loading_and_analysis وincompatible_change
--[no]incompatible_enable_apple_toolchain_resolution التلقائي: "false;quot;
استخدام دقة سلسلة الأدوات لاختيار حزمة تطوير البرامج (SDK) الخاصة بـ Apple لتطبيق قواعد التفاح (Starlark وNative)
العلامات: loading_and_analysis وincompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، لن يُعيد تطبيق Bazel استخدام سطر الأوامر في إجراء C++ لرابط سطر الأوامر في سطر الأوامر لـ lto (راجِع https://github.com/bazelbuild/bazel/issues/6791 للحصول على مزيد من المعلومات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، سيقدّم Bazel شكوى عند ضبط سمتَي cc_toolchain.cpu وcc_toolchain.المجمِّع (يمكنك الاطّلاع على https://github.com/bazelbuild/bazel/issues/7075 للحصول على تعليمات حول نقل البيانات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_remove_legacy_whole_archive التلقائي: "true;true"
إذا كان الأمر كذلك، لن تربط Bazel تبعيات المكتبة كأرشيف بالكامل تلقائيًا (راجِع https://github.com/bazelbuild/bazel/issues/7362 للحصول على تعليمات نقل البيانات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_require_ctx_in_configure_features التلقائي: "true;true"
إذا كانت إجابتك صحيحة، سيطلب Bazel المعلّمة 'ctx' المعلَمة إلى cc_common.configure_features (يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7793 للحصول على مزيد من المعلومات).
العلامات: loading_and_analysis، incompatible_change
--[no]interface_shared_objects التلقائي: "true;true"
يمكنك استخدام العناصر المشتركة للواجهة إذا كانت متوافقة مع سلسلة الأدوات. تتيح جميع سلاسل أدوات ELF هذا الإعداد حاليًا.
العلامات: loading_and_analysis، affects_outputs، affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
يحدد إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل iOS لاستخدامه في إنشاء تطبيقات iOS. إذا لم يتم تحديدها، فإنها تستخدم الإصدار التلقائي من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من 'xcode_version'.
العلامات: loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
يحدد إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل macOS لاستخدامه في إنشاء تطبيقات macOS. إذا لم يتم تحديدها، فإنها تستخدم الإصدار التلقائي من نظام التشغيل macOS SDK من 'xcode_version'.
العلامات: loses_incremental_state
--minimum_os_version=<a string> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل الذي تستهدفه حزمة التجميع
العلامات: loading_and_analysis، affects_outputs
--platform_mappings=<a relative path> التلقائي: ""
مكان ملف الربط الذي يصف النظام الأساسي الذي يجب استخدامه في حال عدم ضبط أي من الأنظمة أو العلامات التي يتم تحديدها عند توفّر النظام الأساسي. يجب أن يكون مرتبطًا بجذر مساحة العمل الرئيسية. ويتم الإعداد تلقائيًا على 'platform_mappings' (ملف مباشرةً ضمن جذر مساحة العمل).
العلامات: affects_outputs، changes_inputs، loading_and_analysis
--platforms=<a build target label> التلقائي: ""
تصنيفات قواعد النظام الأساسي التي تصف الأنظمة الأساسية المستهدفة للأمر الحالي.
العلامات: affects_outputs، changes_inputs، loading_and_analysis
--python2_path=<a string> التلقائي: عرض الوصف
متوقّف نهائيًا، وقد تم إيقافه بواسطة `--incompatible_use_python_toolchains`.
العلامات: no_op وdeprecated
--python3_path=<a string> التلقائي: عرض الوصف
متوقّف نهائيًا، وقد تم إيقافه بواسطة `--incompatible_use_python_toolchains`.
العلامات: no_op وdeprecated
--python_path=<a string> التلقائي: عرض الوصف
تمثّل المسار المطلق في لغة Python في تشغيل أهداف Python على المنصة الهدف. متوقّف؛ تم الإيقاف من قِبل --incompatible_use_python_toolchains.
العلامات: loading_and_analysis، affects_outputs
--python_top=<a build target label> التلقائي: عرض الوصف
تصنيف py_runtime الذي يمثّل مترجم Python الذي تم استدعاءه لتنفيذ أهداف Python على النظام الأساسي الهدف متوقّف؛ تم الإيقاف من قِبل --incompatible_use_python_toolchains.
العلامات: loading_and_analysis، affects_outputs
--target_platform_fallback=<a build target label> التلقائي: "@local_config_platform//:host"
تصنيف قاعدة نظام أساسي يجب استخدامها في حال عدم ضبط أي منصة مستهدفة وعدم تطابق عملية ربط النظام الأساسي مع مجموعة العلامات الحالية
العلامات: affects_outputs، changes_inputs، loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
يحدد هذا الإعداد إصدار حزمة تطوير البرامج (SDK) لنظام tvOS لاستخدامها في إنشاء تطبيقات tvOS. إذا لم يتم تحديدها، يتم استخدام الإصدار التلقائي من حزمة tvOS SDK من 'xcode_version'.
العلامات: loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
يحدد هذا الإعداد إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Watch المستخدَم لإنشاء تطبيقات ساعة OS. إذا لم يتم تحديدها، سيتم استخدام الإصدار التلقائي من حزمة SDK لنظام التشغيل WatchOS من 'xcode_version'.
العلامات: loses_incremental_state
--xcode_version=<a string> التلقائي: عرض الوصف
في حال تم تحديد هذه السمة، استخدِم Xcode من الإصدار المحدّد لتنفيذ إجراءات الإصدار ذات الصلة. إذا لم يتم تحديده، يتم استخدام الإصدار التلقائي للمنفِّذ Xcode.
العلامات: loses_incremental_state
--xcode_version_config=<a build target label> التلقائي: "@bazel_tools//tools/cpp:host_xcodes"
تصنيف قاعدة xcode_config المُستخدَمة لاختيار إصدار Xcode في إعدادات الإصدار
العلامات: loses_incremental_state، loading_and_analysis
الخيارات التي تتحكّم في ناتج الأمر:
--[no]apple_enable_auto_dsym_dbg التلقائي: "false;quot;
ما إذا كان يجب فرض إنشاء ملفات تصحيح الأخطاء (.dSYM) لإصدارات dbg.
العلامات: affects_outputs، action_command_lines
--[no]apple_generate_dsym التلقائي: "false;quot;
تحديد ما إذا كان سيتم إنشاء ملفات تصحيح الأخطاء ( .dSYM)
العلامات: affects_outputs، action_command_lines
--[no]build التلقائي: "true;true"
نفِّذ عملية الإنشاء، وهذا هو السلوك المعتاد. يؤدي تحديد --nobuild إلى إيقاف الإصدار قبل تنفيذ إجراءات الإصدار وعرض صفر إذا تم الانتهاء من تحميل الحزمة والتحليل بنجاح، هذا الوضع مفيد لاختبار هذه المراحل.
العلامات: execution، affects_outputs
في حال ضبط هذه السياسة على "صحيح"، أنشِئ مجموعات رمزية للملفات القابلة للتنفيذ لجميع الاستهدافات. وفي حال ضبطها على "خطأ"، يُرجى كتابة البيانات فقط عند الإمكان.
العلامات: affects_outputs
--[no]build_runfile_manifests التلقائي: "true;true"
إذا كانت القيمة صحيحة، يُرجى كتابة بيانات ملفات Run لجميع الأهداف. وإذا لم تكن متوفّرة، احذفها. وسيتعذّر تشغيل الاختبارات المحلية عند ضبطها على "خطأ".
العلامات: affects_outputs
--[no]build_test_dwp التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، سيتم تلقائيًا إنشاء ملف .dwp لهذا البرنامج الثنائي عند إجراء اختبارات C++ بشكل ثابت، وسيتم أيضًا إنشاء ملف بالامتداد .dwp أيضًا.
العلامات: loading_and_analysis، affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options> التلقائي: "p.h.h"
يضبط بادئات ملفات العناوين التي ينشئها cc_proto_library.
العلامات: affects_outputs، loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options> التلقائي: ".pb.cc"
يضبط بادئات الملفات المصدر التي ينشئها cc_proto_library.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info التلقائي: "false;quot;
تنفيذ إجراءات إضافية لإصدارات Java api البديلة في proto_library.
العلامات: affects_outputs، loading_and_analysis، experimental
--[no]experimental_proto_extra_actions التلقائي: "false;quot;
تنفيذ إجراءات إضافية لإصدارات Java api البديلة في proto_library.
العلامات: affects_outputs، loading_and_analysis، experimental
--[no]experimental_run_validations التلقائي: "true;true"
يمكنك استخدام --run_validations بدلاً من ذلك.
العلامات: execution، affects_outputs
--[no]experimental_save_feature_state التلقائي: "false;quot;
حفظ حالة الخصائص المميّزة المطلوبة والمطلوبة كنتيجة للتجميع.
العلامات: affects_outputs، experimental
--[no]experimental_use_validation_aspect التلقائي: "false;quot;
تنفيذ إجراءات التحقّق باستخدام ميزة "الجانب" (التوازي مع الاختبارات)
العلامات: execution، affects_outputs
--fission=<a set of compilation modes> التلقائي: "no"
تحدد أوضاع التجميع التي تستخدم الأزمة بهدف تجميع C++ والروابط. يمكن أن تكون هذه الخوارزمية أيًا من {'fastbuild', 'dbg', 'opt'} أو القيم الخاصة 'yes' لتفعيل كل الأوضاع و 'no' لإيقاف جميع الأوضاع.
العلامات: loading_and_analysis، action_command_lines، affects_outputs
--[no]legacy_external_runfiles التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، أنشِئ مجموعات رمزية لمجلدات التشغيل للمستودعات الخارجية ضمن .runfiles/wsname/external/repo (بالإضافة إلى .runfiles/repo).
العلامات: affects_outputs
--[no]objc_generate_linkmap التلقائي: "false;quot;
يحدد هذا الإعداد ما إذا كان سيتم إنشاء ملف linklink.
العلامات: affects_outputs
تراكم --output_groups=<comma-separated list of options> استخدامات متعددة
قائمة بأسماء مجموعات الإخراج المفصولة بفواصل، على أن يكون كلٌّ منها مسبوقًا بعلامة "+" أو "-". تتم إضافة المجموعة التي تسبقها علامة "+" إلى المجموعة التلقائية لمجموعات الإخراج، بينما تتم إزالة المجموعة التي تسبقها المجموعة "-" من المجموعة التلقائية. في حال لم تكن هناك بادئة واحدة على الأقل، يتم حذف المجموعة التلقائية لمجموعات الإخراج. على سبيل المثال، تُنشئ --output_groups=+foo,+bar اتحاد المجموعة التلقائية وfoo والشريط، بينما يلغي -- --إخراج_groups=foo، الشريط التلقائي مثل هذه المجموعة فقط foo وشريط.
العلامات: execution، affects_outputs
--[no]run_validations التلقائي: "true;true"
تنفيذ إجراءات التحقّق كجزء من الإصدار يمكنك الاطّلاع على https://bazel.build/rules/rules#validation_actions
العلامات: execution وaffects_outputs
--[no]save_temps التلقائي: "false;quot;
في حال ضبط هذه السياسة، سيتم حفظ النتائج المؤقتة من gcc. تتضمّن هذه الملفات ملفات .s (رمز التجميع) وملفات i. (التي تتم معالجتها مسبقًا C) وملفات .ii (C++ التي تمت معالجتها مسبقًا).
العلامات: affects_outputs
الخيارات التي تتيح للمستخدم ضبط النتائج المطلوبة ما يؤثر في قيمتها بدلاً من ظهورها:
تراكم --action_env=<a 'name=value' assignment with an optional value part> استخدامات متعددة
يحدد مجموعة من متغيرات البيئة المتاحة للإجراءات مع الإعداد المستهدف. يمكن تحديد المتغيرات حسب الاسم، وفي هذه الحالة سيتم الحصول على القيمة من بيئة الاستدعاء، أو من خلال زوج الاسم=القيمة الذي يضبط القيمة بشكل مستقل عن بيئة الاستدعاء. يمكن استخدام هذا الخيار عدة مرات، أما بالنسبة إلى الخيارات المتوفرة للمتغيّر نفسه، فتختلف عمليات الفوز الأخيرة وآخر الخيارات.
العلامات: action_command_lines
--android_cpu=<a string> التلقائي: "armeabi-v7a"
وحدة المعالجة المركزية (CPU) المستهدفة في Android
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--[no]android_databinding_use_androidx التلقائي: "false;quot;
إنشاء ملفات ربط بيانات متوافقة مع AndroidX. وتُستخدم هذه الطريقة فقط مع الإصدار 2 من ربط البيانات.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state، experimental
--[no]android_databinding_use_v3_4_args التلقائي: "false;quot;
استخدام الإصدار 2.3 من Android Databinding مع الوسيطة 3.4.0
العلامات: affects_outputs وloading_and_analysis وloses_incremental_state وexperimental
--android_dynamic_mode=<off, default or fully> التلقائي: "off;quot;
يحدد ما إذا كان سيتم ربط أقسام C++ لقواعد Android بشكل ديناميكي عندما لا ينشئ cc_binary مكتبة مشتركة بشكل صريح. 'default' يعني اختيار البازيل الاختيار بين الربط ديناميكيًا. 'full' يعني ربط جميع المكتبات ديناميكيًا. 'off' يعني ربط جميع المكتبات في الوضع الثابت الثابت.
العلامات: affects_outputs، loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> التلقائي: "alphabetical"
يحدد ترتيب البيان الذي تم تمريره إلى دمج البيان لبرامج Android الثنائية. تعني كلمة "ALPHABALAL" أنّ البيانات يتم ترتيبها حسب المسار المرتبط بالتنفيذ. يعني ALPHABETICAL_BY_CONFIGURATION أن البيانات مرتّبة حسب المسارات بالنسبة إلى دليل الضبط ضمن دليل الناتج. يُقصد ببروتوكول DEPENDENCY أنّه يتم ترتيب البيان مع كل بيان في مكتبة المكتبة قبل عرضها على البيانات التابعة لها.
العلامات: action_command_lines، execution
--[no]android_resource_shrinking التلقائي: "false;quot;
تفعيل تقليص الموارد لملفات android_binary APK التي تستخدم ProGuard.
العلامات: affects_outputs، loading_and_analysis
تراكم --apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst> استخدامات متعددة
حدِّد وضع Apple Bicode لإعداد خطوات تجميع الخطوات التي تستهدف بُنى الأجهزة. وتكون القيم بالشكل التالي: وفي حال توفّر هذا الوضع، يتم تطبيق وضع الرمز البريدي على هذه المنصة تحديدًا، وفي حال حذفه، يتم تطبيقه على جميع الأنظمة الأساسية. يجب أن يكون الوضع &#39؛none' أو 'embed_flags' أو 'embed'. قد يتم تقديم هذا الخيار عدة مرات.
العلامات: loses_incremental_state
تراكم --aspects=<comma-separated list of options> استخدامات متعددة
قائمة جوانب مفصولة بفواصل يتم تطبيقها على الأهداف ذات المستوى الأعلى. في القائمة، إذا حدّد بعض جوانب العرض أصحاب الخصائص المطلوبة المطلوبين من خلال provider_aspect_providers، سيتم تشغيل بعض_الجانب بعد كل جانب تمت الإشارة إليه قبل ذلك في قائمة الأوجه التي يستوفي فيها مقدّمو الخدمة المُعلَن عن الإعلانات بعض جوانب العرض المطلوبة. علاوةً على ذلك، سيتم تشغيل بعض_الجوانب بعد جميع جوانبها المطلوبة التي تحدّدها السمة. وبعد ذلك، سيتوفّر لدى بعض_المواصفات إمكانية الوصول إلى قيم هذه الجوانب. <bzl-file-label>%<aspect_name> مثلاً '//tools:my_def.bzl%my_aspect', حيث 'my_aspect' هو قيمة عالية المستوى من أدوات الملفات/my_def.bzl
--[no]build_python_zip التلقائي: "auto;quot;
إنشاء ملف zip python قابل للتنفيذ، وتفعيله على Windows، وإيقافه على الأنظمة الأساسية الأخرى
العلامات: affects_outputs
تراكم --catalyst_cpus=<comma-separated list of options> استخدامات متعددة
قائمة من البُنى التي تُستخدم لإنشاء برامج ثنائية على Apple Catalyst مفصولة بفواصل.
العلامات: loses_incremental_state، loading_and_analysis
--[no]collect_code_coverage التلقائي: "false;quot;
في حال حدَّدت العلامة التجارية، ستستخدم Bazel رمز الوسيلة (باستخدام لوحة البيانات بلا اتصال بالإنترنت حيثما أمكن) وستجمع معلومات التغطية أثناء الاختبارات. ولن تتأثر سوى الاستهدافات التي تتطابق مع --toolation_filter. يجب عادةً عدم تحديد هذا الخيار مباشرةً - 'bazelتغطية' يجب استخدام الأمر بدلاً من ذلك.
العلامات: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] التلقائية: "fastbuild"
حدِّد الوضع الذي سيتم استخدامه في البرنامج الثنائي. القيم: 'Fastbuild', 'dbg', 'opt'
العلامات: affects_outputs، action_command_lines، explicit_in_output_path
تراكم --conlyopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى Gcc عند تجميع ملفات المصدر C.
العلامات: action_command_lines، affects_outputs
تراكم --copt=<a string> استخدامات متعددة
خيارات إضافية لإدخالها إلى Gcc.
العلامات: action_command_lines، affects_outputs
--cpu=<a string> التلقائي: ""
وحدة المعالجة المركزية (CPU) المستهدفة
العلامات: changes_inputs، affects_outputs، explicit_in_output_path
--cs_fdo_absolute_path=<a string> التلقائي: عرض الوصف
يمكنك استخدام معلومات ملف CSFDO الشخصي لتحسين التجميع. حدِّد اسم المسار المطلق لملف ZIP الذي يحتوي على ملف الملف الشخصي أو ملف شخصي غير مُعدَّل أو ملف شخصي مُفهرس LLVM مُفهرس.
العلامات: affects_outputs
--cs_fdo_instrument=<a string> التلقائي: عرض الوصف
إنشاء برامج ثنائية باستخدام أداة FDO الحساسة الحسّاسة من حيث السياق باستخدام مجمِّع Clang/LLVM، يقبل أيضًا اسم الدليل الذي يتم بموجبه تفريغ ملفات الملف الشخصي الأولية في وقت التشغيل.
العلامات: affects_outputs
--cs_fdo_profile=<a build target label> التلقائي: عرض الوصف
الملف cs_fdo_profile الذي يمثّل الملف الشخصي الحساس للسياق الذي سيتم استخدامه في التحسين.
العلامات: affects_outputs
تراكم --cxxopt=<a string> استخدامات متعددة
خيار إضافي لتمريره إلى Gcc عند تجميع ملفات مصدر C++.
العلامات: action_command_lines، affects_outputs
تراكم --define=<a 'name=value' assignment> استخدامات متعددة
يحدد كل خيار --define مهمة لمتغيّر إصدار.
العلامات: changes_inputs، affects_outputs
--dynamic_mode=<off, default or fully> التلقائي: "default;default"
يحدد ما إذا كان سيتم ربط برامج C++ الثنائية بشكل ديناميكي. 'default' يعني أن Bazel سيختار الربط بشكل ديناميكي. 'full' يعني ربط جميع المكتبات ديناميكيًا. 'off' يعني ربط جميع المكتبات في الوضع الثابت الثابت.
العلامات: loading_and_analysis، affects_outputs
--[no]enable_fdo_profile_absolute_path التلقائي: "true;true"
في حال تم ضبط هذه السياسة، سيؤدي استخدام fdo_absolute_profile_path إلى حدوث خطأ.
العلامات: affects_outputs
--[no]enable_runfiles التلقائي: "auto;quot;
تفعيل شجرة رمز التشغيل لملفات التشغيل، وبشكل تلقائي، يتم إيقافها على نظام التشغيل Windows على أنظمة أساسية أخرى
العلامات: affects_outputs
تراكم --experimental_action_listener=<a build target label> استخدامات متعددة
تم إيقافها لصالح جوانب مختلفة. استخدِم action_listener لإرفاق إجراء إضافي مع إجراءات الإصدار الحالية.
العلامات: execution، experimental
--[no]experimental_android_compress_java_resources التلقائي: "false;quot;
ضغط موارد Java في ملفات APK
العلامات: affects_outputs وloading_and_analysis وexperimental
--[no]experimental_android_databinding_v2 التلقائي: "false;quot;
استخدام السمة Android bindbind v2
العلامات: affects_outputs وloading_and_analysis وloses_incremental_state وexperimental
--[no]experimental_android_resource_shrinking التلقائي: "false;quot;
تفعيل تقليص الموارد لملفات android_binary APK التي تستخدم ProGuard.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex التلقائي: "false;quot;
استخدام أداة rex لإعادة كتابة ملفات dex
العلامات: affects_outputs وloading_and_analysis وloses_incremental_state وexperimental
تتحكّم هذه العلامة في كيفية إدارة الروابط الرمزية (الروابط الرمزية التي تظهر في مساحة العمل بعد الإصدار). القيم المحتملة: عادي (تلقائي): سيتم إنشاء أو حذف كل نوع من الروابط الرمزية، كما هو محدد في الإصدار. نظيفة: سيتم حذف جميع الروابط الرمزية بدون شروط. تجاهل: سيتم ترك الروابط الرمزية بشكل منفرد. log_only: أنشئ رسائل السجلّ كما لو كانت 'normal' تم اجتيازها، ولكنها لا تُنفّذ أي عمليات لنظام الملفات (مفيدة للأدوات). تجدر الإشارة إلى أنه يمكن تأثُّر الروابط الرمزية فقط التي يتم إنشاء أسمائها من خلال القيمة الحالية "--symlink_prefix". وفي حال تغيير البادئة، سيتم ترك أي روابط رمزية موجودة مسبقًا بمفردها.
العلامات: affects_outputs
تتحكّم هذه العلامة في ما إذا كنّا سننشر حدث eventحدث ConconfienceSymlinksIdentities إلى BuildEventProtocol أم لا. وفي حال كانت القيمة صحيحة، سيتضمّن BuildEventProtocol إدخالاً لـSMSymlinksIdentified مع إدراج جميع رموز تسهيل الاستخدام التي تم إنشاؤها في مساحة العمل. وعند ضبط السياسة على "خطأ"، لن يُتاح الإدخال EnterSymlinksIdentified في BuildEventProtocol.
العلامات: affects_outputs
تراكم --experimental_multi_cpu=<comma-separated list of options> استخدامات متعددة
تم إيقاف العمل به. No-op.
العلامات: affects_outputs، experimental
--experimental_objc_fastbuild_options=<comma-separated list of options> التلقائي: "-O0,-DDEBUG=1"
تستخدِم هذه السلاسل كخيارات مجمّع objc Fastbuild.
العلامات: action_command_lines
--[no]experimental_omitfp التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، استخدِم libunwind لتراجع استدعاء الدوال البرمجية وتجميعها باستخدام -fomit-frame-pointer و-fsync-unwind-tables.
العلامات: action_command_lines، affects_outputs، experimental
--[no]experimental_platform_in_output_dir التلقائي: "false;quot;
في حال اختيار هذا الإعداد، يتم استخدام النظام الأساسي المستهدف في اسم دليل الإخراج بدلاً من وحدة المعالجة المركزية (CPU).
العلامات: affects_outputs، experimental
--[no]experimental_use_llvm_covmap التلقائي: "false;quot;
في حال تحديد Bazel، ستُنشئ معلومات خريطة تغطية llvm-cov بدلاً من gcov عند تفعيل جمع_رمز_التغطية.
العلامات: changes_inputs، affects_outputs، loading_and_analysis، experimental
--fat_apk_cpu=<comma-separated list of options> التلقائي: "armeabi-v7a"
يؤدي ضبط هذا الخيار إلى تفعيل ملفات APK للدهون التي تحتوي على برامج ثنائية أصلية لكل البُنى المستهدَفة المحدّدة، مثل --fat_APK_cpu=x86,armeabi-v7a. إذا تم تحديد هذه العلامة، سيتم تجاهل --android_cpu في تبعيات قواعد android_binary.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--[no]fat_apk_hwasan التلقائي: "false;quot;
تحديد ما إذا كان سيتم إنشاء تقسيمات HWASAN.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--fdo_instrument=<a string> التلقائي: عرض الوصف
إنشاء برامج ثنائية باستخدام أداة FDO باستخدام مجمِّع Clang/LLVM، يقبل أيضًا اسم الدليل الذي يتم بموجبه تفريغ ملفات الملف الشخصي الأولية في وقت التشغيل.
العلامات: affects_outputs
--fdo_optimize=<a string> التلقائي: عرض الوصف
يمكنك استخدام معلومات الملف الشخصي لإدارة الأغذية والدواء لتحسين التجميع. حدِّد اسم ملف ZIP يحتوي على شجرة ملفات .gcda، أو ملف afdo يحتوي على ملف شخصي تلقائي، أو ملف شخصي LLVM. تقبل هذه العلامة أيضًا الملفات المحددة كتصنيفات (على سبيل المثال `//foo/bar:file.afdo` - قد تحتاج إلى إضافة توجيه "exports_files" إلى الحزمة المقابلة) والتصنيفات التي تشير إلى استهدافات "fdo_profile". ستحل قاعدة "fdo_profile" محل هذه العلامة.
العلامات: affects_outputs
--fdo_prefetch_hints=<a build target label> التلقائي: عرض الوصف
استخدام تلميحات الجلب المسبق لذاكرة التخزين المؤقت
العلامات: affects_outputs
--fdo_profile=<a build target label> التلقائي: عرض الوصف
الملف الشخصي fdo_profile الذي يمثّل الملف الشخصي الذي سيتم استخدامه للتحسين.
العلامات: affects_outputs
تراكم --features=<a string> استخدامات متعددة
سيتم تفعيل الميزات المعيّنة أو إيقافها بشكل تلقائي لجميع الحِزم. يؤدي تحديد -<feature> إلى إيقاف الميزة على المستوى العالمي. دائمًا ما تلغي الميزات السلبية الميزات الإيجابية. تُستخدَم هذه العلامة للسماح بطرح تغييرات تلقائية للميزات بدون إصدار Bazel.
العلامات: changes_inputs، affects_outputs
--[no]force_pic التلقائي: "false;quot;
في حال تفعيل هذه الميزة، تؤدي جميع مجمّعات C++ إلى إنشاء رمز مستقل عن الموضع ("-fPIC")، وتفضّل الروابط المكتبات المصمّمة مسبقًا بطريقة PIC بدلاً من المكتبات غير المزوّدة بتقنية PIC، وتنشئ الروابط روابط تنفيذية مستقلة عن الموضع ("-pie").
العلامات: loading_and_analysis، affects_outputs
تراكم --host_action_env=<a 'name=value' assignment with an optional value part> استخدامات متعددة
يحدد مجموعة متغيرات البيئة المتاحة للإجراءات التي تحتوي على إعدادات المضيف أو التنفيذ. يمكن تحديد المتغيرات حسب الاسم، وفي هذه الحالة سيتم الحصول على القيمة من بيئة الاستدعاء، أو من خلال زوج الاسم=القيمة الذي يضبط القيمة بشكل مستقل عن بيئة الاستدعاء. يمكن استخدام هذا الخيار عدة مرات، أما بالنسبة إلى الخيارات المتوفرة للمتغيّر نفسه، فتختلف عمليات الفوز الأخيرة وآخر الخيارات.
العلامات: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> التلقائي: "opt"
حدِّد الوضع الذي سيتم فيه استخدام الأدوات المُستخدَمة أثناء الإصدار. القيم: 'Fastbuild', 'dbg', 'opt'
العلامات: affects_outputs، action_command_lines
تراكم --host_conlyopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى Gcc عند تجميع ملفات المصدر C للأدوات المضيفة.
العلامات: action_command_lines، affects_outputs
تراكم --host_copt=<a string> استخدامات متعددة
خيارات إضافية لإدخال كلمة "مركز عملائي" إلى "أدوات المضيف".
العلامات: action_command_lines، affects_outputs
--host_cpu=<a string> التلقائي: ""
وحدة المعالجة المركزية (CPU) المضيفة
العلامات: changes_inputs، affects_outputs
تراكم --host_cxxopt=<a string> استخدامات متعددة
خيارات إضافية لإدخال كلمة "مركز عملائي" إلى "أدوات المضيف".
العلامات: action_command_lines، affects_outputs
--host_force_python=<PY2 or PY3> التلقائي: عرض الوصف
يلغي إصدار Python لضبط المضيف. يمكن أن تكون "PY2" أو &&;;PY3".
العلامات: loading_and_analysis، affects_outputs
تراكم --host_linkopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى مركز عملائي في حال الربط بأدوات المضيف.
العلامات: action_command_lines، affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل macOS المتوافق مع أهداف المضيف. إذا لم يتم تحديدها، استخدِم 'macos_sdk_version'.
العلامات: loses_incremental_state
تراكم --host_swiftcopt=<a string> استخدامات متعددة
خيارات إضافية للانتقال إلى swiftc لأدوات المضيف.
العلامات: action_command_lines، affects_outputs
--[no]incompatible_avoid_conflict_dlls التلقائي: "true;true"
في حال تفعيل هذا الإعداد، ستتم إعادة تسمية جميع مكتبات C++ الديناميكية المرتبطة (DLL) التي تم إنشاؤها بواسطة cc_library على نظام التشغيل Windows إلى name_{hash}.dll حيث يتم حساب التجزئة استنادًا إلى RepositoryName ومسار حزمة DLL'. يكون هذا الخيار مفيدًا عندما تكون لديك حزمة واحدة تعتمد على العديد من cc_library التي تحمل الاسم نفسه (مثل //foo/bar1:utils و //foo/bar2:utils).
العلامات: loading_and_analysis، affects_outputs، incompatible_change
--[no]incompatible_merge_genfiles_directory التلقائي: "true;true"
إذا كان هذا صحيحًا، يتم طي الدليل gfiles في دليل bin.
العلامات: affects_outputs، incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، تتم إزالة إعدادات القيود من @bazel_tools.
العلامات: affects_outputs، incompatible_change
--[no]instrument_test_targets التلقائي: "false;quot;
عند تفعيل التغطية، يتم تحديد ما إذا كنت تريد مراعاة قواعد اختبار قياس حالة التطبيق. وعند الضبط، يتم عرض قواعد الاختبار المضمّنة في --toolation_filter. وإلاّ، يتم دائمًا استبعاد قواعد الاختبار من أدوات التغطية.
العلامات: affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> التلقائي: "-/javatests[/:],-/test/java[/:]"
عند تفعيل التغطية، سيتم استخدام القواعد ذات الأسماء المضمنة من خلال الفلتر المستند إلى regex فقط. يتم استبعاد القواعد التي تبدأ بـ '-' بدلاً من ذلك. تجدر الإشارة إلى أنه لا يتم عرض سوى القواعد غير التجريبية ما لم يتم تفعيل --tool_test_targets.
العلامات: affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار iOS المتوافق مع أجهزة المحاكاة والأجهزة المستهدفة. إذا لم يتم تحديدها، استخدِم 'ios_sdk_version'.
العلامات: loses_incremental_state
تراكم --ios_multi_cpus=<comma-separated list of options> استخدامات متعددة
قائمة بتصميمات معمارية مفصولة بفواصل لإنشاء تطبيق ios. وتكون النتيجة برنامجًا ثنائيًا عامًا يحتوي على جميع البُنى المحدّدة.
العلامات: loses_incremental_state، loading_and_analysis
--[no]legacy_whole_archive التلقائي: "true;true"
تم إحلاله محل الإصدار --incompatible_remove_legacy_whole_archive (يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7362 لمزيد من التفاصيل). عند تفعيل هذا الإعداد، استخدِم --whole-archive لقواعد cc_binary التي تحتوي على رابط shared=True وlinkstatic=True أو '-static' في linkopts. وذلك لأغراض التوافق مع الأنظمة القديمة فقط. البديل الأفضل هو استخدام linklink=1 عند الحاجة.
العلامات: action_command_lines، affects_outputs، deprecated
تراكم --linkopt=<a string> استخدامات متعددة
خيار إضافي لتمرير البيانات إلى مركز عملائي عند الربط.
العلامات: action_command_lines، affects_outputs
تراكم --ltobackendopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى خطوة خلفية LTO (ضمن --features=thin_lto).
العلامات: action_command_lines، affects_outputs
تراكم --ltoindexopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى خطوة فهرسة LTO (ضمن --features=thin_lto).
العلامات: action_command_lines، affects_outputs
تراكم --macos_cpus=<comma-separated list of options> استخدامات متعددة
قائمة من البُنى التي تُنشئ تطبيقات ثنائية على نظام التشغيل Apple macOS مفصولة بفواصل.
العلامات: loses_incremental_state، loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل macOS المتوافق للأهداف. إذا لم يتم تحديدها، استخدِم 'macos_sdk_version'.
العلامات: loses_incremental_state
--[no]objc_debug_with_GLIBCXX التلقائي: "false;quot;
في حال ضبط السياسة وضبط وضع التجميع على 'dbg' ، حدِّد GLIBCXX_DEBUG وGLIBCXX_DEBUG_PEDANTIC وGLIBCPP_CONCEPT_checkS.
العلامات: action_command_lines
--[no]objc_enable_binary_stripping التلقائي: "false;quot;
تحديد ما إذا كان سيتم تنفيذ عمليات إزالة الرموز والرموز غير الصالحة على البرامج الثنائية المرتبطة. سيتم تنفيذ عمليات الإزالة الثنائية إذا تم تحديد كل من هذه العلامة و --compilation_mode=opt.
العلامات: action_command_lines
تراكم --objccopt=<a string> استخدامات متعددة
خيارات إضافية لإدخالها إلى "مركز عملائي" عند تجميع ملفات المصدر Purpose-C/C++.
العلامات: action_command_lines
تراكم --per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> استخدامات متعددة
خيارات إضافية للانتقال إلى GCC بشكل انتقائي عند تجميع ملفات معيّنة. يمكن تمرير هذا الخيار عدة مرات. البنية: regex_filter@option_1,option_2,...,option_n. حيث يشير regex_filter إلى قائمة تتضمن أنماط التعبير العادي واستبعادها (اطّلع أيضًا على --toolation_filter). يشير Option_1 إلى Option_n إلى خيارات سطر الأوامر العشوائية. إذا كان أحد الخيارات يحتوي على فاصلة، يجب اقتباسها شرطة مائلة للخلف. يمكن أن تحتوي الخيارات على @. يتم استخدام أول @ فقط لتقسيم السلسلة. مثال: يضيف --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 خيار سطر الأوامر -O0 إلى سطر الأوامر gcc لجميع ملفات cc في //foo/ باستثناء Bar.cc.
العلامات: action_command_lines، affects_outputs
تراكم --per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> استخدامات متعددة
خيارات إضافية للانتقال بشكل اختياري إلى خلفية LTO (ضمن --features=thin_lto) عند تجميع عناصر خلفية معيّنة. يمكن تمرير هذا الخيار عدة مرات. البنية: regex_filter@option_1,option_2,...,option_n. يشير الاختصار regex_filter إلى قائمة من أنماط التضمين العادية واستبعادها. يشير Option_1 إلى Option_n إلى خيارات سطر الأوامر العشوائية. إذا كان أحد الخيارات يحتوي على فاصلة، يجب اقتباسها شرطة مائلة للخلف. يمكن أن تحتوي الخيارات على @. يتم استخدام أول @ فقط لتقسيم السلسلة. مثال: يضيف --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 خيار سطر الأوامر -O0 إلى سطر الأوامر الخلفي لـ LTO لجميع ملفات o في //foo/ باستثناء Bar.o.
العلامات: action_command_lines، affects_outputs
--platform_suffix=<a string> التلقائي: عرض الوصف
يحدد لاحقة لإضافتها إلى دليل الإعداد.
العلامات: loses_incremental_state، affects_outputs، loading_and_analysis
--propeller_optimize=<a build target label> التلقائي: عرض الوصف
استخدِم معلومات الملف الشخصي للمحترفين لتحسين هدف الإصدار.يجب أن يحتوي الملف الشخصي للمعجب على ملفَين على الأقل، على أن يكون الملف الشخصي في حقل "نسخة إلى" وملفًا شخصيًا في ملف شخصي. تقبل هذه العلامة تصنيف إصدار يجب أن يشير إلى ملفات إدخال الملف الشخصي للدفع. على سبيل المثال، ملف BUILD الذي يحدّد التصنيف، في a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)يجب أن يتطابق التوجيه الذي يظهر مع الباصات أنّه يجب أن يكون وأن يكون بالإضافة إلى الحزمة متاحًا على الملف للسلع المُخزَّنة. يجب استخدام الخيار على النحو التالي: --propeller_optimize=//a/b:propeller_profile
العلامات: action_command_lines وaffects_outputs
--propeller_optimize_absolute_cc_profile=<a string> التلقائي: عرض الوصف
اسم المسار المطلق لملف cc_profile لإصدارات Propeller المحسّن.
العلامات: affects_outputs
--propeller_optimize_absolute_ld_profile=<a string> التلقائي: عرض الوصف
اسم المسار المطلق لملف ld_profile لإصدارات ProProler المحسّنة.
العلامات: affects_outputs
--run_under=<a prefix in front of command> التلقائي: عرض الوصف
بادئة لإدراجها قبل الملفات التنفيذية للأمرَين 'test' و 'run'. إذا كانت القيمة هي 'foo -bar'، وكان سطر أوامر التنفيذ هو 'test_binary -baz'، يكون سطر الأوامر النهائي هو 'foo -bar test_binary -baz'.ويمكن أن يكون هذا أيضًا تصنيفًا لهدف قابل للتنفيذ. بعض الأمثلة هي: 'valgrind','strace','strace -c', 'valgrind --quiet --num-callers=20', '//package:target',&33;//package:target',#39;//package:target',#39;//package:target'
العلامات: action_command_lines
--[no]share_native_deps التلقائي: "true;true"
في حال كان هذا صحيحًا، ستتم مشاركة المكتبات الأصلية التي تتضمّن وظائف متطابقة بين الأهداف المختلفة.
العلامات: loading_and_analysis وaffects_outputs
--[no]stamp التلقائي: "false;quot;
استخدِم الطوابع الثنائية بالتاريخ، واسم المستخدم، واسم المضيف، ومعلومات مساحة العمل، وما إلى ذلك.
العلامات: affects_outputs
--strip=<always, sometimes or never> التلقائي: "أحيانًا&quot
يحدد ما إذا كان سيتم إزالة البرامج الثنائية والمكتبات المشتركة (باستخدام "-Wl;---strip-debug"). تعني القيمة التلقائية 'أحيانًا##9
العلامات: affects_outputs
تراكم --stripopt=<a string> استخدامات متعددة
خيارات إضافية يتم تمريرها إلى شريط العناصر عند إنشاء برنامج '<name>.stripped' ثنائي.
العلامات: action_command_lines، affects_outputs
تراكم --swiftcopt=<a string> استخدامات متعددة
خيارات إضافية للانتقال إلى مجمّع Swift.
العلامات: action_command_lines
البادئة التي يتم إلحاقها بأي من الرموز المميزة المناسبة التي يتم إنشاؤها بعد الإصدار. إذا تم حذف القيمة، تكون القيمة التلقائية هي اسم أداة الإصدار متبوعة بواصلة. في حال اجتياز عملية & تحذير: سيتم إيقاف الوظيفة الخاصة لـ '/' قريبًا. استخدِم --experimental_convenience_symlinks=ignore بدلاً من ذلك.
العلامات: affects_outputs
تراكم --tvos_cpus=<comma-separated list of options> استخدامات متعددة
قائمة من البُنى التي تُستخدَم لإنشاء برامج ثنائية على Apple tvOS.
العلامات: loses_incremental_state، loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل المتوافق مع التلفزيونات لمحاكيات الأجهزة والأجهزة المستهدفة. إذا لم يتم تحديدها، استخدِم 'tvos_sdk_version'.
العلامات: loses_incremental_state
تراكم --watchos_cpus=<comma-separated list of options> استخدامات متعددة
قائمة من البُنى التي تُستخدَم لإنشاء برامج ثنائية على نظام التشغيل Apple Watch.
العلامات: loses_incremental_state، loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل المتوافق مع ساعة المشاهدة للمحاكيات والأجهزة المستهدفة. إذا لم يتم تحديدها، استخدِم 'watchos_sdk_version'.
العلامات: loses_incremental_state
--xbinary_fdo=<a build target label> التلقائي: عرض الوصف
استخدِم معلومات الملف الشخصي في XbinaryFDO لتحسين التجميع. تحديد اسم الملف الشخصي التلقائي على مستوى البرنامج الثنائي عند استخدام الخيار مع --fdo_tool/--fdo_optimize/--fdo_profile، سيُطبَّق هذا الخيار دائمًا كما لو لم يتم تحديد xbinary_fdo مطلقًا.
العلامات: affects_outputs
الخيارات التي تؤثّر في مدى قوة تطبيق Bazel لمدخلات الإصدارات الصالحة (تعريفات القواعد ومجموعات العلامات وغيرها):
--auto_cpu_environment_group=<a build target label> التلقائي: ""
يمكنك تعريف البيئة_group لاستخدامها لربط قيم وحدة المعالجة المركزية (CPU) تلقائيًا بقيم target_environment.
العلامات: changes_inputs، loading_and_analysis، experimental
--[no]check_licenses التلقائي: "false;quot;
تحقَّق من أنّ قيود الترخيص التي تفرضها الحِزم التابعة لا تتعارض مع أوضاع توزيع الأهداف التي يتم إنشاؤها. ولا يتم التحقق من التراخيص تلقائيًا.
العلامات: build_file_semantics
--[no]check_visibility التلقائي: "true;true"
في حال إيقاف هذا الإعداد، يتم خفض ترتيب أخطاء مستوى الرؤية في العناصر التابعة المستهدفة إلى تحذيرات.
العلامات: build_file_semantics
--[no]desugar_for_android التلقائي: "true;true"
يمكنك إزالة رمز Java 8 بايت قبل إلغاء تحويله إلى نص.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--[no]desugar_java8_libs التلقائي: "false;quot;
تضمين مكتبات Java 8 المتوافقة في التطبيقات المخصّصة للأجهزة القديمة.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state، experimental
--[no]enforce_constraints التلقائي: "true;true"
التحقّق من البيئات المتوافقة مع كل استهداف والإبلاغ عن الأخطاء في حال كان أي هدف يتضمن تبعيات لا تتوافق مع البيئات نفسها
العلامات: build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs التلقائي: "false;quot;
يمكنك الإبلاغ للمساعدة في عملية الانتقال من عدم السماح بقواعد android_librarys التي لا تتضمّن srcs مع حذفات فرعية. يجب تنظيف المستودع ليتم طرحه تلقائيًا.
العلامات: eagerness_to_exit، loading_and_analysis
--[no]experimental_check_desugar_deps التلقائي: "true;true"
التحقّق جيدًا من مستوى الصواب الصحيح على مستوى برنامج Android الثنائي
العلامات: eagerness_to_exit، loading_and_analysis، experimental
--experimental_import_deps_checking=<off, warning or error> التلقائي: "off;quot;
عند تفعيل هذا الإعداد، تحقّق مما إذا كانت المهام التابعة لسمة aar_import مكتملة. يمكن أن يؤدي هذا التنفيذ إلى تلف الإصدار، أو يمكن أن يؤدي فقط إلى تحذيرات.
العلامات: loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default> التلقائي: "default;default"
في حال كان هذا صحيحًا، يتم التحقُّق من أن الاستهداف في Java يعلن بشكلٍ صريح عن جميع الأهداف المستخدمة مباشرةً على أنها اعتماديات.
العلامات: build_file_semantics، eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يمكنك التحقّق من الاختبار فقط بحثًا عن الاستهدافات الأساسية التي تمثل ملفات الإخراج من خلال البحث عن قاعدة الإنشاء فقط. ويتطابق هذا مع التحقّق من إذن الوصول.
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_disable_native_android_rules التلقائي: "false;quot;
في حال التفعيل، يتم إيقاف الاستخدام المباشر لقواعد Android الأصلية. يُرجى استخدام قواعد Android Starar على Android من https://github.com/bazelbuild/rules_android
العلامات: eagerness_to_exit وincompatible_change
--[no]incompatible_disable_native_apple_binary_rule التلقائي: "false;quot;
لا تتوفّر إمكانية التشغيل، ويتم الاحتفاظ بها هنا لتوفير التوافق مع الأنظمة القديمة.
العلامات: eagerness_to_exit، incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark التلقائي: "true;true"
في حال تفعيل هذه الميزة، عليك وضع معايير صارمة للتحقّق من صحة العناوين في واجهة برمجة التطبيقات Starlark
العلامات: loading_and_analysis وchanges_inputs وincompatible_change
--[no]incompatible_validate_top_level_header_inclusions التلقائي: "true;true"
إذا كان الأمر كذلك، ستتحقّق Bazel أيضًا من عمليات تضمين عناوين المستوى الأعلى (يمكنك الاطّلاع على https://github.com/bazelbuild/bazel/issues/10047 للحصول على مزيد من المعلومات).
العلامات: loading_and_analysis، incompatible_change
--[no]strict_filesets التلقائي: "false;quot;
في حال تفعيل هذا الخيار، يتم الإبلاغ عن مجموعات الملفات التي تتجاوز حدود الحزمة باعتبارها أخطاء. ولا تعمل هذه الميزة عند إيقاف check_fileset_dependenities_recursively.
العلامات: build_file_semantics، eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default> التلقائي: "error&quot&quot
ما لم يتم إيقاف السياسة، تتحقّق تلك المعلّمة من أن الاستهداف في proto_library تُعلن صراحةً عن جميع الأهداف المستخدَمة مباشرةً على أنها اعتماديات.
العلامات: build_file_semantics، eagerness_to_exit، incompatible_change
--strict_public_imports=<off, warn, error, strict or default> التلقائي: "off;quot;
ما لم يتم إيقاف السياسة، تتحقّق من أنّ الاستهداف في Proto_library يحدّد بشكلٍ صريح جميع الأهداف المستخدَمة في 'import public' على أنّها تم تصديرها.
العلامات: build_file_semantics، eagerness_to_exit، incompatible_change
--[no]strict_system_includes التلقائي: "false;quot;
في حال كان هذا صحيحًا، يجب أيضًا أن تتضمّن العناوين التي تم العثور عليها من خلال النظام المسارات (-isystem) لعرضها.
العلامات: loading_and_analysis، eagerness_to_exit
تراكم --target_environment=<a build target label> استخدامات متعددة
تعلن هذه البيئة المستهدفة في هذا الإصدار. يجب أن يكون مرجع تصنيف خاصًا بقاعدة "en;ronviation". وفي حال تحديدها، يجب أن تكون جميع أهداف المستوى الأعلى متوافقة مع هذه البيئة.
العلامات: changes_inputs
الخيارات التي تؤثّر في التوقيع على التصميم:
--apk_signing_method=<v1, v2, v1_v2 or v4> التلقائي: "v1_v2"
التنفيذ المطلوب استخدامه لتوقيع حِزم APK
العلامات: action_command_lines وaffects_outputs وloading_and_analysis
--[no]device_debug_entitlements التلقائي: "true;true"
في حال ضبط هذا الإعداد ولم يتم ضبط وضع التجميع، 'opt'، ستحتوي تطبيقات objc على استحقاقات تصحيح الأخطاء عند التوقيع.
العلامات: changes_inputs
--ios_signing_cert_name=<a string> التلقائي: عرض الوصف
اسم الشهادة لاستخدامها في توقيع iOS. في حال ترك هذه السياسة بدون ضبط، سيتم الرجوع إلى الملف الشخصي لإدارة الحسابات. قد تكون هذه هي القيمة المفضّلة لسلسلة مفاتيح الشهادة أو (سلسلة فرعية) من الاسم الشائع للشهادة، وفقًا لصفحة الشخص الموقَّع للترميز (معرّفات التوقيع).
العلامات: action_command_lines
يؤثّر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بإصدارات BUILD أو ملفات .bzl أو ملفات WORKSPACE:
--[no]incompatible_config_setting_private_default_visibility التلقائي: "false;quot;
في حال عدم التوافق_ar_force_setting_setting_visible=false، هذه القيمة عمليّة جديدة. بخلاف ذلك، إذا كانت هذه العلامة غير صحيحة، أي config_setting بدون سمة ظهور واضحة هو //impression:public. إذا كانت هذه العلامة صحيحة، يتّبع config_setting منطق مستوى الرؤية نفسه الذي تتبعه جميع القواعد الأخرى. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12933.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_disallow_legacy_py_provider التلقائي: "true;true"
ستتم إزالة إمكانية التفعيل قريبًا.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_enforce_config_setting_visibility التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، فرض قيود على إعداد config_setting. وفي حال اختيار القيمة "خطأ"، سيكون كل إعداد config_setting مرئيًا لكل هدف. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12932.
العلامات: loading_and_analysis، incompatible_change
الخيارات التي تحكم سلوك بيئة الاختبار أو بيئة الاختبار:
--[no]allow_analysis_failures التلقائي: "false;quot;
في حال كان هذا صحيحًا، يؤدي تعذُّر تحليل هدف القاعدة إلى نشر مثيل " تحليلFailureInfo" لمنصّة "الهدف" التي تتضمّن وصف الخطأ، بدلاً من أن يؤدي إلى تعذّر إنشاء الإصدار.
العلامات: loading_and_analysis، experimental
--analysis_testing_deps_limit=<an integer> التلقائي: "2000"
يضبط هذا الإعداد الحد الأقصى لعدد التبعيات الانتقالية من خلال سمة قاعدة مع عملية نقل الإعداد for_analysis_testing. سيؤدي تجاوز هذا الحد إلى خطأ في القاعدة.
العلامات: loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure التلقائي: "false;quot;
في حال إخفاق إجراءات Dex2oat الفعلية، سيؤدي ذلك إلى تعطُّل الإصدار بدلاً من تنفيذ Dex2oat أثناء وقت التشغيل.
العلامات: loading_and_analysis، experimental
--[no]check_tests_up_to_date التلقائي: "false;quot;
لا أجرِ اختبارات، وما عليك سوى التأكّد من أنها حديثة. إذا كانت جميع نتائج الاختبارات محدَّثة، يتم إكمال الاختبار بنجاح. وإذا كان هناك حاجة إلى إنشاء أي اختبار أو تنفيذه، يتم الإبلاغ عن خطأ ولا يمكن إجراء الاختبار. يشير هذا الخيار إلى السلوك --check_up_to_date.
العلامات: execution
--[no]experimental_android_use_parallel_dex2oat التلقائي: "false;quot;
يمكنك استخدام dex2oat بالتوازي لمساعدتك على تسريع نظام التشغيل android_test.
العلامات: loading_and_analysis، host_machine_resource_optimizations، experimental
تراكم --flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once> استخدامات متعددة
ستتم إعادة محاولة إجراء كل اختبار حسب العدد المحدّد من المرات في حال تعذّر اجتياز أي اختبار. يتم تصنيف الاختبارات التي تتطلب أكثر من محاولة واحدة لاجتيازها على أنها 'FLAKY' في ملخص الاختبار. عادةً ما تكون القيمة المحددة مجرد عدد صحيح أو السلسلة 'default'. إذا كان عددًا صحيحًا، سيتم تشغيل جميع الاختبارات حتى س مرة. إذا كانت &'default'، سيتم إجراء محاولة اختبار واحدة فقط للاختبارات العادية وثلاثة لاختبارات تم وضع علامة عليها صراحةً على أنها غير ثابتة من خلال القاعدة (السمة flaky=1). البنية البديلة: regex_filter@flaky_test_attempts. حيث يشير flaky_test_attempts إلى ما هو وارد أعلاه، ويشير regex_filter إلى قائمة تتضمّن أنماط التعبير العادي ويستبعدها (يُرجى الاطّلاع أيضًا على --runs_per_test). مثال: --flaky_test_attempts=//foo/.*,-//foo/bar/.*@3 يؤدي إلى إزالة جميع الاختبارات في //foo/ باستثناء تلك التي تقع ضمن foo/bar ثلاث مرات. يمكن تمرير هذا الخيار عدة مرات. وتكون الأولوية للوسيطة التي تم تجاوزها مؤخرًا والتي تتطابق مع البيانات. إذا لم يتطابق أي شيء، سيكون السلوك كما لو كان 'default&#39؛ أعلاه.
العلامات: execution
--[no]ios_memleaks التلقائي: "false;quot;
تفعيل التحقق من تسرُّبات الذاكرة في أهداف ios_test.
العلامات: action_command_lines
--ios_simulator_device=<a string> التلقائي: عرض الوصف
الجهاز الذي سيتم محاكاةه عند تشغيل تطبيق iOS في المحاكي، مثلاً 'iPhone 6&#39؛ يمكنك الحصول على قائمة بالأجهزة من خلال تشغيل 'xcrun simctl list devicestypes' على الجهاز الذي سيتم تشغيل المحاكي عليه.
العلامات: test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
إصدار iOS الذي سيتم تشغيله على المحاكي عند تشغيله أو اختباره يتم تجاهل هذه القاعدة لقواعد ios_test في حال تحديد جهاز مستهدف في القاعدة.
العلامات: test_runner
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> التلقائي: "auto;quot;
الحد الأقصى لعدد مهام الاختبار المحلي التي سيتم تشغيلها بشكلٍ متزامن. يحصل على عدد صحيح أو كلمة رئيسية (&&;quot;auto","HOST_CPUS","HOST_RAM";) اختياريًا، تليها عملية ([-|*]< العدد>) مثل "auto", "HOST_CPUS*.5" 0 تعني الموارد المحلية الحدّ من عدد مهام الاختبار المحلي التي سيتم تشغيلها بشكلٍ متزامن. يعدّ ضبط هذه القيمة على قيمة "-jobs" غير فعّال.
العلامات: execution
تراكم --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> استخدامات متعددة
يحدد هذا الإعداد عدد مرات تشغيل كل اختبار. وفي حال فشل أي من هذه المحاولات لأي سبب، سيُعتبر الاختبار بالكامل فاشلاً. عادةً ما تكون القيمة المحددة مجرد عدد صحيح. مثال: سوف تُجري --runs_per_test=3 جميع الاختبارات 3 مرات. البنية البديلة: regex_filter@runs_per_test. يشير يشير run_per_test إلى قيمة العدد الصحيح بينما يشير regex_filter إلى قائمة تتضمن أنماط التعبير العادي ويستثنيها (اطّلع أيضًا على --toolation_filter). مثال: يُجري --runs_per_test=//foo/.*,-//foo/bar/.*@3 جميع الاختبارات في //foo/ باستثناء تلك التي تقع ضمن foo/bar ثلاث مرات. يمكن تمرير هذا الخيار عدة مرات. وتكون الأولوية للوسيطة التي تم تجاوزها مؤخرًا والتي تتطابق مع البيانات. في حال عدم تطابق أي شيء، لن يتم إجراء الاختبار سوى مرة واحدة.
تراكم --test_env=<a 'name=value' assignment with an optional value part> استخدامات متعددة
يحدد متغيرات بيئة إضافية ليتم إدخالها في بيئة تشغيل الاختبار. يمكن تحديد المتغيرات حسب الاسم، وفي هذه الحالة، ستتم قراءة قيمتها من بيئة عميل Bazel أو بواسطة زوج الاسم=القيمة. يمكن استخدام هذا الخيار عدة مرات لتحديد عدة متغيرات. لا يتم استخدامه إلا باستخدام الأمر 'bazel test'.
العلامات: test_runner
--[no]test_keep_going التلقائي: "true;true"
عند إيقاف الإعداد، سيتم إيقاف الإصدار بالكامل. يتم تنفيذ جميع الاختبارات تلقائيًا، حتى في حال لم تنجح بعض الاختبارات.
العلامات: execution
--test_strategy=<a string> التلقائي: ""
يحدّد الاستراتيجية التي يجب استخدامها عند إجراء الاختبارات.
العلامات: execution
--test_timeout=<a single integer or comma-separated list of 4 integers> التلقائي: "-1"
إلغاء قيم مهلة الاختبار التلقائية لمهلة الاختبار (بالثواني) في حال تحديد قيمة عدد صحيح موجب، سيتم إلغاء جميع الفئات. إذا تم تحديد 4 أرقام صحيحة مفصولة بفواصل، ستُلغي المهلات القصيرة والمتوسطة والطويلة والأبدية (بهذا الترتيب). في أي من الخيارين، تخبر القيمة -1 بلاز باستخدام المهلات التلقائية لهذه الفئة.
--test_tmpdir=<a path> التلقائي: عرض الوصف
يحدد الدليل المؤقت الأساسي لـ 'bazel test' للاستخدام.
--tvos_simulator_device=<a string> التلقائي: عرض الوصف
الجهاز الذي سيتم محاكاةه عند تشغيل تطبيق tvOS في المحاكي، مثلاً 'Apple TV 1080p' يمكنك الحصول على قائمة بالأجهزة من خلال تشغيل 'xcrun simctl list devicestypes' على الجهاز الذي سيتم تشغيل المحاكي عليه.
العلامات: test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
إصدار نظام التشغيل tvOS لتشغيله على المحاكي عند تشغيله أو اختباره
العلامات: test_runner
--watchos_simulator_device=<a string> التلقائي: عرض الوصف
الجهاز الذي يجب محاكاته عند تشغيل تطبيق ساعة نظام التشغيل في المحاكي، مثل 'Apple Watch - 38mm' يمكنك الحصول على قائمة بالأجهزة من خلال تشغيل 'xcrun simctl list devicestypes' على الجهاز الذي سيتم تشغيل المحاكي عليه.
العلامات: test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
إصدار نظام التشغيل الذي يتم تشغيله على جهاز المحاكاة عند تشغيله أو اختباره
العلامات: test_runner
--[no]zip_undeclared_test_outputs التلقائي: "true;true"
في حال كان هذا صحيحًا، ستتم أرشفة مخرجات الاختبار غير المعلَنة في ملف ZIP.
العلامات: test_runner
الخيارات التي تؤدي إلى تحسينات في وقت الإصدار:
--[no]collapse_duplicate_defines التلقائي: "false;quot;
عند التفعيل، ستتم إزالة القيم المكرّرة، في مرحلة مبكرة من الإصدار. يؤدي ذلك إلى تجنُّب فقدان ذاكرة التخزين المؤقت للتحليل غير ضروري لأنواع معيّنة من الإصدارات المكافئة.
العلامات: loading_and_analysis، loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar التلقائي: "false;quot;
يمكنك فلترة ProGuard ProgramJar لإزالة أي صفوف متوفّرة أيضًا في LibraryJar.
العلامات: action_command_lines
--[no]experimental_inmemory_dotd_files التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتم تمرير ملفات C++ .d في الذاكرة مباشرةً من عُقد الإصدار البعيدة بدلاً من كتابتها على القرص.
العلامات: loading_and_analysis، execution، affects_outputs، experimental
--[no]experimental_inmemory_jdeps_files التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتم تمرير ملفات الاعتمادية (.jdeps) التي تم إنشاؤها من التجميعات Java في الذاكرة مباشرةً من عُقد الإصدار البعيدة بدلاً من كتابتها على القرص.
العلامات: loading_and_analysis، execution، affects_outputs، experimental
--[no]experimental_objc_include_scanning التلقائي: "false;quot;
تحديد ما إذا كان مطلوبًا إجراء عملية فحص لتحقيق الهدف C/C++ .
العلامات: loading_and_analysis وexecution وchanges_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found التلقائي: "false;quot;
في حال تفعيل هذه الميزة، لا تنشئ ميزة pars_headers إجراء تجميع منفصل للرؤوس في حال العثور على مصدر يحمل الاسم الأساسي نفسه في الهدف نفسه.
العلامات: loading_and_analysis، affects_outputs
--[no]experimental_retain_test_configuration_across_testonly التلقائي: "false;quot;
عند تفعيل هذا الإعداد، لن يؤدي هذا إلى قطع إعداد الاختبار للقواعد التي تم وضع علامة testonly=1 عليها. تهدف هذه السياسة إلى الحدّ من مشاكل تعارض الإجراء عندما تعتمد القواعد غير التجريبية على قواعد cc_test. لا يتم تطبيق أي تأثير إذا كان --trim_test_configuration خطأ.
العلامات: loading_and_analysis، loses_incremental_state
--[no]experimental_starlark_cc_import التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يمكن استخدام إصدار Starlark من cc_import.
العلامات: loading_and_analysis، experimental
--[no]experimental_unsupported_and_brittle_include_scanning التلقائي: "false;quot;
تحديد ما إذا كان يمكن تضييق نطاق المدخلات إلى تجميع C/C++ عن طريق تحليل #include أسطر من ملفات الإدخال يمكن أن يؤدي ذلك إلى تحسين الأداء والتزايد عن طريق تقليل حجم أشجار الإدخال المجمّعة. ويمكن أيضًا أن يؤدي ذلك إلى إيقاف الإصدارات لأنّ الماسح الضوئي الذي يتضمّن تلك الأداة لا ينفّذ دلالات المعالج الأولي C بالكامل. وعلى وجه الخصوص، لا يفهم توجيهات #include الديناميكية ويتجاهل المنطق الشرطي المُسبق للمعالج. لذلك استخدمها على مسؤوليتك الشخصية. سيتم إغلاق أي مشاكل متعلقة بهذه العلامة التي تم تقديمها.
العلامات: loading_and_analysis، execution، changes_inputs
--[no]incremental_dexing التلقائي: "true;true"
يمكن تنفيذ معظم مهام العمل على سطح المكتب بشكل منفصل لكل ملف Jar.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--[no]objc_use_dotd_pruning التلقائي: "true;true"
في حال تم ضبط هذه السياسة، سيتم استخدام الملفات بالامتداد .d المنبّهة من قِبل المصدر.
العلامات: changes_inputs، loading_and_analysis
--[no]process_headers_in_dependencies التلقائي: "false;quot;
عند إنشاء هدف //a:a، تتم معالجة العناوين في جميع الأهداف التي //a:a تعتمد عليها (إذا تم تفعيل معالجة العناوين لسلسلة الأدوات).
العلامات: execution
--[no]trim_test_configuration التلقائي: "true;true"
عندما يكون الخيار مفعّلاً، سيتم محو الخيارات المتعلّقة بالاختبار تحت المستوى الأعلى من الإصدار. عندما تكون هذه العلامة نشطة، لا يمكن إنشاء الاختبارات كاعتماديات على القواعد غير التجريبية، ولكن التغييرات على الخيارات ذات الصلة بالاختبار لن تؤدي إلى إعادة تحليل القواعد غير التجريبية.
العلامات: loading_and_analysis، loses_incremental_state
--[no]use_singlejar_apkbuilder التلقائي: "true;true"
تم إيقاف هذا الخيار. وهو الآن غير متاح وستتم إزالته قريبًا.
العلامات: loading_and_analysis
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]announce التلقائي: "false;quot;
تم إيقاف العمل به. بيئة مستقلة:
العلامات: affects_outputs
--[no]experimental_bep_target_summary التلقائي: "false;quot;
ما إذا كان سيتم نشر أحداث Targetملخّص
--[no]experimental_build_event_expand_filesets التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، وسِّع "مجموعات الملفات" في الملف BEP عند تقديم ملفات الإخراج.
العلامات: affects_outputs
في حال ضبط هذه السياسة على"صحيح"، يجب حلّ روابط الملفات المُجمَّعة النسبية في ملف BEP عند عرض ملفات الإخراج. يتطلب --experimental_build_event_expand_filesets.
العلامات: affects_outputs
--experimental_build_event_upload_max_retries=<an integer> التلقائي: "4"
الحد الأقصى لعدد المرات التي يجب على Bazel إعادة محاولة تحميل حدث إصدار فيها.
العلامات: bazel_internal_configuration
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.> التلقائي: "1;"
أولاً، الحد الأدنى للتأخير في حالات إعادة المحاولة الأسية في حال تعذّر تحميل الملف BEP (الأس: 1.6)
العلامات: bazel_internal_configuration
--experimental_build_event_upload_strategy=<a string> التلقائي: عرض الوصف
يختار كيفية تحميل العناصر المُشار إليها في بروتوكول حدث الإصدار.
العلامات: affects_outputs
--[no]experimental_materialize_param_files_directly التلقائي: "false;quot;
في حال تحقيق ملفات وسائط، يمكنك إجراء ذلك من خلال الكتابة المباشرة على القرص.
العلامات: execution
--[no]experimental_stream_log_file_uploads التلقائي: "false;quot;
يمكن تحميل ملفات سجل السجلّ مباشرةً إلى وحدة التخزين عن بُعد بدلاً من كتابتها على القرص.
العلامات: affects_outputs
--explain=<a path> التلقائي: عرض الوصف
تعرض هذه الميزة نظام الإصدار لشرح كل خطوة تم تنفيذها من الإصدار. تتم كتابة التفسير في ملف السجلّ المُحدَّد.
العلامات: affects_outputs
--[no]legacy_important_outputs التلقائي: "true;true"
استخدِم هذا الخيار لإيقاف إنشاء حقل القيمة_الإخراجة القديمة في الحدث TargetComplete. ويجب توفّر المخرجات المهمة. إلى Bazel إلى ResultStore.
العلامات: affects_outputs
--[no]materialize_param_files التلقائي: "false;quot;
تكتب ملفات المعلمات المتوسطة لإخراج العرض التدرّجي حتى عند استخدام تنفيذ الإجراءات عن بُعد. يكون هذا الخيار مفيدًا عند تصحيح أخطاء الإجراءات. تتم الإشارة إلى ذلك باستخدام --subcommands و-verbose_failures.
العلامات: execution
--max_config_changes_to_show=<an integer> التلقائي: "3"
عند تجاهل ذاكرة التخزين المؤقت للتحليل بسبب تغيير في خيارات الإصدار، يتم عرض ما يصل إلى العدد المحدّد من أسماء الخيارات التي تم تغييرها. إذا كان الرقم الذي تم تقديمه هو -1، سيتم عرض جميع الخيارات التي تم تغييرها.
العلامات: terminal_output
--max_test_output_bytes=<an integer> التلقائي: "-1"
يحدد هذا الإعداد الحد الأقصى لحجم كل سجلّ اختبار يمكن إصداره عندما يكون --test_output هو 'errors' أو 'all'. وتُعدّ هذه الطريقة مفيدة لتجنّب إزعاج مخرجات الاختبار بإزعاج كثيرة. يتم تضمين رأس الاختبار في حجم السجلّ. لا تتضمّن القيم السلبية أي حدّ. النتيجة هي كل شيء أو لا شيء.
العلامات: test_runner، terminal_output، execution
--output_filter=<a valid Java regular expression> التلقائي: عرض الوصف
يعرض فقط تحذيرات القواعد التي تحمل اسمًا يتطابق مع التعبير العادي المقدَّم.
العلامات: affects_outputs
--progress_report_interval=<an integer in 0-3600 range> التلقائي: "0"
عدد الثواني المطلوب الانتظار خلالها بين تقريرين عن الوظائف التي لا تزال قيد التشغيل. تعني القيمة التلقائية 0 استخدام الخوارزمية المتزايدة 10:30:60.
العلامات: affects_outputs
--show_result=<an integer> التلقائي: "1;"
اعرض نتائج الإصدار. بالنسبة إلى كل هدف، حدِّد ما إذا كان قد تم تحديثه أم لا، وإذا كان الأمر كذلك، حدِّد قائمة بملفات الإخراج التي تم إنشاؤها. الملفات المطبوعة هي سلاسل ملائمة للنسخ واللصق إلى واجهة المستخدم لتنفيذها. يتطلب هذا الخيار وسيطة عدد صحيح، وهي عدد الحدّ الأدنى للأهداف التي لا تتم طباعة معلومات النتيجة فوقها. ويؤدي الصفر إلى إيقاف الرسالة، بينما يتسبب MAX_INT في طباعة النتيجة دائمًا. الإعداد التلقائي هو واحد.
العلامات: affects_outputs
--[no]subcommands [-s] التلقائية: "false"
اعرض الأوامر الفرعية التي تم تنفيذها أثناء الإصدار. العلامات ذات الصلة: --execution_log_json_file, --execution_log_binary_file (لتسجيل الأوامر الفرعية إلى ملف بتنسيق متوافق مع الأداة).
العلامات: terminal_output
--test_output=<summary, errors, all or streamed> التلقائي: "summary"
يحدد وضع الإخراج المطلوب. القيم الصالحة هي 'summary' لعرض نتائج حالة الاختبار فقط، 'errors' لطباعة سجلات الاختبار كذلك للاختبارات التي تعذّر تنفيذها، و#39;all' لطباعة سجلات جميع الاختبارات و#39;streamed' إلى نتائج السجلّ لجميع الاختبارات في الوقت الفعلي (سيؤدي ذلك إلى فرض تنفيذ الاختبارات محليًا في كل مرة بغض النظر عن ذلك - بصرف النظر عن قيمة الاختبار - بصرف النظر عن ذلك).
العلامات: test_runner، terminal_output، execution
--test_summary=<short, terse, detailed, none or testcase> التلقائي: "short;quot;
يحدد تنسيق ملخص الاختبار المطلوب. القيم الصالحة هي 'short' لطباعة المعلومات فقط حول الاختبارات التي تم تنفيذها، و#39;tere' ، ولطباعة معلومات فقط عن الاختبارات غير الناجحة التي تم إجراؤها، و#39;detailed' لطباعة معلومات مفصّلة عن حالات الاختبار التي تعذّر اجتيازها، و#39;testcase' لطباعة ملخّص لنتيجة الاختبار هذه وعدم حذف معلومة واحدة و#9 وبلغت 39% عن أي حالة اختبارية
العلامات: terminal_output
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> التلقائي: "-;*"
يمكنك طباعة معلومات تصحيح الأخطاء أثناء حل سلسلة الأدوات. تستخدِم العلامة تعبيرًا عاديًا يتم التحقّق منه في أنواع سلاسل الأدوات والأهداف المحدّدة لمعرفة الأخطاء التي سيتم تصحيحها. قد يتم فصل التعبيرات المتعددة بفواصل، ثم يتم التحقق من كل regex بشكل منفصل. ملاحظة: نتيجة هذه العلامة معقّدة جدًا ومن المرجّح أن تكون مفيدة فقط للخبراء الذين يمكنهم حلّ سلسلة الأدوات.
العلامات: terminal_output
--[no]verbose_explanations التلقائي: "false;quot;
تزيد الإسهاب من التفسيرات الصادرة في حال تفعيل "الشرح". ليس له أي تأثير في حالة عدم تفعيل-الشرح.
العلامات: affects_outputs
--[no]verbose_failures التلقائي: "false;quot;
في حال تعذّر تنفيذ أحد الأوامر، يُرجى طباعة سطر الأوامر بالكامل.
العلامات: terminal_output
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
تراكم --aspects_parameters=<a 'name=value' assignment> استخدامات متعددة
يحدد قيم معلّمات جوانب الأوامر. يتم تحديد كل قيمة معلّمة من خلال <param_name>ISBNlt;param_value> على سبيل المثال 'my_param=my_val ' حيث &&33;my_param' هي معلّمة لبعض الجوانب في قائمة-الجوانب أو مطلوبة من خلال جانب في القائمة. يمكن استخدام هذا الخيار عدة مرات. ومع ذلك، لا يُسمح بتخصيص قيم للمعلَمة نفسها أكثر من مرة.
العلامات: loading_and_analysis
تراكم --flag_alias=<a 'name=value' flag alias> استخدامات متعددة
باستخدام اسم مختلَف لعلامة Starlark ويتم استخدام زوج واحد من المفاتيح والقيم في النموذج "<key>ISBNlt;value>" كوسيطة.
العلامات: changes_inputs
--[no]incompatible_default_to_explicit_init_py التلقائي: "false;quot;
تُغيّر هذه العلامة السلوك التلقائي بحيث لا يتم إنشاء ملفات __init__.py تلقائيًا في ملفات تنفيذ أهداف Python. وبشكل خاص، عندما يتم ضبط هدف py_binary أو py_test على قديمة_create_init إلى "quot;auto;quot; (الإعداد التلقائي)، يتم التعامل معه على أنه خطأ في حال ضبط هذه العلامة فقط. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/10076.
العلامات: affects_outputs، incompatible_change
--[no]incompatible_py2_outputs_are_suffixed التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، ستظهر الأهداف المُنشَأة في إعدادات Python 2 ضمن جذر ناتج يتضمّن اللاحقة '-py2&#39، بينما ستظهر الأهداف المُنشَأة في Python 3 في جذر لا يتضمّن لاحقة Python. وهذا يعني أنّ الرمز المميّز المريح لـ "bazel-bin" سيشير إلى استهدافات Python 3 بدلاً من Python 2. في حال تفعيل هذا الخيار، ننصحك أيضًا بتفعيل `--incompatible_py3_is_default`.
العلامات: affects_outputs وincompatible_change
--[no]incompatible_py3_is_default التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، سيتم تلقائيًا ضبط السياستَين "py_binary" و"py_test` التي لم يتم ضبطهما على "python_version" (أو "default_python_version") في PY3 بدلاً من PY2. في حال ضبط هذه العلامة، ننصحك أيضًا بضبط `--incompatible_py2_outputs_are_suffixed`.
العلامات: loading_and_analysis وaffects_outputs وincompatible_change
--[no]incompatible_use_python_toolchains التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، فإنّ قواعد Python الأصلية القابلة للتنفيذ ستستخدم وقت تشغيل Python الذي تحدّده سلسلة أدوات Python، بدلاً من وقت التشغيل الذي تحدّده العلامات القديمة مثل --python_top.
العلامات: loading_and_analysis، incompatible_change
--python_version=<PY2 or PY3> التلقائي: عرض الوصف
وضع الإصدار الرئيسي في Python، إما "PY2" أو "PY3"، ويُرجى العلم بأنّه يتم إلغاء هذا الإعداد باستخدام هدفَي "py_binary" و"py_test` (حتى إذا لم يحدّدا إصدارًا صريحًا)، لذلك ليس هناك عادةً سبب كافٍ لتوفير هذه العلامة.
العلامات: loading_and_analysis، affects_outputs، explicit_in_output_path
--target_pattern_file=<a string> التلقائي: ""
في حال ضبط هذه السياسة، سيقرأ الإصدار أنماطًا من الملف المذكور هنا، بدلاً من سطر الأوامر. خطأ في تحديد ملف هنا بالإضافة إلى أنماط سطر الأوامر.
العلامات: changes_inputs
خيارات متنوعة، لا يتم تصنيفها بأي طريقة أخرى:
--[no]build_manual_tests التلقائي: "false;quot;
فرض إنشاء الأهداف المستهدفة التي تم وضع علامة عليها، 'manual'. 'manual' يتم استبعاد معالجة الاختبارات. يفرض هذا الخيار إنشاءها (وليس تنفيذها).
--build_tag_filters=<comma-separated list of options> التلقائي: ""
يحدد قائمة علامات مفصولة بفواصل. يمكن أن يسبق كل علامة اختياريًا مسبوقة بالعلامة '-' لتحديد العلامات المستبعدة. وسيتم فقط إنشاء هذه الأهداف التي تحتوي على علامة واحدة مُضمَّنة على الأقل ولا تحتوي على أي علامات مستبعدة. لا يؤثر هذا الخيار في مجموعة الاختبارات التي يتم تنفيذها باستخدام الأمر 'test'، حيث تخضع هذه الخيارات لخيارات فلترة الاختبار، على سبيل المثال '--test_tag_filters'
--[no]build_tests_only التلقائي: "false;quot;
في حال تحديد السياسة، سيتم إنشاء القواعد *_test وtest_suite فقط، وسيتم تجاهل الأهداف الأخرى المحدّدة في سطر الأوامر. وسيتم تلقائيًا إنشاء كل ما تم طلبه.
--[no]cache_test_results [-t] التلقائية: "auto;quot;
في حال ضبط الإعدادات على 'auto'، يُعيد Bazel إجراء الاختبار في الحالات التالية فقط: (1) اكتشاف Bazel للتغييرات في الاختبار أو تبعياته، أو (2) وضع علامة على الاختبار بأنه خارجي، أو (3) طلب تنفيذ عدة اختبارات باستخدام --runs_per_test أو(4) تعذّر الاختبار في السابق. في حال ضبط الإعدادات على 'yes'، يخزِّن Bazel جميع نتائج الاختبار مؤقتًا باستثناء الاختبارات التي تم وضع علامة عليها باعتبارها خارجية. في حال ضبط الإعدادات على 'no'، لا يخزّن Bazel أي نتائج اختبار في ذاكرة التخزين المؤقت.
--[no]compile_one_dependency التلقائي: "false;quot;
جمّع اعتمادية واحدة من ملفات الوسيطة. ويُفيد ذلك في التحقّق من ملفات المصدر في IDE على سبيل المثال، من خلال إعادة إنشاء استهداف واحد يعتمد على الملف المصدر لرصد الأخطاء في أقرب وقت ممكن في دورة التعديل/الإنشاء/الاختبار. وتؤثر هذه الوسيطة في طريقة تفسير كل الوسيطات التي لا تتضمن علامة، وبدلاً من أن تكون استهدافات لإنشاءها، فهي أسماء ملفات مصدر. وبالنسبة إلى كل اسم ملف مصدر، يتم إنشاء هدف عشوائي يعتمد على ذلك.
--deleted_packages=<comma-separated list of package names> التلقائي: ""
قائمة بأسماء الحِزم المفصولة بفاصلة والتي يعتبرها نظام الإصدار غير موجودة، حتى إذا كانت مرئية في مكان ما على مسار الحزمة. استخدِم هذا الخيار عند حذف حزمة فرعية 'x/y' من حزمة حالية 'x&#39؛. على سبيل المثال، بعد حذف x/y/BUILD في برنامجك، قد يعترض نظام الإصدار إذا واجه تصنيفًا '//x:y/z&#39؛ إذا كان لا يزال يتم تقديمه من خلال إدخال package_path آخر. ويؤدي تحديد --delete_packages x/y إلى تجنُّب هذه المشكلة.
--[no]discard_analysis_cache التلقائي: "false;quot;
تجاهل ذاكرة التخزين المؤقت للتحليل بعد اكتمال مرحلة التحليل مباشرةً يقلل من استخدام الذاكرة بنسبة %10 تقريبًا، ولكنه يجعل الإصدارات المتزايدة بشكل أبطأ.
--execution_log_binary_file=<a path> التلقائي: عرض الوصف
سجِّل تكاثر التنفيذ في هذا الملف كنماذج أوليّة ومحدّدة مسبقًا، وفقًا للسمة src/primary/protobuf/spawn.proto. تتم كتابة السجلّ أولاً بدون ترتيب، وفي نهاية الاستدعاء، يتم ترتيبه بترتيب ثابت (يمكن أن يكون وحدة المعالجة المركزية (CPU) وذاكرة مكثفة). العلامات ذات الصلة: --execution_log_json_file (تنسيق نص JSON))، و-experimental_execution_log_file (تنسيق Protobuf الثنائي غير المُرتَّب)، --subcommands (لعرض الأوامر الفرعية في المخرجات الطرفية).
--execution_log_json_file=<a path> التلقائي: عرض الوصف
سجِّل التغييرات التي يتم تنفيذها في هذا الملف كتمثيل json لنماذج Prown المفصولة بفواصل، وفقًا للسمة src/primary/protobuf/spawn.proto. تتم كتابة السجلّ أولاً بدون ترتيب، وفي نهاية الاستدعاء، يتم ترتيبه بترتيب ثابت (يمكن أن يكون وحدة المعالجة المركزية (CPU) وذاكرة مكثفة). العلامات ذات الصلة: العلامات ذات الصلة: --execution_log_binary_file (تنسيق Protobuf الثنائي) أو --experimental_execution_log_file (تنسيق Protobuf الثنائي غير المُرتَّب) --commands (لعرض الأوامر الفرعية في المخرجات الطرفية).
--[no]expand_test_suites التلقائي: "true;true"
عليك توسيع استهدافات test_suite إلى اختبارات الأقسام الخاصة بها قبل التحليل. عند تفعيل هذه العلامة (الإعداد التلقائي)، سيتم تطبيق أنماط الاستهداف السلبية على الاختبارات التي تنتمي إلى حزمة الاختبار، وإلا لن يتم تطبيقها. يكون إيقاف هذه العلامة مفيدًا عند تطبيق جوانب المستوى الأعلى على سطر الأوامر: وبعد ذلك، يمكن تحليل أهداف test_suite.
العلامات: loading_and_analysis
--[no]experimental_cancel_concurrent_tests التلقائي: "false;quot;
في حال كان هذا صحيحًا، ستلغي"بليز"الاختبارات بشكلٍ متزامن في أول عملية تشغيل ناجحة. ويكون هذا مفيدًا فقط جنبًا إلى جنب مع --runs_per_test_detects_flakes.
العلامات: affects_outputs، loading_and_analysis
--experimental_execution_log_file=<a path> التلقائي: عرض الوصف
سجِّل تكاثر التنفيذ في هذا الملف كنماذج أوليّة ومحدّدة مسبقًا، وفقًا للسمة src/primary/protobuf/spawn.proto. تمت كتابة هذا الملف بالترتيب الذي يتم به تربية النبات. العلامات ذات الصلة: --execution_log_binary_file (تنسيق Protobuf الثنائي) أو --execution_log_json_file (تنسيق النص json المطلوب) أو الأمر الأمر الفرعي (لعرض الأوامر الفرعية في المخرجات الطرفية).
--[no]experimental_execution_log_spawn_metrics التلقائي: "false;quot;
تضمين مقاييس التناسب في سجلّ النسلات التي تم تنفيذها.
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> التلقائي: ""
تم إيقافها لصالح جوانب مختلفة. فلاتر مجموعة من الأهداف لجدولة action_actions لإجراءات إضافية.
--[no]experimental_extra_action_top_level_only التلقائي: "false;quot;
تم إيقافها لصالح جوانب مختلفة. حدِّد جدولاً إجراءات إضافية_للأهداف ذات المستوى الأعلى فقط.
--[no]experimental_fetch_all_coverage_outputs التلقائي: "false;quot;
في حال اختيار قيم صحيحة، تجلب Bazel دليل بيانات التغطية بالكامل لكل اختبار أثناء إجراء التغطية.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_generate_llvm_lcov التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، ستتولّى تغطية النقرة الاجتماعية إنشاء تقرير LCOV.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_j2objc_header_map التلقائي: "true;true"
تحديد ما إذا كنت تريد إنشاء خريطة عنوان J2OBjC بالتوازي مع تحويل J2ObjC.
--[no]experimental_j2objc_shorter_header_path التلقائي: "false;quot;
تحديد ما إذا كان سيتم الإنشاء باستخدام مسار عنوان أقصر (يستخدِم "quot;_ios" بدلاً من &&;;j2objc")
العلامات: affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel> التلقائي: "javabuilder"
تفعيل مسارات تحليل منخفضة لتركيبات Java.
--[no]experimental_limit_android_lint_to_android_constrained_java التلقائي: "false;quot;
التقييد --experimental_run_android_lint_on_java_rules للمكتبات المتوافقة مع Android.
العلامات: affects_outputs
--[no]experimental_prioritize_local_actions التلقائي: "true;true"
في حال ضبط السياسة، يتم إعطاء الأولوية للإجراءات التي لا يمكن تنفيذها محليًا إلا في الحصول على الموارد، ويتم منح العوامل التي تُشغَّل ديناميكيًا الفرصة الثانية، وتكون الإجراءات المستقلة التي يتم تنفيذها ديناميكيًا أخيرًا.
العلامات: execution
--[no]experimental_run_android_lint_on_java_rules التلقائي: "false;quot;
التحقق من صحة مصادر java_*.
العلامات: affects_outputs
--[no]explicit_java_test_deps التلقائي: "false;quot;
يمكنك تحديد الاعتمادية صراحةً على JUnit أو Hamcrest في اختبار java_test بدلاً من الحصول عليها عن طريق الخطأ من TestRunner's. لا تعمل هذه الخدمة حاليًا إلا مع البازلاء.
--host_java_launcher=<a build target label> التلقائي: عرض الوصف
مشغِّل Java الذي تستخدمه الأدوات التي يتم تنفيذها أثناء عملية الإنشاء.
تراكم --host_javacopt=<a string> استخدامات متعددة
خيارات إضافية للانتقال إلى JavaScript عند تصميم الأدوات التي يتم تنفيذها أثناء إنشاء الإضافة.
تراكم --host_jvmopt=<a string> استخدامات متعددة
خيارات إضافية لتمريرها إلى جهاز افتراضي جافا (VM) عند إنشاء الأدوات التي يتم تنفيذها أثناء الإصدار. ستتم إضافة هذه الخيارات إلى خيارات بدء تشغيل الجهاز الافتراضي (VM) لكل هدف java_binary.
--[no]incompatible_exclusive_test_sandboxed التلقائي: "false;quot;
في حال كان هذا صحيحًا، سيتم إجراء الاختبارات الحصرية باستخدام استراتيجية وضع الحماية. أضِف 'local'Tag لفرض إجراء اختبار حصري محليًا
العلامات: incompatible_change
--[no]incompatible_strict_action_env التلقائي: "false;quot;
إذا كان الأمر كذلك، سيستخدم Bazel بيئة بقيمة ثابتة PATH ولا يكتسب LD_LIBRARY_PATH. استخدم --action_env=ENV_VARIABLE إذا كنت تريد اكتساب متغيرات بيئة معينة من العميل، ولكن لاحظ أن ذلك يمكن أن يؤدي إلى منع التخزين المؤقت بين المستخدمين في حال استخدام ذاكرة تخزين مؤقت مشتركة.
العلامات: loading_and_analysis، incompatible_change
تراكم --j2objc_translation_flags=<comma-separated list of options> استخدامات متعددة
خيارات إضافية للانتقال إلى أداة J2OBjC.
--java_debug
تسبّب هذه الأداة الجهاز الافتراضي لاختبار Java في اختبار لغة JavaScript في انتظار الاتصال بالإنترنت من برنامج تصحيح الأخطاء المتوافق مع JDWP (مثل jdb)، قبل بدء الاختبار. تضمين -test_output=streamed.
التوسيع إلى:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps التلقائي: "true;true"
يمكنك إنشاء معلومات الاعتمادية (في الوقت الحالي، مسار الصف وقت التجميع) لكل هدف Java.
--[no]java_header_compilation التلقائي: "true;true"
اجمَع الملفات من المصدر مباشرةً.
--java_language_version=<a string> التلقائي: "8;quot;
إصدار لغة Java
--java_launcher=<a build target label> التلقائي: عرض الوصف
مشغّل Java للاستخدام عند إنشاء برامج ثنائية Java. إذا تم ضبط هذه العلامة على السلسلة الفارغة، سيتم استخدام مشغّل تطبيقات JDK. تلغي السمة "مشغّل التطبيقات"علامة التبويب هذه العلامة.
--java_runtime_version=<a string> التلقائي: "local;local_jdk"
إصدار وقت تشغيل Java
تراكم --javacopt=<a string> استخدامات متعددة
خيارات إضافية للانتقال إلى JavaScript.
تراكم --jvmopt=<a string> استخدامات متعددة
خيارات إضافية لتمريرها إلى جهاز افتراضي يعمل بنظام التشغيل Java. ستتم إضافة هذه الخيارات إلى خيارات بدء تشغيل الجهاز الافتراضي (VM) لكل هدف java_binary.
--legacy_main_dex_list_generator=<a build target label> التلقائي: عرض الوصف
يحدد برنامجًا ثنائيًا لاستخدامه لإنشاء قائمة بالفئات التي يجب أن تكون في المجموعة الرئيسية عند تجميع الشاشات المتعددة القديمة.
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.> التلقائي: "HOST_CPUS"
حدِّد بشكلٍ صريح إجمالي عدد النوى المحلية لوحدة المعالجة المركزية المتوفّرة لدى Bazel للإنفاق على إجراءات الإصدار التي تم تنفيذها محليًا. يأخذ عددًا صحيحًا أو &&;; معلش_وحدة المعالجة المركزية (CPU)"، يليها اختياريًا [-|*]<؛> (على سبيل المثال HOST_CPUS*5. لاستخدام نصف وحدة المعالجة المركزية المتاحة لوحدة المعالجة المركزية (CPU).وفقًا للإعدادات التلقائية، ("HOST_CPUS")، سيبحث Bazel عن إعدادات النظام لتقدير عدد النوى المتاحة لوحدة المعالجة المركزية (CPU).
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.> التلقائي: "HOST_RAM*.67&quot
حدِّد صراحةً إجمالي ذاكرة الوصول العشوائي (RAM) للمضيف المحلي (بالميغابايت) المتاحة لشركة Bazel لإنفاقها على إجراءات الإصدار التي تم تنفيذها محليًا. يأخذ عددًا صحيحًا أو &&;;;; معلش_ذاكرة الوصول العشوائي&&;; وفيها خيار اختياري متبوعًا بـ [-|*]< العدد > (مثل HOST_RAM*.5 لاستخدام نصف ذاكرة الوصول العشوائي المتاحة). وفقًا للإعدادات التلقائية، ("HOST_RAM*.67")، سيبحث Bazel عن إعدادات النظام لتقدير حجم ذاكرة الوصول العشوائي المتاحة وسيستخدِم 67% منها.
--local_termination_grace_seconds=<an integer> التلقائي: "15&quot
حان وقت الانتظار بين إنهاء عملية محلية بسبب انتهاء المهلة وفرض إغلاقها.
--package_path=<colon-separated list of options> التلقائي: "%workspace%"
قائمة مفصولة بفواصل من المكان الذي يجب البحث فيه عن الطرود. العناصر التي تبدأ بـ '%workspace%' نسبية إلى مساحة العمل المضمنة. في حال حذف الحقل أو تركه فارغًا، يكون الإعداد التلقائي هو الناتج 'bazel information default-package-path'.
تراكم --plugin=<a build target label> استخدامات متعددة
المكوّنات الإضافية المراد استخدامها في الإصدار تعمل حاليًا مع java_plugin.
--proguard_top=<a build target label> التلقائي: عرض الوصف
يحدد إصدار ProGuard الذي يتم استخدامه لإزالة الرمز عند إنشاء برنامج ثنائي بلغة Java.
--proto_compiler=<a build target label> التلقائي: "@bazel_tools//tools/proto:protoc"
تصنيف مجمِّع النماذج الأولية
العلامات: affects_outputs، loading_and_analysis
--proto_toolchain_for_cc=<a build target label> التلقائي: "@bazel_tools//tools/proto:cc_toolchain"
تصنيف proto_lang_toolchain() الذي يصف طريقة تجميع Cpro+ protos
العلامات: affects_outputs وloading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> التلقائي: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"
يمكنك تصنيف proto_lang_toolchain() التي توضّح كيفية تجميع j2objc protos
العلامات: affects_outputs وloading_and_analysis
--proto_toolchain_for_java=<a build target label> التلقائي: "@bazel_tools//tools/proto:java_toolchain"
التصنيف "proto_lang_toolchain()" الذي يصف طريقة تجميع بيانات Java protos
العلامات: affects_outputs وloading_and_analysis
--proto_toolchain_for_javalite=<a build target label> التلقائي: "@bazel_tools//tools/proto:javalite_toolchain"
تصنيف proto_lang_toolchain() الذي يصف طريقة تجميع بيانات JavaLite Protos
العلامات: affects_outputs وloading_and_analysis
تراكم --protocopt=<a string> استخدامات متعددة
خيارات إضافية يمكن تمريرها إلى برنامج الترميز Protobuf.
العلامات: affects_outputs
--[no]runs_per_test_detects_flakes التلقائي: "false;quot;
في حال كان هذا صحيحًا، فإن أي جزء يتم فيه اجتياز عملية تشغيل/محاولة واحدة على الأقل وتعذّر تشغيل/محاولة واحدة على الأقل يحصل على حالة FLAKY.
--shell_executable=<a path> التلقائي: عرض الوصف
مسار مطلق إلى واجهة المستخدم التنفيذية التي سيستخدِمها Bazel. إذا لم يتم ضبط هذا الإعداد، ولكن تم ضبط متغيّر البيئة BAZEL_SH عند استدعاء Bazel الأول (بدء تشغيل خادم Bazel)، سيستخدم Bazel ذلك. إذا لم يتم ضبط أي من الإعدادين، سيستخدم Bazel مسارًا تلقائيًا ثابتًا وفقًا لنظام التشغيل على (Windows: c:/tools/msys64/usr/bin/bash.exe أو FreeBSD: /usr/local/bin/bash (جميع الأجهزة الأخرى: /bin/bash). تجدر الإشارة إلى أن استخدام واجهة غير متوافقة مع bash قد يؤدي إلى حدوث حالات إخفاق أو إخفاق في وقت التشغيل في البرامج الثنائية التي تم إنشاؤها.
العلامات: loading_and_analysis
--[no]show_loading_progress التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتسبب تطبيق Bazel في طباعة الرسائل &quot&تحميل الحِزمة:".
تراكم --test_arg=<a string> استخدامات متعددة
يحدد الخيارات الإضافية والوسيطات التي يجب تمريرها إلى الملف التنفيذي للاختبار. يمكن استخدامها عدة مرات لتحديد وسيطات متعددة. وفي حال تنفيذ اختبارات متعددة، سيتلقّى كل اختبار منها وسيطات متطابقة. لا يتم استخدامه إلا باستخدام الأمر 'bazel test'.
--test_filter=<a string> التلقائي: عرض الوصف
يحدد هذا الإعداد فلتر لإعادة التوجيه إلى إطار عمل الاختبار. يُستخدم للحد من إجراء الاختبارات. لاحظ أن هذا لا يؤثر في الأهداف التي يتم إنشاؤها.
--test_lang_filters=<comma-separated list of options> التلقائي: ""
يحدد قائمة لغات الاختبار مفصولة بفواصل. يمكن أن تسبق كل لغة اختياريًا باستخدام '-' لتحديد اللغات المستبعَدة. ولن يتم العثور سوى على تلك الأهداف التجريبية المكتوبة باللغات المحدّدة. يجب أن يكون الاسم المستخدَم لكل لغة هو نفسه بادئة اللغة في القاعدة *_test، مثل واحد من 'cc', 'java', 'py' وما إلى ذلك. يؤثر هذا الخيار في سلوك --build_tests_only وأمر الاختبار.
--test_result_expiration=<an integer> التلقائي: "-1"
تم إيقاف هذا الخيار وليس له أي تأثير.
--[no]test_runner_fail_fast التلقائي: "false;quot;
تتعذّر إعادة توجيه الخيار السريع إلى المشاركين في الاختبار. من المفترض أن يتوقف إجراء الاختبار عن العمل عند الفشل الأول.
--test_sharding_strategy=<explicit or disabled> التلقائي: "explicit"
حدِّد استراتيجية تجزئة الاختبار: 'explicit' لاستخدام التجزئة فقط في حال توفر السمة 'shard_count' BUILD. 'disabled' عدم استخدام تجزئة الاختبار مطلقًا.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous> التلقائي: ""
يحدد قائمة بأحجام الاختبارات مفصولة بفواصل. يمكن أن يسبق كل حجم اختياريًا باستخدام '-' لتحديد الأحجام المستبعدة. سيتم العثور على أهداف الاختبار هذه فقط التي تحتوي على حجم مُضمَّن واحد على الأقل ولا تحتوي على أي أحجام مستبعدة. يؤثر هذا الخيار في سلوك-build_tests_only وأمر الاختبار.
--test_tag_filters=<comma-separated list of options> التلقائي: ""
يحدد قائمة علامات الاختبار مفصولة بفواصل. يمكن أن يسبق كل علامة اختياريًا مسبوقة بالعلامة '-' لتحديد العلامات المستبعدة. سيتم العثور على أهداف الاختبار هذه التي تحتوي على علامة مضمّنة واحدة على الأقل ولا تحتوي على أي علامات مستبعدة. يؤثر هذا الخيار في سلوك-build_tests_only وأمر الاختبار.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal> التلقائي: ""
يُحدد قائمة مهلات الاختبار مفصولة بفواصل. يمكن أن تسبق كل مهلة بشكل اختياري مع '-' لتحديد المهلات المستبعدة. سيتم العثور على أهداف الاختبار هذه فقط التي تحتوي على مهلة واحدة على الأقل مُتضمَّنة ولا تحتوي على أي مهلات مستثناة. يؤثر هذا الخيار في سلوك-build_tests_only وأمر الاختبار.
--tool_java_language_version=<a string> التلقائي: "8;quot;
إصدار لغة Java المُستخدَمة لتنفيذ الأدوات اللازمة أثناء عملية الإنشاء
--tool_java_runtime_version=<a string> التلقائي: "remotejdk_11"
إصدار وقت تشغيل جافا المستخدم لتنفيذ الأدوات أثناء الإصدار
--[no]use_ijars التلقائي: "true;true"
في حال تفعيل هذا الإعداد، يؤدي التجميع عند تشغيل Java إلى استخدام جرارات للواجهة. وسيؤدي ذلك إلى تجميع البيانات بشكل أسرع، ولكن يمكن أن تختلف رسائل الخطأ.

خيارات علامات التصنيف الأساسية

يكتسب جميع الخيارات من إصدار.

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتحكّم في ناتج الأمر:
--[no]canonicalize_policy التلقائي: "false;quot;
بعد تنفيذ السياسة الأساسية، يتم توسيع نطاق السياسة الأساسية بعد فلترتها وفلترتها. وللحفاظ على سلامة الناتج، لن يتم عرض وسيطات الأمر الأساسية عند ضبط هذا الخيار على "صحيح". يُرجى العِلم أنّ الأمر المحدّد من خلال -for_command يؤثر في السياسة التي تمت فلترتها، وإذا لم يتم تحديد أي أمر، سيكون الأمر التلقائي 'build'.
العلامات: affects_outputs، terminal_output
--[no]show_warnings التلقائي: "false;quot;
إخراج تحذيرات المحلل اللغوي إلى الخطأ العادي (على سبيل المثال، بالنسبة إلى خيارات العلامات المتعارضة).
العلامات: affects_outputs، terminal_output
الخيارات التي تؤثر في مدى تطبيق Bazel لمدخلات الإصدار الصالحة (تعريفات القواعد ومجموعات العلامات وغيرها).
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
--[no]incompatible_config_setting_private_default_visibility التلقائي: "false;quot;
في حال عدم التوافق_ar_force_setting_setting_visible=false، هذه القيمة عمليّة جديدة. بخلاف ذلك، إذا كانت هذه العلامة غير صحيحة، أي config_setting بدون سمة ظهور واضحة هو //impression:public. إذا كانت هذه العلامة صحيحة، يتّبع config_setting منطق مستوى الرؤية نفسه الذي تتبعه جميع القواعد الأخرى. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12933.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_enforce_config_setting_visibility التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، فرض قيود على إعداد config_setting. وفي حال اختيار القيمة "خطأ"، سيكون كل إعداد config_setting مرئيًا لكل هدف. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12932.
العلامات: loading_and_analysis، incompatible_change
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة"bazel_dep"المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
في حال كان هذا الملف غير فارغ، يُرجى قراءة الملف المحدَّد بدلاً من ملف WORKSPACE
العلامات: changes_inputs
--for_command=<a string> التلقائي: "build;quot;
الأمر الذي يجب تحديد الخيارات الأساسية له.
العلامات: affects_outputs، terminal_output
--invocation_policy=<a string> التلقائي: ""
تطبِّق سياسة استدعاء على الخيارات الأساسية.
العلامات: affects_outputs، terminal_output
خيارات التخزين المؤقت والتنفيذ عن بُعد:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
--deleted_packages=<comma-separated list of package names> التلقائي: ""
قائمة بأسماء الحِزم المفصولة بفاصلة والتي يعتبرها نظام الإصدار غير موجودة، حتى إذا كانت مرئية في مكان ما على مسار الحزمة. استخدِم هذا الخيار عند حذف حزمة فرعية 'x/y' من حزمة حالية 'x&#39؛. على سبيل المثال، بعد حذف x/y/BUILD في برنامجك، قد يعترض نظام الإصدار إذا واجه تصنيفًا '//x:y/z&#39؛ إذا كان لا يزال يتم تقديمه من خلال إدخال package_path آخر. ويؤدي تحديد --delete_packages x/y إلى تجنُّب هذه المشكلة.
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.
--package_path=<colon-separated list of options> التلقائي: "%workspace%"
قائمة مفصولة بفواصل من المكان الذي يجب البحث فيه عن الطرود. العناصر التي تبدأ بـ '%workspace%' نسبية إلى مساحة العمل المضمنة. في حال حذف الحقل أو تركه فارغًا، يكون الإعداد التلقائي هو الناتج 'bazel information default-package-path'.
--[no]show_loading_progress التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتسبب تطبيق Bazel في طباعة الرسائل &quot&تحميل الحِزمة:".

خيارات التنظيف

يكتسب جميع الخيارات من إصدار.

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتحكّم في ناتج الأمر:
--[no]async التلقائي: "false;quot;
في حال كان هذا صحيحًا، لن تتم مزامنة الملفات الشخصية مع تلك التي تمت إزالتها. عند اكتمال هذا الأمر، سيكون تنفيذ الأوامر الجديدة آمنًا في البرنامج نفسه، على الرغم من أن الحذف قد يستمر في الخلفية.
العلامات: host_machine_resource_optimizations
--[no]expunge التلقائي: "false;quot;
في حال اختيار "صحيح"، تُزيل أداة "الحذف سريعًا" شجرة العمل بالكامل لهذه النسخة من البازلاء، والتي تتضمّن جميع الملفات المؤقتة التي تم إنشاؤها في البازلاء ويتم إنشاء ملفات إخراجات، وإيقاف الخادم إذا كان قيد التشغيل.
العلامات: host_machine_resource_optimizations
--expunge_async
في حال اختيار هذا الملف، يُنظّف الملف بشكل غير متزامن شجرة العمل بالكامل لنسخة البازل هذه، والتي تتضمّن جميع ملفات Bazel المؤقتة التي يتم إنشاؤها وتصميم ملفات للمخرجات، وتتوقّف عن تشغيل الخادم، إذا كان قيد التشغيل. عند اكتمال هذا الأمر، سيكون تنفيذ الأوامر الجديدة آمنًا في البرنامج نفسه، على الرغم من أن الحذف قد يستمر في الخلفية.
التوسيع إلى:
--expunge
--async

العلامات: host_machine_resource_optimizations
في حال ضبط السياسة على"صحيح"، سيتم حذف جميع الروابط الرمزية في مساحة العمل ذات البادئة symlink_prefix. بدون هذه العلامة، يتم فقط إزالة الروابط ذات اللاحقات المحدّدة مسبقًا.
العلامات: affects_outputs
الخيارات التي تؤثّر في مدى تطبيق Bazel لعمليات الإدخال الصالحة للرموز (تعريفات القواعد ومجموعات التركيبات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة"bazel_dep"المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.

خيارات الإعداد

خيارات التغطية

يكتسب جميع الخيارات من test.

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على "صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تؤثّر في مدى تطبيق Bazel لمدخلات صالحة لإنشاء الإصدارات (تعريفات القواعد ومجموعات العلامات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة "bazel_dep" المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.

خيارات Cquery

يكتسب جميع الخيارات من test.

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تؤثّر في مدى تطبيق Bazel لمدخلات صالحة لإنشاء الإصدارات (تعريفات القواعد ومجموعات العلامات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات ذات الصلة بمخرجات طلب البحث والدلالية:
--aspect_deps=<off, conservative or precise> التلقائي: "conserveative"
كيفية حل تبعيات العرض عندما يكون تنسيق الناتج واحدًا من {xml,proto,record}. 'off' تعني أنه لم يتم التعامل مع أي تبعيات للجانب، 'conserveative' (الإعداد التلقائي) تعني أن جميع تبعيات الجانب المُعلَن تمت إضافتها بغض النظر عما إذا تم منحها فئة قاعدة للاعتماديات المباشرة أو "#39;precise'" تعني أنه تتم إضافة هذه الجوانب التي من المحتمل أن تكون نشطة وفقًا لفئة القاعدة من التبعية المباشرة. لاحظ أن الوضع الدقيق يتطلب تحميل حِزم أخرى لتقييم هدف واحد، ما يجعله أبطأ من الأوضاع الأخرى. يُرجى العِلم أيضًا أنّ الوضع الدقيق ليس دقيقًا بالكامل، بل يتم اتّخاذ قرار بشأن احتساب جانب في مرحلة التحليل، وهو ما لا يتم تشغيله أثناء إعداد " #39;bazel query'".
العلامات: build_file_semantics
--[no]graph:factored التلقائي: "true;true"
إذا تم ضبط هذه السياسة على "صحيح"، سيتم دمج رسم بياني منشِئ &'عامل>&#39؛ أي أنه سيتم دمج العُقد المتماثلة طوبولوجيا معًا وربط تصنيفاتها. ينطبق هذا الخيار على --output=graph فقط.
العلامات: terminal_output
--graph:node_limit=<an integer> التلقائي: "512"
الحد الأقصى لطول سلسلة التصنيف لعقدة رسم بياني في الإخراج. سيتم اقتطاع التصنيفات الأطول، وتعني القيمة -1 عدم اقتطاعها. ينطبق هذا الخيار على --output=graph فقط.
العلامات: terminal_output
--[no]implicit_deps التلقائي: "true;true"
في حال تفعيل هذه الميزة، سيتم تضمين العناصر الضمنية في الرسم البياني للاعتمادية الذي يعمل عليه طلب البحث. الاعتمادية الضمنية هي تلك التي لم يتم تحديدها صراحةً في ملف BUILD، ولكن تمت إضافتها بواسطة البازل. بالنسبة إلى طلب البحث، يتحكم هذا الخيار في فلترة سلاسل الأدوات التي تم حلها.
العلامات: build_file_semantics
--[no]include_aspects التلقائي: "true;true"
aquery, cquery: ما إذا كان مطلوبًا تضمين الإجراءات التي يتم إنشاؤها من خلال العرض الجانبي في الإخراج. طلب البحث: no-op (يتم تتبّع الجوانب دائمًا).
العلامات: terminal_output
--[no]incompatible_display_source_file_location التلقائي: "true;true"
"صحيح" يعرض تلقائيًا الهدف من الملف المصدر. إذا كان هذا صحيحًا، يتم عرض موقع السطر 1 من الملفات المصدر في مخرجات الموقع. لا تتوفّر هذه العلامة إلا لأغراض نقل البيانات.
العلامات: terminal_output، incompatible_change
--[no]incompatible_package_group_includes_double_slash التلقائي: "true;true"
في حال تفعيل هذا الإعداد، عند حذف السمة package_group's "الحزم"، لن يتم حذف السمة "//" البادئة.
العلامات: terminal_output، incompatible_change
--[no]infer_universe_scope التلقائي: "false;quot;
في حال ترك السياسة بدون ضبط و --universe_scope بدون ضبط، سيتم استنتاج قيمة --universe_scope في شكل قائمة بالأنماط المستهدَفة الفريدة في تعبير طلب البحث. تجدُر الإشارة إلى أن قيمة --universe_scope التي تم استنتاجها لتعبير طلب بحث تستخدم الدوال على مستوى الكون (مثل `allrdeps`) قد لا تكون ما تريده، لذا يجب استخدام هذا الخيار فقط إذا كنت تعرف ما تفعله. يمكنك الاطّلاع على https://bazel.build/reference/query#sky-query لمعرفة التفاصيل والأمثلة. في حال ضبط --universe_scope، سيتم تجاهل قيمة هذا الخيار's. ملاحظة: ينطبق هذا الخيار فقط على "طلب البحث" (أي ليس "cquery").
العلامات: loading_and_analysis
--[no]line_terminator_null التلقائي: "false;quot;
ما إذا كان سيتم إنهاء كل تنسيق باستخدام \0 بدلاً من السطر الجديد.
العلامات: terminal_output
--[no]nodep_deps التلقائي: "true;true"
في حال تفعيل هذه السياسة، سيتم تضمين سمات من "nodep"، في الرسم البياني الخاص بالاعتمادية الذي يعمل عليه طلب البحث. ومن الأمثلة الشائعة للسمة "nodep" ";;;;;;; كيف إنّ "> شغِّل مخرجات "معلومات إصدار اللغة" وتحليلها للحصول على معلومات عن جميع السمات ""nodep" في لغة الإصدار.
العلامات: build_file_semantics
--output=<a string> التلقائي: "label;label"
التنسيق الذي يجب طباعة نتائج طلب البحث فيه. القيم المسموح بها لكل من cquery هي: label وlabel_kind وtextproto وtransitss وproto وjsonproto. إذا اخترت 'transitions&#39؛ عليك أيضًا تحديد الخيار --transitions=(lite|full).
العلامات: terminal_output
--[no]proto:default_values التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، يتم تضمين السمات التي لم يتم تحديد قيمتها صراحةً في ملف BUILD، وإلا سيتم حذفها. ينطبق هذا الخيار على --output=proto
العلامات: terminal_output
--[no]proto:definition_stack التلقائي: "false;quot;
تعبئة حقل pro_stack Proto الذي يسجّل كل مثيل القاعدة لحزمة استدعاء Starlark في الوقت الذي يتم فيه تحديد فئة القاعدة.
العلامات: terminal_output
--[no]proto:flatten_selects التلقائي: "true;true"
في حال تفعيل هذا الإعداد، يتم استنساخ السمات القابلة للضبط التي تم إنشاؤها من خلال Select(). بالنسبة إلى أنواع القوائم، يمثّل التمثيل مسطّحًا قائمة تتضمّن كل قيمة للخريطة المحدّدة مرة واحدة فقط. يتم تحويل أنواع الكميات إلى عناصر فارغة.
العلامات: build_file_semantics
--[no]proto:include_configurations التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتضمّن إخراج Proto معلومات حول عمليات الضبط. وعند إيقاف هذا الإعداد، يشبه تنسيق مخرجات طلب البحث Cto تنسيق تنسيق طلب البحث.
العلامات: affects_outputs
--[no]proto:include_synthetic_attribute_hash التلقائي: "false;quot;
يمكنك حساب السمة $internal_attr_hash تعبئتها أو لا.
العلامات: terminal_output
--[no]proto:instantiation_stack التلقائي: "false;quot;
تعبئة حزمة استدعاء مثيل كل قاعدة. يُرجى العلم أنّ ذلك يتطلّب توفّر الحزمة
العلامات: terminal_output
--[no]proto:locations التلقائي: "true;true"
تحديد ما إذا كان سيتم إخراج معلومات الموقع الجغرافي في وضع Proto تمامًا.
العلامات: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> التلقائي: "all"
قائمة سمات مفصولة بفواصل لتضمينها. ويتم إعداد كل السمات تلقائيًا. اضبط على سلسلة فارغة لإخراج أي سمة. ينطبق هذا الخيار على --output=proto.
العلامات: terminal_output
--[no]proto:rule_inputs_and_outputs التلقائي: "true;true"
تحديد ما إذا كنت تريد تعبئة حقلي base_input وrule_output
العلامات: terminal_output
--[no]relative_locations التلقائي: "false;quot;
إذا كان هذا صحيحًا، سيكون موقع ملفات BUILD في xml ومخرجات Proto نسبيًا. وفقًا للإعدادات التلقائية، تكون بيانات الموقع الجغرافي مسارًا مطلقًا ولن تكون متسقة على جميع الأجهزة. ويمكنك ضبط هذا الخيار على "صحيح" للحصول على نتيجة متسقة على جميع الأجهزة.
العلامات: terminal_output
--show_config_fragments=<off, direct or transitive> التلقائي: "off;quot;
تعرض أجزاء الضبط المطلوبة بواسطة قاعدة واعتمادياتها الانتقالية. يمكن أن تفيدك هذه المعلومات في تقييم الجزء الذي يمكن قطعه من الرسم البياني المستهدَف.
العلامات: affects_outputs
--starlark:expr=<a string> التلقائي: ""
تعبير Starlark لتنسيق كل هدف مستهدَف في cquery's --output=starlark. الهدف الذي تم ضبطه مرتبط بـ 'target'. إذا لم يتم تحديد --starlark:expr ولا --starlark:file، سيتم تلقائيًا ضبط هذا الخيار على 'str(target.label)'. ومن الخطأ تحديد كل من --starlark:expr و-starlark:file.
العلامات: terminal_output
--starlark:file=<a string> التلقائي: ""
اسم ملف يحدِّد دالة Starlark المعروفة باسم 'format'، من وسيطة واحدة، والتي يتم تطبيقها على كل هدف تم ضبطه لتنسيقه كسلسلة بيانات. ومن الخطأ تحديد كل من --starlark:expr و-starlark:file. للحصول على مزيد من التفاصيل، يُرجى الاطّلاع على المساعدة حول --output=starlark.
العلامات: terminal_output
--[no]tool_deps التلقائي: "true;true"
طلب بحث: في حال إيقاف هذه الميزة، لن يتم تضمين الأهداف المتعلّقة بالاعتمادات على 'host configuration' أو 'execution'; المستهدَفة في الرسم البياني للاعتمادية الذي يعمل عليه طلب البحث. A 'host configuration';الارتباطية: مثل تلك الموجودة في أي من 'proto_library' القاعدة إلى مجمّع البروتوكول، يوجّه عادةً إلى أداة تم تنفيذها أثناء الإصدار بدلاً من جزء من نفس البرنامج #&39;target' طلب البحث: في حال الإيقاف، يتم استبعاد جميع الأهداف التي تم ضبطها والتي من خلال نقل مضيف أو تنفيذ من الاستهداف من المستوى الأعلى الذي اكتشف هذا الاستهداف الذي تم ضبطه. وهذا يعني أنّه إذا كان الاستهداف ذو المستوى الأعلى في إعدادات الاستهداف، لن يتم عرض سوى الأهداف التي تم ضبطها في الإعدادات المستهدفة. إذا كان هدف المستوى الأعلى في ضبط المضيف، لن يتم عرض سوى الاستهدافات التي تم ضبطها للمضيف. ولن يستبعد هذا الخيار سلاسل الأدوات التي تم حلّها.
العلامات: build_file_semantics
--transitions=<full, lite or none> التلقائي: "none;quot;
التنسيق الذي سيطبع به طلب البحث معلومات النقل.
العلامات: affects_outputs
--universe_scope=<comma-separated list of options> التلقائي: ""
مجموعة من الأنماط المستهدفة مفصولة بفواصل (مضَافة وم طرحة). يمكن أن يتم تنفيذ طلب البحث في الكون المحدد عن طريق الإغلاق الانتقالي للأهداف المحدّدة. يُستخدَم هذا الخيار لطلبات البحث وcquery. بالنسبة إلى طلب البحث، إنّ الإدخال في هذا الخيار هو الأهداف التي تم إنشاء جميع الإجابات من خلالها، وبالتالي قد يؤثر هذا الخيار في الإعدادات وعمليات النقل. إذا لم يتم تحديد هذا الخيار، يتم افتراض أنّ أهداف المستوى الأعلى هي الأهداف التي تم تحليلها من تعبير طلب البحث. ملاحظة: بالنسبة إلى طلب البحث، قد يؤدي عدم تحديد هذا الخيار إلى تعطُّل الإصدار إذا كانت الأهداف التي يتم تحليلها من تعبير طلب البحث غير قابلة للإنشاء باستخدام خيارات المستوى الأعلى.
العلامات: loading_and_analysis
الخيارات المتعلقة بإخراج Bzlmod ودلالات الترميز:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة"bazel_dep"المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.
الخيارات التي تتحكّم في تنفيذ الإصدار:
تحديد ما إذا كان سيتم إجراء طلبات مباشرة لنظام الملفات لإنشاء أشجار رمزية
العلامات: loading_and_analysis وexecution وexperimental
--[no]experimental_remotable_source_manifests التلقائي: "false;quot;
تحديد ما إذا كان من الممكن اتخاذ إجراءات في بيان المصدر عن بُعد
العلامات: loading_and_analysis وexecution وexperimental
--[no]experimental_split_coverage_postprocessing التلقائي: "false;quot;
إذا كان الأمر كذلك، ستجري Bazel معالجة ما بعد التغطية لاختبارها في وقت جديد.
العلامات: execution
--[no]experimental_strict_fileset_output التلقائي: "false;quot;
إذا تم تفعيل هذا الخيار، ستتعامل مجموعات الملفات مع جميع عناصر الإخراج كملفات عادية. لن تمرِّر الأدلة أو تكون حساسة للروابط الرمزية.
العلامات: execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...> التلقائي: ""
يمكنك إضافة مفاتيح أو إزالتها من معلومات تنفيذ الإجراءات بناءً على تذكير الإجراء. لا ينطبق إلا على الإجراءات التي تدعم معلومات التنفيذ. وتتيح العديد من الإجراءات الشائعة استخدام معلومات التنفيذ، مثل Genrule وCppCompile وJavac وStarlarkAction وTestRunner. عند تحديد قيم متعددة، يكون هناك أهمية لترتيبها، لأن العديد من التعبيرات العادية قد تنطبق على رسالة التذكّر نفسها. البنية: "regex=[+-]key,regex=[+-]key،..." أمثلة: '.*=+x,.*=-y,.*=+z' يضيف 'x' و 'z' إلى 'y' من معلومات التنفيذ لكل الإجراءات. 'Genrule=+requirementss-x' يضيف 'يتطلب-x' إلى معلومات التنفيذ لجميع إجراءات Genrule. '(?!Genrule).*=-requireds-x' remove 'requirementss-x' من معلومات التنفيذ لكل الإجراءات غير المرتبطة بقاعدة Genrule.
العلامات: execution، affects_outputs، loading_and_analysis
--persistent_android_dex_desugar
تفعيل الإجراءات المستمرة في Android Dex and Deugar باستخدام العمّال.
التوسيع إلى:
--strategy=Desugar=worker
--strategy=DexBuilder=worker

العلامات: host_machine_resource_optimizations, execution
--persistent_android_resource_processor
تفعيل معالج موارد Android باستمرار باستخدام العاملين.
تتوسّع هذه الاستراتيجية إلى:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker.
--persistent_multiplex_android_dex_desugar
تفعيل إجراءات Android Dex متعددة الطلبات والسحب المتعددة باستخدام العمّال.
التوسيع إلى:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers

العلامات: host_machine_resource_optimizations, execution
--persistent_multiplex_android_resource_processor
تفعيل معالج موارد Android المتعدّدة المتعدد باستخدام العاملين.
تتوسّع هذه الاستراتيجية إلى:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers.
--persistent_multiplex_android_tools
تفعيل أدوات Android دائمة ومتعددة الإرسال (التكديس والإزالة ومعالجة الموارد).
التوسيع إلى:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar

العلامات: host_machine_resource_optimizations, execution
الخيارات التي تحدّد سلسلة الأدوات المستخدَمة لتنفيذ الإجراء:
--android_compiler=<a string> التلقائي: عرض الوصف
أداة التجميع المستهدفة في Android.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--android_crosstool_top=<a build target label> التلقائي: "//external:android/crosstool"
الموقع الجغرافي للعارض C++ الذي يتم استخدامه لإصدارات Android
العلامات: affects_outputs، changes_inputs، loading_and_analysis، loses_incremental_state
--android_grte_top=<a label> التلقائي: عرض الوصف
هدف Android grte_top.
العلامات: changes_inputs، loading_and_analysis، loses_incremental_state
--android_manifest_merger=<legacy, android or force_android> التلقائي: "android;quot"
يحدد دمج البيان المراد استخدامه مع قواعد android_binary. الإبلاغ للمساعدة في الانتقال إلى دمج بيان Android من عملية الدمج القديمة.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--android_platforms=<a build target label> التلقائي: ""
يضبط هذا الإعداد الأنظمة الأساسية التي يستخدمها android_binary. وإذا تم تحديد أنظمة أساسية متعددة، يكون البرنامج الثنائي عبارة عن ملفات APK للدهون تحتوي على برامج ثنائية أصلية لكل نظام أساسي مستهدف محدّد.
العلامات: changes_inputs، loading_and_analysis، loses_incremental_state
--android_sdk=<a build target label> التلقائي: "@bazel_tools//tools/android:sdk"
يُحدِّد هذا الإعداد نظام التشغيل Android SDK/النظام الأساسي الذي يُستخدم لإصدار تطبيقات Android.
العلامات: changes_inputs، loading_and_analysis، loses_incremental_state
--apple_compiler=<a string> التلقائي: عرض الوصف
العارض أبل المستهدف. يفيد في اختيار صيغ سلسلة من الأدوات (مثل xcode-الإصدار التجريبي).
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--apple_crosstool_top=<a build target label> التلقائي: "@bazel_tools//tools/cpp:toolchain"
تصنيف الحزمة على جميع الأدوات المراد استخدامها في قواعد Apple وObjc وتبعياتها
العلامات: loses_incremental_state، changes_inputs
--apple_grte_top=<a build target label> التلقائي: عرض الوصف
هدف grte_top من Apple.
العلامات: changes_inputs، loading_and_analysis، loses_incremental_state
--cc_output_directory_tag=<a string> التلقائي: ""
يحدد لاحقة لإضافتها إلى دليل الإعداد.
العلامات: affects_outputs، explicit_in_output_path
--compiler=<a string> التلقائي: عرض الوصف
المحوّل C++ الذي سيتم استخدامه لتجميع الهدف.
العلامات: loading_and_analysis، execution
--coverage_output_generator=<a build target label> التلقائي: "@bazel_tools//tools/test:lcov_merger"
موقع البرنامج الثنائي الذي يتم استخدامه لمعالجة تقارير التغطية الأولية في مرحلة ما بعد المعالجة. يجب أن تكون هذه المجموعة حاليًا مجموعة ملفات تحتوي على ملف ثنائي، وهو برنامج ثنائي. القيمة التلقائية هي '//tools/test:lcov_merger'.
العلامات: changes_inputs، affects_outputs، loading_and_analysis
--coverage_report_generator=<a build target label> التلقائي: "@bazel_tools//tools/test:تغطيةage_report_creator"
موقع البرنامج الثنائي الذي يتم استخدامه لإنشاء تقارير التغطية. يجب أن تكون هذه المجموعة حاليًا مجموعة ملفات تحتوي على ملف ثنائي، وهو برنامج ثنائي. ويتم ضبطه تلقائيًا على '//tools/test:تغطيةage_report_creator'.
العلامات: changes_inputs، affects_outputs، loading_and_analysis
--coverage_support=<a build target label> التلقائي: "@bazel_tools//tools/test:تغطيةage_support"
مكان ملفات الدعم المطلوبة على مدخلات كل إجراء اختبار يجمع تغطية الرمز. ويتم ضبطه تلقائيًا على '//tools/test:تغطيةage_support'.
العلامات: changes_inputs، affects_outputs، loading_and_analysis
--crosstool_top=<a build target label> التلقائي: "@bazel_tools//tools/cpp:toolchain"
تصنيف الحزمة على جميع الأدوات التي يمكن استخدامها لتجميع رمز C++
العلامات: loading_and_analysis، changes_inputs، affects_outputs
--custom_malloc=<a build target label> التلقائي: عرض الوصف
تحدِّد هذه العملية عملية تنفيذ مخصّص لبيانات المستخدم. يلغي هذا الإعداد سمات مالوك في قواعد الإصدار.
العلامات: changes_inputs، affects_outputs
تراكم --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> استخدامات متعددة
قائمة بالتعبيرات العادية المفصولة بفواصل، على أن يكون كل منها مسبوقًا اختياريًا بعلامة - (التعبير السلبي)، مع تخصيص (=) إلى قائمة تتضمّن استهدافات قيم القيود المفصولة بفواصل. إذا كان أحد الاستهدافات لا يتطابق مع أي تعبير سالب وكان تعبير واحد موجب على الأقل، سيتم تنفيذ دقة سلسلة الأدوات كما لو كان قد أعلن عن قيم القيود كقيود على التنفيذ. مثال: سيضيف //demo,-test=@platforms//cpus:x86_64 &'x86_64' إلى أي استهداف ضمن //demo باستثناء تلك التي يحتوي اسمها على 'test'.
العلامات: loading_and_analysis
--[no]experimental_enable_objc_cc_deps التلقائي: "true;true"
يسمح هذا الإعداد لقواعد objc_* بالاعتماد على cc_library ويتسبب في إنشاء أي تبعيات objc باستخدام -cpu مع ضبط "ios;ios_<--ios_cpu>" لأي قيم في --ios_multi_cpu.
العلامات: loading_and_analysis، incompatible_change
--[no]experimental_include_xcode_execution_requirements التلقائي: "false;quot;
في حال ضبط هذه السياسة، أضِف متطلّبات تنفيذ &"أبعاد:{x}:{version}"كل إجراء Xcode. إذا كان إصدار xcode يتضمّن تصنيفًا واصلًا، أضِف أيضًا مطلب التنفيذ &"أبعاد;sx-label:{version_label}".
العلامات: loses_incremental_state، loading_and_analysis، execution
--[no]experimental_prefer_mutual_xcode التلقائي: "true;true"
في حال كان هذا صحيحًا، استخدِم أحدث إصدار من Xcode المتاح محليًا وعن بُعد. وإذا كانت القيمة غير صحيحة، أو في حال عدم توفّر إصدارات مشتركة، استخدِم إصدار Xcode المحلي الذي تم اختياره من خلال xcode-select.
العلامات: loses_incremental_state
تراكم --extra_execution_platforms=<comma-separated list of options> استخدامات متعددة
المنصّات المتوفّرة كمنصّات تنفيذ لتنفيذ الإجراءات. يمكن تحديد المنصّات من خلال الاستهداف الدقيق أو كنمط هدف. وسيتم النظر في هذه الأنظمة الأساسية قبل تلك المُعلَنة في ملف WORKSPACE بواسطة record_execution_platforms().
العلامات: execution
تراكم --extra_toolchains=<comma-separated list of options> استخدامات متعددة
قواعد سلسلة الأدوات التي يجب أخذها في الاعتبار أثناء حلّ سلسلة الأدوات يمكن تحديد سلاسل الأدوات حسب الهدف الدقيق أو كنمط هدف. سيتم مراعاة سلاسل الأدوات هذه قبل تلك المُعلَنة في ملف WORKSPACE بواسطة record_toolchains().
العلامات: affects_outputs وchanges_inputs وloading_and_analysis
--grte_top=<a label> التلقائي: عرض الوصف
تصنيف في مكتبة libc تم تسجيل الدخول إليها يتم اختيار القيمة التلقائية من خلال سلسلة الأدوات المختلفة.
العلامات: action_command_lines، affects_outputs
--host_compiler=<a string> التلقائي: عرض الوصف
محول C++ للاستخدام لتجميع المضيف. ويتم تجاهل هذه السياسة إذا لم يتم ضبط "host_crosstool_top".
العلامات: loading_and_analysis، execution
--host_crosstool_top=<a build target label> التلقائي: عرض الوصف
يتم أيضًا استخدام الخيارَين --crosstool_top و-- المجمِّع تلقائيًا لضبط المضيف. في حال توفير هذه العلامة، يستخدم Bazel المعلَمة التلقائية libc ومُجمِّع الخاصية Crosstool_top المحددة.
العلامات: loading_and_analysis، changes_inputs، affects_outputs
--host_grte_top=<a label> التلقائي: عرض الوصف
في حال تحديد هذا الإعداد، يلغي دليل libc للمستوى الأعلى (--grte_top) لضبط المضيف.
العلامات: action_command_lines، affects_outputs
--host_platform=<a build target label> التلقائي: ""
تصنيف قاعدة النظام الأساسي التي تصف النظام المضيف.
العلامات: affects_outputs، changes_inputs، loading_and_analysis
--[no]incompatible_disable_expand_if_all_available_in_flag_set التلقائي: "true;true"
في حال ضبط السياسة على"صحيح"، لن يسمح Bazel بتحديد extension_if_all_available فيFlag_sets(يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7008 للحصول على تعليمات نقل البيانات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_dont_enable_host_nonhost_crosstool_features التلقائي: "true;true"
إذا كان الأمر كذلك، لن يفعِّل Bazel 'host' و 'nonhost' الميزات في سلسلة أدوات c++ (يمكنك الاطّلاع على https://github.com/bazelbuild/bazel/issues/7407 لمزيد من المعلومات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_enable_android_toolchain_resolution التلقائي: "false;quot;
يمكنك استخدام دقة سلسلة الأدوات لاختيار حزمة تطوير البرامج (SDK) لنظام التشغيل Android لقواعد Android (إصدار Starlark والإعلانات المدمجة مع المحتوى)
العلامات: loading_and_analysis وincompatible_change
--[no]incompatible_enable_apple_toolchain_resolution التلقائي: "false;quot;
استخدام دقة سلسلة الأدوات لاختيار حزمة تطوير البرامج (SDK) الخاصة بـ Apple لتطبيق قواعد التفاح (Starlark وNative)
العلامات: loading_and_analysis وincompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، لن يُعيد تطبيق Bazel استخدام سطر الأوامر في إجراء C++ لرابط سطر الأوامر في سطر الأوامر لـ lto (راجِع https://github.com/bazelbuild/bazel/issues/6791 للحصول على مزيد من المعلومات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، سيقدّم Bazel شكوى عند ضبط سمتَي cc_toolchain.cpu وcc_toolchain.المجمِّع (يمكنك الاطّلاع على https://github.com/bazelbuild/bazel/issues/7075 للحصول على تعليمات حول نقل البيانات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_remove_legacy_whole_archive التلقائي: "true;true"
إذا كان الأمر كذلك، لن تربط Bazel تبعيات المكتبة كأرشيف بالكامل تلقائيًا (راجِع https://github.com/bazelbuild/bazel/issues/7362 للحصول على تعليمات نقل البيانات).
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_require_ctx_in_configure_features التلقائي: "true;true"
إذا كانت إجابتك صحيحة، سيطلب Bazel المعلّمة 'ctx' المعلَمة إلى cc_common.configure_features (يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7793 للحصول على مزيد من المعلومات).
العلامات: loading_and_analysis، incompatible_change
--[no]interface_shared_objects التلقائي: "true;true"
يمكنك استخدام العناصر المشتركة للواجهة إذا كانت متوافقة مع سلسلة الأدوات. تتيح جميع سلاسل أدوات ELF هذا الإعداد حاليًا.
العلامات: loading_and_analysis، affects_outputs، affects_outputs
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
يحدد إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل iOS لاستخدامه في إنشاء تطبيقات iOS. إذا لم يتم تحديدها، فإنها تستخدم الإصدار التلقائي من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من 'xcode_version'.
العلامات: loses_incremental_state
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
يحدد إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل macOS لاستخدامه في إنشاء تطبيقات macOS. إذا لم يتم تحديدها، فإنها تستخدم الإصدار التلقائي من نظام التشغيل macOS SDK من 'xcode_version'.
العلامات: loses_incremental_state
--minimum_os_version=<a string> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل الذي تستهدفه حزمة التجميع
العلامات: loading_and_analysis، affects_outputs
--platform_mappings=<a relative path> التلقائي: ""
مكان ملف الربط الذي يصف النظام الأساسي الذي يجب استخدامه في حال عدم ضبط أي من الأنظمة أو العلامات التي يتم تحديدها عند توفّر النظام الأساسي. يجب أن يكون مرتبطًا بجذر مساحة العمل الرئيسية. ويتم الإعداد تلقائيًا على 'platform_mappings' (ملف مباشرةً ضمن جذر مساحة العمل).
العلامات: affects_outputs، changes_inputs، loading_and_analysis
--platforms=<a build target label> التلقائي: ""
تصنيفات قواعد النظام الأساسي التي تصف الأنظمة الأساسية المستهدفة للأمر الحالي.
العلامات: affects_outputs، changes_inputs، loading_and_analysis
--python2_path=<a string> التلقائي: عرض الوصف
متوقّف نهائيًا، وقد تم إيقافه بواسطة `--incompatible_use_python_toolchains`.
العلامات: no_op وdeprecated
--python3_path=<a string> التلقائي: عرض الوصف
متوقّف نهائيًا، وقد تم إيقافه بواسطة `--incompatible_use_python_toolchains`.
العلامات: no_op وdeprecated
--python_path=<a string> التلقائي: عرض الوصف
تمثّل المسار المطلق في لغة Python في تشغيل أهداف Python على المنصة الهدف. متوقّف؛ تم الإيقاف من قِبل --incompatible_use_python_toolchains.
العلامات: loading_and_analysis، affects_outputs
--python_top=<a build target label> التلقائي: عرض الوصف
تصنيف py_runtime الذي يمثّل مترجم Python الذي تم استدعاءه لتنفيذ أهداف Python على النظام الأساسي الهدف متوقّف؛ تم الإيقاف من قِبل --incompatible_use_python_toolchains.
العلامات: loading_and_analysis، affects_outputs
--target_platform_fallback=<a build target label> التلقائي: "@local_config_platform//:host"
تصنيف قاعدة نظام أساسي يجب استخدامها في حال عدم ضبط أي منصة مستهدفة وعدم تطابق عملية ربط النظام الأساسي مع مجموعة العلامات الحالية
العلامات: affects_outputs، changes_inputs، loading_and_analysis
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
يحدد هذا الإعداد إصدار حزمة تطوير البرامج (SDK) لنظام tvOS لاستخدامها في إنشاء تطبيقات tvOS. إذا لم يتم تحديدها، يتم استخدام الإصدار التلقائي من حزمة tvOS SDK من 'xcode_version'.
العلامات: loses_incremental_state
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
يحدد هذا الإعداد إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Watch المستخدَم لإنشاء تطبيقات ساعة OS. إذا لم يتم تحديدها، سيتم استخدام الإصدار التلقائي من حزمة SDK لنظام التشغيل WatchOS من 'xcode_version'.
العلامات: loses_incremental_state
--xcode_version=<a string> التلقائي: عرض الوصف
في حال تم تحديد هذه السمة، استخدِم Xcode من الإصدار المحدّد لتنفيذ إجراءات الإصدار ذات الصلة. إذا لم يتم تحديده، يتم استخدام الإصدار التلقائي للمنفِّذ Xcode.
العلامات: loses_incremental_state
--xcode_version_config=<a build target label> التلقائي: "@bazel_tools//tools/cpp:host_xcodes"
تصنيف قاعدة xcode_config المُستخدَمة لاختيار إصدار Xcode في إعدادات الإصدار
العلامات: loses_incremental_state، loading_and_analysis
الخيارات التي تتحكّم في ناتج الأمر:
--[no]apple_enable_auto_dsym_dbg التلقائي: "false;quot;
ما إذا كان يجب فرض إنشاء ملفات تصحيح الأخطاء (.dSYM) لإصدارات dbg.
العلامات: affects_outputs، action_command_lines
--[no]apple_generate_dsym التلقائي: "false;quot;
تحديد ما إذا كان سيتم إنشاء ملفات تصحيح الأخطاء ( .dSYM)
العلامات: affects_outputs، action_command_lines
في حال ضبط هذه السياسة على "صحيح"، أنشِئ مجموعات رمزية للملفات القابلة للتنفيذ لجميع الاستهدافات. وفي حال ضبطها على "خطأ"، يُرجى كتابة البيانات فقط عند الإمكان.
العلامات: affects_outputs
--[no]build_runfile_manifests التلقائي: "true;true"
إذا كانت القيمة صحيحة، يُرجى كتابة بيانات ملفات Run لجميع الأهداف. وإذا لم تكن متوفّرة، احذفها. وسيتعذّر تشغيل الاختبارات المحلية عند ضبطها على "خطأ".
العلامات: affects_outputs
--[no]build_test_dwp التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، سيتم تلقائيًا إنشاء ملف .dwp لهذا البرنامج الثنائي عند إجراء اختبارات C++ بشكل ثابت، وسيتم أيضًا إنشاء ملف بالامتداد .dwp أيضًا.
العلامات: loading_and_analysis، affects_outputs
--cc_proto_library_header_suffixes=<comma-separated list of options> التلقائي: "p.h.h"
يضبط بادئات ملفات العناوين التي ينشئها cc_proto_library.
العلامات: affects_outputs، loading_and_analysis
--cc_proto_library_source_suffixes=<comma-separated list of options> التلقائي: ".pb.cc"
يضبط بادئات الملفات المصدر التي ينشئها cc_proto_library.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_proto_descriptor_sets_include_source_info التلقائي: "false;quot;
تنفيذ إجراءات إضافية لإصدارات Java api البديلة في proto_library.
العلامات: affects_outputs، loading_and_analysis، experimental
--[no]experimental_proto_extra_actions التلقائي: "false;quot;
تنفيذ إجراءات إضافية لإصدارات Java api البديلة في proto_library.
العلامات: affects_outputs، loading_and_analysis، experimental
--[no]experimental_save_feature_state التلقائي: "false;quot;
حفظ حالة الخصائص المميّزة المطلوبة والمطلوبة كنتيجة للتجميع.
العلامات: affects_outputs، experimental
--fission=<a set of compilation modes> التلقائي: "no"
تحدد أوضاع التجميع التي تستخدم الأزمة بهدف تجميع C++ والروابط. يمكن أن تكون هذه الخوارزمية أيًا من {'fastbuild', 'dbg', 'opt'} أو القيم الخاصة 'yes' لتفعيل كل الأوضاع و 'no' لإيقاف جميع الأوضاع.
العلامات: loading_and_analysis، action_command_lines، affects_outputs
--[no]legacy_external_runfiles التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، أنشِئ مجموعات رمزية لمجلدات التشغيل للمستودعات الخارجية ضمن .runfiles/wsname/external/repo (بالإضافة إلى .runfiles/repo).
العلامات: affects_outputs
--[no]objc_generate_linkmap التلقائي: "false;quot;
يحدد هذا الإعداد ما إذا كان سيتم إنشاء ملف linklink.
العلامات: affects_outputs
--[no]save_temps التلقائي: "false;quot;
في حال ضبط هذه السياسة، سيتم حفظ النتائج المؤقتة من gcc. تتضمّن هذه الملفات ملفات .s (رمز التجميع) وملفات i. (التي تتم معالجتها مسبقًا C) وملفات .ii (C++ التي تمت معالجتها مسبقًا).
العلامات: affects_outputs
الخيارات التي تتيح للمستخدم ضبط النتائج المطلوبة ما يؤثر في قيمتها بدلاً من ظهورها:
تراكم --action_env=<a 'name=value' assignment with an optional value part> استخدامات متعددة
يحدد مجموعة من متغيرات البيئة المتاحة للإجراءات مع الإعداد المستهدف. يمكن تحديد المتغيرات حسب الاسم، وفي هذه الحالة سيتم الحصول على القيمة من بيئة الاستدعاء، أو من خلال زوج الاسم=القيمة الذي يضبط القيمة بشكل مستقل عن بيئة الاستدعاء. يمكن استخدام هذا الخيار عدة مرات، أما بالنسبة إلى الخيارات المتوفرة للمتغيّر نفسه، فتختلف عمليات الفوز الأخيرة وآخر الخيارات.
العلامات: action_command_lines
--android_cpu=<a string> التلقائي: "armeabi-v7a"
وحدة المعالجة المركزية (CPU) المستهدفة في Android
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--[no]android_databinding_use_androidx التلقائي: "false;quot;
إنشاء ملفات ربط بيانات متوافقة مع AndroidX. وتُستخدم هذه الطريقة فقط مع الإصدار 2 من ربط البيانات.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state، experimental
--[no]android_databinding_use_v3_4_args التلقائي: "false;quot;
استخدام الإصدار 2.3 من Android Databinding مع الوسيطة 3.4.0
العلامات: affects_outputs وloading_and_analysis وloses_incremental_state وexperimental
--android_dynamic_mode=<off, default or fully> التلقائي: "off;quot;
يحدد ما إذا كان سيتم ربط أقسام C++ لقواعد Android بشكل ديناميكي عندما لا ينشئ cc_binary مكتبة مشتركة بشكل صريح. 'default' يعني اختيار البازيل الاختيار بين الربط ديناميكيًا. 'full' يعني ربط جميع المكتبات ديناميكيًا. 'off' يعني ربط جميع المكتبات في الوضع الثابت الثابت.
العلامات: affects_outputs، loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> التلقائي: "alphabetical"
يحدد ترتيب البيان الذي تم تمريره إلى دمج البيان لبرامج Android الثنائية. تعني كلمة "ALPHABALAL" أنّ البيانات يتم ترتيبها حسب المسار المرتبط بالتنفيذ. يعني ALPHABETICAL_BY_CONFIGURATION أن البيانات مرتّبة حسب المسارات بالنسبة إلى دليل الضبط ضمن دليل الناتج. يُقصد ببروتوكول DEPENDENCY أنّه يتم ترتيب البيان مع كل بيان في مكتبة المكتبة قبل عرضها على البيانات التابعة لها.
العلامات: action_command_lines، execution
--[no]android_resource_shrinking التلقائي: "false;quot;
تفعيل تقليص الموارد لملفات android_binary APK التي تستخدم ProGuard.
العلامات: affects_outputs، loading_and_analysis
تراكم --apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst> استخدامات متعددة
حدِّد وضع Apple Bicode لإعداد خطوات تجميع الخطوات التي تستهدف بُنى الأجهزة. وتكون القيم بالشكل التالي: وفي حال توفّر هذا الوضع، يتم تطبيق وضع الرمز البريدي على هذه المنصة تحديدًا، وفي حال حذفه، يتم تطبيقه على جميع الأنظمة الأساسية. يجب أن يكون الوضع &#39؛none' أو 'embed_flags' أو 'embed'. قد يتم تقديم هذا الخيار عدة مرات.
العلامات: loses_incremental_state
--[no]build_python_zip التلقائي: "auto;quot;
إنشاء ملف zip python قابل للتنفيذ، وتفعيله على Windows، وإيقافه على الأنظمة الأساسية الأخرى
العلامات: affects_outputs
تراكم --catalyst_cpus=<comma-separated list of options> استخدامات متعددة
قائمة من البُنى التي تُستخدم لإنشاء برامج ثنائية على Apple Catalyst مفصولة بفواصل.
العلامات: loses_incremental_state، loading_and_analysis
--[no]collect_code_coverage التلقائي: "false;quot;
في حال حدَّدت العلامة التجارية، ستستخدم Bazel رمز الوسيلة (باستخدام لوحة البيانات بلا اتصال بالإنترنت حيثما أمكن) وستجمع معلومات التغطية أثناء الاختبارات. ولن تتأثر سوى الاستهدافات التي تتطابق مع --toolation_filter. يجب عادةً عدم تحديد هذا الخيار مباشرةً - 'bazelتغطية' يجب استخدام الأمر بدلاً من ذلك.
العلامات: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] التلقائية: "fastbuild"
حدِّد الوضع الذي سيتم استخدامه في البرنامج الثنائي. القيم: 'Fastbuild', 'dbg', 'opt'
العلامات: affects_outputs، action_command_lines، explicit_in_output_path
تراكم --conlyopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى Gcc عند تجميع ملفات المصدر C.
العلامات: action_command_lines، affects_outputs
تراكم --copt=<a string> استخدامات متعددة
خيارات إضافية لإدخالها إلى Gcc.
العلامات: action_command_lines، affects_outputs
--cpu=<a string> التلقائي: ""
وحدة المعالجة المركزية (CPU) المستهدفة
العلامات: changes_inputs، affects_outputs، explicit_in_output_path
--cs_fdo_absolute_path=<a string> التلقائي: عرض الوصف
يمكنك استخدام معلومات ملف CSFDO الشخصي لتحسين التجميع. حدِّد اسم المسار المطلق لملف ZIP الذي يحتوي على ملف الملف الشخصي أو ملف شخصي غير مُعدَّل أو ملف شخصي مُفهرس LLVM مُفهرس.
العلامات: affects_outputs
--cs_fdo_instrument=<a string> التلقائي: عرض الوصف
إنشاء برامج ثنائية باستخدام أداة FDO الحساسة الحسّاسة من حيث السياق باستخدام مجمِّع Clang/LLVM، يقبل أيضًا اسم الدليل الذي يتم بموجبه تفريغ ملفات الملف الشخصي الأولية في وقت التشغيل.
العلامات: affects_outputs
--cs_fdo_profile=<a build target label> التلقائي: عرض الوصف
الملف cs_fdo_profile الذي يمثّل الملف الشخصي الحساس للسياق الذي سيتم استخدامه في التحسين.
العلامات: affects_outputs
تراكم --cxxopt=<a string> استخدامات متعددة
خيار إضافي لتمريره إلى Gcc عند تجميع ملفات مصدر C++.
العلامات: action_command_lines، affects_outputs
تراكم --define=<a 'name=value' assignment> استخدامات متعددة
يحدد كل خيار --define مهمة لمتغيّر إصدار.
العلامات: changes_inputs، affects_outputs
--dynamic_mode=<off, default or fully> التلقائي: "default;default"
يحدد ما إذا كان سيتم ربط برامج C++ الثنائية بشكل ديناميكي. 'default' يعني أن Bazel سيختار الربط بشكل ديناميكي. 'full' يعني ربط جميع المكتبات ديناميكيًا. 'off' يعني ربط جميع المكتبات في الوضع الثابت الثابت.
العلامات: loading_and_analysis، affects_outputs
--[no]enable_fdo_profile_absolute_path التلقائي: "true;true"
في حال تم ضبط هذه السياسة، سيؤدي استخدام fdo_absolute_profile_path إلى حدوث خطأ.
العلامات: affects_outputs
--[no]enable_runfiles التلقائي: "auto;quot;
تفعيل شجرة رمز التشغيل لملفات التشغيل، وبشكل تلقائي، يتم إيقافها على نظام التشغيل Windows على أنظمة أساسية أخرى
العلامات: affects_outputs
تراكم --experimental_action_listener=<a build target label> استخدامات متعددة
تم إيقافها لصالح جوانب مختلفة. استخدِم action_listener لإرفاق إجراء إضافي مع إجراءات الإصدار الحالية.
العلامات: execution، experimental
--[no]experimental_android_compress_java_resources التلقائي: "false;quot;
ضغط موارد Java في ملفات APK
العلامات: affects_outputs وloading_and_analysis وexperimental
--[no]experimental_android_databinding_v2 التلقائي: "false;quot;
استخدام السمة Android bindbind v2
العلامات: affects_outputs وloading_and_analysis وloses_incremental_state وexperimental
--[no]experimental_android_resource_shrinking التلقائي: "false;quot;
تفعيل تقليص الموارد لملفات android_binary APK التي تستخدم ProGuard.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_android_rewrite_dexes_with_rex التلقائي: "false;quot;
استخدام أداة rex لإعادة كتابة ملفات dex
العلامات: affects_outputs وloading_and_analysis وloses_incremental_state وexperimental
--experimental_objc_fastbuild_options=<comma-separated list of options> التلقائي: "-O0,-DDEBUG=1"
تستخدِم هذه السلاسل كخيارات مجمّع objc Fastbuild.
العلامات: action_command_lines
--[no]experimental_omitfp التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، استخدِم libunwind لتراجع استدعاء الدوال البرمجية وتجميعها باستخدام -fomit-frame-pointer و-fsync-unwind-tables.
العلامات: action_command_lines، affects_outputs، experimental
--[no]experimental_platform_in_output_dir التلقائي: "false;quot;
في حال اختيار هذا الإعداد، يتم استخدام النظام الأساسي المستهدف في اسم دليل الإخراج بدلاً من وحدة المعالجة المركزية (CPU).
العلامات: affects_outputs، experimental
--[no]experimental_use_llvm_covmap التلقائي: "false;quot;
في حال تحديد Bazel، ستُنشئ معلومات خريطة تغطية llvm-cov بدلاً من gcov عند تفعيل جمع_رمز_التغطية.
العلامات: changes_inputs، affects_outputs، loading_and_analysis، experimental
--fat_apk_cpu=<comma-separated list of options> التلقائي: "armeabi-v7a"
يؤدي ضبط هذا الخيار إلى تفعيل ملفات APK للدهون التي تحتوي على برامج ثنائية أصلية لكل البُنى المستهدَفة المحدّدة، مثل --fat_APK_cpu=x86,armeabi-v7a. إذا تم تحديد هذه العلامة، سيتم تجاهل --android_cpu في تبعيات قواعد android_binary.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--[no]fat_apk_hwasan التلقائي: "false;quot;
تحديد ما إذا كان سيتم إنشاء تقسيمات HWASAN.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--fdo_instrument=<a string> التلقائي: عرض الوصف
إنشاء برامج ثنائية باستخدام أداة FDO باستخدام مجمِّع Clang/LLVM، يقبل أيضًا اسم الدليل الذي يتم بموجبه تفريغ ملفات الملف الشخصي الأولية في وقت التشغيل.
العلامات: affects_outputs
--fdo_optimize=<a string> التلقائي: عرض الوصف
يمكنك استخدام معلومات الملف الشخصي لإدارة الأغذية والدواء لتحسين التجميع. حدِّد اسم ملف ZIP يحتوي على شجرة ملفات .gcda، أو ملف afdo يحتوي على ملف شخصي تلقائي، أو ملف شخصي LLVM. تقبل هذه العلامة أيضًا الملفات المحددة كتصنيفات (على سبيل المثال `//foo/bar:file.afdo` - قد تحتاج إلى إضافة توجيه "exports_files" إلى الحزمة المقابلة) والتصنيفات التي تشير إلى استهدافات "fdo_profile". ستحل قاعدة "fdo_profile" محل هذه العلامة.
العلامات: affects_outputs
--fdo_prefetch_hints=<a build target label> التلقائي: عرض الوصف
استخدام تلميحات الجلب المسبق لذاكرة التخزين المؤقت
العلامات: affects_outputs
--fdo_profile=<a build target label> التلقائي: عرض الوصف
الملف الشخصي fdo_profile الذي يمثّل الملف الشخصي الذي سيتم استخدامه للتحسين.
العلامات: affects_outputs
تراكم --features=<a string> استخدامات متعددة
سيتم تفعيل الميزات المعيّنة أو إيقافها بشكل تلقائي لجميع الحِزم. يؤدي تحديد -<feature> إلى إيقاف الميزة على المستوى العالمي. دائمًا ما تلغي الميزات السلبية الميزات الإيجابية. تُستخدَم هذه العلامة للسماح بطرح تغييرات تلقائية للميزات بدون إصدار Bazel.
العلامات: changes_inputs، affects_outputs
--[no]force_pic التلقائي: "false;quot;
في حال تفعيل هذه الميزة، تؤدي جميع مجمّعات C++ إلى إنشاء رمز مستقل عن الموضع ("-fPIC")، وتفضّل الروابط المكتبات المصمّمة مسبقًا بطريقة PIC بدلاً من المكتبات غير المزوّدة بتقنية PIC، وتنشئ الروابط روابط تنفيذية مستقلة عن الموضع ("-pie").
العلامات: loading_and_analysis، affects_outputs
تراكم --host_action_env=<a 'name=value' assignment with an optional value part> استخدامات متعددة
يحدد مجموعة متغيرات البيئة المتاحة للإجراءات التي تحتوي على إعدادات المضيف أو التنفيذ. يمكن تحديد المتغيرات حسب الاسم، وفي هذه الحالة سيتم الحصول على القيمة من بيئة الاستدعاء، أو من خلال زوج الاسم=القيمة الذي يضبط القيمة بشكل مستقل عن بيئة الاستدعاء. يمكن استخدام هذا الخيار عدة مرات، أما بالنسبة إلى الخيارات المتوفرة للمتغيّر نفسه، فتختلف عمليات الفوز الأخيرة وآخر الخيارات.
العلامات: action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt> التلقائي: "opt"
حدِّد الوضع الذي سيتم فيه استخدام الأدوات المُستخدَمة أثناء الإصدار. القيم: 'Fastbuild', 'dbg', 'opt'
العلامات: affects_outputs، action_command_lines
تراكم --host_conlyopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى Gcc عند تجميع ملفات المصدر C للأدوات المضيفة.
العلامات: action_command_lines، affects_outputs
تراكم --host_copt=<a string> استخدامات متعددة
خيارات إضافية لإدخال كلمة "مركز عملائي" إلى "أدوات المضيف".
العلامات: action_command_lines، affects_outputs
--host_cpu=<a string> التلقائي: ""
وحدة المعالجة المركزية (CPU) المضيفة
العلامات: changes_inputs، affects_outputs
تراكم --host_cxxopt=<a string> استخدامات متعددة
خيارات إضافية لإدخال كلمة "مركز عملائي" إلى "أدوات المضيف".
العلامات: action_command_lines، affects_outputs
--host_force_python=<PY2 or PY3> التلقائي: عرض الوصف
يلغي إصدار Python لضبط المضيف. يمكن أن تكون "PY2" أو &&;;PY3".
العلامات: loading_and_analysis، affects_outputs
تراكم --host_linkopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى مركز عملائي في حال الربط بأدوات المضيف.
العلامات: action_command_lines، affects_outputs
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل macOS المتوافق مع أهداف المضيف. إذا لم يتم تحديدها، استخدِم 'macos_sdk_version'.
العلامات: loses_incremental_state
تراكم --host_swiftcopt=<a string> استخدامات متعددة
خيارات إضافية للانتقال إلى swiftc لأدوات المضيف.
العلامات: action_command_lines، affects_outputs
--[no]incompatible_avoid_conflict_dlls التلقائي: "true;true"
في حال تفعيل هذا الإعداد، ستتم إعادة تسمية جميع مكتبات C++ الديناميكية المرتبطة (DLL) التي تم إنشاؤها بواسطة cc_library على نظام التشغيل Windows إلى name_{hash}.dll حيث يتم حساب التجزئة استنادًا إلى RepositoryName ومسار حزمة DLL'. يكون هذا الخيار مفيدًا عندما تكون لديك حزمة واحدة تعتمد على العديد من cc_library التي تحمل الاسم نفسه (مثل //foo/bar1:utils و //foo/bar2:utils).
العلامات: loading_and_analysis، affects_outputs، incompatible_change
--[no]incompatible_merge_genfiles_directory التلقائي: "true;true"
إذا كان هذا صحيحًا، يتم طي الدليل gfiles في دليل bin.
العلامات: affects_outputs، incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، تتم إزالة إعدادات القيود من @bazel_tools.
العلامات: affects_outputs، incompatible_change
--[no]instrument_test_targets التلقائي: "false;quot;
عند تفعيل التغطية، يتم تحديد ما إذا كنت تريد مراعاة قواعد اختبار قياس حالة التطبيق. وعند الضبط، يتم عرض قواعد الاختبار المضمّنة في --toolation_filter. وإلاّ، يتم دائمًا استبعاد قواعد الاختبار من أدوات التغطية.
العلامات: affects_outputs
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> التلقائي: "-/javatests[/:],-/test/java[/:]"
عند تفعيل التغطية، سيتم استخدام القواعد ذات الأسماء المضمنة من خلال الفلتر المستند إلى regex فقط. يتم استبعاد القواعد التي تبدأ بـ '-' بدلاً من ذلك. تجدر الإشارة إلى أنه لا يتم عرض سوى القواعد غير التجريبية ما لم يتم تفعيل --tool_test_targets.
العلامات: affects_outputs
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار iOS المتوافق مع أجهزة المحاكاة والأجهزة المستهدفة. إذا لم يتم تحديدها، استخدِم 'ios_sdk_version'.
العلامات: loses_incremental_state
تراكم --ios_multi_cpus=<comma-separated list of options> استخدامات متعددة
قائمة بتصميمات معمارية مفصولة بفواصل لإنشاء تطبيق ios. وتكون النتيجة برنامجًا ثنائيًا عامًا يحتوي على جميع البُنى المحدّدة.
العلامات: loses_incremental_state، loading_and_analysis
--[no]legacy_whole_archive التلقائي: "true;true"
تم إحلاله محل الإصدار --incompatible_remove_legacy_whole_archive (يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7362 لمزيد من التفاصيل). عند تفعيل هذا الإعداد، استخدِم --whole-archive لقواعد cc_binary التي تحتوي على رابط shared=True وlinkstatic=True أو '-static' في linkopts. وذلك لأغراض التوافق مع الأنظمة القديمة فقط. البديل الأفضل هو استخدام linklink=1 عند الحاجة.
العلامات: action_command_lines، affects_outputs، deprecated
تراكم --linkopt=<a string> استخدامات متعددة
خيار إضافي لتمرير البيانات إلى مركز عملائي عند الربط.
العلامات: action_command_lines، affects_outputs
تراكم --ltobackendopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى خطوة خلفية LTO (ضمن --features=thin_lto).
العلامات: action_command_lines، affects_outputs
تراكم --ltoindexopt=<a string> استخدامات متعددة
خيار إضافي للانتقال إلى خطوة فهرسة LTO (ضمن --features=thin_lto).
العلامات: action_command_lines، affects_outputs
تراكم --macos_cpus=<comma-separated list of options> استخدامات متعددة
قائمة من البُنى التي تُنشئ تطبيقات ثنائية على نظام التشغيل Apple macOS مفصولة بفواصل.
العلامات: loses_incremental_state، loading_and_analysis
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل macOS المتوافق للأهداف. إذا لم يتم تحديدها، استخدِم 'macos_sdk_version'.
العلامات: loses_incremental_state
--[no]objc_debug_with_GLIBCXX التلقائي: "false;quot;
في حال ضبط السياسة وضبط وضع التجميع على 'dbg' ، حدِّد GLIBCXX_DEBUG وGLIBCXX_DEBUG_PEDANTIC وGLIBCPP_CONCEPT_checkS.
العلامات: action_command_lines
--[no]objc_enable_binary_stripping التلقائي: "false;quot;
تحديد ما إذا كان سيتم تنفيذ عمليات إزالة الرموز والرموز غير الصالحة على البرامج الثنائية المرتبطة. سيتم تنفيذ عمليات الإزالة الثنائية إذا تم تحديد كل من هذه العلامة و --compilation_mode=opt.
العلامات: action_command_lines
تراكم --objccopt=<a string> استخدامات متعددة
خيارات إضافية لإدخالها إلى"مركز عملائي"عند تجميع ملفات المصدر Purpose-C/C++.
العلامات: action_command_lines
تراكم --per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> استخدامات متعددة
خيارات إضافية للانتقال إلى GCC بشكل انتقائي عند تجميع ملفات معيّنة. يمكن تمرير هذا الخيار عدة مرات. البنية: regex_filter@option_1,option_2,...,option_n. حيث يشير regex_filter إلى قائمة تتضمن أنماط التعبير العادي واستبعادها (اطّلع أيضًا على --toolation_filter). يشير Option_1 إلى Option_n إلى خيارات سطر الأوامر العشوائية. إذا كان أحد الخيارات يحتوي على فاصلة، يجب اقتباسها شرطة مائلة للخلف. يمكن أن تحتوي الخيارات على @. يتم استخدام أول @ فقط لتقسيم السلسلة. مثال: يضيف --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 خيار سطر الأوامر -O0 إلى سطر الأوامر gcc لجميع ملفات cc في //foo/ باستثناء Bar.cc.
العلامات: action_command_lines، affects_outputs
تراكم --per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options> استخدامات متعددة
خيارات إضافية للانتقال بشكل اختياري إلى خلفية LTO (ضمن --features=thin_lto) عند تجميع عناصر خلفية معيّنة. يمكن تمرير هذا الخيار عدة مرات. البنية: regex_filter@option_1,option_2,...,option_n. يشير الاختصار regex_filter إلى قائمة من أنماط التضمين العادية واستبعادها. يشير Option_1 إلى Option_n إلى خيارات سطر الأوامر العشوائية. إذا كان أحد الخيارات يحتوي على فاصلة، يجب اقتباسها شرطة مائلة للخلف. يمكن أن تحتوي الخيارات على @. يتم استخدام أول @ فقط لتقسيم السلسلة. مثال: يضيف --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 خيار سطر الأوامر -O0 إلى سطر الأوامر الخلفي لـ LTO لجميع ملفات o في //foo/ باستثناء Bar.o.
العلامات: action_command_lines، affects_outputs
--platform_suffix=<a string> التلقائي: عرض الوصف
يحدد لاحقة لإضافتها إلى دليل الإعداد.
العلامات: loses_incremental_state، affects_outputs، loading_and_analysis
--propeller_optimize=<a build target label> التلقائي: عرض الوصف
استخدِم معلومات الملف الشخصي للمحترفين لتحسين هدف الإصدار.يجب أن يحتوي الملف الشخصي للمعجب على ملفَين على الأقل، على أن يكون الملف الشخصي في حقل"نسخة إلى"وملفًا شخصيًا في ملف شخصي. تقبل هذه العلامة تصنيف إصدار يجب أن يشير إلى ملفات إدخال الملف الشخصي للدفع. على سبيل المثال، ملف BUILD الذي يحدّد التصنيف، في a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",)يجب أن يتطابق التوجيه الذي يظهر مع الباصات أنّه يجب أن يكون وأن يكون بالإضافة إلى الحزمة متاحًا على الملف للسلع المُخزَّنة. يجب استخدام الخيار على النحو التالي: --propeller_optimize=//a/b:propeller_profile
العلامات: action_command_lines وaffects_outputs
--propeller_optimize_absolute_cc_profile=<a string> التلقائي: عرض الوصف
اسم المسار المطلق لملف cc_profile لإصدارات Propeller المحسّن.
العلامات: affects_outputs
--propeller_optimize_absolute_ld_profile=<a string> التلقائي: عرض الوصف
اسم المسار المطلق لملف ld_profile لإصدارات ProProler المحسّنة.
العلامات: affects_outputs
--run_under=<a prefix in front of command> التلقائي: عرض الوصف
بادئة لإدراجها قبل الملفات التنفيذية للأمرَين 'test' و 'run'. إذا كانت القيمة هي 'foo -bar'، وكان سطر أوامر التنفيذ هو 'test_binary -baz'، يكون سطر الأوامر النهائي هو 'foo -bar test_binary -baz'.ويمكن أن يكون هذا أيضًا تصنيفًا لهدف قابل للتنفيذ. بعض الأمثلة هي: 'valgrind','strace','strace -c', 'valgrind --quiet --num-callers=20', '//package:target',&33;//package:target',#39;//package:target',#39;//package:target'
العلامات: action_command_lines
--[no]share_native_deps التلقائي: "true;true"
في حال كان هذا صحيحًا، ستتم مشاركة المكتبات الأصلية التي تتضمّن وظائف متطابقة بين الأهداف المختلفة.
العلامات: loading_and_analysis وaffects_outputs
--[no]stamp التلقائي: "false;quot;
استخدِم الطوابع الثنائية بالتاريخ، واسم المستخدم، واسم المضيف، ومعلومات مساحة العمل، وما إلى ذلك.
العلامات: affects_outputs
--strip=<always, sometimes or never> التلقائي: "أحيانًا&quot
يحدد ما إذا كان سيتم إزالة البرامج الثنائية والمكتبات المشتركة (باستخدام "-Wl;---strip-debug"). تعني القيمة التلقائية 'أحيانًا##9
العلامات: affects_outputs
تراكم --stripopt=<a string> استخدامات متعددة
خيارات إضافية يتم تمريرها إلى شريط العناصر عند إنشاء برنامج '<name>.stripped' ثنائي.
العلامات: action_command_lines، affects_outputs
تراكم --swiftcopt=<a string> استخدامات متعددة
خيارات إضافية للانتقال إلى مجمّع Swift.
العلامات: action_command_lines
تراكم --tvos_cpus=<comma-separated list of options> استخدامات متعددة
قائمة من البُنى التي تُستخدَم لإنشاء برامج ثنائية على Apple tvOS.
العلامات: loses_incremental_state، loading_and_analysis
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل المتوافق مع التلفزيونات لمحاكيات الأجهزة والأجهزة المستهدفة. إذا لم يتم تحديدها، استخدِم 'tvos_sdk_version'.
العلامات: loses_incremental_state
تراكم --watchos_cpus=<comma-separated list of options> استخدامات متعددة
قائمة من البُنى التي تُستخدَم لإنشاء برامج ثنائية على نظام التشغيل Apple Watch.
العلامات: loses_incremental_state، loading_and_analysis
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
الحد الأدنى لإصدار نظام التشغيل المتوافق مع ساعة المشاهدة للمحاكيات والأجهزة المستهدفة. إذا لم يتم تحديدها، استخدِم 'watchos_sdk_version'.
العلامات: loses_incremental_state
--xbinary_fdo=<a build target label> التلقائي: عرض الوصف
استخدِم معلومات الملف الشخصي في XbinaryFDO لتحسين التجميع. تحديد اسم الملف الشخصي التلقائي على مستوى البرنامج الثنائي عند استخدام الخيار مع --fdo_tool/--fdo_optimize/--fdo_profile، سيُطبَّق هذا الخيار دائمًا كما لو لم يتم تحديد xbinary_fdo مطلقًا.
العلامات: affects_outputs
الخيارات التي تؤثّر في مدى قوة تطبيق Bazel لمدخلات الإصدارات الصالحة (تعريفات القواعد ومجموعات العلامات وغيرها):
--auto_cpu_environment_group=<a build target label> التلقائي: ""
يمكنك تعريف البيئة_group لاستخدامها لربط قيم وحدة المعالجة المركزية (CPU) تلقائيًا بقيم target_environment.
العلامات: changes_inputs، loading_and_analysis، experimental
--[no]check_licenses التلقائي: "false;quot;
تحقَّق من أنّ قيود الترخيص التي تفرضها الحِزم التابعة لا تتعارض مع أوضاع توزيع الأهداف التي يتم إنشاؤها. ولا يتم التحقق من التراخيص تلقائيًا.
العلامات: build_file_semantics
--[no]check_visibility التلقائي: "true;true"
في حال إيقاف هذا الإعداد، يتم خفض ترتيب أخطاء مستوى الرؤية في العناصر التابعة المستهدفة إلى تحذيرات.
العلامات: build_file_semantics
--[no]desugar_for_android التلقائي: "true;true"
يمكنك إزالة رمز Java 8 بايت قبل إلغاء تحويله إلى نص.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--[no]desugar_java8_libs التلقائي: "false;quot;
تضمين مكتبات Java 8 المتوافقة في التطبيقات المخصّصة للأجهزة القديمة.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state، experimental
--[no]enforce_constraints التلقائي: "true;true"
التحقّق من البيئات المتوافقة مع كل استهداف والإبلاغ عن الأخطاء في حال كان أي هدف يتضمن تبعيات لا تتوافق مع البيئات نفسها
العلامات: build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs التلقائي: "false;quot;
يمكنك الإبلاغ للمساعدة في عملية الانتقال من عدم السماح بقواعد android_librarys التي لا تتضمّن srcs مع حذفات فرعية. يجب تنظيف المستودع ليتم طرحه تلقائيًا.
العلامات: eagerness_to_exit، loading_and_analysis
--[no]experimental_check_desugar_deps التلقائي: "true;true"
التحقّق جيدًا من مستوى الصواب الصحيح على مستوى برنامج Android الثنائي
العلامات: eagerness_to_exit، loading_and_analysis، experimental
--experimental_import_deps_checking=<off, warning or error> التلقائي: "off;quot;
عند تفعيل هذا الإعداد، تحقّق مما إذا كانت المهام التابعة لسمة aar_import مكتملة. يمكن أن يؤدي هذا التنفيذ إلى تلف الإصدار، أو يمكن أن يؤدي فقط إلى تحذيرات.
العلامات: loading_and_analysis
--experimental_strict_java_deps=<off, warn, error, strict or default> التلقائي: "default;default"
في حال كان هذا صحيحًا، يتم التحقُّق من أن الاستهداف في Java يعلن بشكلٍ صريح عن جميع الأهداف المستخدمة مباشرةً على أنها اعتماديات.
العلامات: build_file_semantics، eagerness_to_exit
--[no]incompatible_check_testonly_for_output_files التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يمكنك التحقّق من الاختبار فقط بحثًا عن الاستهدافات الأساسية التي تمثل ملفات الإخراج من خلال البحث عن قاعدة الإنشاء فقط. ويتطابق هذا مع التحقّق من إذن الوصول.
العلامات: build_file_semantics، incompatible_change
--[no]incompatible_disable_native_android_rules التلقائي: "false;quot;
في حال التفعيل، يتم إيقاف الاستخدام المباشر لقواعد Android الأصلية. يُرجى استخدام قواعد Android Starar على Android من https://github.com/bazelbuild/rules_android
العلامات: eagerness_to_exit وincompatible_change
--[no]incompatible_disable_native_apple_binary_rule التلقائي: "false;quot;
لا تتوفّر إمكانية التشغيل، ويتم الاحتفاظ بها هنا لتوفير التوافق مع الأنظمة القديمة.
العلامات: eagerness_to_exit، incompatible_change
--[no]incompatible_force_strict_header_check_from_starlark التلقائي: "true;true"
في حال تفعيل هذه الميزة، عليك وضع معايير صارمة للتحقّق من صحة العناوين في واجهة برمجة التطبيقات Starlark
العلامات: loading_and_analysis وchanges_inputs وincompatible_change
--[no]incompatible_validate_top_level_header_inclusions التلقائي: "true;true"
إذا كان الأمر كذلك، ستتحقّق Bazel أيضًا من عمليات تضمين عناوين المستوى الأعلى (يمكنك الاطّلاع على https://github.com/bazelbuild/bazel/issues/10047 للحصول على مزيد من المعلومات).
العلامات: loading_and_analysis، incompatible_change
--[no]strict_filesets التلقائي: "false;quot;
في حال تفعيل هذا الخيار، يتم الإبلاغ عن مجموعات الملفات التي تتجاوز حدود الحزمة باعتبارها أخطاء. ولا تعمل هذه الميزة عند إيقاف check_fileset_dependenities_recursively.
العلامات: build_file_semantics، eagerness_to_exit
--strict_proto_deps=<off, warn, error, strict or default> التلقائي: "error&quot&quot
ما لم يتم إيقاف السياسة، تتحقّق تلك المعلّمة من أن الاستهداف في proto_library تُعلن صراحةً عن جميع الأهداف المستخدَمة مباشرةً على أنها اعتماديات.
العلامات: build_file_semantics، eagerness_to_exit، incompatible_change
--strict_public_imports=<off, warn, error, strict or default> التلقائي: "off;quot;
ما لم يتم إيقاف السياسة، تتحقّق من أنّ الاستهداف في Proto_library يحدّد بشكلٍ صريح جميع الأهداف المستخدَمة في 'import public' على أنّها تم تصديرها.
العلامات: build_file_semantics، eagerness_to_exit، incompatible_change
--[no]strict_system_includes التلقائي: "false;quot;
في حال كان هذا صحيحًا، يجب أيضًا أن تتضمّن العناوين التي تم العثور عليها من خلال النظام المسارات (-isystem) لعرضها.
العلامات: loading_and_analysis، eagerness_to_exit
تراكم --target_environment=<a build target label> استخدامات متعددة
تعلن هذه البيئة المستهدفة في هذا الإصدار. يجب أن يكون مرجع تصنيف خاصًا بقاعدة "en;ronviation". وفي حال تحديدها، يجب أن تكون جميع أهداف المستوى الأعلى متوافقة مع هذه البيئة.
العلامات: changes_inputs
الخيارات التي تؤثّر في التوقيع على التصميم:
--apk_signing_method=<v1, v2, v1_v2 or v4> التلقائي: "v1_v2"
التنفيذ المطلوب استخدامه لتوقيع حِزم APK
العلامات: action_command_lines وaffects_outputs وloading_and_analysis
--[no]device_debug_entitlements التلقائي: "true;true"
في حال ضبط هذا الإعداد ولم يتم ضبط وضع التجميع، 'opt'، ستحتوي تطبيقات objc على استحقاقات تصحيح الأخطاء عند التوقيع.
العلامات: changes_inputs
--ios_signing_cert_name=<a string> التلقائي: عرض الوصف
اسم الشهادة لاستخدامها في توقيع iOS. في حال ترك هذه السياسة بدون ضبط، سيتم الرجوع إلى الملف الشخصي لإدارة الحسابات. قد تكون هذه هي القيمة المفضّلة لسلسلة مفاتيح الشهادة أو (سلسلة فرعية) من الاسم الشائع للشهادة، وفقًا لصفحة الشخص الموقَّع للترميز (معرّفات التوقيع).
العلامات: action_command_lines
يؤثّر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بإصدارات BUILD أو ملفات .bzl أو ملفات WORKSPACE:
--[no]incompatible_disallow_legacy_py_provider التلقائي: "true;true"
ستتم إزالة إمكانية التفعيل قريبًا.
العلامات: loading_and_analysis، incompatible_change
الخيارات التي تحكم سلوك بيئة الاختبار أو بيئة الاختبار:
--[no]allow_analysis_failures التلقائي: "false;quot;
في حال كان هذا صحيحًا، يؤدي تعذُّر تحليل هدف القاعدة إلى نشر مثيل " تحليلFailureInfo" لمنصّة "الهدف" التي تتضمّن وصف الخطأ، بدلاً من أن يؤدي إلى تعذّر إنشاء الإصدار.
العلامات: loading_and_analysis، experimental
--analysis_testing_deps_limit=<an integer> التلقائي: "2000"
يضبط هذا الإعداد الحد الأقصى لعدد التبعيات الانتقالية من خلال سمة قاعدة مع عملية نقل الإعداد for_analysis_testing. سيؤدي تجاوز هذا الحد إلى خطأ في القاعدة.
العلامات: loading_and_analysis
--[no]break_build_on_parallel_dex2oat_failure التلقائي: "false;quot;
في حال إخفاق إجراءات Dex2oat الفعلية، سيؤدي ذلك إلى تعطُّل الإصدار بدلاً من تنفيذ Dex2oat أثناء وقت التشغيل.
العلامات: loading_and_analysis، experimental
--[no]experimental_android_use_parallel_dex2oat التلقائي: "false;quot;
يمكنك استخدام dex2oat بالتوازي لمساعدتك على تسريع نظام التشغيل android_test.
العلامات: loading_and_analysis، host_machine_resource_optimizations، experimental
--[no]ios_memleaks التلقائي: "false;quot;
تفعيل التحقق من تسرُّبات الذاكرة في أهداف ios_test.
العلامات: action_command_lines
--ios_simulator_device=<a string> التلقائي: عرض الوصف
الجهاز الذي سيتم محاكاةه عند تشغيل تطبيق iOS في المحاكي، مثلاً 'iPhone 6&#39؛ يمكنك الحصول على قائمة بالأجهزة من خلال تشغيل 'xcrun simctl list devicestypes' على الجهاز الذي سيتم تشغيل المحاكي عليه.
العلامات: test_runner
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
إصدار iOS الذي سيتم تشغيله على المحاكي عند تشغيله أو اختباره يتم تجاهل هذه القاعدة لقواعد ios_test في حال تحديد جهاز مستهدف في القاعدة.
العلامات: test_runner
تراكم --runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once> استخدامات متعددة
يحدد هذا الإعداد عدد مرات تشغيل كل اختبار. وفي حال فشل أي من هذه المحاولات لأي سبب، سيُعتبر الاختبار بالكامل فاشلاً. عادةً ما تكون القيمة المحددة مجرد عدد صحيح. مثال: سوف تُجري --runs_per_test=3 جميع الاختبارات 3 مرات. البنية البديلة: regex_filter@runs_per_test. يشير يشير run_per_test إلى قيمة العدد الصحيح بينما يشير regex_filter إلى قائمة تتضمن أنماط التعبير العادي ويستثنيها (اطّلع أيضًا على --toolation_filter). مثال: يُجري --runs_per_test=//foo/.*,-//foo/bar/.*@3 جميع الاختبارات في //foo/ باستثناء تلك التي تقع ضمن foo/bar ثلاث مرات. يمكن تمرير هذا الخيار عدة مرات. وتكون الأولوية للوسيطة التي تم تجاوزها مؤخرًا والتي تتطابق مع البيانات. في حال عدم تطابق أي شيء، لن يتم إجراء الاختبار سوى مرة واحدة.
تراكم --test_env=<a 'name=value' assignment with an optional value part> استخدامات متعددة
يحدد متغيرات بيئة إضافية ليتم إدخالها في بيئة تشغيل الاختبار. يمكن تحديد المتغيرات حسب الاسم، وفي هذه الحالة، ستتم قراءة قيمتها من بيئة عميل Bazel أو بواسطة زوج الاسم=القيمة. يمكن استخدام هذا الخيار عدة مرات لتحديد عدة متغيرات. لا يتم استخدامه إلا باستخدام الأمر 'bazel test'.
العلامات: test_runner
--test_timeout=<a single integer or comma-separated list of 4 integers> التلقائي: "-1"
إلغاء قيم مهلة الاختبار التلقائية لمهلة الاختبار (بالثواني) في حال تحديد قيمة عدد صحيح موجب، سيتم إلغاء جميع الفئات. إذا تم تحديد 4 أرقام صحيحة مفصولة بفواصل، ستُلغي المهلات القصيرة والمتوسطة والطويلة والأبدية (بهذا الترتيب). في أي من الخيارين، تخبر القيمة -1 بلاز باستخدام المهلات التلقائية لهذه الفئة.
--tvos_simulator_device=<a string> التلقائي: عرض الوصف
الجهاز الذي سيتم محاكاةه عند تشغيل تطبيق tvOS في المحاكي، مثلاً 'Apple TV 1080p' يمكنك الحصول على قائمة بالأجهزة من خلال تشغيل 'xcrun simctl list devicestypes' على الجهاز الذي سيتم تشغيل المحاكي عليه.
العلامات: test_runner
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
إصدار نظام التشغيل tvOS لتشغيله على المحاكي عند تشغيله أو اختباره
العلامات: test_runner
--watchos_simulator_device=<a string> التلقائي: عرض الوصف
الجهاز الذي يجب محاكاته عند تشغيل تطبيق ساعة نظام التشغيل في المحاكي، مثل 'Apple Watch - 38mm' يمكنك الحصول على قائمة بالأجهزة من خلال تشغيل 'xcrun simctl list devicestypes' على الجهاز الذي سيتم تشغيل المحاكي عليه.
العلامات: test_runner
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')> التلقائي: عرض الوصف
إصدار نظام التشغيل الذي يتم تشغيله على جهاز المحاكاة عند تشغيله أو اختباره
العلامات: test_runner
--[no]zip_undeclared_test_outputs التلقائي: "true;true"
في حال كان هذا صحيحًا، ستتم أرشفة مخرجات الاختبار غير المعلَنة في ملف ZIP.
العلامات: test_runner
الخيارات المرتبطة بإخراج طلب البحث والدلالة:
--aspect_deps=<off, conservative or precise> التلقائي: "conserveative"
كيفية حل تبعيات العرض عندما يكون تنسيق الناتج واحدًا من {xml,proto,record}. 'off' تعني أنه لم يتم التعامل مع أي تبعيات للجانب، 'conserveative' (الإعداد التلقائي) تعني أن جميع تبعيات الجانب المُعلَن تمت إضافتها بغض النظر عما إذا تم منحها فئة قاعدة للاعتماديات المباشرة أو "#39;precise'" تعني أنه تتم إضافة هذه الجوانب التي من المحتمل أن تكون نشطة وفقًا لفئة القاعدة من التبعية المباشرة. لاحظ أن الوضع الدقيق يتطلب تحميل حِزم أخرى لتقييم هدف واحد، ما يجعله أبطأ من الأوضاع الأخرى. يُرجى العِلم أيضًا أنّ الوضع الدقيق ليس دقيقًا بالكامل، بل يتم اتّخاذ قرار بشأن احتساب جانب في مرحلة التحليل، وهو ما لا يتم تشغيله أثناء إعداد " #39;bazel query'".
العلامات: build_file_semantics
--[no]graph:factored التلقائي: "true;true"
إذا تم ضبط هذه السياسة على"صحيح"، سيتم دمج رسم بياني منشِئ &'عامل>&#39؛ أي أنه سيتم دمج العُقد المتماثلة طوبولوجيا معًا وربط تصنيفاتها. ينطبق هذا الخيار على --output=graph فقط.
العلامات: terminal_output
--graph:node_limit=<an integer> التلقائي: "512"
الحد الأقصى لطول سلسلة التصنيف لعقدة رسم بياني في الإخراج. سيتم اقتطاع التصنيفات الأطول، وتعني القيمة -1 عدم اقتطاعها. ينطبق هذا الخيار على --output=graph فقط.
العلامات: terminal_output
--[no]implicit_deps التلقائي: "true;true"
في حال تفعيل هذه الميزة، سيتم تضمين العناصر الضمنية في الرسم البياني للاعتمادية الذي يعمل عليه طلب البحث. الاعتمادية الضمنية هي تلك التي لم يتم تحديدها صراحةً في ملف BUILD، ولكن تمت إضافتها بواسطة البازل. بالنسبة إلى طلب البحث، يتحكم هذا الخيار في فلترة سلاسل الأدوات التي تم حلها.
العلامات: build_file_semantics
--[no]include_aspects التلقائي: "true;true"
aquery, cquery: ما إذا كان مطلوبًا تضمين الإجراءات التي يتم إنشاؤها من خلال العرض الجانبي في الإخراج. طلب البحث: no-op (يتم تتبّع الجوانب دائمًا).
العلامات: terminal_output
--[no]incompatible_display_source_file_location التلقائي: "true;true"
"صحيح" يعرض تلقائيًا الهدف من الملف المصدر. إذا كان هذا صحيحًا، يتم عرض موقع السطر 1 من الملفات المصدر في مخرجات الموقع. لا تتوفّر هذه العلامة إلا لأغراض نقل البيانات.
العلامات: terminal_output، incompatible_change
--[no]incompatible_package_group_includes_double_slash التلقائي: "true;true"
في حال تفعيل هذا الإعداد، عند حذف السمة package_group's "الحزم"، لن يتم حذف السمة "//" البادئة.
العلامات: terminal_output، incompatible_change
--[no]infer_universe_scope التلقائي: "false;quot;
في حال ترك السياسة بدون ضبط و --universe_scope بدون ضبط، سيتم استنتاج قيمة --universe_scope في شكل قائمة بالأنماط المستهدَفة الفريدة في تعبير طلب البحث. تجدُر الإشارة إلى أن قيمة --universe_scope التي تم استنتاجها لتعبير طلب بحث تستخدم الدوال على مستوى الكون (مثل `allrdeps`) قد لا تكون ما تريده، لذا يجب استخدام هذا الخيار فقط إذا كنت تعرف ما تفعله. يمكنك الاطّلاع على https://bazel.build/reference/query#sky-query لمعرفة التفاصيل والأمثلة. في حال ضبط --universe_scope، سيتم تجاهل قيمة هذا الخيار's. ملاحظة: ينطبق هذا الخيار فقط على "طلب البحث" (أي ليس "cquery").
العلامات: loading_and_analysis
--[no]line_terminator_null التلقائي: "false;quot;
ما إذا كان سيتم إنهاء كل تنسيق باستخدام \0 بدلاً من السطر الجديد.
العلامات: terminal_output
--[no]nodep_deps التلقائي: "true;true"
في حال تفعيل هذه السياسة، سيتم تضمين سمات من "nodep"، في الرسم البياني الخاص بالاعتمادية الذي يعمل عليه طلب البحث. ومن الأمثلة الشائعة للسمة "nodep" ";;;;;;; كيف إنّ "> شغِّل مخرجات "معلومات إصدار اللغة" وتحليلها للحصول على معلومات عن جميع السمات ""nodep" في لغة الإصدار.
العلامات: build_file_semantics
--output=<a string> التلقائي: "label;label"
التنسيق الذي يجب طباعة نتائج طلب البحث فيه. القيم المسموح بها لكل من cquery هي: label وlabel_kind وtextproto وtransitss وproto وjsonproto. إذا اخترت 'transitions&#39؛ عليك أيضًا تحديد الخيار --transitions=(lite|full).
العلامات: terminal_output
--[no]proto:default_values التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، يتم تضمين السمات التي لم يتم تحديد قيمتها صراحةً في ملف BUILD، وإلا سيتم حذفها. ينطبق هذا الخيار على --output=proto
العلامات: terminal_output
--[no]proto:definition_stack التلقائي: "false;quot;
تعبئة حقل pro_stack Proto الذي يسجّل كل مثيل القاعدة لحزمة استدعاء Starlark في الوقت الذي يتم فيه تحديد فئة القاعدة.
العلامات: terminal_output
--[no]proto:flatten_selects التلقائي: "true;true"
في حال تفعيل هذا الإعداد، يتم استنساخ السمات القابلة للضبط التي تم إنشاؤها من خلال Select(). بالنسبة إلى أنواع القوائم، يمثّل التمثيل مسطّحًا قائمة تتضمّن كل قيمة للخريطة المحدّدة مرة واحدة فقط. يتم تحويل أنواع الكميات إلى عناصر فارغة.
العلامات: build_file_semantics
--[no]proto:include_configurations التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتضمّن إخراج Proto معلومات حول عمليات الضبط. وعند إيقاف هذا الإعداد، يشبه تنسيق مخرجات طلب البحث Cto تنسيق تنسيق طلب البحث.
العلامات: affects_outputs
--[no]proto:include_synthetic_attribute_hash التلقائي: "false;quot;
يمكنك حساب السمة $internal_attr_hash تعبئتها أو لا.
العلامات: terminal_output
--[no]proto:instantiation_stack التلقائي: "false;quot;
تعبئة حزمة استدعاء مثيل كل قاعدة. يُرجى العلم أنّ ذلك يتطلّب توفّر الحزمة
العلامات: terminal_output
--[no]proto:locations التلقائي: "true;true"
تحديد ما إذا كان سيتم إخراج معلومات الموقع الجغرافي في وضع Proto تمامًا.
العلامات: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> التلقائي: "all"
قائمة سمات مفصولة بفواصل لتضمينها. ويتم إعداد كل السمات تلقائيًا. اضبط على سلسلة فارغة لإخراج أي سمة. ينطبق هذا الخيار على --output=proto.
العلامات: terminal_output
--[no]proto:rule_inputs_and_outputs التلقائي: "true;true"
تحديد ما إذا كنت تريد تعبئة حقلي base_input وrule_output
العلامات: terminal_output
--[no]relative_locations التلقائي: "false;quot;
إذا كان هذا صحيحًا، سيكون موقع ملفات BUILD في xml ومخرجات Proto نسبيًا. وفقًا للإعدادات التلقائية، تكون بيانات الموقع الجغرافي مسارًا مطلقًا ولن تكون متسقة على جميع الأجهزة. ويمكنك ضبط هذا الخيار على "صحيح" للحصول على نتيجة متسقة على جميع الأجهزة.
العلامات: terminal_output
--show_config_fragments=<off, direct or transitive> التلقائي: "off;quot;
تعرض أجزاء الضبط المطلوبة بواسطة قاعدة واعتمادياتها الانتقالية. يمكن أن تفيدك هذه المعلومات في تقييم الجزء الذي يمكن قطعه من الرسم البياني المستهدَف.
العلامات: affects_outputs
--starlark:expr=<a string> التلقائي: ""
تعبير Starlark لتنسيق كل هدف مستهدَف في cquery's --output=starlark. الهدف الذي تم ضبطه مرتبط بـ 'target'. إذا لم يتم تحديد --starlark:expr ولا --starlark:file، سيتم تلقائيًا ضبط هذا الخيار على 'str(target.label)'. ومن الخطأ تحديد كل من --starlark:expr و-starlark:file.
العلامات: terminal_output
--starlark:file=<a string> التلقائي: ""
اسم ملف يحدِّد دالة Starlark المعروفة باسم 'format'، من وسيطة واحدة، والتي يتم تطبيقها على كل هدف تم ضبطه لتنسيقه كسلسلة بيانات. ومن الخطأ تحديد كل من --starlark:expr و-starlark:file. للحصول على مزيد من التفاصيل، يُرجى الاطّلاع على المساعدة حول --output=starlark.
العلامات: terminal_output
--[no]tool_deps التلقائي: "true;true"
طلب بحث: في حال إيقاف هذه الميزة، لن يتم تضمين الأهداف المتعلّقة بالاعتمادات على 'host configuration' أو 'execution'; المستهدَفة في الرسم البياني للاعتمادية الذي يعمل عليه طلب البحث. A 'host configuration';الارتباطية: مثل تلك الموجودة في أي من 'proto_library' القاعدة إلى مجمّع البروتوكول، يوجّه عادةً إلى أداة تم تنفيذها أثناء الإصدار بدلاً من جزء من نفس البرنامج #&39;target' طلب البحث: في حال الإيقاف، يتم استبعاد جميع الأهداف التي تم ضبطها والتي من خلال نقل مضيف أو تنفيذ من الاستهداف من المستوى الأعلى الذي اكتشف هذا الاستهداف الذي تم ضبطه. وهذا يعني أنّه إذا كان الاستهداف ذو المستوى الأعلى في إعدادات الاستهداف، لن يتم عرض سوى الأهداف التي تم ضبطها في الإعدادات المستهدفة. إذا كان هدف المستوى الأعلى في ضبط المضيف، لن يتم عرض سوى الاستهدافات التي تم ضبطها للمضيف. ولن يستبعد هذا الخيار سلاسل الأدوات التي تم حلّها.
العلامات: build_file_semantics
--transitions=<full, lite or none> التلقائي: "none;quot;
التنسيق الذي سيطبع به طلب البحث معلومات النقل.
العلامات: affects_outputs
--universe_scope=<comma-separated list of options> التلقائي: ""
مجموعة من الأنماط المستهدفة مفصولة بفواصل (مضَافة وم طرحة). يمكن أن يتم تنفيذ طلب البحث في الكون المحدد عن طريق الإغلاق الانتقالي للأهداف المحدّدة. يُستخدَم هذا الخيار لطلبات البحث وcquery. بالنسبة إلى طلب البحث، إنّ الإدخال في هذا الخيار هو الأهداف التي تم إنشاء جميع الإجابات من خلالها، وبالتالي قد يؤثر هذا الخيار في الإعدادات وعمليات النقل. إذا لم يتم تحديد هذا الخيار، يتم افتراض أنّ أهداف المستوى الأعلى هي الأهداف التي تم تحليلها من تعبير طلب البحث. ملاحظة: بالنسبة إلى طلب البحث، قد يؤدي عدم تحديد هذا الخيار إلى تعطُّل الإصدار إذا كانت الأهداف التي يتم تحليلها من تعبير طلب البحث غير قابلة للإنشاء باستخدام خيارات المستوى الأعلى.
العلامات: loading_and_analysis
الخيارات التي تؤدي إلى تحسينات في وقت الإصدار:
--[no]collapse_duplicate_defines التلقائي: "false;quot;
عند التفعيل، ستتم إزالة القيم المكرّرة، في مرحلة مبكرة من الإصدار. يؤدي ذلك إلى تجنُّب فقدان ذاكرة التخزين المؤقت للتحليل غير ضروري لأنواع معيّنة من الإصدارات المكافئة.
العلامات: loading_and_analysis، loses_incremental_state
--[no]experimental_filter_library_jar_with_program_jar التلقائي: "false;quot;
يمكنك فلترة ProGuard ProgramJar لإزالة أي صفوف متوفّرة أيضًا في LibraryJar.
العلامات: action_command_lines
--[no]experimental_inmemory_dotd_files التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتم تمرير ملفات C++ .d في الذاكرة مباشرةً من عُقد الإصدار البعيدة بدلاً من كتابتها على القرص.
العلامات: loading_and_analysis، execution، affects_outputs، experimental
--[no]experimental_inmemory_jdeps_files التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتم تمرير ملفات الاعتمادية (.jdeps) التي تم إنشاؤها من التجميعات Java في الذاكرة مباشرةً من عُقد الإصدار البعيدة بدلاً من كتابتها على القرص.
العلامات: loading_and_analysis، execution، affects_outputs، experimental
--[no]experimental_objc_include_scanning التلقائي: "false;quot;
تحديد ما إذا كان مطلوبًا إجراء عملية فحص لتحقيق الهدف C/C++ .
العلامات: loading_and_analysis وexecution وchanges_inputs
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found التلقائي: "false;quot;
في حال تفعيل هذه الميزة، لا تنشئ ميزة pars_headers إجراء تجميع منفصل للرؤوس في حال العثور على مصدر يحمل الاسم الأساسي نفسه في الهدف نفسه.
العلامات: loading_and_analysis، affects_outputs
--[no]experimental_retain_test_configuration_across_testonly التلقائي: "false;quot;
عند تفعيل هذا الإعداد، لن يؤدي هذا إلى قطع إعداد الاختبار للقواعد التي تم وضع علامة testonly=1 عليها. تهدف هذه السياسة إلى الحدّ من مشاكل تعارض الإجراء عندما تعتمد القواعد غير التجريبية على قواعد cc_test. لا يتم تطبيق أي تأثير إذا كان --trim_test_configuration خطأ.
العلامات: loading_and_analysis، loses_incremental_state
--[no]experimental_starlark_cc_import التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يمكن استخدام إصدار Starlark من cc_import.
العلامات: loading_and_analysis، experimental
--[no]experimental_unsupported_and_brittle_include_scanning التلقائي: "false;quot;
تحديد ما إذا كان يمكن تضييق نطاق المدخلات إلى تجميع C/C++ عن طريق تحليل #include أسطر من ملفات الإدخال يمكن أن يؤدي ذلك إلى تحسين الأداء والتزايد عن طريق تقليل حجم أشجار الإدخال المجمّعة. ويمكن أيضًا أن يؤدي ذلك إلى إيقاف الإصدارات لأنّ الماسح الضوئي الذي يتضمّن تلك الأداة لا ينفّذ دلالات المعالج الأولي C بالكامل. وعلى وجه الخصوص، لا يفهم توجيهات #include الديناميكية ويتجاهل المنطق الشرطي المُسبق للمعالج. لذلك استخدمها على مسؤوليتك الشخصية. سيتم إغلاق أي مشاكل متعلقة بهذه العلامة التي تم تقديمها.
العلامات: loading_and_analysis، execution، changes_inputs
--[no]incremental_dexing التلقائي: "true;true"
يمكن تنفيذ معظم مهام العمل على سطح المكتب بشكل منفصل لكل ملف Jar.
العلامات: affects_outputs، loading_and_analysis، loses_incremental_state
--[no]objc_use_dotd_pruning التلقائي: "true;true"
في حال تم ضبط هذه السياسة، سيتم استخدام الملفات بالامتداد .d المنبّهة من قِبل المصدر.
العلامات: changes_inputs، loading_and_analysis
--[no]process_headers_in_dependencies التلقائي: "false;quot;
عند إنشاء هدف //a:a، تتم معالجة العناوين في جميع الأهداف التي //a:a تعتمد عليها (إذا تم تفعيل معالجة العناوين لسلسلة الأدوات).
العلامات: execution
--[no]trim_test_configuration التلقائي: "true;true"
عندما يكون الخيار مفعّلاً، سيتم محو الخيارات المتعلّقة بالاختبار تحت المستوى الأعلى من الإصدار. عندما تكون هذه العلامة نشطة، لا يمكن إنشاء الاختبارات كاعتماديات على القواعد غير التجريبية، ولكن التغييرات على الخيارات ذات الصلة بالاختبار لن تؤدي إلى إعادة تحليل القواعد غير التجريبية.
العلامات: loading_and_analysis، loses_incremental_state
--[no]use_singlejar_apkbuilder التلقائي: "true;true"
تم إيقاف هذا الخيار. وهو الآن غير متاح وستتم إزالته قريبًا.
العلامات: loading_and_analysis
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> التلقائي: "-;*"
يمكنك طباعة معلومات تصحيح الأخطاء أثناء حل سلسلة الأدوات. تستخدِم العلامة تعبيرًا عاديًا يتم التحقّق منه في أنواع سلاسل الأدوات والأهداف المحدّدة لمعرفة الأخطاء التي سيتم تصحيحها. قد يتم فصل التعبيرات المتعددة بفواصل، ثم يتم التحقق من كل regex بشكل منفصل. ملاحظة: نتيجة هذه العلامة معقّدة جدًا ومن المرجّح أن تكون مفيدة فقط للخبراء الذين يمكنهم حلّ سلسلة الأدوات.
العلامات: terminal_output
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
تراكم --flag_alias=<a 'name=value' flag alias> استخدامات متعددة
باستخدام اسم مختلَف لعلامة Starlark ويتم استخدام زوج واحد من المفاتيح والقيم في النموذج "<key>ISBNlt;value>" كوسيطة.
العلامات: changes_inputs
--[no]incompatible_default_to_explicit_init_py التلقائي: "false;quot;
تُغيّر هذه العلامة السلوك التلقائي بحيث لا يتم إنشاء ملفات __init__.py تلقائيًا في ملفات تنفيذ أهداف Python. وبشكل خاص، عندما يتم ضبط هدف py_binary أو py_test على قديمة_create_init إلى "quot;auto;quot; (الإعداد التلقائي)، يتم التعامل معه على أنه خطأ في حال ضبط هذه العلامة فقط. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/10076.
العلامات: affects_outputs، incompatible_change
--[no]incompatible_py2_outputs_are_suffixed التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، ستظهر الأهداف المُنشَأة في إعدادات Python 2 ضمن جذر ناتج يتضمّن اللاحقة '-py2&#39، بينما ستظهر الأهداف المُنشَأة في Python 3 في جذر لا يتضمّن لاحقة Python. وهذا يعني أنّ الرمز المميّز المريح لـ "bazel-bin" سيشير إلى استهدافات Python 3 بدلاً من Python 2. في حال تفعيل هذا الخيار، ننصحك أيضًا بتفعيل `--incompatible_py3_is_default`.
العلامات: affects_outputs وincompatible_change
--[no]incompatible_py3_is_default التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، سيتم تلقائيًا ضبط السياستَين "py_binary" و"py_test` التي لم يتم ضبطهما على "python_version" (أو "default_python_version") في PY3 بدلاً من PY2. في حال ضبط هذه العلامة، ننصحك أيضًا بضبط `--incompatible_py2_outputs_are_suffixed`.
العلامات: loading_and_analysis وaffects_outputs وincompatible_change
--[no]incompatible_use_python_toolchains التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، فإنّ قواعد Python الأصلية القابلة للتنفيذ ستستخدم وقت تشغيل Python الذي تحدّده سلسلة أدوات Python، بدلاً من وقت التشغيل الذي تحدّده العلامات القديمة مثل --python_top.
العلامات: loading_and_analysis، incompatible_change
--python_version=<PY2 or PY3> التلقائي: عرض الوصف
وضع الإصدار الرئيسي في Python، إما "PY2" أو "PY3"، ويُرجى العلم بأنّه يتم إلغاء هذا الإعداد باستخدام هدفَي "py_binary" و"py_test` (حتى إذا لم يحدّدا إصدارًا صريحًا)، لذلك ليس هناك عادةً سبب كافٍ لتوفير هذه العلامة.
العلامات: loading_and_analysis، affects_outputs، explicit_in_output_path
خيارات متنوعة، غير مصنّفة بطريقة أخرى:
--[no]cache_test_results [-t] التلقائية: "auto;quot;
في حال ضبط الإعدادات على 'auto'، يُعيد Bazel إجراء الاختبار في الحالات التالية فقط: (1) اكتشاف Bazel للتغييرات في الاختبار أو تبعياته، أو (2) وضع علامة على الاختبار بأنه خارجي، أو (3) طلب تنفيذ عدة اختبارات باستخدام --runs_per_test أو(4) تعذّر الاختبار في السابق. في حال ضبط الإعدادات على 'yes'، يخزِّن Bazel جميع نتائج الاختبار مؤقتًا باستثناء الاختبارات التي تم وضع علامة عليها باعتبارها خارجية. في حال ضبط الإعدادات على 'no'، لا يخزّن Bazel أي نتائج اختبار في ذاكرة التخزين المؤقت.
--[no]experimental_cancel_concurrent_tests التلقائي: "false;quot;
في حال كان هذا صحيحًا، ستلغي"بليز"الاختبارات بشكلٍ متزامن في أول عملية تشغيل ناجحة. ويكون هذا مفيدًا فقط جنبًا إلى جنب مع --runs_per_test_detects_flakes.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_fetch_all_coverage_outputs التلقائي: "false;quot;
في حال اختيار قيم صحيحة، تجلب Bazel دليل بيانات التغطية بالكامل لكل اختبار أثناء إجراء التغطية.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_generate_llvm_lcov التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، ستتولّى تغطية النقرة الاجتماعية إنشاء تقرير LCOV.
العلامات: affects_outputs، loading_and_analysis
--[no]experimental_j2objc_header_map التلقائي: "true;true"
تحديد ما إذا كنت تريد إنشاء خريطة عنوان J2OBjC بالتوازي مع تحويل J2ObjC.
--[no]experimental_j2objc_shorter_header_path التلقائي: "false;quot;
تحديد ما إذا كان سيتم الإنشاء باستخدام مسار عنوان أقصر (يستخدِم "quot;_ios" بدلاً من &&;;j2objc")
العلامات: affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel> التلقائي: "javabuilder"
تفعيل مسارات تحليل منخفضة لتركيبات Java.
--[no]experimental_limit_android_lint_to_android_constrained_java التلقائي: "false;quot;
التقييد --experimental_run_android_lint_on_java_rules للمكتبات المتوافقة مع Android.
العلامات: affects_outputs
--[no]experimental_run_android_lint_on_java_rules التلقائي: "false;quot;
التحقق من صحة مصادر java_*.
العلامات: affects_outputs
--[no]explicit_java_test_deps التلقائي: "false;quot;
يمكنك تحديد الاعتمادية صراحةً على JUnit أو Hamcrest في اختبار java_test بدلاً من الحصول عليها عن طريق الخطأ من TestRunner's. لا تعمل هذه الخدمة حاليًا إلا مع البازلاء.
--host_java_launcher=<a build target label> التلقائي: عرض الوصف
مشغِّل Java الذي تستخدمه الأدوات التي يتم تنفيذها أثناء عملية الإنشاء.
تراكم --host_javacopt=<a string> استخدامات متعددة
خيارات إضافية للانتقال إلى JavaScript عند تصميم الأدوات التي يتم تنفيذها أثناء إنشاء الإضافة.
تراكم --host_jvmopt=<a string> استخدامات متعددة
خيارات إضافية لتمريرها إلى جهاز افتراضي جافا (VM) عند إنشاء الأدوات التي يتم تنفيذها أثناء الإصدار. ستتم إضافة هذه الخيارات إلى خيارات بدء تشغيل الجهاز الافتراضي (VM) لكل هدف java_binary.
--[no]incompatible_exclusive_test_sandboxed التلقائي: "false;quot;
في حال كان هذا صحيحًا، سيتم إجراء الاختبارات الحصرية باستخدام استراتيجية وضع الحماية. أضِف 'local'Tag لفرض إجراء اختبار حصري محليًا
العلامات: incompatible_change
--[no]incompatible_strict_action_env التلقائي: "false;quot;
إذا كان الأمر كذلك، سيستخدم Bazel بيئة بقيمة ثابتة PATH ولا يكتسب LD_LIBRARY_PATH. استخدم --action_env=ENV_VARIABLE إذا كنت تريد اكتساب متغيرات بيئة معينة من العميل، ولكن لاحظ أن ذلك يمكن أن يؤدي إلى منع التخزين المؤقت بين المستخدمين في حال استخدام ذاكرة تخزين مؤقت مشتركة.
العلامات: loading_and_analysis، incompatible_change
تراكم --j2objc_translation_flags=<comma-separated list of options> استخدامات متعددة
خيارات إضافية للانتقال إلى أداة J2OBjC.
--java_debug
تسبّب هذه الأداة الجهاز الافتراضي لاختبار Java في اختبار لغة JavaScript في انتظار الاتصال بالإنترنت من برنامج تصحيح الأخطاء المتوافق مع JDWP (مثل jdb)، قبل بدء الاختبار. تضمين -test_output=streamed.
التوسيع إلى:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps التلقائي: "true;true"
يمكنك إنشاء معلومات الاعتمادية (في الوقت الحالي، مسار الصف وقت التجميع) لكل هدف Java.
--[no]java_header_compilation التلقائي: "true;true"
اجمَع الملفات من المصدر مباشرةً.
--java_language_version=<a string> التلقائي: "8;quot;
إصدار لغة Java
--java_launcher=<a build target label> التلقائي: عرض الوصف
مشغّل Java للاستخدام عند إنشاء برامج ثنائية Java. إذا تم ضبط هذه العلامة على السلسلة الفارغة، سيتم استخدام مشغّل تطبيقات JDK. تلغي السمة "مشغّل التطبيقات"علامة التبويب هذه العلامة.
--java_runtime_version=<a string> التلقائي: "local;local_jdk"
إصدار وقت تشغيل Java
تراكم --javacopt=<a string> استخدامات متعددة
خيارات إضافية للانتقال إلى JavaScript.
تراكم --jvmopt=<a string> استخدامات متعددة
خيارات إضافية لتمريرها إلى جهاز افتراضي يعمل بنظام التشغيل Java. ستتم إضافة هذه الخيارات إلى خيارات بدء تشغيل الجهاز الافتراضي (VM) لكل هدف java_binary.
--legacy_main_dex_list_generator=<a build target label> التلقائي: عرض الوصف
يحدد برنامجًا ثنائيًا لاستخدامه لإنشاء قائمة بالفئات التي يجب أن تكون في المجموعة الرئيسية عند تجميع الشاشات المتعددة القديمة.
تراكم --plugin=<a build target label> استخدامات متعددة
المكوّنات الإضافية المراد استخدامها في الإصدار تعمل حاليًا مع java_plugin.
--proguard_top=<a build target label> التلقائي: عرض الوصف
يحدد إصدار ProGuard الذي يتم استخدامه لإزالة الرمز عند إنشاء برنامج ثنائي بلغة Java.
--proto_compiler=<a build target label> التلقائي: "@bazel_tools//tools/proto:protoc"
تصنيف مجمِّع النماذج الأولية
العلامات: affects_outputs، loading_and_analysis
--proto_toolchain_for_cc=<a build target label> التلقائي: "@bazel_tools//tools/proto:cc_toolchain"
تصنيف proto_lang_toolchain() الذي يصف طريقة تجميع Cpro+ protos
العلامات: affects_outputs وloading_and_analysis
--proto_toolchain_for_j2objc=<a build target label> التلقائي: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"
يمكنك تصنيف proto_lang_toolchain() التي توضّح كيفية تجميع j2objc protos
العلامات: affects_outputs وloading_and_analysis
--proto_toolchain_for_java=<a build target label> التلقائي: "@bazel_tools//tools/proto:java_toolchain"
التصنيف "proto_lang_toolchain()" الذي يصف طريقة تجميع بيانات Java protos
العلامات: affects_outputs وloading_and_analysis
--proto_toolchain_for_javalite=<a build target label> التلقائي: "@bazel_tools//tools/proto:javalite_toolchain"
تصنيف proto_lang_toolchain() الذي يصف طريقة تجميع بيانات JavaLite Protos
العلامات: affects_outputs وloading_and_analysis
تراكم --protocopt=<a string> استخدامات متعددة
خيارات إضافية يمكن تمريرها إلى برنامج الترميز Protobuf.
العلامات: affects_outputs
--[no]runs_per_test_detects_flakes التلقائي: "false;quot;
في حال كان هذا صحيحًا، فإن أي جزء يتم فيه اجتياز عملية تشغيل/محاولة واحدة على الأقل وتعذّر تشغيل/محاولة واحدة على الأقل يحصل على حالة FLAKY.
--shell_executable=<a path> التلقائي: عرض الوصف
مسار مطلق إلى واجهة المستخدم التنفيذية التي سيستخدِمها Bazel. إذا لم يتم ضبط هذا الإعداد، ولكن تم ضبط متغيّر البيئة BAZEL_SH عند استدعاء Bazel الأول (بدء تشغيل خادم Bazel)، سيستخدم Bazel ذلك. إذا لم يتم ضبط أي من الإعدادين، سيستخدم Bazel مسارًا تلقائيًا ثابتًا وفقًا لنظام التشغيل على (Windows: c:/tools/msys64/usr/bin/bash.exe أو FreeBSD: /usr/local/bin/bash (جميع الأجهزة الأخرى: /bin/bash). تجدر الإشارة إلى أن استخدام واجهة غير متوافقة مع bash قد يؤدي إلى حدوث حالات إخفاق أو إخفاق في وقت التشغيل في البرامج الثنائية التي تم إنشاؤها.
العلامات: loading_and_analysis
تراكم --test_arg=<a string> استخدامات متعددة
يحدد الخيارات الإضافية والوسيطات التي يجب تمريرها إلى الملف التنفيذي للاختبار. يمكن استخدامها عدة مرات لتحديد وسيطات متعددة. وفي حال تنفيذ اختبارات متعددة، سيتلقّى كل اختبار منها وسيطات متطابقة. لا يتم استخدامه إلا باستخدام الأمر 'bazel test'.
--test_filter=<a string> التلقائي: عرض الوصف
يحدد هذا الإعداد فلتر لإعادة التوجيه إلى إطار عمل الاختبار. يُستخدم للحد من إجراء الاختبارات. لاحظ أن هذا لا يؤثر في الأهداف التي يتم إنشاؤها.
--test_result_expiration=<an integer> التلقائي: "-1"
تم إيقاف هذا الخيار وليس له أي تأثير.
--[no]test_runner_fail_fast التلقائي: "false;quot;
تتعذّر إعادة توجيه الخيار السريع إلى المشاركين في الاختبار. من المفترض أن يتوقف إجراء الاختبار عن العمل عند الفشل الأول.
--test_sharding_strategy=<explicit or disabled> التلقائي: "explicit"
حدِّد استراتيجية تجزئة الاختبار: 'explicit' لاستخدام التجزئة فقط في حال توفر السمة 'shard_count' BUILD. 'disabled' عدم استخدام تجزئة الاختبار مطلقًا.
--tool_java_language_version=<a string> التلقائي: "8;quot;
إصدار لغة Java المُستخدَمة لتنفيذ الأدوات اللازمة أثناء عملية الإنشاء
--tool_java_runtime_version=<a string> التلقائي: "remotejdk_11"
إصدار وقت تشغيل جافا المستخدم لتنفيذ الأدوات أثناء الإصدار
--[no]use_ijars التلقائي: "true;true"
في حال تفعيل هذا الإعداد، يؤدي التجميع عند تشغيل Java إلى استخدام جرارات للواجهة. وسيؤدي ذلك إلى تجميع البيانات بشكل أسرع، ولكن يمكن أن تختلف رسائل الخطأ.

خيارات التفريغ

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على "صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتحكّم في ناتج الأمر:
--[no]action_cache التلقائي: "false;quot;
تفريغ المحتوى لذاكرة التخزين المؤقت للإجراءات
العلامات: bazel_monitoring
--[no]packages التلقائي: "false;quot;
تفريغ المحتوى لذاكرة التخزين المؤقت للحزمة
العلامات: bazel_monitoring
--[no]rule_classes التلقائي: "false;quot;
تفريغ صفوف القاعدة
العلامات: bazel_monitoring
--[no]rules التلقائي: "false;quot;
قواعد التفريغ، بما في ذلك الأعداد واستخدام الذاكرة (في حال تتبّع الذاكرة)
العلامات: bazel_monitoring
--skyframe=<off, summary, count, deps or rdeps> التلقائي: "off;quot;
تفريغ الرسم البياني لـ Skyframe: 'off', 'summary', 'count', 'deps', &&33;rdeps'
العلامات: bazel_monitoring
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths> التلقائي: "*"
فلتر التعبير العادي لأسماء SkyKey المطلوب إخراجها ويُستخدَم فقط مع --skyframe=deps، وrdeps.
العلامات: bazel_monitoring
--skylark_memory=<a string> التلقائي: عرض الوصف
يتم تفريغ الملف الشخصي المتوافق مع pprof إلى المسار المحدد. لمزيد من المعلومات، يُرجى الاطّلاع على https://github.com/google/pprof.
العلامات: bazel_monitoring
الخيارات التي تؤثّر في مدى تطبيق Bazel لعمليات الإدخال الصالحة للرموز (تعريفات القواعد ومجموعات التركيبات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة"bazel_dep"المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.

خيارات الجلب

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتحكّم في تنفيذ الإصدار:
في حال ضبط هذه السياسة على "صحيح" و"-compatible_remote_symlinks" أيضًا، يُسمح باستخدام الروابط الرمزية في مخرجات الإجراء.
العلامات: execution، incompatible_change
في حال ضبط هذه السياسة على"صحيح"، سيمثّل Bazel الروابط الرمزية في مخرجات الإجراءات في بروتوكول التنفيذ/التخزين المؤقت عن بُعد. بخلاف ذلك، سيتم تتبُّع الروابط الرمزية لتمثيلها أو تمثيلها كملفات أو أدلة. راجِع #6631 لمزيد من التفاصيل.
العلامات: execution، incompatible_change
--[no]keep_going [-k] التلقائية: "false"
يُرجى المتابعة قدر الإمكان بعد حدوث خطأ. في حين أنه لا يمكن تحليل الاستهداف الذي تعذّر الاستهداف وتلك التي تعتمد عليه، يمكن إجراء متطلبات أساسية أخرى لهذه الأهداف.
العلامات: eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> التلقائي: "auto;quot;
عدد سلاسل المحادثات المتوازية المطلوب استخدامها لمرحلة التحميل/التحليل.ويتم استخدام عدد صحيح أو كلمة رئيسية ("auto", "HOST_CPUS", "HOST_RAM") متبوعةً بعملية ([-|*]< العدد>) مثل. "auto", "HOST_CPUS*.5" "auto"تعيين إعداد تلقائي معقول بناءً على موارد المضيف. يجب أن تكون 1 على الأقل.
العلامات: bazel_internal_configuration
الخيارات التي تتيح للمستخدم ضبط النتائج المطلوبة، ما يؤثر في قيمتها بدلاً من تفعيلها:
--bep_maximum_open_remote_upload_files=<an integer> التلقائي: "-1"
الحد الأقصى لعدد الملفات المفتوحة المسموح بها أثناء تحميل العنصر BEP.
العلامات: affects_outputs
--remote_download_minimal
عدم تنزيل أي نتائج إخراج عن بُعد إلى الجهاز المحلي. هذه العلامة عبارة عن اختصار لثلاثة علامات: --experimental_inmemory_jdeps_files، --experimental_inmemory_dotd_files و --remote_download_outputs=minimal.
التوسيع إلى:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=minimal

العلامات: affects_outputs
--remote_download_outputs=<all, minimal or toplevel> التلقائي: "all"
في حال ضبط السياسة على 'minimal' ولا يتم تنزيل أي مخرجات إصدار عن بُعد إلى الجهاز المحلي، باستثناء تلك التي تتطلّبها الإجراءات المحلية. في حال الضبط على 'toplevel' يتصرف مثل'minimal&#39؛ إلا أنه يؤدي أيضًا إلى تنزيل مخرجات أهداف المستوى الأعلى إلى الجهاز المحلي. يمكن أن يقلل كلا الخيارين من أوقات الإصدار إذا كانت هناك قيود على معدل نقل البيانات للشبكة.
العلامات: affects_outputs
بدلاً من تنزيل مخرجات الإصدار عن بُعد إلى الجهاز المحلي، يمكنك إنشاء روابط رمزية. يمكن تحديد هدف الروابط الرمزية في شكل سلسلة نموذج. قد تحتوي سلسلة النموذج هذه على {hash} و{size_ وحدات البايت} التي يتم توسيعها إلى تجزئة العنصر والحجم بالبايت، على التوالي. ويمكن أن تشير هذه الروابط الرمزية مثلاً إلى نظام ملفات FUSE الذي يحمِّل عناصر من CAS عند الطلب.
العلامات: affects_outputs
--remote_download_toplevel
يتم تنزيل النتائج عن بُعد لأهداف المستوى الأعلى على الجهاز المحلي فقط. هذه العلامة عبارة عن اختصار لثلاثة علامات: --experimental_inmemory_jdeps_files، --experimental_inmemory_dotd_files و-remote_download_outputs=toplevel.
التوسيع إلى:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel

العلامات: affects_outputs
الخيارات التي تؤثّر في مدى صرامة تطبيق Bazel لعمليات الإدخال الصالحة للبيانات (تعريفات القواعد ومجموعات التركيبات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
--[no]incompatible_config_setting_private_default_visibility التلقائي: "false;quot;
في حال عدم التوافق_ar_force_setting_setting_visible=false، هذه القيمة عمليّة جديدة. بخلاف ذلك، إذا كانت هذه العلامة غير صحيحة، أي config_setting بدون سمة ظهور واضحة هو //impression:public. إذا كانت هذه العلامة صحيحة، يتّبع config_setting منطق مستوى الرؤية نفسه الذي تتبعه جميع القواعد الأخرى. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12933.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_enforce_config_setting_visibility التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، فرض قيود على إعداد config_setting. وفي حال اختيار القيمة "خطأ"، سيكون كل إعداد config_setting مرئيًا لكل هدف. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12932.
العلامات: loading_and_analysis، incompatible_change
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة "bazel_dep" المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
--experimental_repository_resolved_file=<a string> التلقائي: ""
إذا كانت السياسة غير فارغة، اكتب قيمة Starlark باستخدام المعلومات التي تم حلّها لجميع قواعد مستودع Starlark التي تم تنفيذها.
العلامات: affects_outputs
--remote_print_execution_messages=<failure, success or all> التلقائي: "failure"
اختيار وقت طباعة رسائل التنفيذ عن بُعد القيم الصالحة هي "fail" أو "الطباعة" عند تعذُّر الطباعة إلا و"النجاح" للطباعة في حالات النجاح فقط و"الكل" للطباعة دائمًا.
العلامات: terminal_output
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
--[no]experimental_guard_against_concurrent_changes التلقائي: "false;quot;
إيقاف هذه الميزة لإيقاف التحقّق من وقت ملفات إدخال الإجراءات قبل تحميلها إلى ذاكرة التخزين المؤقت عن بُعد قد يعود سبب هذه المشكلة إلى حالات تأخير في كتابة ملفات Linux kernel، ما قد يؤدي إلى حالات موجبة خاطئة.
--experimental_remote_build_event_upload=<all or minimal> التلقائي: "all"
في حال الضبط على 'all'، يتم تحميل كل النتائج المحلية التي يشير إليها بروتوكول BEP إلى ذاكرة التخزين المؤقت عن بُعد. في حال الضبط على 'minimal'، لا يتم تحميل النتائج المحلية التي يشير إليها BEP إلى ذاكرة التخزين المؤقت البعيدة، باستثناء الملفات المهمة للمستهلكين في حالة BEP (مثل سجلات الاختبار والملف الشخصي للتوقيت). ويتم استخدام مخطط //:file لمسارات الملفات المحلية ومخطَّط // stream. ضبط تلقائي على 'all'
--[no]experimental_remote_cache_async التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، سيتم إجراء مؤتمر I/O لذاكرة التخزين المؤقت عن بُعد في الخلفية بدلاً من عقده كجزء من عملية النبات.
--[no]experimental_remote_cache_compression التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يُرجى ضغط كائن تخزين البيانات الثنائية الكبيرة أو فك ضغطه باستخدام zstd.
--experimental_remote_capture_corrupted_outputs=<a path> التلقائي: عرض الوصف
المسار المؤدي إلى دليل يتم فيه إخراج النتائج التالفة إليه.
--experimental_remote_downloader=<a string> التلقائي: عرض الوصف
معرّف موارد منتظم (URI) لنقطة نهاية واجهة برمجة التطبيقات البعيدة لمواد العرض، لاستخدامه كخادم وكيل للتنزيل عن بُعد. المخططات المعتمدة هي grpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX المحلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. يُرجى الاطّلاع على الرابط: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset_proto
--[no]experimental_remote_downloader_local_fallback التلقائي: "false;quot;
تحديد ما إذا كان من الممكن الرجوع إلى أداة التنزيل المحلية في حال تعذّر تنزيل أداة التنزيل عن بُعد.
--[no]experimental_remote_execution_keepalive التلقائي: "false;quot;
استخدام رسالة التحقّق من الاتصال لمكالمات التنفيذ عن بُعد
--experimental_remote_grpc_log=<a path> التلقائي: عرض الوصف
في حال تم تحديد مسار إلى ملف لتسجيل التفاصيل المتعلقة بمكالمة gRPC. يتكون هذا السجل من تسلسل من com.google.devtools.build.lib.remote.log.remoteExecutionLog.LogEntrys9fs مع كل رسالة مسبوقة بعلامة تشير إلى حجم رسالة Protobuf التسلسلية التالية، كما ننفّذها الطريقة LogLog.writeDelimitedTo(إخراجStream).
--[no]experimental_remote_mark_tool_inputs التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، سيضع Bazel علامة على الإدخالات كإدخالات للأداة التنفيذية عن بُعد. ويمكن استخدام هذا في تنفيذ العاملين الدائمين عن بُعد.
--[no]experimental_remote_merkle_tree_cache التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، سيتم تدوين حسابات شجرة ميركل لتحسين سرعة التحقّق من نتائج ذاكرة التخزين المؤقت عن بُعد. يتم التحكم في طباعة ذاكرة التخزين المؤقت في الذاكرة باستخدام --experimental_remote_merlick_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer> التلقائي: "1000"
عدد أشجار Mer وتتوفّر لتذكُّرها لتحسين سرعة التحقُّق من النتائج في ذاكرة التخزين المؤقت عن بُعد. ومع أنّ ذاكرة التخزين المؤقت يتم تشغيلها تلقائيًا وفقًا لطريقة معالجة Java& العديد من المراجع، قد تظهر أخطاء متعلّقة بالذاكرة إذا تم ضبطها على قيمة مرتفعة جدًا. إذا تم ضبطها على 0، يكون حجم ذاكرة التخزين المؤقت غير محدود. تختلف القيمة المثالية حسب حجم المشروع. القيمة التلقائية هي 1000.
--[no]incompatible_remote_build_event_upload_respect_no_cache التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، لا يتم تحميل النتائج التي يشير إليها بروتوكول BEP إلى ذاكرة التخزين المؤقت عن بُعد في حال تعذّر تخزين إجراء الإنشاء مؤقتًا عن بُعد.
--[no]incompatible_remote_downloader_send_all_headers التلقائي: "true;true"
ما إذا كان سيتم إرسال جميع قيم العنوان المتعدد القيم إلى أداة التنزيل عن بُعد بدلاً من القيمة الأولى فقط.
العلامات: incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root التلقائي: "false;quot;
في حال الضبط على "صحيح"، ترتبط مسارات الإخراج بجذر الإدخال بدلاً من دليل العمل.
العلامات: incompatible_change
--[no]incompatible_remote_results_ignore_disk التلقائي: "true;true"
في حال ضبطها على"صحيح"، لن يتم تطبيق --noremote_upload_local_results و-noremote_accept_cached على ذاكرة التخزين المؤقت على القرص. في حال استخدام ذاكرة تخزين مؤقت مجمّعة: --noremote_upload_local_results سيؤدي إلى كتابة نتائج في ذاكرة التخزين المؤقت على القرص، ولكن لا يتم تحميلها إلى ذاكرة التخزين المؤقت عن بُعد. --noremote_Accept_cached: سيؤدي ذلك إلى بحث Bazel عن النتائج في ذاكرة التخزين المؤقت على القرص، ولكن ليس في ذاكرة التخزين المؤقت عن بُعد. يمكن أن تؤدي إجراءات no-remote-exec إلى ذاكرة التخزين المؤقت على القرص. راجِع #8216 لمزيد من التفاصيل.
العلامات: incompatible_change
--[no]remote_accept_cached التلقائي: "true;true"
قبول نتائج الإجراء المخزنة عن بُعد.
--remote_bytestream_uri_prefix=<a string> التلقائي: عرض الوصف
اسم المضيف واسم النسخة الافتراضية المطلوب استخدامهما في معرّفات الموارد المنتظمة (URI) // stream. يمكن تحديد هذا الخيار عند تنفيذ الإصدارات باستخدام خادم وكيل، مما يؤدي إلى عدم تطابق قيم --remote_executor و--remote_instance_name مع الاسم الأساسي لخدمة التنفيذ عن بُعد. وعند عدم ضبطها تلقائيًا، سيتم ضبطها تلقائيًا على "${hostname}/${instance_name}".
--remote_cache=<a string> التلقائي: عرض الوصف
معرّف موارد منتظم (URI) لنقطة نهاية ذاكرة التخزين المؤقت المخططات المتاحة هي http وhttps وgrpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX محلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. حدِّد grpc:// أو http:// أو Unix: مخطط لإيقاف بروتوكول أمان طبقة النقل. يُرجى الاطّلاع على https://bazel.build/remote/caching
تراكم --remote_cache_header=<a 'name=value' assignment> استخدامات متعددة
حدِّد عنوانًا سيتم تضمينه في طلبات ذاكرة التخزين المؤقت: --remote_cache_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
تراكم --remote_default_exec_properties=<a 'name=value' assignment> استخدامات متعددة
يمكنك ضبط خصائص exe التلقائية المراد استخدامها كمنصة تنفيذ عن بُعد في حال عدم ضبط منصة تنفيذ من قبل exec_property.
العلامات: affects_outputs
--remote_default_platform_properties=<a string> التلقائي: ""
يمكنك ضبط خصائص النظام الأساسي التلقائية المطلوب ضبطها لواجهة برمجة التطبيقات للتنفيذ عن بُعد، إذا لم تكن منصة التنفيذ قد تم ضبطها عن بُعد. وستُستخدَم هذه القيمة أيضًا في حال اختيار النظام الأساسي المضيف كنظام أساسي للتنفيذ عن بُعد.
تراكم --remote_downloader_header=<a 'name=value' assignment> استخدامات متعددة
حدد عنوانًا سيتم تضمينه في طلبات التنزيل عن بُعد: --remote_downloader_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
تراكم --remote_exec_header=<a 'name=value' assignment> استخدامات متعددة
حدِّد عنوانًا سيتم تضمينه في طلبات التنفيذ: "remote_exec_header=Name=Value". يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
--remote_execution_priority=<an integer> التلقائي: "0"
الأولوية النسبية للإجراءات التي سيتم تنفيذها عن بُعد تعتمد دلال قيم الأولوية المحدّدة على الخادم.
--remote_executor=<a string> التلقائي: عرض الوصف
المضيف أو HOST:PORT لنقطة نهاية التنفيذ عن بُعد. المخططات المعتمدة هي grpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX المحلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. حدِّد grpc:// أو unix: مخطط لإيقاف بروتوكول أمان طبقة النقل.
تراكم --remote_header=<a 'name=value' assignment> استخدامات متعددة
تحديد عنوان سيتم تضمينه في الطلبات: --remote_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
--remote_instance_name=<a string> التلقائي: ""
القيمة التي يجب إدخالها كمثال example_name في واجهة برمجة التطبيقات للتنفيذ عن بُعد.
--[no]remote_local_fallback التلقائي: "false;quot;
ما إذا كان المطلوب الالتزام باستراتيجية التنفيذ المحلية المستقلة في حال تعذّر التنفيذ عن بُعد.
--remote_local_fallback_strategy=<a string> التلقائي: "local;quot"
لا تتوفّر إمكانية التشغيل يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7480 للحصول على التفاصيل.
--remote_max_connections=<an integer> التلقائي: "100"
الحد الأقصى لعدد الاتصالات المتزامنة إلى ذاكرة التخزين المؤقت/التنفيذ عن بُعد وتكون القيمة 100 تلقائيًا. ويعني ضبطها على 0 أنّه ما مِن قيود. بالنسبة إلى ذاكرة التخزين المؤقت عن بُعد في HTTP، يمكن لاتصال TCP واحد معالجة طلب واحد في كل مرة، لذا يمكن أن يتولى Bazel ما يصل إلى --remote_max_connections من الطلبات المتزامنة. في ما يتعلق بذاكرة التخزين المؤقت/المنفّذ عن بُعد لدى gRPC، يمكن عادةً أن تعالج قناة gRPC أكثر من 100 طلب متزامن، لذا يمكن أن يرسل Bazel حوالي طلبات متزامنة بين ---remote_max_connections * 100`.
العلامات: host_machine_resource_optimizations
--remote_proxy=<a string> التلقائي: عرض الوصف
الاتصال بذاكرة التخزين المؤقت عن بُعد من خلال خادم وكيل. لا يمكن استخدام هذه العلامة حاليًا إلا لإعداد مقبس نطاق Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer> التلقائي: "0"
الأولوية النسبية للإجراءات البعيدة المراد تخزينها في ذاكرة التخزين المؤقت عن بُعد. تعتمد دلال قيم الأولوية المحدّدة على الخادم.
--remote_retries=<an integer> التلقائي: "5"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح عابر. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
--remote_timeout=<An immutable length of time.> التلقائي: "60s"
الحد الأقصى لوقت انتظار التنفيذ عن بُعد وذاكرة التخزين المؤقت للمكالمات. وبالنسبة إلى ذاكرة التخزين المؤقت في REST، تكون هذه القيمة هي مهلة الاتصال ومهلة القراءة. يمكن استخدام الوحدات التالية: الأيام (د) والساعات (س) والدقائق (م) والثواني (ث) والملي ثانية (ملي ثانية). إذا تم حذف الوحدة، يتم تفسير القيمة بالثواني.
--[no]remote_upload_local_results التلقائي: "true;true"
تحميل نتائج الإجراءات التي تم تنفيذها محليًا إلى ذاكرة التخزين المؤقت عن بُعد
--[no]remote_verify_downloads التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، سيحتسب Bazel مجموع التجزئة لجميع عمليات التنزيل عن بُعد وسيتجاهل القيم المخزَّنة مؤقتًا عن بُعد في حال عدم تطابقها مع القيمة المتوقَّعة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
--deleted_packages=<comma-separated list of package names> التلقائي: ""
قائمة بأسماء الحِزم المفصولة بفاصلة والتي يعتبرها نظام الإصدار غير موجودة، حتى إذا كانت مرئية في مكان ما على مسار الحزمة. استخدِم هذا الخيار عند حذف حزمة فرعية 'x/y' من حزمة حالية 'x&#39؛. على سبيل المثال، بعد حذف x/y/BUILD في برنامجك، قد يعترض نظام الإصدار إذا واجه تصنيفًا '//x:y/z&#39؛ إذا كان لا يزال يتم تقديمه من خلال إدخال package_path آخر. ويؤدي تحديد --delete_packages x/y إلى تجنُّب هذه المشكلة.
--disk_cache=<a path> التلقائي: عرض الوصف
مسار للاطّلاع على دليل حيث يمكن لتطبيق Bazel قراءة الإجراءات وإجراءاتها وكتابتها. في حال عدم توفّر الدليل، سيتم إنشاؤه.
تراكم --experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.> استخدامات متعددة
لضبط"بيانات اعتماد الاعتماد"في استخدامها لاسترداد بيانات الاعتماد للنطاق المقدَّم (النطاق). تحظى بيانات الاعتماد من "مساعدو المساعدة" بالأولوية على بيانات الاعتماد من <code&code>--google_default_credentials</code> أو `--google_credentials` أو &<code>.netrc</code>
--experimental_credential_helper_cache_duration=<An immutable length of time.> التلقائي: "30m"
لضبط المدة التي يتم خلالها تخزين بيانات اعتماد"أدوات مساعدة الاعتماد"مؤقتًا.
--experimental_credential_helper_timeout=<An immutable length of time.> التلقائي: "5;"
لضبط المهلة لمساعد بيانات الاعتماد. وسيتعذّر استدعاء بيانات اعتماد الوصول خلال هذه المهلة.
--google_auth_scopes=<comma-separated list of options> التلقائي: "https://www.googleapis.com/auth/cloud-platform"
قائمة مفصولة بفواصل لنطاقات المصادقة في Google Cloud
--google_credentials=<a string> التلقائي: عرض الوصف
يحدد الملف للحصول على بيانات اعتماد المصادقة. يمكنك الاطّلاع على https://cloud.google.com/docs/authentication للحصول على التفاصيل.
--[no]google_default_credentials التلقائي: "false;quot;
ما إذا كان المطلوب استخدام بيانات الاعتماد التلقائية في &39;Google للتطبيقات لإجراء المصادقة. يمكنك الاطّلاع على https://cloud.google.com/docs/authentication للحصول على التفاصيل. هذه الميزة غير مفعّلة تلقائيًا.
--grpc_keepalive_time=<An immutable length of time.> التلقائي: عرض الوصف
يمكنك ضبط إشعارات البقاء على قيد الاتصال لاتصالات gRPC الصادرة. إذا تم ضبط الإعداد، يُرسِل Bazel إشعارات بعد هذه الفترة من عدم توفّر عمليات قراءة على الاتصال، إلا إذا كان هناك طلب gRPC واحد على الأقل في انتظار المراجعة. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. يتم إيقاف إشعارات البقاء على الوضع تلقائيًا. يجب التنسيق مع مالك الخدمة قبل تفعيل هذا الإعداد. على سبيل المثال، لضبط قيمة 30 ثانية على هذه العلامة، يجب إجراؤها على النحو التالي --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.> التلقائي: "20s"
يضبط هذا الإعداد مهلة الاحتفاظ بالبيانات لاتصالات gRPC الصادرة. في حال تفعيل إشعارات البقاء على الاتصال مع --grpc_keepalive_time، ستنتهي مهلة Bazel للاتصال إذا لم تتلقَ رد فحص الاتصال بعد هذا الوقت الكبير. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. في حال إيقاف إشعارات التحقّق من الاتصال، يتم تجاهل هذا الإعداد.
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.
--package_path=<colon-separated list of options> التلقائي: "%workspace%"
قائمة مفصولة بفواصل من المكان الذي يجب البحث فيه عن الطرود. العناصر التي تبدأ بـ '%workspace%' نسبية إلى مساحة العمل المضمنة. في حال حذف الحقل أو تركه فارغًا، يكون الإعداد التلقائي هو الناتج 'bazel information default-package-path'.
--[no]show_loading_progress التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتسبب تطبيق Bazel في طباعة الرسائل &quot&تحميل الحِزمة:".
--tls_certificate=<a string> التلقائي: عرض الوصف
حدِّد مسارًا لشهادة بروتوكول أمان طبقة النقل (TLS) موثوقة لتوقيع شهادات الخادم.
--tls_client_certificate=<a string> التلقائي: عرض الوصف
حدِّد شهادة عميل طبقة النقل الآمنة التي تريد استخدامها، وعليك أيضًا تقديم مفتاح عميل لتفعيل مصادقة العميل.
--tls_client_key=<a string> التلقائي: عرض الوصف
حدِّد مفتاح عميل طبقة النقل الآمنة الذي سيتم استخدامه، وعليك أيضًا تقديم شهادة عميل لتفعيل مصادقة العميل.

خيارات المساعدة

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تؤثّر في مدى تطبيق Bazel لمدخلات صالحة لإنشاء الإصدارات (تعريفات القواعد ومجموعات العلامات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة"bazel_dep"المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
--help_verbosity=<long, medium or short> التلقائي: "medium;quot"
اختَر الإسهاب في طلب المساعدة.
العلامات: affects_outputs، terminal_output
--long [-l]
اعرض الوصف الكامل لكل خيار، بدلاً من اسمه فقط.
التوسيع إلى:
--help_verbosity=long

العلامات: affects_outputs, terminal_output
--short
يجب عرض أسماء الخيارات فقط، وليس أنواعها أو معانيها.
يتوسّع إلى:
--help_verbosity=short

العلامات: affects_outputs, terminal_output
الخيارات التي تحدّد إدخالاً عامًا أو تغيّره لأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.

خيارات المعلومات

يكتسب جميع الخيارات من إصدار.

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على "صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تؤثّر في مدى تطبيق Bazel لمدخلات صالحة لإنشاء الإصدارات (تعريفات القواعد ومجموعات العلامات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة "bazel_dep" المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
--[no]show_make_env التلقائي: "false;quot;
تضمين البيئة "&&;;&;;;;;;;;&quot؛ في الإخراج.
العلامات: affects_outputs، terminal_output
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.

خيارات الترخيص

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على "صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تؤثّر في مدى تطبيق Bazel لمدخلات صالحة لإنشاء الإصدارات (تعريفات القواعد ومجموعات العلامات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة"bazel_dep"المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.

خيارات التثبيت على الأجهزة الجوّالة

يكتسب جميع الخيارات من إصدار.

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتحكّم في تنفيذ الإصدار:
--mode=<classic, classic_internal_test_do_not_use or skylark> التلقائي: " Classic;quot;
اختَر كيفية تشغيل تثبيت الأجهزة الجوّالة. " Classic";; تشغيل الإصدار الحالي من تثبيت الأجهزة الجوالة. "skylark" تستخدم الإصدار الجديد من Starlark الذي يتوافق مع android_test.
العلامات: loading_and_analysis، execution، incompatible_change
الخيارات التي تعمل على ضبط سلسلة الأدوات المستخدَمة لتنفيذ الإجراء:
--adb=<a string> التلقائي: ""
برنامج ثنائي البرنامج adb لاستخدامه مع الأمر 'mobile-install'. وفي حال عدم تحديدها، يتم استخدام الحزمة المتوفرة في "حزمة تطوير البرامج (SDK) لنظام التشغيل Android" بواسطة خيار سطر الأوامر "-android_sdk" (أو حزمة تطوير البرامج (SDK) التلقائية في حال عدم تحديد "android_sdk").
العلامات: changes_inputs
الخيارات التي تتحكّم في ناتج الأمر:
--[no]incremental التلقائي: "false;quot;
تحديد ما إذا كنت تريد إجراء تثبيت متزايد. إذا كان هذا صحيحًا، حاول تجنُّب العمل الإضافي غير اللازم من خلال قراءة حالة الجهاز الذي تم تثبيت الرمز عليه واستخدام هذه المعلومات لتجنّب العمل غير الضروري. وإذا كانت القيمة false (الخيار التلقائي)، عليك إجراء عملية تثبيت كاملة دائمًا.
العلامات: loading_and_analysis
--[no]split_apks التلقائي: "false;quot;
استخدام حِزم APK المُقسَّمة لتثبيت التطبيق وتحديثه على الجهاز لا يعمل هذا الإعداد إلا مع الأجهزة التي تستخدم الإصدار Marshmallow أو الإصدارات الأحدث
العلامات: loading_and_analysis, affects_outputs
الخيارات التي تتيح للمستخدم ضبط النتائج المطلوبة، ما يؤثر في قيمتها بدلاً من تفعيلها:
تراكم --adb_arg=<a string> استخدامات متعددة
وسيطات إضافية للتمرير إلى adb. يُستخدَم عادةً لتخصيص جهاز لتثبيته.
العلامات: action_command_lines
--debug_app
تحديد ما إذا كنت تنتظر أداة تصحيح الأخطاء قبل بدء تشغيل التطبيق
التوسيع إلى:
--start=DEBUG

العلامات: execution
--device=<a string> التلقائي: ""
الرقم التسلسلي لجهاز adb. إذا لم يتم تحديدها، سيتم استخدام الجهاز الأول.
العلامات: action_command_lines
--start=<no, cold, warm or debug> التلقائي: "NO"
كيفية بدء تشغيل التطبيق بعد تثبيته. الضبط على WARM للاحتفاظ بحالة التطبيق واستعادتها في عمليات التثبيت المتزايدة.
العلامات: execution
--start_app
بدء تشغيل التطبيق بعد تثبيته.
التوسيع إلى:
--start=COLD

العلامات: execution
الخيارات التي تؤثّر في مدى تطبيق Bazel لعمليات الإدخال الصالحة للإصدار (تعريفات القواعد ومجموعات التركيبات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة"bazel_dep"المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
--incremental_install_verbosity=<a string> التلقائي: ""
الإسهاب في عمليات التثبيت المتزايدة. اضبط القيمة على 1 لتسجيل تصحيح الأخطاء.
العلامات: bazel_monitoring
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.

خيارات Modquery

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على "صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتحكّم في تنفيذ الإصدار:
--[no]keep_going [-k] التلقائية: "false"
يُرجى المتابعة قدر الإمكان بعد حدوث خطأ. في حين أنه لا يمكن تحليل الاستهداف الذي تعذّر الاستهداف وتلك التي تعتمد عليه، يمكن إجراء متطلبات أساسية أخرى لهذه الأهداف.
العلامات: eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> التلقائي: "auto;quot;
عدد سلاسل المحادثات المتوازية المطلوب استخدامها لمرحلة التحميل/التحليل.ويتم استخدام عدد صحيح أو كلمة رئيسية ("auto", "HOST_CPUS", "HOST_RAM") متبوعةً بعملية ([-|*]< العدد>) مثل. "auto", "HOST_CPUS*.5" "auto"تعيين إعداد تلقائي معقول بناءً على موارد المضيف. يجب أن تكون 1 على الأقل.
العلامات: bazel_internal_configuration
الخيارات التي تؤثّر في مدى فرض تطبيق Bazel لمدخلات الإصدارات الصالحة (تعريفات القواعد ومجموعات التركيبات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
--[no]incompatible_config_setting_private_default_visibility التلقائي: "false;quot;
في حال عدم التوافق_ar_force_setting_setting_visible=false، هذه القيمة عمليّة جديدة. بخلاف ذلك، إذا كانت هذه العلامة غير صحيحة، أي config_setting بدون سمة ظهور واضحة هو //impression:public. إذا كانت هذه العلامة صحيحة، يتّبع config_setting منطق مستوى الرؤية نفسه الذي تتبعه جميع القواعد الأخرى. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12933.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_enforce_config_setting_visibility التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، فرض قيود على إعداد config_setting. وفي حال اختيار القيمة "خطأ"، سيكون كل إعداد config_setting مرئيًا لكل هدف. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12932.
العلامات: loading_and_analysis، incompatible_change
الخيارات المتعلقة بإخراج modquery ودلالات الألفاظ:
--charset=<utf8 or ascii> التلقائي: "utf8"
اختيار حرف الأحرف المراد استخدامه للشجرة. لا يؤثر هذا الإعداد إلا في إخراج النص. القيم الصالحة هي "utf8" أو "ascii". وتكون القيمة التلقائية هي "utmf8"
العلامات: terminal_output
--[no]cycles التلقائي: "false;quot;
تشير إلى دورات الاعتمادية داخل العرض التدرّجي المعروض، والتي يتم تجاهلها عادةً بشكل تلقائي.
العلامات: execution
--depth=<an integer> التلقائي: "-1"
الحد الأقصى لعمق العرض في شجرة الاعتمادية. على سبيل المثال، عمق 1 يعرض تبعيات مباشرة. بالنسبة إلى الأشجار والمسار وall_path والإعداد التلقائي هو Integer.MAX_VALUE، في حين يتم تحديد الانخفاضات تلقائيًا وتوضيحه على 1 (يتم عرض الانخفاضات المباشرة للجذر فقط إلى جانب أوراق الهدف ووالدَيها).
العلامات: execution
--[no]extra التلقائي: "false;quot;
ستعرض طلبات البحث أيضًا سبب حلّ الوحدات في إصدارها الحالي (في حال تغييرها). ويتم الإعداد تلقائيًا على "صحيح" فقط لطلب البحث الشرح.
العلامات: execution
--from=<a list of <module>s separated by comma> التلقائي: "root;quot;
سيتم عرض الوحدات التي يبدأ منها طلب البحث عن الرسم البياني للاعتمادية. يُرجى التحقق من وصف كل طلب بحث بالنسبة إلى الدلالة الدقيقة. ويتم إعداده تلقائيًا على الجذر.
العلامات: execution
--[no]include_unused التلقائي: "false;quot;
سيتم أيضًا وضع طلبات البحث في الاعتبار وعرض الوحدات غير المستخدَمة، وهي غير متوفّرة في الرسم البياني لدقة الوحدة بعد اختيارها (بسبب قواعد اختيار الإصدار البسيط أو إلغاءها). ويمكن أن يكون لذلك تأثيرات مختلفة لكل نوع من أنواع طلبات البحث، أي تضمين مسارات جديدة في الأمر all_paths، أو اعتماديات إضافية في الأمر تفسير.
العلامات: execution
--output=<text, json or graph> التلقائي: "text;text"
التنسيق الذي يجب طباعة نتائج طلب البحث به القيم المسموح بها لطلب البحث هي: النص وjson والرسم البياني
العلامات: terminal_output
الخيارات المتعلقة بإخراج Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة"bazel_dep"المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
--deleted_packages=<comma-separated list of package names> التلقائي: ""
قائمة بأسماء الحِزم المفصولة بفاصلة والتي يعتبرها نظام الإصدار غير موجودة، حتى إذا كانت مرئية في مكان ما على مسار الحزمة. استخدِم هذا الخيار عند حذف حزمة فرعية 'x/y' من حزمة حالية 'x&#39؛. على سبيل المثال، بعد حذف x/y/BUILD في برنامجك، قد يعترض نظام الإصدار إذا واجه تصنيفًا '//x:y/z&#39؛ إذا كان لا يزال يتم تقديمه من خلال إدخال package_path آخر. ويؤدي تحديد --delete_packages x/y إلى تجنُّب هذه المشكلة.
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.
--package_path=<colon-separated list of options> التلقائي: "%workspace%"
قائمة مفصولة بفواصل من المكان الذي يجب البحث فيه عن الطرود. العناصر التي تبدأ بـ '%workspace%' نسبية إلى مساحة العمل المضمنة. في حال حذف الحقل أو تركه فارغًا، يكون الإعداد التلقائي هو الناتج 'bazel information default-package-path'.
--[no]show_loading_progress التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتسبب تطبيق Bazel في طباعة الرسائل &quot&تحميل الحِزمة:".

يكتسب جميع الخيارات من إصدار.

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تؤثّر في مدى تطبيق Bazel لمدخلات صالحة لإنشاء الإصدارات (تعريفات القواعد ومجموعات العلامات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة "bazel_dep" المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.
تراكم --print_action_mnemonics=<a string> استخدامات متعددة
القوائم التي تعمل بتذكيرات الوسائط لفلترة بيانات إجراءات_الطباعة، بدون إجراء فلترة عند تركها فارغة.

خيارات طلب البحث

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتحكّم في تنفيذ الإصدار:
في حال ضبط هذه السياسة على "صحيح" و"-compatible_remote_symlinks" أيضًا، يُسمح باستخدام الروابط الرمزية في مخرجات الإجراء.
العلامات: execution، incompatible_change
في حال ضبط هذه السياسة على "صحيح"، سيمثّل Bazel الروابط الرمزية في مخرجات الإجراءات في بروتوكول التنفيذ/التخزين المؤقت عن بُعد. بخلاف ذلك، سيتم تتبُّع الروابط الرمزية لتمثيلها أو تمثيلها كملفات أو أدلة. راجِع #6631 لمزيد من التفاصيل.
العلامات: execution، incompatible_change
--[no]keep_going [-k] التلقائية: "false"
يُرجى المتابعة قدر الإمكان بعد حدوث خطأ. في حين أنه لا يمكن تحليل الاستهداف الذي تعذّر الاستهداف وتلك التي تعتمد عليه، يمكن إجراء متطلبات أساسية أخرى لهذه الأهداف.
العلامات: eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> التلقائي: "auto;quot;
عدد سلاسل المحادثات المتوازية المطلوب استخدامها لمرحلة التحميل/التحليل.ويتم استخدام عدد صحيح أو كلمة رئيسية ("auto", "HOST_CPUS", "HOST_RAM") متبوعةً بعملية ([-|*]< العدد>) مثل. "auto", "HOST_CPUS*.5" "auto"تعيين إعداد تلقائي معقول بناءً على موارد المضيف. يجب أن تكون 1 على الأقل.
العلامات: bazel_internal_configuration
الخيارات التي تتيح للمستخدم ضبط النتائج المطلوبة، ما يؤثر في قيمتها بدلاً من تفعيلها:
--bep_maximum_open_remote_upload_files=<an integer> التلقائي: "-1"
الحد الأقصى لعدد الملفات المفتوحة المسموح بها أثناء تحميل العنصر BEP.
العلامات: affects_outputs
--remote_download_minimal
عدم تنزيل أي نتائج إخراج عن بُعد إلى الجهاز المحلي. هذه العلامة عبارة عن اختصار لثلاثة علامات: --experimental_inmemory_jdeps_files، --experimental_inmemory_dotd_files و --remote_download_outputs=minimal.
التوسيع إلى:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=minimal

العلامات: affects_outputs
--remote_download_outputs=<all, minimal or toplevel> التلقائي: "all"
في حال ضبط السياسة على 'minimal' ولا يتم تنزيل أي مخرجات إصدار عن بُعد إلى الجهاز المحلي، باستثناء تلك التي تتطلّبها الإجراءات المحلية. في حال الضبط على 'toplevel' يتصرف مثل'minimal&#39؛ إلا أنه يؤدي أيضًا إلى تنزيل مخرجات أهداف المستوى الأعلى إلى الجهاز المحلي. يمكن أن يقلل كلا الخيارين من أوقات الإصدار إذا كانت هناك قيود على معدل نقل البيانات للشبكة.
العلامات: affects_outputs
بدلاً من تنزيل مخرجات الإصدار عن بُعد إلى الجهاز المحلي، يمكنك إنشاء روابط رمزية. يمكن تحديد هدف الروابط الرمزية في شكل سلسلة نموذج. قد تحتوي سلسلة النموذج هذه على {hash} و{size_ وحدات البايت} التي يتم توسيعها إلى تجزئة العنصر والحجم بالبايت، على التوالي. ويمكن أن تشير هذه الروابط الرمزية مثلاً إلى نظام ملفات FUSE الذي يحمِّل عناصر من CAS عند الطلب.
العلامات: affects_outputs
--remote_download_toplevel
يتم تنزيل النتائج عن بُعد لأهداف المستوى الأعلى على الجهاز المحلي فقط. هذه العلامة عبارة عن اختصار لثلاثة علامات: --experimental_inmemory_jdeps_files، --experimental_inmemory_dotd_files و-remote_download_outputs=toplevel.
التوسيع إلى:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel

العلامات: affects_outputs
الخيارات التي تؤثّر في مدى صرامة تطبيق Bazel لعمليات الإدخال الصالحة للبيانات (تعريفات القواعد ومجموعات التركيبات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
--[no]incompatible_config_setting_private_default_visibility التلقائي: "false;quot;
في حال عدم التوافق_ar_force_setting_setting_visible=false، هذه القيمة عمليّة جديدة. بخلاف ذلك، إذا كانت هذه العلامة غير صحيحة، أي config_setting بدون سمة ظهور واضحة هو //impression:public. إذا كانت هذه العلامة صحيحة، يتّبع config_setting منطق مستوى الرؤية نفسه الذي تتبعه جميع القواعد الأخرى. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12933.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_enforce_config_setting_visibility التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، فرض قيود على إعداد config_setting. وفي حال اختيار القيمة "خطأ"، سيكون كل إعداد config_setting مرئيًا لكل هدف. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12932.
العلامات: loading_and_analysis، incompatible_change
خيارات متعلقة بمخرجات طلب البحث والدلالة:
--aspect_deps=<off, conservative or precise> التلقائي: "conserveative"
كيفية حل تبعيات العرض عندما يكون تنسيق الناتج واحدًا من {xml,proto,record}. 'off' تعني أنه لم يتم التعامل مع أي تبعيات للجانب، 'conserveative' (الإعداد التلقائي) تعني أن جميع تبعيات الجانب المُعلَن تمت إضافتها بغض النظر عما إذا تم منحها فئة قاعدة للاعتماديات المباشرة أو "#39;precise'" تعني أنه تتم إضافة هذه الجوانب التي من المحتمل أن تكون نشطة وفقًا لفئة القاعدة من التبعية المباشرة. لاحظ أن الوضع الدقيق يتطلب تحميل حِزم أخرى لتقييم هدف واحد، ما يجعله أبطأ من الأوضاع الأخرى. يُرجى العِلم أيضًا أنّ الوضع الدقيق ليس دقيقًا بالكامل، بل يتم اتّخاذ قرار بشأن احتساب جانب في مرحلة التحليل، وهو ما لا يتم تشغيله أثناء إعداد " #39;bazel query'".
العلامات: build_file_semantics
--[no]experimental_graphless_query التلقائي: "auto;quot;
إذا كان الأمر كذلك، يتم استخدام تنفيذ طلب بحث لا ينشئ نسخة من الرسم البياني. لا يدعم التنفيذ الجديد سوى --order_output=no، بالإضافة إلى مجموعة فرعية فقط من مُنسقات الإخراج.
العلامات: build_file_semantics، eagerness_to_exit
--graph:conditional_edges_limit=<an integer> التلقائي: "4"
الحد الأقصى لعدد تصنيفات الشروط المطلوب عرضها. -1 تعني عدم اقتطاعه ويشير الرقم 0 إلى عدم توفّر تعليق توضيحي. ينطبق هذا الخيار على --output=graph فقط.
العلامات: terminal_output
--[no]graph:factored التلقائي: "true;true"
إذا تم ضبط هذه السياسة على"صحيح"، سيتم دمج رسم بياني منشِئ &'عامل>&#39؛ أي أنه سيتم دمج العُقد المتماثلة طوبولوجيا معًا وربط تصنيفاتها. ينطبق هذا الخيار على --output=graph فقط.
العلامات: terminal_output
--graph:node_limit=<an integer> التلقائي: "512"
الحد الأقصى لطول سلسلة التصنيف لعقدة رسم بياني في الإخراج. سيتم اقتطاع التصنيفات الأطول، وتعني القيمة -1 عدم اقتطاعها. ينطبق هذا الخيار على --output=graph فقط.
العلامات: terminal_output
--[no]implicit_deps التلقائي: "true;true"
في حال تفعيل هذه الميزة، سيتم تضمين العناصر الضمنية في الرسم البياني للاعتمادية الذي يعمل عليه طلب البحث. الاعتمادية الضمنية هي تلك التي لم يتم تحديدها صراحةً في ملف BUILD، ولكن تمت إضافتها بواسطة البازل. بالنسبة إلى طلب البحث، يتحكم هذا الخيار في فلترة سلاسل الأدوات التي تم حلها.
العلامات: build_file_semantics
--[no]include_aspects التلقائي: "true;true"
aquery, cquery: ما إذا كان مطلوبًا تضمين الإجراءات التي يتم إنشاؤها من خلال العرض الجانبي في الإخراج. طلب البحث: no-op (يتم تتبّع الجوانب دائمًا).
العلامات: terminal_output
--[no]incompatible_display_source_file_location التلقائي: "true;true"
"صحيح" يعرض تلقائيًا الهدف من الملف المصدر. إذا كان هذا صحيحًا، يتم عرض موقع السطر 1 من الملفات المصدر في مخرجات الموقع. لا تتوفّر هذه العلامة إلا لأغراض نقل البيانات.
العلامات: terminal_output، incompatible_change
--[no]incompatible_lexicographical_output التلقائي: "true;true"
في حال تم ضبط هذا الخيار، يتم ترتيب --order_output=autoإخراج تلقائيًا.
العلامات: terminal_output، incompatible_change
--[no]incompatible_package_group_includes_double_slash التلقائي: "true;true"
في حال تفعيل هذا الإعداد، عند حذف السمة package_group's "الحزم"، لن يتم حذف السمة "//" البادئة.
العلامات: terminal_output، incompatible_change
--[no]infer_universe_scope التلقائي: "false;quot;
في حال ترك السياسة بدون ضبط و --universe_scope بدون ضبط، سيتم استنتاج قيمة --universe_scope في شكل قائمة بالأنماط المستهدَفة الفريدة في تعبير طلب البحث. تجدُر الإشارة إلى أن قيمة --universe_scope التي تم استنتاجها لتعبير طلب بحث تستخدم الدوال على مستوى الكون (مثل `allrdeps`) قد لا تكون ما تريده، لذا يجب استخدام هذا الخيار فقط إذا كنت تعرف ما تفعله. يمكنك الاطّلاع على https://bazel.build/reference/query#sky-query لمعرفة التفاصيل والأمثلة. في حال ضبط --universe_scope، سيتم تجاهل قيمة هذا الخيار's. ملاحظة: ينطبق هذا الخيار فقط على "طلب البحث" (أي ليس "cquery").
العلامات: loading_and_analysis
--[no]line_terminator_null التلقائي: "false;quot;
ما إذا كان سيتم إنهاء كل تنسيق باستخدام \0 بدلاً من السطر الجديد.
العلامات: terminal_output
--[no]nodep_deps التلقائي: "true;true"
في حال تفعيل هذه السياسة، سيتم تضمين سمات من "nodep"، في الرسم البياني الخاص بالاعتمادية الذي يعمل عليه طلب البحث. ومن الأمثلة الشائعة للسمة "nodep" ";;;;;;; كيف إنّ "> شغِّل مخرجات "معلومات إصدار اللغة" وتحليلها للحصول على معلومات عن جميع السمات ""nodep" في لغة الإصدار.
العلامات: build_file_semantics
--noorder_results
يمكنك عرض النتائج بترتيب يستند إلى التبعية (تلقائي) أو بدون ترتيب. تكون النتائج غير المُرتّبة أسرع ولكن لا تتوافق إلا مع -إخراج غير أدنى أو أعلى ترتيب أو رسم بياني.
التوسيع إلى:
--order_output=no

العلامات: terminal_output
--null
ما إذا كان سيتم إنهاء كل تنسيق باستخدام \0 بدلاً من السطر الجديد.
التوسيع إلى:
--line_terminator_null=true

العلامات: terminal_output
--order_output=<no, deps, auto or full> التلقائي: "auto;quot;
يمكنك إرسال النتائج بدون ترتيب (بدون) أو ترتيبها حسب التبعية (deps) أو ترتيبها بالكامل (كاملة). وتكون القيمة التلقائية هي 'auto'، أي أن النتائج يتم ترتيبها وفقًا للاعتمادية أو الترتيب الكامل، اعتمادًا على منسِّق الإخراج (مُرتَّب بشكل اعتمادي بالنسبة إلى Proto وminink وmaxMax والرسم البياني، وقد تم ترتيبه كاملاً لجميع العناصر الأخرى). عندما يتم تطبيق الناتج بشكل كامل، تتم طباعة العُقد بترتيب مُحدَّد بالكامل (الإجمالي). أولاً، يتم ترتيب جميع العُقد أبجديًا. بعد ذلك، يتم استخدام كل عُقدة في القائمة كبداية للبحث الأوّل عن عمق الطلب الذي يتم فيه اجتياز الحواف الصادرة إلى العُقد التي لم تتم زيارتها بترتيب أبجدي للعُقد اللاحقة. وأخيرًا، تتم طباعة العُقد عكس الترتيب الذي تمت زيارتها فيه.
العلامات: terminal_output
--order_results
يمكنك عرض النتائج بترتيب يستند إلى التبعية (تلقائي) أو بدون ترتيب. تكون النتائج غير المُرتّبة أسرع ولكن لا تتوافق إلا مع -إخراج غير أدنى أو أعلى ترتيب أو رسم بياني.
التوسيع إلى:
--order_output=auto

العلامات: terminal_output
--output=<a string> التلقائي: "label;label"
التنسيق الذي يجب طباعة نتائج طلب البحث به القيم المسموح بها لطلب البحث هي: build والرسم البياني والتصنيف وتصنيف_المكان والموقع والحد الأقصى والحد الأدنى والحزمة وproto وxml.
العلامات: terminal_output
--[no]proto:default_values التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، يتم تضمين السمات التي لم يتم تحديد قيمتها صراحةً في ملف BUILD، وإلا سيتم حذفها. ينطبق هذا الخيار على --output=proto
العلامات: terminal_output
--[no]proto:definition_stack التلقائي: "false;quot;
تعبئة حقل pro_stack Proto الذي يسجّل كل مثيل القاعدة لحزمة استدعاء Starlark في الوقت الذي يتم فيه تحديد فئة القاعدة.
العلامات: terminal_output
--[no]proto:flatten_selects التلقائي: "true;true"
في حال تفعيل هذا الإعداد، يتم استنساخ السمات القابلة للضبط التي تم إنشاؤها من خلال Select(). بالنسبة إلى أنواع القوائم، يمثّل التمثيل مسطّحًا قائمة تتضمّن كل قيمة للخريطة المحدّدة مرة واحدة فقط. يتم تحويل أنواع الكميات إلى عناصر فارغة.
العلامات: build_file_semantics
--[no]proto:include_synthetic_attribute_hash التلقائي: "false;quot;
يمكنك حساب السمة $internal_attr_hash تعبئتها أو لا.
العلامات: terminal_output
--[no]proto:instantiation_stack التلقائي: "false;quot;
تعبئة حزمة استدعاء مثيل كل قاعدة. يُرجى العلم أنّ ذلك يتطلّب توفّر الحزمة
العلامات: terminal_output
--[no]proto:locations التلقائي: "true;true"
تحديد ما إذا كان سيتم إخراج معلومات الموقع الجغرافي في وضع Proto تمامًا.
العلامات: terminal_output
--proto:output_rule_attrs=<comma-separated list of options> التلقائي: "all"
قائمة سمات مفصولة بفواصل لتضمينها. ويتم إعداد كل السمات تلقائيًا. اضبط على سلسلة فارغة لإخراج أي سمة. ينطبق هذا الخيار على --output=proto.
العلامات: terminal_output
--[no]proto:rule_inputs_and_outputs التلقائي: "true;true"
تحديد ما إذا كنت تريد تعبئة حقلي base_input وrule_output
العلامات: terminal_output
--query_file=<a string> التلقائي: ""
في حال تم ضبط هذه السياسة، سيقرأ طلب البحث الطلب من الملف المحدّد هنا، بدلاً من سطر الأوامر. خطأ في تحديد ملف هنا بالإضافة إلى طلب سطر الأوامر.
العلامات: changes_inputs
--[no]relative_locations التلقائي: "false;quot;
إذا كان هذا صحيحًا، سيكون موقع ملفات BUILD في xml ومخرجات Proto نسبيًا. وفقًا للإعدادات التلقائية، تكون بيانات الموقع الجغرافي مسارًا مطلقًا ولن تكون متسقة على جميع الأجهزة. ويمكنك ضبط هذا الخيار على "صحيح" للحصول على نتيجة متسقة على جميع الأجهزة.
العلامات: terminal_output
--[no]strict_test_suite التلقائي: "false;quot;
إذا كان الأمر صحيحًا، يقدم التعبير test() خطأ إذا واجه test_suite الذي يحتوي على استهدافات غير اختبارية.
العلامات: build_file_semantics، eagerness_to_exit
--[no]tool_deps التلقائي: "true;true"
طلب بحث: في حال إيقاف هذه الميزة، لن يتم تضمين الأهداف المتعلّقة بالاعتمادات على 'host configuration' أو 'execution'; المستهدَفة في الرسم البياني للاعتمادية الذي يعمل عليه طلب البحث. A 'host configuration';الارتباطية: مثل تلك الموجودة في أي من 'proto_library' القاعدة إلى مجمّع البروتوكول، يوجّه عادةً إلى أداة تم تنفيذها أثناء الإصدار بدلاً من جزء من نفس البرنامج #&39;target' طلب البحث: في حال الإيقاف، يتم استبعاد جميع الأهداف التي تم ضبطها والتي من خلال نقل مضيف أو تنفيذ من الاستهداف من المستوى الأعلى الذي اكتشف هذا الاستهداف الذي تم ضبطه. وهذا يعني أنّه إذا كان الاستهداف ذو المستوى الأعلى في إعدادات الاستهداف، لن يتم عرض سوى الأهداف التي تم ضبطها في الإعدادات المستهدفة. إذا كان هدف المستوى الأعلى في ضبط المضيف، لن يتم عرض سوى الاستهدافات التي تم ضبطها للمضيف. ولن يستبعد هذا الخيار سلاسل الأدوات التي تم حلّها.
العلامات: build_file_semantics
--universe_scope=<comma-separated list of options> التلقائي: ""
مجموعة من الأنماط المستهدفة مفصولة بفواصل (مضَافة وم طرحة). يمكن أن يتم تنفيذ طلب البحث في الكون المحدد عن طريق الإغلاق الانتقالي للأهداف المحدّدة. يُستخدَم هذا الخيار لطلبات البحث وcquery. بالنسبة إلى طلب البحث، إنّ الإدخال في هذا الخيار هو الأهداف التي تم إنشاء جميع الإجابات من خلالها، وبالتالي قد يؤثر هذا الخيار في الإعدادات وعمليات النقل. إذا لم يتم تحديد هذا الخيار، يتم افتراض أنّ أهداف المستوى الأعلى هي الأهداف التي تم تحليلها من تعبير طلب البحث. ملاحظة: بالنسبة إلى طلب البحث، قد يؤدي عدم تحديد هذا الخيار إلى تعطُّل الإصدار إذا كانت الأهداف التي يتم تحليلها من تعبير طلب البحث غير قابلة للإنشاء باستخدام خيارات المستوى الأعلى.
العلامات: loading_and_analysis
--[no]xml:default_values التلقائي: "false;quot;
إذا كانت القيمة صحيحة، تتم طباعة سمات القاعدة التي لم يتم تحديد قيمتها صراحةً في ملف BUILD، وإلا سيتم حذفها.
العلامات: terminal_output
--[no]xml:line_numbers التلقائي: "true;true"
إذا كانت القيمة صحيحة، تحتوي نتيجة XML على أرقام أسطر. قد يؤدي إيقاف هذا الخيار إلى تسهيل قراءة الاختلافات. ينطبق هذا الخيار فقط على --output=xml.
العلامات: terminal_output
الخيارات المتعلقة بإخراج Bzlmod ودلالات الترميز:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة "bazel_dep" المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
--experimental_repository_resolved_file=<a string> التلقائي: ""
إذا كانت السياسة غير فارغة، اكتب قيمة Starlark باستخدام المعلومات التي تم حلّها لجميع قواعد مستودع Starlark التي تم تنفيذها.
العلامات: affects_outputs
--remote_print_execution_messages=<failure, success or all> التلقائي: "failure"
اختيار وقت طباعة رسائل التنفيذ عن بُعد القيم الصالحة هي "fail" أو "الطباعة" عند تعذُّر الطباعة إلا و"النجاح" للطباعة في حالات النجاح فقط و"الكل" للطباعة دائمًا.
العلامات: terminal_output
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
--[no]experimental_guard_against_concurrent_changes التلقائي: "false;quot;
إيقاف هذه الميزة لإيقاف التحقّق من وقت ملفات إدخال الإجراءات قبل تحميلها إلى ذاكرة التخزين المؤقت عن بُعد قد يعود سبب هذه المشكلة إلى حالات تأخير في كتابة ملفات Linux kernel، ما قد يؤدي إلى حالات موجبة خاطئة.
--experimental_remote_build_event_upload=<all or minimal> التلقائي: "all"
في حال الضبط على 'all'، يتم تحميل كل النتائج المحلية التي يشير إليها بروتوكول BEP إلى ذاكرة التخزين المؤقت عن بُعد. في حال الضبط على 'minimal'، لا يتم تحميل النتائج المحلية التي يشير إليها BEP إلى ذاكرة التخزين المؤقت البعيدة، باستثناء الملفات المهمة للمستهلكين في حالة BEP (مثل سجلات الاختبار والملف الشخصي للتوقيت). ويتم استخدام مخطط //:file لمسارات الملفات المحلية ومخطَّط // stream. ضبط تلقائي على 'all'
--[no]experimental_remote_cache_async التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، سيتم إجراء مؤتمر I/O لذاكرة التخزين المؤقت عن بُعد في الخلفية بدلاً من عقده كجزء من عملية النبات.
--[no]experimental_remote_cache_compression التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يُرجى ضغط كائن تخزين البيانات الثنائية الكبيرة أو فك ضغطه باستخدام zstd.
--experimental_remote_capture_corrupted_outputs=<a path> التلقائي: عرض الوصف
المسار المؤدي إلى دليل يتم فيه إخراج النتائج التالفة إليه.
--experimental_remote_downloader=<a string> التلقائي: عرض الوصف
معرّف موارد منتظم (URI) لنقطة نهاية واجهة برمجة التطبيقات البعيدة لمواد العرض، لاستخدامه كخادم وكيل للتنزيل عن بُعد. المخططات المعتمدة هي grpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX المحلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. يُرجى الاطّلاع على الرابط: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset_proto
--[no]experimental_remote_downloader_local_fallback التلقائي: "false;quot;
تحديد ما إذا كان من الممكن الرجوع إلى أداة التنزيل المحلية في حال تعذّر تنزيل أداة التنزيل عن بُعد.
--[no]experimental_remote_execution_keepalive التلقائي: "false;quot;
استخدام رسالة التحقّق من الاتصال لمكالمات التنفيذ عن بُعد
--experimental_remote_grpc_log=<a path> التلقائي: عرض الوصف
في حال تم تحديد مسار إلى ملف لتسجيل التفاصيل المتعلقة بمكالمة gRPC. يتكون هذا السجل من تسلسل من com.google.devtools.build.lib.remote.log.remoteExecutionLog.LogEntrys9fs مع كل رسالة مسبوقة بعلامة تشير إلى حجم رسالة Protobuf التسلسلية التالية، كما ننفّذها الطريقة LogLog.writeDelimitedTo(إخراجStream).
--[no]experimental_remote_mark_tool_inputs التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، سيضع Bazel علامة على الإدخالات كإدخالات للأداة التنفيذية عن بُعد. ويمكن استخدام هذا في تنفيذ العاملين الدائمين عن بُعد.
--[no]experimental_remote_merkle_tree_cache التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، سيتم تدوين حسابات شجرة ميركل لتحسين سرعة التحقّق من نتائج ذاكرة التخزين المؤقت عن بُعد. يتم التحكم في طباعة ذاكرة التخزين المؤقت في الذاكرة باستخدام --experimental_remote_merlick_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer> التلقائي: "1000"
عدد أشجار Mer وتتوفّر لتذكُّرها لتحسين سرعة التحقُّق من النتائج في ذاكرة التخزين المؤقت عن بُعد. ومع أنّ ذاكرة التخزين المؤقت يتم تشغيلها تلقائيًا وفقًا لطريقة معالجة Java& العديد من المراجع، قد تظهر أخطاء متعلّقة بالذاكرة إذا تم ضبطها على قيمة مرتفعة جدًا. إذا تم ضبطها على 0، يكون حجم ذاكرة التخزين المؤقت غير محدود. تختلف القيمة المثالية حسب حجم المشروع. القيمة التلقائية هي 1000.
--[no]incompatible_remote_build_event_upload_respect_no_cache التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، لا يتم تحميل النتائج التي يشير إليها بروتوكول BEP إلى ذاكرة التخزين المؤقت عن بُعد في حال تعذّر تخزين إجراء الإنشاء مؤقتًا عن بُعد.
--[no]incompatible_remote_downloader_send_all_headers التلقائي: "true;true"
ما إذا كان سيتم إرسال جميع قيم العنوان المتعدد القيم إلى أداة التنزيل عن بُعد بدلاً من القيمة الأولى فقط.
العلامات: incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root التلقائي: "false;quot;
في حال الضبط على "صحيح"، ترتبط مسارات الإخراج بجذر الإدخال بدلاً من دليل العمل.
العلامات: incompatible_change
--[no]incompatible_remote_results_ignore_disk التلقائي: "true;true"
في حال ضبطها على "صحيح"، لن يتم تطبيق --noremote_upload_local_results و-noremote_accept_cached على ذاكرة التخزين المؤقت على القرص. في حال استخدام ذاكرة تخزين مؤقت مجمّعة: --noremote_upload_local_results سيؤدي إلى كتابة نتائج في ذاكرة التخزين المؤقت على القرص، ولكن لا يتم تحميلها إلى ذاكرة التخزين المؤقت عن بُعد. --noremote_Accept_cached: سيؤدي ذلك إلى بحث Bazel عن النتائج في ذاكرة التخزين المؤقت على القرص، ولكن ليس في ذاكرة التخزين المؤقت عن بُعد. يمكن أن تؤدي إجراءات no-remote-exec إلى ذاكرة التخزين المؤقت على القرص. راجِع #8216 لمزيد من التفاصيل.
العلامات: incompatible_change
--[no]remote_accept_cached التلقائي: "true;true"
قبول نتائج الإجراء المخزنة عن بُعد.
--remote_bytestream_uri_prefix=<a string> التلقائي: عرض الوصف
اسم المضيف واسم النسخة الافتراضية المطلوب استخدامهما في معرّفات الموارد المنتظمة (URI) // stream. يمكن تحديد هذا الخيار عند تنفيذ الإصدارات باستخدام خادم وكيل، مما يؤدي إلى عدم تطابق قيم --remote_executor و--remote_instance_name مع الاسم الأساسي لخدمة التنفيذ عن بُعد. وعند عدم ضبطها تلقائيًا، سيتم ضبطها تلقائيًا على "${hostname}/${instance_name}".
--remote_cache=<a string> التلقائي: عرض الوصف
معرّف موارد منتظم (URI) لنقطة نهاية ذاكرة التخزين المؤقت المخططات المتاحة هي http وhttps وgrpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX محلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. حدِّد grpc:// أو http:// أو Unix: مخطط لإيقاف بروتوكول أمان طبقة النقل. يُرجى الاطّلاع على https://bazel.build/remote/caching
تراكم --remote_cache_header=<a 'name=value' assignment> استخدامات متعددة
حدِّد عنوانًا سيتم تضمينه في طلبات ذاكرة التخزين المؤقت: --remote_cache_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
تراكم --remote_default_exec_properties=<a 'name=value' assignment> استخدامات متعددة
يمكنك ضبط خصائص exe التلقائية المراد استخدامها كمنصة تنفيذ عن بُعد في حال عدم ضبط منصة تنفيذ من قبل exec_property.
العلامات: affects_outputs
--remote_default_platform_properties=<a string> التلقائي: ""
يمكنك ضبط خصائص النظام الأساسي التلقائية المطلوب ضبطها لواجهة برمجة التطبيقات للتنفيذ عن بُعد، إذا لم تكن منصة التنفيذ قد تم ضبطها عن بُعد. وستُستخدَم هذه القيمة أيضًا في حال اختيار النظام الأساسي المضيف كنظام أساسي للتنفيذ عن بُعد.
تراكم --remote_downloader_header=<a 'name=value' assignment> استخدامات متعددة
حدد عنوانًا سيتم تضمينه في طلبات التنزيل عن بُعد: --remote_downloader_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
تراكم --remote_exec_header=<a 'name=value' assignment> استخدامات متعددة
حدِّد عنوانًا سيتم تضمينه في طلبات التنفيذ: "remote_exec_header=Name=Value". يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
--remote_execution_priority=<an integer> التلقائي: "0"
الأولوية النسبية للإجراءات التي سيتم تنفيذها عن بُعد تعتمد دلال قيم الأولوية المحدّدة على الخادم.
--remote_executor=<a string> التلقائي: عرض الوصف
المضيف أو HOST:PORT لنقطة نهاية التنفيذ عن بُعد. المخططات المعتمدة هي grpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX المحلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. حدِّد grpc:// أو unix: مخطط لإيقاف بروتوكول أمان طبقة النقل.
تراكم --remote_header=<a 'name=value' assignment> استخدامات متعددة
تحديد عنوان سيتم تضمينه في الطلبات: --remote_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
--remote_instance_name=<a string> التلقائي: ""
القيمة التي يجب إدخالها كمثال example_name في واجهة برمجة التطبيقات للتنفيذ عن بُعد.
--[no]remote_local_fallback التلقائي: "false;quot;
ما إذا كان المطلوب الالتزام باستراتيجية التنفيذ المحلية المستقلة في حال تعذّر التنفيذ عن بُعد.
--remote_local_fallback_strategy=<a string> التلقائي: "local;quot"
لا تتوفّر إمكانية التشغيل يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7480 للحصول على التفاصيل.
--remote_max_connections=<an integer> التلقائي: "100"
الحد الأقصى لعدد الاتصالات المتزامنة إلى ذاكرة التخزين المؤقت/التنفيذ عن بُعد وتكون القيمة 100 تلقائيًا. ويعني ضبطها على 0 أنّه ما مِن قيود. بالنسبة إلى ذاكرة التخزين المؤقت عن بُعد في HTTP، يمكن لاتصال TCP واحد معالجة طلب واحد في كل مرة، لذا يمكن أن يتولى Bazel ما يصل إلى --remote_max_connections من الطلبات المتزامنة. في ما يتعلق بذاكرة التخزين المؤقت/المنفّذ عن بُعد لدى gRPC، يمكن عادةً أن تعالج قناة gRPC أكثر من 100 طلب متزامن، لذا يمكن أن يرسل Bazel حوالي طلبات متزامنة بين ---remote_max_connections * 100`.
العلامات: host_machine_resource_optimizations
--remote_proxy=<a string> التلقائي: عرض الوصف
الاتصال بذاكرة التخزين المؤقت عن بُعد من خلال خادم وكيل. لا يمكن استخدام هذه العلامة حاليًا إلا لإعداد مقبس نطاق Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer> التلقائي: "0"
الأولوية النسبية للإجراءات البعيدة المراد تخزينها في ذاكرة التخزين المؤقت عن بُعد. تعتمد دلال قيم الأولوية المحدّدة على الخادم.
--remote_retries=<an integer> التلقائي: "5"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح عابر. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
--remote_timeout=<An immutable length of time.> التلقائي: "60s"
الحد الأقصى لوقت انتظار التنفيذ عن بُعد وذاكرة التخزين المؤقت للمكالمات. وبالنسبة إلى ذاكرة التخزين المؤقت في REST، تكون هذه القيمة هي مهلة الاتصال ومهلة القراءة. يمكن استخدام الوحدات التالية: الأيام (د) والساعات (س) والدقائق (م) والثواني (ث) والملي ثانية (ملي ثانية). إذا تم حذف الوحدة، يتم تفسير القيمة بالثواني.
--[no]remote_upload_local_results التلقائي: "true;true"
تحميل نتائج الإجراءات التي تم تنفيذها محليًا إلى ذاكرة التخزين المؤقت عن بُعد
--[no]remote_verify_downloads التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، سيحتسب Bazel مجموع التجزئة لجميع عمليات التنزيل عن بُعد وسيتجاهل القيم المخزَّنة مؤقتًا عن بُعد في حال عدم تطابقها مع القيمة المتوقَّعة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
--deleted_packages=<comma-separated list of package names> التلقائي: ""
قائمة بأسماء الحِزم المفصولة بفاصلة والتي يعتبرها نظام الإصدار غير موجودة، حتى إذا كانت مرئية في مكان ما على مسار الحزمة. استخدِم هذا الخيار عند حذف حزمة فرعية 'x/y' من حزمة حالية 'x&#39؛. على سبيل المثال، بعد حذف x/y/BUILD في برنامجك، قد يعترض نظام الإصدار إذا واجه تصنيفًا '//x:y/z&#39؛ إذا كان لا يزال يتم تقديمه من خلال إدخال package_path آخر. ويؤدي تحديد --delete_packages x/y إلى تجنُّب هذه المشكلة.
--disk_cache=<a path> التلقائي: عرض الوصف
مسار للاطّلاع على دليل حيث يمكن لتطبيق Bazel قراءة الإجراءات وإجراءاتها وكتابتها. في حال عدم توفّر الدليل، سيتم إنشاؤه.
تراكم --experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.> استخدامات متعددة
لضبط"بيانات اعتماد الاعتماد"في استخدامها لاسترداد بيانات الاعتماد للنطاق المقدَّم (النطاق). تحظى بيانات الاعتماد من "مساعدو المساعدة" بالأولوية على بيانات الاعتماد من <code&code>--google_default_credentials</code> أو `--google_credentials` أو &<code>.netrc</code>
--experimental_credential_helper_cache_duration=<An immutable length of time.> التلقائي: "30m"
لضبط المدة التي يتم خلالها تخزين بيانات اعتماد"أدوات مساعدة الاعتماد"مؤقتًا.
--experimental_credential_helper_timeout=<An immutable length of time.> التلقائي: "5;"
لضبط المهلة لمساعد بيانات الاعتماد. وسيتعذّر استدعاء بيانات اعتماد الوصول خلال هذه المهلة.
--google_auth_scopes=<comma-separated list of options> التلقائي: "https://www.googleapis.com/auth/cloud-platform"
قائمة مفصولة بفواصل لنطاقات المصادقة في Google Cloud
--google_credentials=<a string> التلقائي: عرض الوصف
يحدد الملف للحصول على بيانات اعتماد المصادقة. يمكنك الاطّلاع على https://cloud.google.com/docs/authentication للحصول على التفاصيل.
--[no]google_default_credentials التلقائي: "false;quot;
ما إذا كان المطلوب استخدام بيانات الاعتماد التلقائية في &39;Google للتطبيقات لإجراء المصادقة. يمكنك الاطّلاع على https://cloud.google.com/docs/authentication للحصول على التفاصيل. هذه الميزة غير مفعّلة تلقائيًا.
--grpc_keepalive_time=<An immutable length of time.> التلقائي: عرض الوصف
يمكنك ضبط إشعارات البقاء على قيد الاتصال لاتصالات gRPC الصادرة. إذا تم ضبط الإعداد، يُرسِل Bazel إشعارات بعد هذه الفترة من عدم توفّر عمليات قراءة على الاتصال، إلا إذا كان هناك طلب gRPC واحد على الأقل في انتظار المراجعة. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. يتم إيقاف إشعارات البقاء على الوضع تلقائيًا. يجب التنسيق مع مالك الخدمة قبل تفعيل هذا الإعداد. على سبيل المثال، لضبط قيمة 30 ثانية على هذه العلامة، يجب إجراؤها على النحو التالي --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.> التلقائي: "20s"
يضبط هذا الإعداد مهلة الاحتفاظ بالبيانات لاتصالات gRPC الصادرة. في حال تفعيل إشعارات البقاء على الاتصال مع --grpc_keepalive_time، ستنتهي مهلة Bazel للاتصال إذا لم تتلقَ رد فحص الاتصال بعد هذا الوقت الكبير. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. في حال إيقاف إشعارات التحقّق من الاتصال، يتم تجاهل هذا الإعداد.
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.
--package_path=<colon-separated list of options> التلقائي: "%workspace%"
قائمة مفصولة بفواصل من المكان الذي يجب البحث فيه عن الطرود. العناصر التي تبدأ بـ '%workspace%' نسبية إلى مساحة العمل المضمنة. في حال حذف الحقل أو تركه فارغًا، يكون الإعداد التلقائي هو الناتج 'bazel information default-package-path'.
--[no]show_loading_progress التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتسبب تطبيق Bazel في طباعة الرسائل &quot&تحميل الحِزمة:".
--tls_certificate=<a string> التلقائي: عرض الوصف
حدِّد مسارًا لشهادة بروتوكول أمان طبقة النقل (TLS) موثوقة لتوقيع شهادات الخادم.
--tls_client_certificate=<a string> التلقائي: عرض الوصف
حدِّد شهادة عميل طبقة النقل الآمنة التي تريد استخدامها، وعليك أيضًا تقديم مفتاح عميل لتفعيل مصادقة العميل.
--tls_client_key=<a string> التلقائي: عرض الوصف
حدِّد مفتاح عميل طبقة النقل الآمنة الذي سيتم استخدامه، وعليك أيضًا تقديم شهادة عميل لتفعيل مصادقة العميل.

خيارات التشغيل

يكتسب جميع الخيارات من إصدار.

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتيح للمستخدم ضبط النتائج المطلوبة، ما يؤثر في قيمتها بدلاً من تفعيلها:
--script_path=<a path> التلقائي: عرض الوصف
في حال تم ضبط هذه السياسة، اكتب نصًا برمجيًا لواجهة المستخدم في الملف المحدَّد الذي يستدعي الهدف. وعند ضبط هذا الخيار، لن يتم تشغيل الهدف من البازل. استخدم 'bazel run --script_path=foo //foo && ./foo' لاستدعاء الهدف '//foo' ويختلف ذلك عن 'bazel run //foo' في أن قفل صدر البازل وربط الملف التنفيذي بمحطة الدفع&#td}.
العلامات: affects_outputs، execution
الخيارات التي تؤثر في مدى قوة تطبيق Bazel لمدخلات الإصدارات الصالحة (تعريفات القواعد ومجموعات التركيبات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة "bazel_dep" المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.

خيارات إيقاف التشغيل

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على "صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتحكّم في ناتج الأمر:
--iff_heap_size_greater_than=<an integer> التلقائي: "0"
في حال لم تكن القيمة صفرًا، لن يتم إيقاف الخادم إلا إذا تجاوز إجمالي سعة الذاكرة (بالميغابايت) التي يستهلكها رمز JVM هذه القيمة.
العلامات: loses_incremental_state، eagerness_to_exit
الخيارات التي تؤثر في مدى تطبيق Bazel لمدخلات الإصدار الصالحة (تعريفات القواعد ومجموعات العلامات وغيرها).
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة "bazel_dep" المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.

خيارات المزامنة

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على "صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتحكّم في تنفيذ الإصدار:
--[no]configure التلقائي: "False;quot;
لا تتم مزامنة المستودعات إلا التي تم وضع علامة عليها 'configure' لأغراض ضبط النظام.
العلامات: changes_inputs
في حال ضبط هذه السياسة على "صحيح" و"-compatible_remote_symlinks" أيضًا، يُسمح باستخدام الروابط الرمزية في مخرجات الإجراء.
العلامات: execution، incompatible_change
في حال ضبط هذه السياسة على "صحيح"، سيمثّل Bazel الروابط الرمزية في مخرجات الإجراءات في بروتوكول التنفيذ/التخزين المؤقت عن بُعد. بخلاف ذلك، سيتم تتبُّع الروابط الرمزية لتمثيلها أو تمثيلها كملفات أو أدلة. راجِع #6631 لمزيد من التفاصيل.
العلامات: execution، incompatible_change
--[no]keep_going [-k] التلقائية: "false"
يُرجى المتابعة قدر الإمكان بعد حدوث خطأ. في حين أنه لا يمكن تحليل الاستهداف الذي تعذّر الاستهداف وتلك التي تعتمد عليه، يمكن إجراء متطلبات أساسية أخرى لهذه الأهداف.
العلامات: eagerness_to_exit
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5"> التلقائي: "auto;quot;
عدد سلاسل المحادثات المتوازية المطلوب استخدامها لمرحلة التحميل/التحليل.ويتم استخدام عدد صحيح أو كلمة رئيسية ("auto", "HOST_CPUS", "HOST_RAM") متبوعةً بعملية ([-|*]< العدد>) مثل. "auto", "HOST_CPUS*.5" "auto"تعيين إعداد تلقائي معقول بناءً على موارد المضيف. يجب أن تكون 1 على الأقل.
العلامات: bazel_internal_configuration
تراكم --only=<a string> استخدامات متعددة
في حال توفُّر هذا الخيار، عليك مزامنة المستودعات المحدّدة مع هذا الخيار فقط. لا يزال كل (أو يتم منح الإعدادات) شبيهًا بالإعداد القديم (أو يتم تقديمه).
العلامات: changes_inputs
الخيارات التي تتيح للمستخدم ضبط النتائج المطلوبة، ما يؤثر في قيمتها بدلاً من تفعيلها:
--bep_maximum_open_remote_upload_files=<an integer> التلقائي: "-1"
الحد الأقصى لعدد الملفات المفتوحة المسموح بها أثناء تحميل العنصر BEP.
العلامات: affects_outputs
--remote_download_minimal
عدم تنزيل أي نتائج إخراج عن بُعد إلى الجهاز المحلي. هذه العلامة عبارة عن اختصار لثلاثة علامات: --experimental_inmemory_jdeps_files، --experimental_inmemory_dotd_files و --remote_download_outputs=minimal.
التوسيع إلى:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=minimal

العلامات: affects_outputs
--remote_download_outputs=<all, minimal or toplevel> التلقائي: "all"
في حال ضبط السياسة على 'minimal' ولا يتم تنزيل أي مخرجات إصدار عن بُعد إلى الجهاز المحلي، باستثناء تلك التي تتطلّبها الإجراءات المحلية. في حال الضبط على 'toplevel' يتصرف مثل'minimal&#39؛ إلا أنه يؤدي أيضًا إلى تنزيل مخرجات أهداف المستوى الأعلى إلى الجهاز المحلي. يمكن أن يقلل كلا الخيارين من أوقات الإصدار إذا كانت هناك قيود على معدل نقل البيانات للشبكة.
العلامات: affects_outputs
بدلاً من تنزيل مخرجات الإصدار عن بُعد إلى الجهاز المحلي، يمكنك إنشاء روابط رمزية. يمكن تحديد هدف الروابط الرمزية في شكل سلسلة نموذج. قد تحتوي سلسلة النموذج هذه على {hash} و{size_ وحدات البايت} التي يتم توسيعها إلى تجزئة العنصر والحجم بالبايت، على التوالي. ويمكن أن تشير هذه الروابط الرمزية مثلاً إلى نظام ملفات FUSE الذي يحمِّل عناصر من CAS عند الطلب.
العلامات: affects_outputs
--remote_download_toplevel
يتم تنزيل النتائج عن بُعد لأهداف المستوى الأعلى على الجهاز المحلي فقط. هذه العلامة عبارة عن اختصار لثلاثة علامات: --experimental_inmemory_jdeps_files، --experimental_inmemory_dotd_files و-remote_download_outputs=toplevel.
التوسيع إلى:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel

العلامات: affects_outputs
الخيارات التي تؤثّر في مدى صرامة تطبيق Bazel لعمليات الإدخال الصالحة للبيانات (تعريفات القواعد ومجموعات التركيبات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
--[no]incompatible_config_setting_private_default_visibility التلقائي: "false;quot;
في حال عدم التوافق_ar_force_setting_setting_visible=false، هذه القيمة عمليّة جديدة. بخلاف ذلك، إذا كانت هذه العلامة غير صحيحة، أي config_setting بدون سمة ظهور واضحة هو //impression:public. إذا كانت هذه العلامة صحيحة، يتّبع config_setting منطق مستوى الرؤية نفسه الذي تتبعه جميع القواعد الأخرى. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12933.
العلامات: loading_and_analysis، incompatible_change
--[no]incompatible_enforce_config_setting_visibility التلقائي: "true;true"
في حال ضبط هذه السياسة على"صحيح"، فرض قيود على إعداد config_setting. وفي حال اختيار القيمة "خطأ"، سيكون كل إعداد config_setting مرئيًا لكل هدف. يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/12932.
العلامات: loading_and_analysis، incompatible_change
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة"bazel_dep"المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
--experimental_repository_resolved_file=<a string> التلقائي: ""
إذا كانت السياسة غير فارغة، اكتب قيمة Starlark باستخدام المعلومات التي تم حلّها لجميع قواعد مستودع Starlark التي تم تنفيذها.
العلامات: affects_outputs
--remote_print_execution_messages=<failure, success or all> التلقائي: "failure"
اختيار وقت طباعة رسائل التنفيذ عن بُعد القيم الصالحة هي "fail" أو "الطباعة" عند تعذُّر الطباعة إلا و"النجاح" للطباعة في حالات النجاح فقط و"الكل" للطباعة دائمًا.
العلامات: terminal_output
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
--[no]experimental_guard_against_concurrent_changes التلقائي: "false;quot;
إيقاف هذه الميزة لإيقاف التحقّق من وقت ملفات إدخال الإجراءات قبل تحميلها إلى ذاكرة التخزين المؤقت عن بُعد قد يعود سبب هذه المشكلة إلى حالات تأخير في كتابة ملفات Linux kernel، ما قد يؤدي إلى حالات موجبة خاطئة.
--experimental_remote_build_event_upload=<all or minimal> التلقائي: "all"
في حال الضبط على 'all'، يتم تحميل كل النتائج المحلية التي يشير إليها بروتوكول BEP إلى ذاكرة التخزين المؤقت عن بُعد. في حال الضبط على 'minimal'، لا يتم تحميل النتائج المحلية التي يشير إليها BEP إلى ذاكرة التخزين المؤقت البعيدة، باستثناء الملفات المهمة للمستهلكين في حالة BEP (مثل سجلات الاختبار والملف الشخصي للتوقيت). ويتم استخدام مخطط //:file لمسارات الملفات المحلية ومخطَّط // stream. ضبط تلقائي على 'all'
--[no]experimental_remote_cache_async التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، سيتم إجراء مؤتمر I/O لذاكرة التخزين المؤقت عن بُعد في الخلفية بدلاً من عقده كجزء من عملية النبات.
--[no]experimental_remote_cache_compression التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يُرجى ضغط كائن تخزين البيانات الثنائية الكبيرة أو فك ضغطه باستخدام zstd.
--experimental_remote_capture_corrupted_outputs=<a path> التلقائي: عرض الوصف
المسار المؤدي إلى دليل يتم فيه إخراج النتائج التالفة إليه.
--experimental_remote_downloader=<a string> التلقائي: عرض الوصف
معرّف موارد منتظم (URI) لنقطة نهاية واجهة برمجة التطبيقات البعيدة لمواد العرض، لاستخدامه كخادم وكيل للتنزيل عن بُعد. المخططات المعتمدة هي grpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX المحلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. يُرجى الاطّلاع على الرابط: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset_proto
--[no]experimental_remote_downloader_local_fallback التلقائي: "false;quot;
تحديد ما إذا كان من الممكن الرجوع إلى أداة التنزيل المحلية في حال تعذّر تنزيل أداة التنزيل عن بُعد.
--[no]experimental_remote_execution_keepalive التلقائي: "false;quot;
استخدام رسالة التحقّق من الاتصال لمكالمات التنفيذ عن بُعد
--experimental_remote_grpc_log=<a path> التلقائي: عرض الوصف
في حال تم تحديد مسار إلى ملف لتسجيل التفاصيل المتعلقة بمكالمة gRPC. يتكون هذا السجل من تسلسل من com.google.devtools.build.lib.remote.log.remoteExecutionLog.LogEntrys9fs مع كل رسالة مسبوقة بعلامة تشير إلى حجم رسالة Protobuf التسلسلية التالية، كما ننفّذها الطريقة LogLog.writeDelimitedTo(إخراجStream).
--[no]experimental_remote_mark_tool_inputs التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، سيضع Bazel علامة على الإدخالات كإدخالات للأداة التنفيذية عن بُعد. ويمكن استخدام هذا في تنفيذ العاملين الدائمين عن بُعد.
--[no]experimental_remote_merkle_tree_cache التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، سيتم تدوين حسابات شجرة ميركل لتحسين سرعة التحقّق من نتائج ذاكرة التخزين المؤقت عن بُعد. يتم التحكم في طباعة ذاكرة التخزين المؤقت في الذاكرة باستخدام --experimental_remote_merlick_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer> التلقائي: "1000"
عدد أشجار Mer وتتوفّر لتذكُّرها لتحسين سرعة التحقُّق من النتائج في ذاكرة التخزين المؤقت عن بُعد. ومع أنّ ذاكرة التخزين المؤقت يتم تشغيلها تلقائيًا وفقًا لطريقة معالجة Java& العديد من المراجع، قد تظهر أخطاء متعلّقة بالذاكرة إذا تم ضبطها على قيمة مرتفعة جدًا. إذا تم ضبطها على 0، يكون حجم ذاكرة التخزين المؤقت غير محدود. تختلف القيمة المثالية حسب حجم المشروع. القيمة التلقائية هي 1000.
--[no]incompatible_remote_build_event_upload_respect_no_cache التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، لا يتم تحميل النتائج التي يشير إليها بروتوكول BEP إلى ذاكرة التخزين المؤقت عن بُعد في حال تعذّر تخزين إجراء الإنشاء مؤقتًا عن بُعد.
--[no]incompatible_remote_downloader_send_all_headers التلقائي: "true;true"
ما إذا كان سيتم إرسال جميع قيم العنوان المتعدد القيم إلى أداة التنزيل عن بُعد بدلاً من القيمة الأولى فقط.
العلامات: incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root التلقائي: "false;quot;
في حال الضبط على "صحيح"، ترتبط مسارات الإخراج بجذر الإدخال بدلاً من دليل العمل.
العلامات: incompatible_change
--[no]incompatible_remote_results_ignore_disk التلقائي: "true;true"
في حال ضبطها على "صحيح"، لن يتم تطبيق --noremote_upload_local_results و-noremote_accept_cached على ذاكرة التخزين المؤقت على القرص. في حال استخدام ذاكرة تخزين مؤقت مجمّعة: --noremote_upload_local_results سيؤدي إلى كتابة نتائج في ذاكرة التخزين المؤقت على القرص، ولكن لا يتم تحميلها إلى ذاكرة التخزين المؤقت عن بُعد. --noremote_Accept_cached: سيؤدي ذلك إلى بحث Bazel عن النتائج في ذاكرة التخزين المؤقت على القرص، ولكن ليس في ذاكرة التخزين المؤقت عن بُعد. يمكن أن تؤدي إجراءات no-remote-exec إلى ذاكرة التخزين المؤقت على القرص. راجِع #8216 لمزيد من التفاصيل.
العلامات: incompatible_change
--[no]remote_accept_cached التلقائي: "true;true"
قبول نتائج الإجراء المخزنة عن بُعد.
--remote_bytestream_uri_prefix=<a string> التلقائي: عرض الوصف
اسم المضيف واسم النسخة الافتراضية المطلوب استخدامهما في معرّفات الموارد المنتظمة (URI) // stream. يمكن تحديد هذا الخيار عند تنفيذ الإصدارات باستخدام خادم وكيل، مما يؤدي إلى عدم تطابق قيم --remote_executor و--remote_instance_name مع الاسم الأساسي لخدمة التنفيذ عن بُعد. وعند عدم ضبطها تلقائيًا، سيتم ضبطها تلقائيًا على "${hostname}/${instance_name}".
--remote_cache=<a string> التلقائي: عرض الوصف
معرّف موارد منتظم (URI) لنقطة نهاية ذاكرة التخزين المؤقت المخططات المتاحة هي http وhttps وgrpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX محلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. حدِّد grpc:// أو http:// أو Unix: مخطط لإيقاف بروتوكول أمان طبقة النقل. يُرجى الاطّلاع على https://bazel.build/remote/caching
تراكم --remote_cache_header=<a 'name=value' assignment> استخدامات متعددة
حدِّد عنوانًا سيتم تضمينه في طلبات ذاكرة التخزين المؤقت: --remote_cache_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
تراكم --remote_default_exec_properties=<a 'name=value' assignment> استخدامات متعددة
يمكنك ضبط خصائص exe التلقائية المراد استخدامها كمنصة تنفيذ عن بُعد في حال عدم ضبط منصة تنفيذ من قبل exec_property.
العلامات: affects_outputs
--remote_default_platform_properties=<a string> التلقائي: ""
يمكنك ضبط خصائص النظام الأساسي التلقائية المطلوب ضبطها لواجهة برمجة التطبيقات للتنفيذ عن بُعد، إذا لم تكن منصة التنفيذ قد تم ضبطها عن بُعد. وستُستخدَم هذه القيمة أيضًا في حال اختيار النظام الأساسي المضيف كنظام أساسي للتنفيذ عن بُعد.
تراكم --remote_downloader_header=<a 'name=value' assignment> استخدامات متعددة
حدد عنوانًا سيتم تضمينه في طلبات التنزيل عن بُعد: --remote_downloader_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
تراكم --remote_exec_header=<a 'name=value' assignment> استخدامات متعددة
حدِّد عنوانًا سيتم تضمينه في طلبات التنفيذ: "remote_exec_header=Name=Value". يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
--remote_execution_priority=<an integer> التلقائي: "0"
الأولوية النسبية للإجراءات التي سيتم تنفيذها عن بُعد تعتمد دلال قيم الأولوية المحدّدة على الخادم.
--remote_executor=<a string> التلقائي: عرض الوصف
المضيف أو HOST:PORT لنقطة نهاية التنفيذ عن بُعد. المخططات المعتمدة هي grpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX المحلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. حدِّد grpc:// أو unix: مخطط لإيقاف بروتوكول أمان طبقة النقل.
تراكم --remote_header=<a 'name=value' assignment> استخدامات متعددة
تحديد عنوان سيتم تضمينه في الطلبات: --remote_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
--remote_instance_name=<a string> التلقائي: ""
القيمة التي يجب إدخالها كمثال example_name في واجهة برمجة التطبيقات للتنفيذ عن بُعد.
--[no]remote_local_fallback التلقائي: "false;quot;
ما إذا كان المطلوب الالتزام باستراتيجية التنفيذ المحلية المستقلة في حال تعذّر التنفيذ عن بُعد.
--remote_local_fallback_strategy=<a string> التلقائي: "local;quot"
لا تتوفّر إمكانية التشغيل يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7480 للحصول على التفاصيل.
--remote_max_connections=<an integer> التلقائي: "100"
الحد الأقصى لعدد الاتصالات المتزامنة إلى ذاكرة التخزين المؤقت/التنفيذ عن بُعد وتكون القيمة 100 تلقائيًا. ويعني ضبطها على 0 أنّه ما مِن قيود. بالنسبة إلى ذاكرة التخزين المؤقت عن بُعد في HTTP، يمكن لاتصال TCP واحد معالجة طلب واحد في كل مرة، لذا يمكن أن يتولى Bazel ما يصل إلى --remote_max_connections من الطلبات المتزامنة. في ما يتعلق بذاكرة التخزين المؤقت/المنفّذ عن بُعد لدى gRPC، يمكن عادةً أن تعالج قناة gRPC أكثر من 100 طلب متزامن، لذا يمكن أن يرسل Bazel حوالي طلبات متزامنة بين ---remote_max_connections * 100`.
العلامات: host_machine_resource_optimizations
--remote_proxy=<a string> التلقائي: عرض الوصف
الاتصال بذاكرة التخزين المؤقت عن بُعد من خلال خادم وكيل. لا يمكن استخدام هذه العلامة حاليًا إلا لإعداد مقبس نطاق Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer> التلقائي: "0"
الأولوية النسبية للإجراءات البعيدة المراد تخزينها في ذاكرة التخزين المؤقت عن بُعد. تعتمد دلال قيم الأولوية المحدّدة على الخادم.
--remote_retries=<an integer> التلقائي: "5"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح عابر. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
--remote_timeout=<An immutable length of time.> التلقائي: "60s"
الحد الأقصى لوقت انتظار التنفيذ عن بُعد وذاكرة التخزين المؤقت للمكالمات. وبالنسبة إلى ذاكرة التخزين المؤقت في REST، تكون هذه القيمة هي مهلة الاتصال ومهلة القراءة. يمكن استخدام الوحدات التالية: الأيام (د) والساعات (س) والدقائق (م) والثواني (ث) والملي ثانية (ملي ثانية). إذا تم حذف الوحدة، يتم تفسير القيمة بالثواني.
--[no]remote_upload_local_results التلقائي: "true;true"
تحميل نتائج الإجراءات التي تم تنفيذها محليًا إلى ذاكرة التخزين المؤقت عن بُعد
--[no]remote_verify_downloads التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، سيحتسب Bazel مجموع التجزئة لجميع عمليات التنزيل عن بُعد وسيتجاهل القيم المخزَّنة مؤقتًا عن بُعد في حال عدم تطابقها مع القيمة المتوقَّعة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
--deleted_packages=<comma-separated list of package names> التلقائي: ""
قائمة بأسماء الحِزم المفصولة بفاصلة والتي يعتبرها نظام الإصدار غير موجودة، حتى إذا كانت مرئية في مكان ما على مسار الحزمة. استخدِم هذا الخيار عند حذف حزمة فرعية 'x/y' من حزمة حالية 'x&#39؛. على سبيل المثال، بعد حذف x/y/BUILD في برنامجك، قد يعترض نظام الإصدار إذا واجه تصنيفًا '//x:y/z&#39؛ إذا كان لا يزال يتم تقديمه من خلال إدخال package_path آخر. ويؤدي تحديد --delete_packages x/y إلى تجنُّب هذه المشكلة.
--disk_cache=<a path> التلقائي: عرض الوصف
مسار للاطّلاع على دليل حيث يمكن لتطبيق Bazel قراءة الإجراءات وإجراءاتها وكتابتها. في حال عدم توفّر الدليل، سيتم إنشاؤه.
تراكم --experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.> استخدامات متعددة
لضبط "بيانات اعتماد الاعتماد" في استخدامها لاسترداد بيانات الاعتماد للنطاق المقدَّم (النطاق). تحظى بيانات الاعتماد من "مساعدو المساعدة" بالأولوية على بيانات الاعتماد من <code&code>--google_default_credentials</code> أو `--google_credentials` أو &<code>.netrc</code>
--experimental_credential_helper_cache_duration=<An immutable length of time.> التلقائي: "30m"
لضبط المدة التي يتم خلالها تخزين بيانات اعتماد "أدوات مساعدة الاعتماد" مؤقتًا.
--experimental_credential_helper_timeout=<An immutable length of time.> التلقائي: "5;"
لضبط المهلة لمساعد بيانات الاعتماد. وسيتعذّر استدعاء بيانات اعتماد الوصول خلال هذه المهلة.
--google_auth_scopes=<comma-separated list of options> التلقائي: "https://www.googleapis.com/auth/cloud-platform"
قائمة مفصولة بفواصل لنطاقات المصادقة في Google Cloud
--google_credentials=<a string> التلقائي: عرض الوصف
يحدد الملف للحصول على بيانات اعتماد المصادقة. يمكنك الاطّلاع على https://cloud.google.com/docs/authentication للحصول على التفاصيل.
--[no]google_default_credentials التلقائي: "false;quot;
ما إذا كان المطلوب استخدام بيانات الاعتماد التلقائية في &39;Google للتطبيقات لإجراء المصادقة. يمكنك الاطّلاع على https://cloud.google.com/docs/authentication للحصول على التفاصيل. هذه الميزة غير مفعّلة تلقائيًا.
--grpc_keepalive_time=<An immutable length of time.> التلقائي: عرض الوصف
يمكنك ضبط إشعارات البقاء على قيد الاتصال لاتصالات gRPC الصادرة. إذا تم ضبط الإعداد، يُرسِل Bazel إشعارات بعد هذه الفترة من عدم توفّر عمليات قراءة على الاتصال، إلا إذا كان هناك طلب gRPC واحد على الأقل في انتظار المراجعة. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. يتم إيقاف إشعارات البقاء على الوضع تلقائيًا. يجب التنسيق مع مالك الخدمة قبل تفعيل هذا الإعداد. على سبيل المثال، لضبط قيمة 30 ثانية على هذه العلامة، يجب إجراؤها على النحو التالي --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.> التلقائي: "20s"
يضبط هذا الإعداد مهلة الاحتفاظ بالبيانات لاتصالات gRPC الصادرة. في حال تفعيل إشعارات البقاء على الاتصال مع --grpc_keepalive_time، ستنتهي مهلة Bazel للاتصال إذا لم تتلقَ رد فحص الاتصال بعد هذا الوقت الكبير. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. في حال إيقاف إشعارات التحقّق من الاتصال، يتم تجاهل هذا الإعداد.
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.
--package_path=<colon-separated list of options> التلقائي: "%workspace%"
قائمة مفصولة بفواصل من المكان الذي يجب البحث فيه عن الطرود. العناصر التي تبدأ بـ '%workspace%' نسبية إلى مساحة العمل المضمنة. في حال حذف الحقل أو تركه فارغًا، يكون الإعداد التلقائي هو الناتج 'bazel information default-package-path'.
--[no]show_loading_progress التلقائي: "true;true"
في حال تفعيل هذا الإعداد، سيتسبب تطبيق Bazel في طباعة الرسائل &quot&تحميل الحِزمة:".
--tls_certificate=<a string> التلقائي: عرض الوصف
حدِّد مسارًا لشهادة بروتوكول أمان طبقة النقل (TLS) موثوقة لتوقيع شهادات الخادم.
--tls_client_certificate=<a string> التلقائي: عرض الوصف
حدِّد شهادة عميل طبقة النقل الآمنة التي تريد استخدامها، وعليك أيضًا تقديم مفتاح عميل لتفعيل مصادقة العميل.
--tls_client_key=<a string> التلقائي: عرض الوصف
حدِّد مفتاح عميل طبقة النقل الآمنة الذي سيتم استخدامه، وعليك أيضًا تقديم شهادة عميل لتفعيل مصادقة العميل.

خيارات الاختبار

يكتسب جميع الخيارات من إصدار.

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتحكّم في تنفيذ الإصدار:
في حال ضبط هذه السياسة على "صحيح" و"-compatible_remote_symlinks" أيضًا، يُسمح باستخدام الروابط الرمزية في مخرجات الإجراء.
العلامات: execution، incompatible_change
في حال ضبط هذه السياسة على"صحيح"، سيمثّل Bazel الروابط الرمزية في مخرجات الإجراءات في بروتوكول التنفيذ/التخزين المؤقت عن بُعد. بخلاف ذلك، سيتم تتبُّع الروابط الرمزية لتمثيلها أو تمثيلها كملفات أو أدلة. راجِع #6631 لمزيد من التفاصيل.
العلامات: execution، incompatible_change
الخيارات التي تتيح للمستخدم ضبط النتائج المطلوبة، ما يؤثر في قيمتها بدلاً من ظهورها:
--bep_maximum_open_remote_upload_files=<an integer> التلقائي: "-1"
الحد الأقصى لعدد الملفات المفتوحة المسموح بها أثناء تحميل العنصر BEP.
العلامات: affects_outputs
--remote_download_minimal
عدم تنزيل أي نتائج إخراج عن بُعد إلى الجهاز المحلي. هذه العلامة عبارة عن اختصار لثلاثة علامات: --experimental_inmemory_jdeps_files، --experimental_inmemory_dotd_files و --remote_download_outputs=minimal.
التوسيع إلى:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=minimal

العلامات: affects_outputs
--remote_download_outputs=<all, minimal or toplevel> التلقائي: "all"
في حال ضبط السياسة على 'minimal' ولا يتم تنزيل أي مخرجات إصدار عن بُعد إلى الجهاز المحلي، باستثناء تلك التي تتطلّبها الإجراءات المحلية. في حال الضبط على 'toplevel' يتصرف مثل'minimal&#39؛ إلا أنه يؤدي أيضًا إلى تنزيل مخرجات أهداف المستوى الأعلى إلى الجهاز المحلي. يمكن أن يقلل كلا الخيارين من أوقات الإصدار إذا كانت هناك قيود على معدل نقل البيانات للشبكة.
العلامات: affects_outputs
بدلاً من تنزيل مخرجات الإصدار عن بُعد إلى الجهاز المحلي، يمكنك إنشاء روابط رمزية. يمكن تحديد هدف الروابط الرمزية في شكل سلسلة نموذج. قد تحتوي سلسلة النموذج هذه على {hash} و{size_ وحدات البايت} التي يتم توسيعها إلى تجزئة العنصر والحجم بالبايت، على التوالي. ويمكن أن تشير هذه الروابط الرمزية مثلاً إلى نظام ملفات FUSE الذي يحمِّل عناصر من CAS عند الطلب.
العلامات: affects_outputs
--remote_download_toplevel
يتم تنزيل النتائج عن بُعد لأهداف المستوى الأعلى على الجهاز المحلي فقط. هذه العلامة عبارة عن اختصار لثلاثة علامات: --experimental_inmemory_jdeps_files، --experimental_inmemory_dotd_files و-remote_download_outputs=toplevel.
التوسيع إلى:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel

العلامات: affects_outputs
الخيارات التي تؤثّر في مدى صرامة تطبيق Bazel لعمليات الإدخال الصالحة للبيانات (تعريفات القواعد ومجموعات التركيبات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة"bazel_dep"المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
--[no]print_relative_test_log_paths التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، عند طباعة المسار إلى سجلّ اختبار، استخدِم المسار النسبي الذي يعتمد على 'testlogs' ملاءمة الرمز التعبيري. جديد
العلامات: affects_outputs
--remote_print_execution_messages=<failure, success or all> التلقائي: "failure"
اختيار وقت طباعة رسائل التنفيذ عن بُعد القيم الصالحة هي "fail" أو "الطباعة" عند تعذُّر الطباعة إلا و"النجاح" للطباعة في حالات النجاح فقط و"الكل" للطباعة دائمًا.
العلامات: terminal_output
--[no]test_verbose_timeout_warnings التلقائي: "false;quot;
في حال كان هذا صحيحًا، يمكنك طباعة تحذيرات إضافية عندما لا يتطابق وقت التنفيذ الفعلي للاختبار مع المهلة التي يحددها الاختبار (سواء كانت ضمنية أو صريحة).
العلامات: affects_outputs
--[no]verbose_test_summary التلقائي: "true;true"
في حال ضبط السياسة على "صحيح"، اطّلِع على معلومات إضافية (مثل الوقت وعدد مرات التعذُّر وما إلى ذلك) في ملخّص الاختبار.
العلامات: affects_outputs
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
--[no]experimental_guard_against_concurrent_changes التلقائي: "false;quot;
إيقاف هذه الميزة لإيقاف التحقّق من وقت ملفات إدخال الإجراءات قبل تحميلها إلى ذاكرة التخزين المؤقت عن بُعد قد يعود سبب هذه المشكلة إلى حالات تأخير في كتابة ملفات Linux kernel، ما قد يؤدي إلى حالات موجبة خاطئة.
--experimental_remote_build_event_upload=<all or minimal> التلقائي: "all"
في حال الضبط على 'all'، يتم تحميل كل النتائج المحلية التي يشير إليها بروتوكول BEP إلى ذاكرة التخزين المؤقت عن بُعد. في حال الضبط على 'minimal'، لا يتم تحميل النتائج المحلية التي يشير إليها BEP إلى ذاكرة التخزين المؤقت البعيدة، باستثناء الملفات المهمة للمستهلكين في حالة BEP (مثل سجلات الاختبار والملف الشخصي للتوقيت). ويتم استخدام مخطط //:file لمسارات الملفات المحلية ومخطَّط // stream. ضبط تلقائي على 'all'
--[no]experimental_remote_cache_async التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، سيتم إجراء مؤتمر I/O لذاكرة التخزين المؤقت عن بُعد في الخلفية بدلاً من عقده كجزء من عملية النبات.
--[no]experimental_remote_cache_compression التلقائي: "false;quot;
في حال تفعيل هذا الإعداد، يُرجى ضغط كائن تخزين البيانات الثنائية الكبيرة أو فك ضغطه باستخدام zstd.
--experimental_remote_capture_corrupted_outputs=<a path> التلقائي: عرض الوصف
المسار المؤدي إلى دليل يتم فيه إخراج النتائج التالفة إليه.
--experimental_remote_downloader=<a string> التلقائي: عرض الوصف
معرّف موارد منتظم (URI) لنقطة نهاية واجهة برمجة التطبيقات البعيدة لمواد العرض، لاستخدامه كخادم وكيل للتنزيل عن بُعد. المخططات المعتمدة هي grpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX المحلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. يُرجى الاطّلاع على الرابط: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset_proto
--[no]experimental_remote_downloader_local_fallback التلقائي: "false;quot;
تحديد ما إذا كان من الممكن الرجوع إلى أداة التنزيل المحلية في حال تعذّر تنزيل أداة التنزيل عن بُعد.
--[no]experimental_remote_execution_keepalive التلقائي: "false;quot;
استخدام رسالة التحقّق من الاتصال لمكالمات التنفيذ عن بُعد
--experimental_remote_grpc_log=<a path> التلقائي: عرض الوصف
في حال تم تحديد مسار إلى ملف لتسجيل التفاصيل المتعلقة بمكالمة gRPC. يتكون هذا السجل من تسلسل من com.google.devtools.build.lib.remote.log.remoteExecutionLog.LogEntrys9fs مع كل رسالة مسبوقة بعلامة تشير إلى حجم رسالة Protobuf التسلسلية التالية، كما ننفّذها الطريقة LogLog.writeDelimitedTo(إخراجStream).
--[no]experimental_remote_mark_tool_inputs التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، سيضع Bazel علامة على الإدخالات كإدخالات للأداة التنفيذية عن بُعد. ويمكن استخدام هذا في تنفيذ العاملين الدائمين عن بُعد.
--[no]experimental_remote_merkle_tree_cache التلقائي: "false;quot;
في حال ضبط هذه السياسة على "صحيح"، سيتم تدوين حسابات شجرة ميركل لتحسين سرعة التحقّق من نتائج ذاكرة التخزين المؤقت عن بُعد. يتم التحكم في طباعة ذاكرة التخزين المؤقت في الذاكرة باستخدام --experimental_remote_merlick_tree_cache_size.
--experimental_remote_merkle_tree_cache_size=<a long integer> التلقائي: "1000"
عدد أشجار Mer وتتوفّر لتذكُّرها لتحسين سرعة التحقُّق من النتائج في ذاكرة التخزين المؤقت عن بُعد. ومع أنّ ذاكرة التخزين المؤقت يتم تشغيلها تلقائيًا وفقًا لطريقة معالجة Java& العديد من المراجع، قد تظهر أخطاء متعلّقة بالذاكرة إذا تم ضبطها على قيمة مرتفعة جدًا. إذا تم ضبطها على 0، يكون حجم ذاكرة التخزين المؤقت غير محدود. تختلف القيمة المثالية حسب حجم المشروع. القيمة التلقائية هي 1000.
--[no]incompatible_remote_build_event_upload_respect_no_cache التلقائي: "false;quot;
في حال ضبط هذه السياسة على"صحيح"، لا يتم تحميل النتائج التي يشير إليها بروتوكول BEP إلى ذاكرة التخزين المؤقت عن بُعد في حال تعذّر تخزين إجراء الإنشاء مؤقتًا عن بُعد.
--[no]incompatible_remote_downloader_send_all_headers التلقائي: "true;true"
ما إذا كان سيتم إرسال جميع قيم العنوان المتعدد القيم إلى أداة التنزيل عن بُعد بدلاً من القيمة الأولى فقط.
العلامات: incompatible_change
--[no]incompatible_remote_output_paths_relative_to_input_root التلقائي: "false;quot;
في حال الضبط على"صحيح"، ترتبط مسارات الإخراج بجذر الإدخال بدلاً من دليل العمل.
العلامات: incompatible_change
--[no]incompatible_remote_results_ignore_disk التلقائي: "true;true"
في حال ضبطها على"صحيح"، لن يتم تطبيق --noremote_upload_local_results و-noremote_accept_cached على ذاكرة التخزين المؤقت على القرص. في حال استخدام ذاكرة تخزين مؤقت مجمّعة: --noremote_upload_local_results سيؤدي إلى كتابة نتائج في ذاكرة التخزين المؤقت على القرص، ولكن لا يتم تحميلها إلى ذاكرة التخزين المؤقت عن بُعد. --noremote_Accept_cached: سيؤدي ذلك إلى بحث Bazel عن النتائج في ذاكرة التخزين المؤقت على القرص، ولكن ليس في ذاكرة التخزين المؤقت عن بُعد. يمكن أن تؤدي إجراءات no-remote-exec إلى ذاكرة التخزين المؤقت على القرص. راجِع #8216 لمزيد من التفاصيل.
العلامات: incompatible_change
--[no]remote_accept_cached التلقائي: "true;true"
قبول نتائج الإجراء المخزنة عن بُعد.
--remote_bytestream_uri_prefix=<a string> التلقائي: عرض الوصف
اسم المضيف واسم النسخة الافتراضية المطلوب استخدامهما في معرّفات الموارد المنتظمة (URI) //stream. يمكن تحديد هذا الخيار عند تنفيذ الإصدارات باستخدام خادم وكيل، مما يؤدي إلى عدم تطابق قيم --remote_executor و--remote_instance_name مع الاسم الأساسي لخدمة التنفيذ عن بُعد. وعند عدم ضبطها تلقائيًا، سيتم ضبطها تلقائيًا على "${hostname}/${instance_name}".
--remote_cache=<a string> التلقائي: عرض الوصف
معرّف موارد منتظم (URI) لنقطة نهاية ذاكرة التخزين المؤقت المخططات المتاحة هي http وhttps وgrpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX محلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. حدِّد grpc:// أو http:// أو Unix: مخطط لإيقاف بروتوكول أمان طبقة النقل. يُرجى الاطّلاع على https://bazel.build/remote/caching
تراكم --remote_cache_header=<a 'name=value' assignment> استخدامات متعددة
حدِّد عنوانًا سيتم تضمينه في طلبات ذاكرة التخزين المؤقت: --remote_cache_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
تراكم --remote_default_exec_properties=<a 'name=value' assignment> استخدامات متعددة
يمكنك ضبط خصائص exe التلقائية المراد استخدامها كمنصة تنفيذ عن بُعد في حال عدم ضبط منصة تنفيذ من قبل exec_property.
العلامات: affects_outputs
--remote_default_platform_properties=<a string> التلقائي: ""
يمكنك ضبط خصائص النظام الأساسي التلقائية المطلوب ضبطها لواجهة برمجة التطبيقات للتنفيذ عن بُعد، إذا لم تكن منصة التنفيذ قد تم ضبطها عن بُعد. وستُستخدَم هذه القيمة أيضًا في حال اختيار النظام الأساسي المضيف كنظام أساسي للتنفيذ عن بُعد.
تراكم --remote_downloader_header=<a 'name=value' assignment> استخدامات متعددة
حدد عنوانًا سيتم تضمينه في طلبات التنزيل عن بُعد: --remote_downloader_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
تراكم --remote_exec_header=<a 'name=value' assignment> استخدامات متعددة
حدِّد عنوانًا سيتم تضمينه في طلبات التنفيذ: "remote_exec_header=Name=Value". يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
--remote_execution_priority=<an integer> التلقائي: "0"
الأولوية النسبية للإجراءات التي سيتم تنفيذها عن بُعد تعتمد دلال قيم الأولوية المحدّدة على الخادم.
--remote_executor=<a string> التلقائي: عرض الوصف
المضيف أو HOST:PORT لنقطة نهاية التنفيذ عن بُعد. المخططات المعتمدة هي grpc وgrpcs (grpc مع تفعيل طبقة النقل الآمنة) وUnix (مقابس UNIX المحلية). إذا لم يتم توفير أي مخطط، سيتم تعيين Bazel تلقائيًا على نقطة التقييم الإجمالية. حدِّد grpc:// أو unix: مخطط لإيقاف بروتوكول أمان طبقة النقل.
تراكم --remote_header=<a 'name=value' assignment> استخدامات متعددة
تحديد عنوان سيتم تضمينه في الطلبات: --remote_header=Name=Value. يمكن تمرير رؤوس متعددة عن طريق تحديد العلامة عدة مرات. سيتم تحويل قيم متعددة للاسم نفسه إلى قائمة مفصولة بفواصل.
--remote_instance_name=<a string> التلقائي: ""
القيمة التي يجب إدخالها كمثال example_name في واجهة برمجة التطبيقات للتنفيذ عن بُعد.
--[no]remote_local_fallback التلقائي: "false;quot;
ما إذا كان المطلوب الالتزام باستراتيجية التنفيذ المحلية المستقلة في حال تعذّر التنفيذ عن بُعد.
--remote_local_fallback_strategy=<a string> التلقائي: "local;quot"
لا تتوفّر إمكانية التشغيل يُرجى الاطّلاع على https://github.com/bazelbuild/bazel/issues/7480 للحصول على التفاصيل.
--remote_max_connections=<an integer> التلقائي: "100"
الحد الأقصى لعدد الاتصالات المتزامنة إلى ذاكرة التخزين المؤقت/التنفيذ عن بُعد وتكون القيمة 100 تلقائيًا. ويعني ضبطها على 0 أنّه ما مِن قيود. بالنسبة إلى ذاكرة التخزين المؤقت عن بُعد في HTTP، يمكن لاتصال TCP واحد معالجة طلب واحد في كل مرة، لذا يمكن أن يتولى Bazel ما يصل إلى --remote_max_connections من الطلبات المتزامنة. في ما يتعلق بذاكرة التخزين المؤقت/المنفّذ عن بُعد لدى gRPC، يمكن عادةً أن تعالج قناة gRPC أكثر من 100 طلب متزامن، لذا يمكن أن يرسل Bazel حوالي طلبات متزامنة بين ---remote_max_connections * 100`.
العلامات: host_machine_resource_optimizations
--remote_proxy=<a string> التلقائي: عرض الوصف
الاتصال بذاكرة التخزين المؤقت عن بُعد من خلال خادم وكيل. لا يمكن استخدام هذه العلامة حاليًا إلا لإعداد مقبس نطاق Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer> التلقائي: "0"
الأولوية النسبية للإجراءات البعيدة المراد تخزينها في ذاكرة التخزين المؤقت عن بُعد. تعتمد دلال قيم الأولوية المحدّدة على الخادم.
--remote_retries=<an integer> التلقائي: "5"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح عابر. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
--remote_timeout=<An immutable length of time.> التلقائي: "60s"
الحد الأقصى لوقت انتظار التنفيذ عن بُعد وذاكرة التخزين المؤقت للمكالمات. وبالنسبة إلى ذاكرة التخزين المؤقت في REST، تكون هذه القيمة هي مهلة الاتصال ومهلة القراءة. يمكن استخدام الوحدات التالية: الأيام (د) والساعات (س) والدقائق (م) والثواني (ث) والملي ثانية (ملي ثانية). إذا تم حذف الوحدة، يتم تفسير القيمة بالثواني.
--[no]remote_upload_local_results التلقائي: "true;true"
تحميل نتائج الإجراءات التي تم تنفيذها محليًا إلى ذاكرة التخزين المؤقت عن بُعد
--[no]remote_verify_downloads التلقائي: "true;true"
في حال ضبط هذه السياسة على "صحيح"، سيحتسب Bazel مجموع التجزئة لجميع عمليات التنزيل عن بُعد وسيتجاهل القيم المخزَّنة مؤقتًا عن بُعد في حال عدم تطابقها مع القيمة المتوقَّعة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
--disk_cache=<a path> التلقائي: عرض الوصف
مسار للاطّلاع على دليل حيث يمكن لتطبيق Bazel قراءة الإجراءات وإجراءاتها وكتابتها. في حال عدم توفّر الدليل، سيتم إنشاؤه.
تراكم --experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.> استخدامات متعددة
لضبط"بيانات اعتماد الاعتماد"في استخدامها لاسترداد بيانات الاعتماد للنطاق المقدَّم (النطاق). تحظى بيانات الاعتماد من "مساعدو المساعدة" بالأولوية على بيانات الاعتماد من <code&code>--google_default_credentials</code> أو `--google_credentials` أو &<code>.netrc</code>
--experimental_credential_helper_cache_duration=<An immutable length of time.> التلقائي: "30m"
لضبط المدة التي يتم خلالها تخزين بيانات اعتماد"أدوات مساعدة الاعتماد"مؤقتًا.
--experimental_credential_helper_timeout=<An immutable length of time.> التلقائي: "5;"
لضبط المهلة لمساعد بيانات الاعتماد. وسيتعذّر استدعاء بيانات اعتماد الوصول خلال هذه المهلة.
--google_auth_scopes=<comma-separated list of options> التلقائي: "https://www.googleapis.com/auth/cloud-platform"
قائمة مفصولة بفواصل لنطاقات المصادقة في Google Cloud
--google_credentials=<a string> التلقائي: عرض الوصف
يحدد الملف للحصول على بيانات اعتماد المصادقة. يمكنك الاطّلاع على https://cloud.google.com/docs/authentication للحصول على التفاصيل.
--[no]google_default_credentials التلقائي: "false;quot;
ما إذا كان المطلوب استخدام بيانات الاعتماد التلقائية في &39;Google للتطبيقات لإجراء المصادقة. يمكنك الاطّلاع على https://cloud.google.com/docs/authentication للحصول على التفاصيل. هذه الميزة غير مفعّلة تلقائيًا.
--grpc_keepalive_time=<An immutable length of time.> التلقائي: عرض الوصف
يمكنك ضبط إشعارات البقاء على قيد الاتصال لاتصالات gRPC الصادرة. إذا تم ضبط الإعداد، يُرسِل Bazel إشعارات بعد هذه الفترة من عدم توفّر عمليات قراءة على الاتصال، إلا إذا كان هناك طلب gRPC واحد على الأقل في انتظار المراجعة. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. يتم إيقاف إشعارات البقاء على الوضع تلقائيًا. يجب التنسيق مع مالك الخدمة قبل تفعيل هذا الإعداد. على سبيل المثال، لضبط قيمة 30 ثانية على هذه العلامة، يجب إجراؤها على النحو التالي --grpc_keepalive_time=30s
--grpc_keepalive_timeout=<An immutable length of time.> التلقائي: "20s"
يضبط هذا الإعداد مهلة الاحتفاظ بالبيانات لاتصالات gRPC الصادرة. في حال تفعيل إشعارات البقاء على الاتصال مع --grpc_keepalive_time، ستنتهي مهلة Bazel للاتصال إذا لم تتلقَ رد فحص الاتصال بعد هذا الوقت الكبير. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. في حال إيقاف إشعارات التحقّق من الاتصال، يتم تجاهل هذا الإعداد.
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.
--tls_certificate=<a string> التلقائي: عرض الوصف
حدِّد مسارًا لشهادة بروتوكول أمان طبقة النقل (TLS) موثوقة لتوقيع شهادات الخادم.
--tls_client_certificate=<a string> التلقائي: عرض الوصف
حدِّد شهادة عميل طبقة النقل الآمنة التي تريد استخدامها، وعليك أيضًا تقديم مفتاح عميل لتفعيل مصادقة العميل.
--tls_client_key=<a string> التلقائي: عرض الوصف
حدِّد مفتاح عميل طبقة النقل الآمنة الذي سيتم استخدامه، وعليك أيضًا تقديم شهادة عميل لتفعيل مصادقة العميل.

خيارات الإصدار

الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
تراكم --distdir=<a path> استخدامات متعددة
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات: bazel_internal_configuration
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: bazel_internal_configuration
--[no]experimental_repository_cache_urls_as_default_canonical_id التلقائي: "false;quot;
إذا تم ضبط السياسة على"صحيح"، استخدِم سلسلة مشتقة من عناوين URL لعمليات تنزيل المستودع بصفتهاcanonical_id (المعرّف_الأساسي) إذا لم يتم تحديدها. ويتسبب ذلك في حدوث تغيير في عناوين URL يؤدي إلى إعادة التنزيل حتى إذا تضمّنت ذاكرة التخزين المؤقت عملية تنزيل بنفس التجزئة. ويمكن استخدام هذا للتحقق من أن تغييرات عناوين URL لا تؤدي إلى إخفاء المستودعات التالفة من خلال ذاكرة التخزين المؤقت.
العلامات: loading_and_analysis، experimental
--[no]experimental_repository_disable_download التلقائي: "false;quot;
في حال ضبط هذه السياسة، لا يُسمح بتنزيل مستودعات خارجية.
العلامات: experimental
--experimental_repository_downloader_retries=<an integer> التلقائي: "0"
الحد الأقصى لعدد محاولات إعادة محاولة تصحيح خطأ في التنزيل. وفي حال ضبطها على 0، تكون عمليات إعادة المحاولة غير مفعَّلة.
العلامات: experimental
--experimental_scale_timeouts=<a double> التلقائي: "1.0"
يُرجى تعديل كل المهلات في قواعد مستودع Starlark حسب هذا العامل. وبهذه الطريقة، يمكن إنشاء مستودعات خارجية تعمل على أجهزة أبطأ من المتوقّع بالنسبة إلى مؤلف القاعدة، بدون تغيير رمز المصدر.
العلامات: bazel_internal_configuration وexperimental
--http_timeout_scaling=<a double> التلقائي: "1.0"
تحديد كل المهلات المتعلّقة بعمليات تنزيل HTTP حسب العامل المحدّد
العلامات: bazel_internal_configuration
--repository_cache=<a path> التلقائي: عرض الوصف
يحدد موقع ذاكرة التخزين المؤقت للقيم التي تم تنزيلها أثناء جلب المستودعات الخارجية. سلسلة فارغة كوسيطة تطلب إيقاف ذاكرة التخزين المؤقت.
العلامات: bazel_internal_configuration
الخيارات التي تتيح للمستخدم ضبط النتائج المطلوبة، ما يؤثر في قيمتها بدلاً من تفعيلها:
--[no]gnu_format التلقائي: "false;quot;
في حال ضبط السياسة، اكتب الإصدار المطلوب تصغيره باستخدام الصيغ الموضحة في معايير GNU.
العلامات: affects_outputs، execution
الخيارات التي تؤثر في مدى قوة تطبيق Bazel لمدخلات الإصدارات الصالحة (تعريفات القواعد ومجموعات التركيبات وغيرها):
--experimental_repository_hash_file=<a string> التلقائي: ""
إذا لم يكن الحقل فارغًا، سيتم تحديد ملف يحتوي على قيمة تم حلّها، ويجب أن يتم التحقّق من تجزئات دليل الدليل وفقًا لها.
العلامات: affects_outputs وexperimental
تراكم --experimental_verify_repository_rules=<a string> استخدامات متعددة
إذا كانت قائمة قواعد المستودع التي يجب التحقق من تجزئة دليل الدليل، يتم تحديد الملف من خلال --experimental_repository_hash_file.
العلامات: affects_outputs أو experimental
يؤثر هذا الخيار في دلالات لغة Starlark أو واجهة برمجة التطبيقات الخاصة بالإصدار والتي يمكن الوصول إليها من خلال ملفات BUILD أو ملفات .bzl أو ملفات WORKSPACE.:
--[no]experimental_allow_top_level_aspects_parameters التلقائي: "true;true"
No-op
العلامات: no_op وdeprecated وexperimental
الخيارات المتعلقة بمخرجات Bzlmod والدلالة:
تراكم --allow_yanked_versions=<a string> استخدامات متعددة
تم تحديد نُسخ الوحدات على شكل " <module1>@<version1>,<module2>@<version2>` التي سيتم السماح بها في الرسم البياني للاعتمادية التي تم حلّها حتى في حال الإعلان عن إزالتها في قاعدة بيانات المسجّلين (إذا لم تكن واردة من قاعدة بيانات المسجّلين). بخلاف ذلك، ستؤدي النُسخ المتأثرة بالخطأ إلى تعذُّر حلّ الحل. يمكنك أيضًا تحديد الإصدار المطلوب المسموح به باستخدام متغير البيئة "BZLMOD_ALLOW_YANKED_DESCRIPTIONS". ويمكنك إيقاف هذا الفحص باستخدام الكلمة الرئيسية 'all' (غير مستحسن).
العلامات: loading_and_analysis
--check_bazel_compatibility=<error, warning or off> التلقائي: "error&quot&quot
تحقّق من توافق إصدار Bazel مع وحدات Bazel. والقيم الصالحة هي "خطأ" لتصعيدها إلى حالة تعذُّر حلّ المشكلة، أو "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق.
العلامات: loading_and_analysis
--check_direct_dependencies=<off, warning or error> التلقائي: "warning"
تحقّق مما إذا كانت العناصر التابعة "bazel_dep" المباشرة المعلَنة في الوحدة التنظيمية الأساسية هي النُسخ نفسها التي تظهر في الرسم البياني للاعتمادية الذي تم حلّه. وتكون القيم الصالحة "إيقاف" لإيقاف عملية التحقّق، أو "تحذير" لطباعة تحذير عند رصد عدم تطابق، أو "خطأ" لتصعيد الطلب إلى نتيجة تعذُّر الوصول إلى حل.
العلامات: loading_and_analysis
--[no]ignore_dev_dependency التلقائي: "false;quot;
في حال اختيار القيمة "true"، يتجاهل Bazel كلاً من "bazel_dep` و"use_extension`" اللذين تم تعريفهما باسم "dev_dependency" في MODULE.bazel في الوحدة الجذر. تجدر الإشارة إلى أنه يتم دائمًا تجاهل تبعيات مطوّري البرامج هذه في MODULE.bazel إذا لم يكن ذلك هو الوحدة الجذر، بغض النظر عن قيمة هذه العلامة.
العلامات: loading_and_analysis
تراكم --override_module=<an equals-separated mapping of module name to path> استخدامات متعددة
يؤدي هذا الإعداد إلى تجاهل وحدة مع دليل محلي.
تراكم --registry=<a string> استخدامات متعددة
يحدد السجلّات المطلوب استخدامها لتحديد تبعيات وحدة Bazel. يُعدّ هذا الأمر مهمًا: سيتمّ البحث في الوحدات التنظيمية أولاً في السجلّات السابقة، ولن يتم الرجوع إلى سجلّات السجلّات اللاحقة إلا في حال عدم توفّرها.
العلامات: changes_inputs
الخيارات التي تؤثّر في الإسهاب أو التنسيق أو مكان التسجيل:
--[no]experimental_record_metrics_for_all_mnemonics التلقائي: "false;quot;
يقتصر عدد أنواع الإجراءات تلقائيًا على 20 رسالة تذكارية تضم أكبر عدد من الإجراءات التي تم تنفيذها. سيؤدي ضبط هذا الخيار إلى كتابة إحصاءات لجميع عمليات الاسترداد.
خيارات تحديد أو إدخال عام في الأمر Bazel لا يندرج ضمن فئات أخرى:
--experimental_resolved_file_instead_of_workspace=<a string> التلقائي: ""
إذا كان الملف غير فارغ، اطّلِع على الملف الذي تم حلّه بدلاً من ملف WORKSPACE
العلامات: changes_inputs
خيارات التخزين المؤقت عن بُعد وتنفيذها:
--experimental_downloader_config=<a string> التلقائي: عرض الوصف
حدِّد ملفًا لضبط أداة التنزيل عن بُعد. يتكون هذا الملف من سطور، يبدأ كل منها توجيه ("allow` أو `block` أو `rewrite`) متبوعًا باسم مضيف (لـ "allow" و"block`) أو نمطَين، أحدهما للمطابقة، والآخر لاستخدامه كعنوان URL بديل، مع استخدام مراجع مرجعية تبدأ من "$1`". يمكن تحقيق توجيهات "إعادة كتابة" متعددة لعنوان URL نفسه، وفي هذه الحالة سيتم عرض عناوين URL متعددة.
خيارات متنوعة، لا مصنّفة بطريقة أخرى:
تراكم --override_repository=<an equals-separated mapping of repository name to path> استخدامات متعددة
لإلغاء مستودع في دليل محلي.

علامات تأثير الخيار

unknown هذا الخيار له تأثير غير معروف أو غير موثَّق.
no_op ولا يكون لهذا الخيار أي تأثير حرفي.
loses_incremental_state يمكن أن يؤدي تغيير قيمة هذا الخيار إلى فقدان كبير للحالة المتزايدة، ما يؤدي إلى إبطاء الإصدارات. قد يتم فقدان الحالة بسبب إعادة تشغيل الخادم أو بسبب إبطال جزء كبير من الرسم البياني للاعتمادية.
changes_inputs يعمل هذا الخيار بشكل متواصل على تغيير المُدخلات التي تأخذها Bazel في الاعتبار، مثل قيود نظام الملفات أو إصدارات المستودع أو الخيارات الأخرى.
affects_outputs يؤثر هذا الخيار في نتائج Bazel&#39s. هذه العلامة عامة عن قصد، ويمكن أن تشمل تأثيرات عابرة، ولا تحدّد نوع الناتج الذي تؤثر فيه.
build_file_semantics يؤثر هذا الخيار في دلالات ملفات BUILD أو .bzl.
bazel_internal_configuration يؤثّر هذا الخيار في إعدادات الآلات الداخلية. ولا تعني هذه العلامة، في حدّ ذاتها، أن العناصر المتأثرة قد تأثرت.
loading_and_analysis يؤثر هذا الخيار في تحميل المهام التابعة وتحليلها، وفي إنشاء الرسم البياني للاعتمادية.
execution ويؤثر هذا الخيار في مرحلة التنفيذ، مثل وضع الحماية أو الخيارات ذات الصلة بالتنفيذ عن بُعد.
host_machine_resource_optimizations يؤدي هذا الخيار إلى تشغيل عملية تحسين قد تكون خاصة بالآلة ولا يمكن ضمان عملها على جميع الأجهزة. ويمكن أن يتضمّن التحسين المقايضة مع جوانب أخرى من الأداء، مثل الذاكرة أو تكلفة وحدة المعالجة المركزية (CPU).
eagerness_to_exit يؤدي هذا الخيار إلى تغيير طريقة خروج بازار الخبز من حالة التعذُّر، حيث يمكنك الاختيار بين الاستمرار رغم تعذّر إتمام الاستدعاء وإنهاء الاستدعاء.
bazel_monitoring يُستخدم هذا الخيار لمراقبة سلوك البازار وأدائها.
terminal_output يؤثّر هذا الخيار في مَخرج طرفي البازار.
action_command_lines يؤدي هذا الخيار إلى تغيير وسيطات سطر الأوامر لواحد أو أكثر من إجراءات الإصدار.
test_runner يؤدي هذا الخيار إلى تغيير بيئة أداة الاختبار للإصدار.

علامات البيانات الوصفية للخيارات

experimental يؤدي هذا الخيار إلى تشغيل ميزة تجريبية بدون أي ضمانات بالوظائف.
incompatible_change يؤدي هذا الخيار إلى حدوث تغيير قد يؤدي إلى عطل. يمكنك استخدام هذا الخيار لاختبار مدى استعدادك لنقل البيانات أو استخدام الميزة الجديدة قبل إطلاقها.
deprecated تم إيقاف هذا الخيار. قد يكون السبب هو إيقاف الميزة التي تؤثر فيها، أو تفضيل طريقة أخرى لتقديم المعلومات.
explicit_in_output_path تمت الإشارة إلى هذا الخيار صراحةً في دليل الناتج.