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's الخاصة بالخادم. في حال ترك هذه السياسة بدون ضبط، يتم تلقائيًا ضبط الإعدادات على موقع جغرافي في الناتج_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
--[no]windows_enable_symlinks
التلقائي: "false;quot;-
في حال استخدام هذه السياسة، سيتم إنشاء روابط رمزية حقيقية على نظام التشغيل 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
-
في حال ضبط هذه السياسة على "صحيح"، سيتم نشر العلامات من هدف إلى إجراءات " #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
-
في حال ضبطها على "صحيح"، ستتوفّر سمات القواعد وطرق واجهة برمجة التطبيقات 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
--[no]incompatible_depset_for_libraries_to_link_getter
التلقائي: "true;true"-
عندما يكون ذلك صحيحًا، لم يعُد تطبيق 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's الداخلي في إطار الإطار. وإذا اكتشف 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"-
يحدد هذا الإعداد الحجم الأقصى لـ 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'؛ ما يعني عدم وجود مهلة.
العلامات: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
--[no]experimental_build_event_fully_resolve_fileset_symlinks
التلقائي: "false;quot;-
في حال ضبط هذه السياسة على"صحيح"، يجب حلّ روابط الملفات المُجمَّعة النسبية في ملف 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;-
يتضمّن تصنيفًا مستهدفًا في أحداث الإجراء'؛ بيانات الملف الشخصي بتنسيق 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 للاتصال إذا لم تتلقَ رد فحص الاتصال بعد هذا الوقت الكبير. يتم التعامل مع الأوقات كدقة ثانية، خطأ عند ضبط قيمة أقل من ثانية واحدة. في حال إيقاف إشعارات التحقّق من الاتصال، يتم تجاهل هذا الإعداد.
--[no]incompatible_disallow_symlink_file_to_dir
التلقائي: "true;true"-
في حال ضبط هذه السياسة على "صحيح"، لن تسمح السياسة "ctx.actions.symlink`" بإعادة ربط الملف داخل دليل.
العلامات:loading_and_analysis
،incompatible_change
--[no]incompatible_remove_rule_name_parameter
التلقائي: "true;true"-
في حال الضبط على "صحيح"، لا يمكن استدعاء "القاعدة"' باستخدام المعلّمة "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
--[no]experimental_repository_cache_hardlinks
التلقائي: "false;quot;-
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: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""-
تحقّق من توافق إصدار 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
--[no]experimental_repository_cache_hardlinks
التلقائي: "false;quot;-
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: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"-
إذا تم ضبط هذه السياسة على "صحيح"، سيتم دمج رسم بياني منشِئ &'عامل>'؛ أي أنه سيتم دمج العُقد المتماثلة طوبولوجيا معًا وربط تصنيفاتها. ينطبق هذا الخيار على --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""-
تحقّق من توافق إصدار 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>
استخدامات متعددة - لإلغاء مستودع في دليل محلي.
- الخيارات التي تتحكّم في تنفيذ الإصدار:
--[no]experimental_inprocess_symlink_creation
التلقائي: "false;quot;-
تحديد ما إذا كان سيتم إجراء طلبات مباشرة لنظام الملفات لإنشاء أشجار رمزية
العلامات: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
-
يمكنك استخدام العناصر المشتركة للواجهة إذا كانت متوافقة مع سلسلة الأدوات. تتيح جميع سلاسل أدوات 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_runfile_links
التلقائي: "true;true"-
في حال ضبط هذه السياسة على"صحيح"، أنشِئ مجموعات رمزية للملفات القابلة للتنفيذ لجميع الاستهدافات. وفي حال ضبطها على "خطأ"، يُرجى كتابة البيانات فقط عند الإمكان.
العلامات: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 لإعداد خطوات تجميع الخطوات التي تستهدف بُنى الأجهزة. وتكون القيم بالشكل التالي: وفي حال توفّر هذا الوضع، يتم تطبيق وضع الرمز البريدي على هذه المنصة تحديدًا، وفي حال حذفه، يتم تطبيقه على جميع الأنظمة الأساسية. يجب أن يكون الوضع '؛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
-
في حال كان هذا صحيحًا، ستتم مشاركة المكتبات الأصلية التي تتضمّن وظائف متطابقة بين الأهداف المختلفة.
العلامات:loading_and_analysis
وaffects_outputs
--[no]stamp
التلقائي: "false;quot;-
استخدِم الطوابع الثنائية بالتاريخ، واسم المستخدم، واسم المضيف، ومعلومات مساحة العمل، وما إلى ذلك.
العلامات:affects_outputs
--strip=<always, sometimes or never>
التلقائي: "أحيانًا"-
يحدد ما إذا كان سيتم إزالة البرامج الثنائية والمكتبات المشتركة (باستخدام "-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""-
ما لم يتم إيقاف السياسة، تتحقّق تلك المعلّمة من أن الاستهداف في 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'؛ يمكنك الحصول على قائمة بالأجهزة من خلال تشغيل '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"-
إذا تم ضبط هذه السياسة على"صحيح"، سيتم دمج رسم بياني منشِئ &'عامل>'؛ أي أنه سيتم دمج العُقد المتماثلة طوبولوجيا معًا وربط تصنيفاتها. ينطبق هذا الخيار على --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'، بينما ستظهر الأهداف المُنشَأة في 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
--[no]experimental_repository_cache_hardlinks
التلقائي: "false;quot;-
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: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'؛ حيث يُجري الذاكرة المساعِدة الإعداد التلقائي لتذكيرات الذاكرة غير المحدَّدة. يتخذ [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"-
عند الإعداد، لا تخضع الاستهدافات التي يتم إنشاؤها &للأداة"، للتنفيذ الديناميكي. ومن غير المرجّح أن يتم إنشاء مثل هذه الأهداف بشكل تدريجي، وبالتالي لا تستحق إنفاق الدورات المحلية عليها.
العلامات: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
--[no]incompatible_remote_dangling_symlinks
التلقائي: "true;true"-
في حال ضبط هذه السياسة على "صحيح" و"-compatible_remote_symlinks" أيضًا، يُسمح باستخدام الروابط الرمزية في مخرجات الإجراء.
العلامات:execution
،incompatible_change
--[no]incompatible_remote_symlinks
التلقائي: "true;true"-
في حال ضبط هذه السياسة على "صحيح"، سيمثّل 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
--[no]incompatible_linkopts_in_user_link_flags
التلقائي: "true;true"-
خيار عدم العمل:
العلامات: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
--[no]experimental_convenience_symlinks
التلقائي: "normal;quot;-
تتحكّم هذه العلامة في كيفية إدارة الروابط الرمزية (الروابط الرمزية التي تظهر في مساحة العمل بعد الإصدار). القيم المحتملة:
عادي (تلقائي): سيتم إنشاء أو حذف كل نوع من الروابط الرمزية، كما هو محدد في الإصدار.
نظيفة: سيتم حذف جميع الروابط الرمزية بدون شروط.
تجاهل: سيتم ترك الروابط الرمزية بشكل منفرد.
log_only: أنشئ رسائل السجلّ كما لو كانت 'normal' تم اجتيازها، ولكنها لا تُنفّذ أي عمليات لنظام الملفات (مفيدة للأدوات).
تجدر الإشارة إلى أنه يمكن تأثُّر الروابط الرمزية فقط التي يتم إنشاء أسمائها من خلال القيمة الحالية "--symlink_prefix". وفي حال تغيير البادئة، سيتم ترك أي روابط رمزية موجودة مسبقًا بمفردها.
العلامات:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
التلقائي: "false;quot;-
تتحكّم هذه العلامة في ما إذا كنّا سننشر حدث 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'؛ إلا أنه يؤدي أيضًا إلى تنزيل مخرجات أهداف المستوى الأعلى إلى الجهاز المحلي. يمكن أن يقلل كلا الخيارين من أوقات الإصدار إذا كانت هناك قيود على معدل نقل البيانات للشبكة.
العلامات:affects_outputs
--remote_download_symlink_template=<a string>
التلقائي: ""-
بدلاً من تنزيل مخرجات الإصدار عن بُعد إلى الجهاز المحلي، يمكنك إنشاء روابط رمزية. يمكن تحديد هدف الروابط الرمزية في شكل سلسلة نموذج. قد تحتوي سلسلة النموذج هذه على {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
--symlink_prefix=<a string>
التلقائي: عرض الوصف-
البادئة التي يتم إلحاقها بأي من الرموز المميزة المناسبة التي يتم إنشاؤها بعد الإصدار. إذا تم حذف القيمة، تكون القيمة التلقائية هي اسم أداة الإصدار متبوعة بواصلة. في حال اجتياز عملية & تحذير: سيتم إيقاف الوظيفة الخاصة لـ '/' قريبًا. استخدِم --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
--[no]experimental_sandboxfs_map_symlink_targets
التلقائي: "false;quot;-
في حال ضبط هذه السياسة على"صحيح"، يتم ربط استهدافات الروابط الرمزية المحدّدة كإدخالات إجراءات في وضع الحماية. وتنطبق هذه الميزة فقط على قواعد تصحيح الأخطاء التي لا تنفّذ هذا الإجراء بمفردها، ويجب إزالتها بعد حلّ كل هذه القواعد.
العلامات: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'؛ أعلاه.
العلامات: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""-
تحقّق من توافق إصدار 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
--[no]experimental_build_event_fully_resolve_fileset_symlinks
التلقائي: "false;quot;-
في حال ضبط هذه السياسة على"صحيح"، يجب حلّ روابط الملفات المُجمَّعة النسبية في ملف 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 كحزمة واحدة)'؛
--[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'؛. على سبيل المثال، بعد حذف x/y/BUILD في برنامجك، قد يعترض نظام الإصدار إذا واجه تصنيفًا '//x:y/z'؛ إذا كان لا يزال يتم تقديمه من خلال إدخال 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"- حدِّد صراحةً إجمالي ذاكرة الوصول العشوائي (RAM) للمضيف المحلي (بالميغابايت) المتاحة لشركة Bazel لإنفاقها على إجراءات الإصدار التي تم تنفيذها محليًا. يأخذ عددًا صحيحًا أو &&;;;; معلش_ذاكرة الوصول العشوائي&&;; وفيها خيار اختياري متبوعًا بـ [-|*]< العدد > (مثل HOST_RAM*.5 لاستخدام نصف ذاكرة الوصول العشوائي المتاحة). وفقًا للإعدادات التلقائية، ("HOST_RAM*.67")، سيبحث Bazel عن إعدادات النظام لتقدير حجم ذاكرة الوصول العشوائي المتاحة وسيستخدِم 67% منها.
--local_termination_grace_seconds=<an integer>
التلقائي: "15"- حان وقت الانتظار بين إنهاء عملية محلية بسبب انتهاء المهلة وفرض إغلاقها.
- تراكم
--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 في طباعة الرسائل "&تحميل الحِزمة:".
--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
--[no]experimental_inprocess_symlink_creation
التلقائي: "false;quot;-
تحديد ما إذا كان سيتم إجراء طلبات مباشرة لنظام الملفات لإنشاء أشجار رمزية
العلامات: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
-
يمكنك استخدام العناصر المشتركة للواجهة إذا كانت متوافقة مع سلسلة الأدوات. تتيح جميع سلاسل أدوات 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
--[no]build_runfile_links
التلقائي: "true;true"-
في حال ضبط هذه السياسة على "صحيح"، أنشِئ مجموعات رمزية للملفات القابلة للتنفيذ لجميع الاستهدافات. وفي حال ضبطها على "خطأ"، يُرجى كتابة البيانات فقط عند الإمكان.
العلامات: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 لإعداد خطوات تجميع الخطوات التي تستهدف بُنى الأجهزة. وتكون القيم بالشكل التالي: وفي حال توفّر هذا الوضع، يتم تطبيق وضع الرمز البريدي على هذه المنصة تحديدًا، وفي حال حذفه، يتم تطبيقه على جميع الأنظمة الأساسية. يجب أن يكون الوضع '؛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
--[no]experimental_convenience_symlinks
التلقائي: "normal;quot;-
تتحكّم هذه العلامة في كيفية إدارة الروابط الرمزية (الروابط الرمزية التي تظهر في مساحة العمل بعد الإصدار). القيم المحتملة:
عادي (تلقائي): سيتم إنشاء أو حذف كل نوع من الروابط الرمزية، كما هو محدد في الإصدار.
نظيفة: سيتم حذف جميع الروابط الرمزية بدون شروط.
تجاهل: سيتم ترك الروابط الرمزية بشكل منفرد.
log_only: أنشئ رسائل السجلّ كما لو كانت 'normal' تم اجتيازها، ولكنها لا تُنفّذ أي عمليات لنظام الملفات (مفيدة للأدوات).
تجدر الإشارة إلى أنه يمكن تأثُّر الروابط الرمزية فقط التي يتم إنشاء أسمائها من خلال القيمة الحالية "--symlink_prefix". وفي حال تغيير البادئة، سيتم ترك أي روابط رمزية موجودة مسبقًا بمفردها.
العلامات:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
التلقائي: "false;quot;-
تتحكّم هذه العلامة في ما إذا كنّا سننشر حدث 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
-
في حال كان هذا صحيحًا، ستتم مشاركة المكتبات الأصلية التي تتضمّن وظائف متطابقة بين الأهداف المختلفة.
العلامات:loading_and_analysis
وaffects_outputs
--[no]stamp
التلقائي: "false;quot;-
استخدِم الطوابع الثنائية بالتاريخ، واسم المستخدم، واسم المضيف، ومعلومات مساحة العمل، وما إلى ذلك.
العلامات:affects_outputs
--strip=<always, sometimes or never>
التلقائي: "أحيانًا"-
يحدد ما إذا كان سيتم إزالة البرامج الثنائية والمكتبات المشتركة (باستخدام "-Wl;---strip-debug"). تعني القيمة التلقائية 'أحيانًا##9
العلامات:affects_outputs
- تراكم
--stripopt=<a string>
استخدامات متعددة -
خيارات إضافية يتم تمريرها إلى شريط العناصر عند إنشاء برنامج '<name>.stripped' ثنائي.
العلامات:action_command_lines
،affects_outputs
- تراكم
--swiftcopt=<a string>
استخدامات متعددة -
خيارات إضافية للانتقال إلى مجمّع Swift.
العلامات:action_command_lines
--symlink_prefix=<a string>
التلقائي: عرض الوصف-
البادئة التي يتم إلحاقها بأي من الرموز المميزة المناسبة التي يتم إنشاؤها بعد الإصدار. إذا تم حذف القيمة، تكون القيمة التلقائية هي اسم أداة الإصدار متبوعة بواصلة. في حال اجتياز عملية & تحذير: سيتم إيقاف الوظيفة الخاصة لـ '/' قريبًا. استخدِم --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""-
ما لم يتم إيقاف السياسة، تتحقّق تلك المعلّمة من أن الاستهداف في 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'؛ أعلاه.
العلامات:execution
--[no]ios_memleaks
التلقائي: "false;quot;-
تفعيل التحقق من تسرُّبات الذاكرة في أهداف ios_test.
العلامات:action_command_lines
--ios_simulator_device=<a string>
التلقائي: عرض الوصف-
الجهاز الذي سيتم محاكاةه عند تشغيل تطبيق iOS في المحاكي، مثلاً 'iPhone 6'؛ يمكنك الحصول على قائمة بالأجهزة من خلال تشغيل '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
--[no]experimental_build_event_fully_resolve_fileset_symlinks
التلقائي: "false;quot;-
في حال ضبط هذه السياسة على"صحيح"، يجب حلّ روابط الملفات المُجمَّعة النسبية في ملف 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'، بينما ستظهر الأهداف المُنشَأة في 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'؛. على سبيل المثال، بعد حذف x/y/BUILD في برنامجك، قد يعترض نظام الإصدار إذا واجه تصنيفًا '//x:y/z'؛ إذا كان لا يزال يتم تقديمه من خلال إدخال 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"- حدِّد صراحةً إجمالي ذاكرة الوصول العشوائي (RAM) للمضيف المحلي (بالميغابايت) المتاحة لشركة Bazel لإنفاقها على إجراءات الإصدار التي تم تنفيذها محليًا. يأخذ عددًا صحيحًا أو &&;;;; معلش_ذاكرة الوصول العشوائي&&;; وفيها خيار اختياري متبوعًا بـ [-|*]< العدد > (مثل HOST_RAM*.5 لاستخدام نصف ذاكرة الوصول العشوائي المتاحة). وفقًا للإعدادات التلقائية، ("HOST_RAM*.67")، سيبحث Bazel عن إعدادات النظام لتقدير حجم ذاكرة الوصول العشوائي المتاحة وسيستخدِم 67% منها.
--local_termination_grace_seconds=<an integer>
التلقائي: "15"- حان وقت الانتظار بين إنهاء عملية محلية بسبب انتهاء المهلة وفرض إغلاقها.
--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 في طباعة الرسائل "&تحميل الحِزمة:".
- تراكم
--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
--[no]experimental_repository_cache_hardlinks
التلقائي: "false;quot;-
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: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""-
تحقّق من توافق إصدار 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'؛. على سبيل المثال، بعد حذف x/y/BUILD في برنامجك، قد يعترض نظام الإصدار إذا واجه تصنيفًا '//x:y/z'؛ إذا كان لا يزال يتم تقديمه من خلال إدخال 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 في طباعة الرسائل "&تحميل الحِزمة:".
خيارات التنظيف
يكتسب جميع الخيارات من إصدار.
- الخيارات التي تظهر قبل الأمر والتي يحلّلها البرنامج:
- تراكم
--distdir=<a path>
استخدامات متعددة -
أماكن إضافية للبحث عن الأرشيفات قبل الوصول إلى الشبكة لتنزيلها.
العلامات:bazel_internal_configuration
--[no]experimental_repository_cache_hardlinks
التلقائي: "false;quot;-
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: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
--[no]remove_all_convenience_symlinks
التلقائي: "false;quot;-
في حال ضبط السياسة على"صحيح"، سيتم حذف جميع الروابط الرمزية في مساحة العمل ذات البادئة 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""-
تحقّق من توافق إصدار 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
--[no]experimental_repository_cache_hardlinks
التلقائي: "false;quot;-
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: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""-
تحقّق من توافق إصدار 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
--[no]experimental_repository_cache_hardlinks
التلقائي: "false;quot;-
في حال تم ضبط ذاكرة التخزين المؤقت، ستربط ذاكرة التخزين المؤقت للمستودع الملف بشكلٍ ثابت في حال حدوث نتيجة لذاكرة تخزين مؤقت، بدلاً من نسخها. والغرض من ذلك هو توفير مساحة على القرص.
العلامات: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"-
إذا تم ضبط هذه السياسة على "صحيح"، سيتم دمج رسم بياني منشِئ &'عامل>'؛ أي أنه سيتم دمج العُقد المتماثلة طوبولوجيا معًا وربط تصنيفاتها. ينطبق هذا الخيار على --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'؛ عليك أيضًا تحديد الخيار --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""-
تحقّق من توافق إصدار 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>
استخدامات متعددة - لإلغاء مستودع في دليل محلي.
- الخيارات التي تتحكّم في تنفيذ الإصدار:
--[no]experimental_inprocess_symlink_creation
التلقائي: "false;quot;-
تحديد ما إذا كان سيتم إجراء طلبات مباشرة لنظام الملفات لإنشاء أشجار رمزية
العلامات: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
-
يمكنك استخدام العناصر المشتركة للواجهة إذا كانت متوافقة مع سلسلة الأدوات. تتيح جميع سلاسل أدوات 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_runfile_links
التلقائي: "true;true"-
في حال ضبط هذه السياسة على "صحيح"، أنشِئ مجموعات رمزية للملفات القابلة للتنفيذ لجميع الاستهدافات. وفي حال ضبطها على "خطأ"، يُرجى كتابة البيانات فقط عند الإمكان.
العلامات: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 لإعداد خطوات تجميع الخطوات التي تستهدف بُنى الأجهزة. وتكون القيم بالشكل التالي: وفي حال توفّر هذا الوضع، يتم تطبيق وضع الرمز البريدي على هذه المنصة تحديدًا، وفي حال حذفه، يتم تطبيقه على جميع الأنظمة الأساسية. يجب أن يكون الوضع '؛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
-
في حال كان هذا صحيحًا، ستتم مشاركة المكتبات الأصلية التي تتضمّن وظائف متطابقة بين الأهداف المختلفة.
العلامات:loading_and_analysis
وaffects_outputs
--[no]stamp
التلقائي: "false;quot;-
استخدِم الطوابع الثنائية بالتاريخ، واسم المستخدم، واسم المضيف، ومعلومات مساحة العمل، وما إلى ذلك.
العلامات:affects_outputs
--strip=<always, sometimes or never>
التلقائي: "أحيانًا"-
يحدد ما إذا كان سيتم إزالة البرامج الثنائية والمكتبات المشتركة (باستخدام "-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""-
ما لم يتم إيقاف السياسة، تتحقّق تلك المعلّمة من أن الاستهداف في 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'؛ يمكنك الحصول على قائمة بالأجهزة من خلال تشغيل '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"-
إذا تم ضبط هذه السياسة على"صحيح"، سيتم دمج رسم بياني منشِئ &'عامل>'؛ أي أنه سيتم دمج العُقد المتماثلة طوبولوجيا معًا وربط تصنيفاتها. ينطبق هذا الخيار على --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'؛ عليك أيضًا تحديد الخيار --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'، بينما ستظهر الأهداف المُنشَأة في 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 أي نتائج اختبار في ذاكرة التخزين