שורת פקודה

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]

כברירת מחדל, האפשרויות של שלושה דברים מוגדרות באופן אוטומטי, וניתן להפעיל אותן באופן הבא:

--<option>=[true|yes|1]
או משביתים אותן באופן הבא:
--no<option>
--<option>=[false|no|0]

פקודות

analyze-profile ניתוח נתוני פרופיל build.
aquery מנתח את היעדים הנתונים ושולח שאילתות לגבי תרשים הפעולות.
build יצירת היעדים שצוינו.
canonicalize-flags קביעת שורה של אפשרויות בזלת.
clean מסיר קובצי פלט ואופציונלי גם מפסיק את השרת.
coverage הסקריפט הזה יוצר דוח כיסוי קוד עבור יעדי בדיקה ספציפיים.
cquery טוען, מנתח ושולח שאילתות לגבי היעדים שצוינו עם התצורות.
dump Dump של המצב הפנימי של תהליך שרת הבסיס.
fetch מאחזר מאגרים חיצוניים שהם דרישות מוקדמות ליעדים.
help תוכלו להדפיס תוכן עם פקודות או אינדקס.
info מוצגים פרטי זמן ריצה על שרת הבסיס.
license מדפיס את רישיון התוכנה.
mobile-install התקנת יעדים למכשירים ניידים.
modquery שליחת שאילתות בתרשים התרשים החיצוני של Bzlmod
print_action מדפיס את זרועות שורת הפקודה כדי להרכיב קובץ.
query הפעלת שאילתת תרשים תלות.
run מריץ את היעד שצוין.
shutdown מפסיק את שרת ה-Bazel.
sync סינכרון של כל המאגרים שצוינו בקובץ סביבת העבודה
test יוצר ומפעיל את יעדי הבדיקה שצוינו.
version הדפסת פרטי הגרסה של bazel.

אפשרויות להפעלה

אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
ברירת מחדל של --[no]autodetect_server_javabase: "true"
כשמעבירים -noautodetect_server_Javabase, Bazel לא נוטש ל-JDK המקומי כדי להפעיל את שרת ה-Bazel ויוצא מהמסוף.
תגים: affects_outputs, loses_incremental_state
ברירת מחדל של --[no]batch: "false"
אם המדיניות מוגדרת, Bazel יפעל כתהליך לקוח ללא שרת, במקום במצב לקוח/שרת רגיל. האפשרות הזו הוצאה משימוש ותוסר, אם אתם רוצים למנוע שרתים ממשיכים, כדאי לסגור את השרת באופן מפורש.
תגים: loses_incremental_state, bazel_internal_configuration, deprecated
ברירת מחדל של --[no]batch_cpu_scheduling: "false"
רק ב-Linux; שימוש ב 'batch' תזמון CPU for Blaze. המדיניות הזו שימושית לעומסי עבודה (workloads) לא אינטראקטיביים, אבל הם לא רוצים להפחית את הערך הנחמד שלהם. 'man 2 sche_setscheduler'. אם הערך הוא False, מערכת Bazel לא תבצע קריאה למערכת.
תגים: host_machine_resource_optimizations
ברירת מחדל של --bazelrc=<path>: תיאור
המיקום של קובץ ה- .bazelrc שכולל את ערכי ברירת המחדל של אפשרויות Bazel. /dev/null יתעלם מכל תבנית נוספת מסוג ' --bazelrc' , שמועילה להשבתה של חיפוש קובץ rc של משתמש. למשל ב-build של גרסה. ניתן לציין אפשרות זו גם מספר פעמים. למשל, אם קוראים את `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`, 1) מתבצעת קריאה ל-x.rc ול-y.rc. 2) המערכת מתעלמת מ-z.rc עקב הגרסה הקודמת: /dev/null. אם לא צוין דבר, Bazel משתמשת בקובץ .bazelrc הראשון שהיא מוצאת בשני המיקומים הבאים: ספריית סביבת העבודה ולאחר מכן בספריית הבית של המשתמש. הערה: האפשרויות בשורת הפקודה תמיד יחליפו כל אפשרות ב-bazelrc.
תגים: changes_inputs
ברירת מחדל של --[no]block_for_lock: "true"
כשמעבירים את -noblock_for_lock, מערכת Bazel לא מחכה לפקודה שמסתיימת, אלא כשהיא יוצאת באופן מיידי.
תגים: eagerness_to_exit
ברירת מחדל של --[no]client_debug: "false"
אם הערך מוגדר נכון, יש לרשום את פרטי ניפוי הבאגים מהלקוח ל-stderr. שינוי האפשרות הזו לא יגרום להפעלה מחדש של השרת.
תגים: affects_outputs, bazel_monitoring
ברירת מחדל של --connect_timeout_secs=<an integer>: "30"
משך הזמן שהלקוח ממתין לכל ניסיון להתחבר לשרת
תגים: bazel_internal_configuration
ברירת מחדל של --[no]expand_configs_in_place: "true"
השינוי של סימון -config מוגדר כך שלא ישתנה בהרחבה של נקודה קבועה בין אפשרויות rc רגילות לבין אפשרויות שצוינו בשורת הפקודה.
תגים: no_op, deprecated
ברירת מחדל של --failure_detail_out=<path>: תיאור
אם המדיניות מוגדרת, היא מציינת מיקום לכתיבה של הודעת Protobuf שנכשלו, אם השרת חווה כשל ולא יכול לדווח עליו באמצעות gRPC, כרגיל. אחרת, המיקום יהיה ${OUTPUT_base}/failure_detail.rawproto.
תגים: affects_outputs, loses_incremental_state
ברירת מחדל של --[no]home_rc: "true"
אם אין לך צורך לחפש את קובץ ה-Bazelrc בכתובת $HOME/.bazelrc
תגים: changes_inputs
ברירת מחדל של --[no]idle_server_tasks: "true"
הפעלת System.gc() כאשר השרת לא פעיל
תגים: loses_incremental_state, host_machine_resource_optimizations
ברירת מחדל של --[no]ignore_all_rc_files: "false"
משביתים את כל קובצי ה-rc, ללא קשר לערכים של סימונים אחרים שמשנים את תוכן ה-rc, גם אם הסימונים האלה מופיעים מאוחר יותר ברשימת אפשרויות האתחול.
תגים: changes_inputs
ברירת מחדל של --io_nice_level={-1,0,1,2,3,4,5,6,7}: "-1"
רק ב-Linux. ניתן להגדיר רמה בין 0 ל-7 לתזמון IO שעושה את התוצאות הטובות ביותר באמצעות קריאת המערכת 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"
קביעת רמת השירות של QoS של שרת הבסיס בעת הפעלה ב-macOS. הסימון הזה לא משפיע על כל הפלטפורמות האחרות, אבל הוא נתמך כדי לוודא שאפשר לשתף קובצי rc ביניהם ללא שינויים. הערכים האפשריים הם: אינטראקציית משתמש, ביוזמת המשתמש, ברירת מחדל, כלי עזר ורקע.
תגים: host_machine_resource_optimizations
ברירת מחדל של --max_idle_secs=<integer>: "10800"
מספר השניות ששרת ה-build ימתין ללא פעילות לפני הכיבוי. אפס פירושו שהשרת לא ייכבה אף פעם. האפשרות הזו נקראה רק בזמן ההפעלה של השרת. שינוי האפשרות הזו לא יגרום להפעלה מחדש של השרת.
תגים: eagerness_to_exit, loses_incremental_state
ברירת מחדל של --output_base=<path>: תיאור
אם היא מוגדרת, המדיניות מציינת את מיקום הפלט שאליו נכתב כל פלט המודל. אחרת, המיקום יהיה ${OUTPUT_ROOT}/_blze_${USER}/${MD5_OF_WORKSPACE_ROOT}. הערה: אם מציינים אפשרות אחרת מהפעלה אחת של Bazel לערך הזה, סביר להניח שתפתחו שרת Bazel חדש. Bazel מפעיל שרת אחד בלבד לכל בסיס פלט שצוין. בדרך כלל יש בסיס פלט אחד לכל סביבת עבודה. עם זאת, כשבוחרים באפשרות הזו, יכולים להיות מספר בסיסים של פלט לכל סביבת עבודה, ובכך להפעיל כמה גרסאות build עבור אותו לקוח בו-זמנית באותו מכונה. הוראות: #&39;bazel עזרה בהשבתה' איך לסגור שרת Bazel.
תגים: affects_outputs, loses_incremental_state
ברירת מחדל של --output_user_root=<path>: תיאור
הספרייה הספציפית למשתמש מתחתיה נכתבת כל פלטת ה-build; כברירת מחדל, זו פונקציה של $USER, אבל על ידי ציון קבוע, ניתן לשתף פלטי build בין משתמשים שמשתפים פעולה.
תגים: affects_outputs, loses_incremental_state
ברירת מחדל של --[no]preemptible: "false"
אם הערך הוא True, ניתן למנוע את הפעלת הפקודה אם פקודה אחרת מתחילה.
תגים: eagerness_to_exit
ברירת מחדל של --server_jvm_out=<path>: תיאור
המיקום שבו כותבים את הפלט של השרת ב-JVM&#39. אם המדיניות לא מוגדרת, ברירת המחדל היא מיקום ב-פלט_בסיס.
תגים: affects_outputs, loses_incremental_state
ברירת מחדל של --[no]shutdown_on_low_sys_mem: "false"
אם ה-max_idle_secs מוגדר ושרת ה-build לא היה פעיל למשך זמן מה, יש לכבות את השרת כשהמערכת חלשה ב-RAM בחינם. ב-Linux בלבד.
תגים: eagerness_to_exit, loses_incremental_state
ברירת מחדל של --[no]system_rc: "true"
אפשר לחפש את הבזאר בכל המערכת.
תגים: changes_inputs
ברירת מחדל של --[no]unlimit_coredumps: "false"
מגדילה את המגבלה של Coredump הרך עד למגבלה הקשיחה כדי לאפשר עיבוד ליבה של השרת (כולל JVM) והלקוח, בתנאים משותפים. סמנו את הדגל הזה בבזאר פעם אחת ושכחו אותו כך שתוכלו לקבל טריגרים כאשר תיתקלו במצב שמפעיל אותם.
תגים: bazel_internal_configuration
ברירת מחדל של --[no]watchfs: "false"
אם הערך true, Bazel מנסה להשתמש בשירות הצפייה בקבצים של מערכת ההפעלה עבור שינויים מקומיים במקום לסרוק כל קובץ לשינוי.
תגים: deprecated
אם הקישור נכון, המערכת תיצור קישורים סימבוליים אמיתיים ב-Windows במקום להעתיק את הקובץ. כדי להפעיל את מצב 'מפתח' של Windows, יש להפעיל את Windows 10 בגרסה 1703 ומעלה.
תגים: bazel_internal_configuration
ברירת מחדל של --[no]workspace_rc: "true"
האם לחפש את קובץ ה-Bazelrc של Workspace? או לא, בכתובת $workspace/.bazelrc
תגים: changes_inputs
אפשרויות שונות, לא נכללות בקטגוריה אחרת
נצברו --host_jvm_args=<jvm_arg> שימושים מרובים
סימונים שצריך להעביר ל-JVM שמפעיל את Blaze.
--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>: ""
אפשרות נוחות להוסיף מספר התרעות סטארט-אפ ספציפיות לפרופילי ניפוי באגים או ניפוי באגים. ל-Bazel יש רשימה של ערכים ידועים שהיא ממפה להתרעות אתחול ב-JVM בתוך הקוד, ויכול להיות שהם מחפשים נתיבים בתוך הקוד שנמצאים בהם קבצים מסוימים.
ברירת מחדל של --server_javabase=<jvm path>: ""
נתיב אל ה-JVM המשמש לביצוע Bazel עצמו.

אפשרויות נפוצות לכל הפקודות

אפשרויות השולטות בביצוע גרסת build:
ברירת מחדל של --experimental_oom_more_eagerly_threshold=<an integer>: "100"
אם הדגל הזה מוגדר כערך נמוך מ-100, Bazel תהיה OOM אם, לאחר שני אחוזים מלאים של GC&#39, עדיין יהיה תפוס של יותר מהאחוז הזה של הערימה (דור קודם).
תגים: 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"
אם המדיניות מושבתת, שגיאות חשיפה ב-Bzl בהצהרות load() יורדות לאזהרות.
תגים: build_file_semantics
האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי .bzl או קובצי WORKSPACE.:
ברירת מחדל של --[no]enable_bzlmod: "false"
אם המדיניות מקבלת את הערך True, המדיניות מאפשרת למערכת ניהול התלות של Bzlmod לקבל עדיפות על פני WORKSPACE. מידע נוסף זמין בכתובת https://bazel.build/docs/bzlmod.
תגים: loading_and_analysis
ברירת מחדל של --[no]experimental_action_resource_set: "true"
אם המדיניות מוגדרת כ-True, הפרמטרים ctx.actions.run() ו-ctx.actions.run_shell() מקבלים פרמטר פרמטר_של משאב לביצוע מקומי. אחרת, ברירת המחדל היא 250MB לזיכרון ומעבד אחד.
תגים: execution, build_file_semantics, experimental
ברירת מחדל של --[no]experimental_allow_tags_propagation: "false"
אם מוגדר כ-true, התגים יופצו מיעד לפעולות' דרישות ביצוע; אחרת התגים לא יופצו. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/8830.
תגים: build_file_semantics, experimental
ברירת מחדל של --[no]experimental_analysis_test_call: "true"
אם המדיניות מוגדרת כ-True, זמינה שיחה מקורית מסוג Analysis_test.
תגים: loading_and_analysis, build_file_semantics, experimental
ברירת מחדל של --[no]experimental_bzl_visibility: "true"
כשהאפשרות הזו מופעלת, המערכת משתמשת בפונקציה 'visible()' שקובצי .bzl עשויים לקרוא לה במהלך ההערכה ברמה העליונה כדי להגדיר את החשיפה שלהם למטרות אמירות מסוג load() .
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_cc_shared_library: "false"
אם המדיניות מוגדרת כ-True, מאפייני הכללים ושיטות ה-API של Starlark יהיו זמינים עבור הכלל cc_shared_library
תגים: build_file_semantics, loading_and_analysis , experimental
ברירת מחדל של --[no]experimental_disable_external_package: "false"
אם המדיניות מוגדרת כ-True, החבילה החיצונית //חיצונית שנוצרה באופן אוטומטי לא תהיה זמינה יותר. מאחר ש-Bazel עדיין לא יכולה לנתח את הקובץ 'external/BUILD', אבל כדורי הארץ יגיעו לחיצוני/ מהחבילה ללא שם יפעלו.
תגים: loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --[no]experimental_enable_android_migration_apis: "false"
אם המדיניות מוגדרת כ-True, ממשקי ה-API הנדרשים תומכים במיגרציה של Android Starlark.
תגים: build_file_semantics
ברירת מחדל של --[no]experimental_get_fixed_configured_action_env: "false"
אם האפשרות מופעלת, הערך action.env יחזיר גם משתני סביבה קבועים שצוינו באמצעות הגדרת תכונות.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_google_legacy_api: "false"
אם המדיניות מוגדרת כ-True, תהיה לך אפשרות לראות כמה קטעי קוד ניסיוניים של Starlark Build API שקשורים לקוד מדור קודם של Google.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_lazy_template_expansion: "true"
אם המדיניות מוגדרת כ-True, ctx.actions.expand_template() מקבל פרמטרtemplateDict עבור הערכה מעוכבת של ערכי החלפה.
תגים: execution, build_file_semantics, experimental
ברירת מחדל של --[no]experimental_platforms_api: "false"
אם המדיניות מוגדרת כ-True, היא מאפשרת להשתמש בכמה ממשקי API של Starlark שקשורים לפלטפורמה לניפוי באגים.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_repo_remote_exec: "false"
אם המדיניות מוגדרת כ-TRUE, יש ל-Database_rule כמה יכולות ביצוע מרחוק.
תגים: build_file_semantics, loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_sibling_repository_layout: "false"
אם היא מוגדרת כ-true, מאגרים שאינם ראשיים נטועים כקישורים מקושרים למאגר הראשי בבסיס הביצוע. כלומר, כל המאגרים הם ילדים ישירים של הספרייה $פלט_בסיס/פועלים. התוצאה היא הסרה של $פלט_בסיס/execution_root/__main__/external עבור הספרייה ברמה העליונה בפועל 'external'.
תגים: action_command_lines, bazel_internal_configuration, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --[no]incompatible_always_check_depset_elements: "true"
יש לבדוק את החוקיות של אלמנטים שנוספו למאגרים, בכל המבנים. האלמנטים חייבים להיות בלתי משתנים, אבל בעבר בנאי ה-depset(direct=...) שכח לבדוק אותם. אפשר להשתמש בפינגלים במקום ברשימות ברכיבי המאגר. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/10313.
תגים: build_file_semantics, incompatible_change
כשהאפשרות מוגדרת כ-Bazel כבר לא מחזירה רשימה מהכתובת link_context.library_to_link, אבל במקום זאת היא מחזירה פונקציה.
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_disable_starlark_host_transitions: "false"
אם היא מוגדרת כ-true, מאפייני הכלל לא יכולים להגדיר 'cfg = "host"'. במקום זאת, הכללים צריכים להגדיר את #&33;cfg = "exec"'
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_disable_target_provider_fields: "false"
אם היא מוגדרת כ-True, משביתים את היכולת לגשת לספקים באובייקטים '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"
אם היא מוגדרת כ-True, ערך ברירת המחדל של הארגומנט 'allow_blank' של glob() הוא False.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_disallow_legacy_javainfo: "true"
הוצא משימוש. לא.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_disallow_struct_provider_syntax: "false"
אם היא מוגדרת כ-True, ייתכן שפונקציות ההטמעה של הכלל לא יחזירו מבנה. במקום זאת, הם צריכים להחזיר רשימה של מופעים של ספקים.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_existing_rules_immutable_view: "true"
אם היא מוגדרת כ-True, המדיניות המקומית.existing_rule ו-native.existing_rules מחזירות אובייקטי תצוגה פשוטים שאינם משתנים, במקום הכתבה הניתנת לשינוי.
תגים: build_file_semantics, loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_fix_package_group_reporoot_syntax: "true"
במאפיין 'חבילות' של package_group' משנה את המשמעות של הערך "//..." כדי להפנות לכל החבילות במאגר הנוכחי, במקום את כל החבילות בכל מאגר. ניתן להשתמש בערך המיוחד "public" במקום "//..." כדי לקבל את ההתנהגות הישנה. סימון זה דורש הפעלה של --incompatible_package_group_has_public_yntax.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_java_common_parameters: "true"
אם המדיניות מוגדרת כ-True, יוסרו הפרמטרים 'פלט_פלט' ו'מארח_Javabase' ב-pack_sources ו-host_Javabase.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_new_actions_api: "true"
אם המדיניות מוגדרת כ-True, ה-API ליצירת פעולות זמין רק ב-'ctx.actions', לא ב-'ctx'.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_no_attr_license: "true"
אם היא מוגדרת כ-True, משביתה את הפונקציה 'attr.license'.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_no_implicit_file_export: "false"
אם קובצי המקור מוגדרים, הם משמשים כפרטיים, אלא אם מייצאים אותם באופן מפורש. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visible.md
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_no_rule_outputs_param: "false"
אם היא מוגדרת כ-True, משביתה את הפרמטר `פלטים` בפונקציה `rule(` Starlark.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_package_group_has_public_syntax: "true"
במאפיין 'packages' של package_group&, מאפשר לכתוב "public" או "private" כדי לציין את כל החבילות או אין חבילות בהתאמה.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_require_linker_input_cc_api: "true"
אם המדיניות מוגדרת כ-True, הכלל Create_linking_context יחייב את linker_inputs במקום ספריות_to_link. גם הקישורים הישנים של link_context יושבתו, ו-linker_inputs יהיה זמין רק.
תגים: build_file_semantics, loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_run_shell_command_string: "true"
אם היא מוגדרת כ-true, פרמטר הפקודה של actions.run_shell יקבל רק מחרוזת
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_stop_exporting_language_modules: "false"
אם האפשרות הזו מופעלת, מודולים ספציפיים לשפה (למשל 'cc_common') לא זמינים בקובצי .bzl של משתמשים, וניתן להפעיל אותם רק ממאגרי הכללים הרלוונטיים.
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_struct_has_no_methods: "false"
השבתה של השיטות to_proto ו-to_proto של מבנה, שמזהרות את מרחב השמות של המבנה. במקום זאת, יש להשתמש ב-json.encode או ב-json.encode_indent עבור JSON, או ב-proto.encode_text עבור textproto.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_top_level_aspects_require_providers: "false"
אם המדיניות מוגדרת כ-True, הספקים מהרמה העליונה יכבדו את הספקים הנדרשים ויפעלו רק ביעדים ברמה העליונה שהכללים שלהם&#39. הספקים שמתפרסמים עומדים בדרישות של הספקים הרלוונטיים.
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_unambiguous_label_stringification: "true"
כשהאפשרות מוגדרת ב-Ballel, המחרוזת של @//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"
כשהאפשרות מוגדרת כ-TRUE, 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"
אם המדיניות מוגדרת כ-True, מתבצעת בדיקה לגבי החשיפה של מאפייני כלל פרטי לגבי הגדרת הכלל, ולא לגבי השימוש בכלל.
תגים: 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
אפשרויות שגורמות לאופטימיזציה של זמן ה-build:
ברירת מחדל של --[no]incompatible_do_not_split_linking_cmdline: "true"
כשנכון, Bazel לא משנה יותר סימונים של שורת פקודה שמשמשים לקישור, וגם לא קובעת באופן סלקטיבי אילו סימונים מועברים לקובץ הפרמטר, ואילו לא. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/7670.
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]keep_state_after_build: "true"
אם הערך הוא False, Blaze ימחק את מצב הזיכרון מה-build הזה כשה-build יסתיים. לגרסאות ה-build הבאות לא יהיו צבירה ביחס לזה.
תגים: loses_incremental_state
--skyframe_high_water_mark_threshold=<an integer> כברירת מחדל: "85"
סימון לצורך הגדרה מתקדמת של מנוע Skyframe הפנימי של Bazel&33. אם תזוהה ב-Bazel שהשימוש באחוז הערימה המאוחסן שלו הוא לפחות הסף הזה, מצב ה-Skyframe הזמני לא יהיה נחוץ יותר. השינוי הזה עשוי לאפשר לכם לצמצם את ההשפעה של רצועת הקירות על הקירות (GC) כאשר, מה שגורם לטריגר של GC הוא (i) שגורם לשימוש בזיכרון במצב זמני זה, וגם (ii) יקר יותר מיצירת המדינה כשיש צורך.
תגים: host_machine_resource_optimizations
ברירת מחדל של --[no]track_incremental_state: "true"
אם המדיניות מוגדרת כ-False, ב-Blaze לא יישמרו נתונים שמאפשרים לבטל את התוקף שלה ולבצע הערכה מחדש של גרסאות build מצטברות, כדי לחסוך בזיכרון של גרסת ה-build הזו. לגרסאות ה-build הבאות לא יהיו צבירה ביחס לזה. בדרך כלל כדאי לציין - אצווה כאשר מגדירים אותה כ-False.
תגים: loses_incremental_state
אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום:
ברירת מחדל של --[no]announce_rc: "false"
האם יש אפשרות להודיע על אפשרויות RC.
תגים: affects_outputs
ברירת מחדל של --[no]attempt_to_print_relative_paths: "false"
כשמדפיסים את חלק המיקום של הודעות, נסו להשתמש בנתיב ביחס לספריית סביבת העבודה או לאחת מהספריות שצוינו על ידי --package_path.
תגים: terminal_output
ברירת מחדל של --bes_backend=<a string>: ""
ההגדרה קובעת את נקודת הקצה העורפי של שירות Build (BES) בפורמט [SCHEME://]HOST[:PORT]. ברירת המחדל היא להשבית את ההעלאות של BES. סכימות נתמכות הן grpc ו-grpcs (GRPC עם TLS מופעל). אם לא סופקה סכימה, Bazel מניחה שהיא GRPs.
תגים: affects_outputs
ברירת מחדל של --[no]bes_check_preceding_lifecycle_events: "false"
מגדירים את השדהcheck_precering_lifecycle_events_present ב-PublishBuildToolEventStreamRequest שמבקשים מ-BES לבדוק אם הוא קיבל בעבר אירועי InvocationAttemptStarted ו-BuildEnqueued שתואמים לאירוע הנוכחי בכלי.
תגים: affects_outputs
נצברו --bes_header=<a 'name=value' assignment> שימושים מרובים
יש לציין כותרת בטופס NAME=VALUE שתיכלל בבקשות BES. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
תגים: affects_outputs
ברירת מחדל של --bes_instance_name=<a string>: תיאור
ההגדרה קובעת את שם המופע שבו BES ימשיך להיות מועלה. ברירת המחדל היא null.
תגים: affects_outputs
נצברו --bes_keywords=<comma-separated list of options> שימושים מרובים
ציון רשימה של מילות מפתח להתראות שיתווספו אל ברירת המחדל של קבוצת מילות המפתח שפורסמו ב-BES ("command_name=<command_name> ", "protocol_name=BEP"). ברירת המחדל היא 'ללא'.
תגים: affects_outputs
ברירת מחדל של --[no]bes_lifecycle_events: "true"
ההגדרה קובעת אם לפרסם אירועים במחזור החיים של BES. (ברירת המחדל היא 'true').
תגים: affects_outputs
ברירת מחדל של --bes_oom_finish_upload_timeout=<An immutable length of time.>: "10m"
קביעת משך הזמן לשמירת הבסיס של BES/BEP בזמן OOMing. הסימון הזה מבטיח שסגירה של ה-JVM חמורה מאוד על ידי GC ולא ניתן להתקדם בשרשור כלשהו של משתמשים.
תגים: bazel_monitoring
ברירת מחדל של --bes_outerr_buffer_size=<an integer>: "10240"
ההגדרה קובעת את הגודל המקסימלי של stdout או std כדי לאחסן במאגר נתונים זמני ב-BEP, לפני שמדווחים עליו כאירוע התקדמות. כתיבה של הודעות אישיות עדיין מדווחת באירוע יחיד, גם אם הערך גדול מהערך שצוין עד -bes_outerr_chunk_size.
תגים: affects_outputs
ברירת מחדל של --bes_outerr_chunk_size=<an integer>: "1048576"
ההגדרה מציינת את הגודל המקסימלי של stdout או stderr לשליחה ל-BEP בהודעה אחת.
תגים: affects_outputs
ברירת מחדל של --bes_proxy=<a string>: תיאור
מתחברים לשירות Build של אירועים דרך שרת proxy. כרגע אפשר להשתמש בסימון הזה רק כדי להגדיר שקע דומיין (Unix:/path/to/socket) ב-Unix:
ברירת מחדל של --bes_results_url=<a string>: ""
ההגדרה קובעת את כתובת ה-URL הבסיסית שבה המשתמש יכול להציג את המידע שמשודר בקצה העורפי של BES. Bazel תייצר פלט של כתובת ה-URL המצורפת למסוף ההפעלה.
תגים: terminal_output
ברירת מחדל של --bes_timeout=<An immutable length of time.>: "0s"
ההגדרה מציינת את משך הזמן הנדרש להוספה של BES/BEP לאחר סיום הבנייה והבדיקות. זמן קצוב לתפוגה חוקי הוא מספר טבעי ואחריו יחידה: ימים (d), שעות (h), דקות (m), שניות (s) ואלפיות שנייה (אלפיות השנייה). ערך ברירת המחדל הוא '0' כלומר, אין זמן קצוב לתפוגה.
תגים: affects_outputs
ברירת מחדל של --build_event_binary_file=<a string>: ""
אם הקובץ לא ריק, כותבים ייצוג בינארי של ערכים מופרדים בקובץ ה-build של הפרוטוקול ב-build. המשמעות של האפשרות הזו היא --bes_upload_mode=Pending_for_upload_complete.
תגים: affects_outputs
ברירת מחדל של --[no]build_event_binary_file_path_conversion: "true"
אפשר להמיר מסלולים בייצוג הקובץ הבינארי של פרוטוקול האירוע Build ל-URI חוקי יותר ברחבי העולם. כשהאפשרות מושבתת, סכמת file:// URI תמיד תשמש
תגים: affects_outputs
ברירת מחדל של --build_event_json_file=<a string>: ""
אם הקובץ לא ריק, צריך לכתוב סידור של JSON בפרוטוקול פרוטוקול build של הקובץ.
תגים: affects_outputs
ברירת מחדל של --[no]build_event_json_file_path_conversion: "true"
כשאפשר, המרת נתיבים בייצוג קובץ json של פרוטוקול build build ל-URI חוקי יותר בעולם. אם משביתים את הסכימה, הסכימה של file:// URI תמיד תשמש
תגים: affects_outputs
ברירת מחדל של --build_event_max_named_set_of_file_entries=<an integer>: "-1"
המספר המקסימלי של רשומות לאירוע בודד בשם name_set_of_files; המערכת מתעלמת מערכים קטנים מ-2 ולא מתבצעת פיצול אירועים. היא מיועדת להגביל את גודל האירוע המקסימלי בפרוטוקול אירוע build, אם כי אין לה שליטה ישירה על גודל האירוע. הגודל הכולל של האירועים הוא פונקציה של מבנה הקבוצה ואורך הקבצים ו-URI, שעשויים להשתנות בהתאם לפונקציית הגיבוב.
תגים: affects_outputs
ברירת מחדל של --[no]build_event_publish_all_actions: "false"
אם צריך לפרסם את כל הפעולות.
תגים: affects_outputs
ברירת מחדל של --build_event_text_file=<a string>: ""
אם הקובץ לא ריק, כותבים ייצוג טקסטואלי של פרוטוקול האירוע build בקובץ הזה
תגים: affects_outputs
ברירת מחדל של --[no]build_event_text_file_path_conversion: "true"
כשהדבר אפשרי, אפשר להמיר נתיבים בייצוג קובץ הטקסט של פרוטוקול build של URI ל ועם מזהי URI חוקיים יותר בכל העולם. אם המדיניות מושבתת, תמיד ייעשה שימוש בסכימת ה-file:// URI
תגים: affects_outputs
ברירת מחדל של --[no]experimental_announce_profile_path: "false"
אם המדיניות מופעלת, המדיניות מוסיפה ליומן את נתיב פרופיל ה-JSON.
תגים: affects_outputs, bazel_monitoring
ברירת מחדל של --[no]experimental_bep_target_summary: "false"
אם רוצים לפרסם אירועי סיכום סיכום.
ברירת מחדל של --[no]experimental_build_event_expand_filesets: "false"
אם הערך הוא TRUE, מרחיבים את FilesApps ב-BEP כשמציגים קובצי פלט.
תגים: affects_outputs
אם הערך הוא True, יש לפתור בצורה מלאה את סמלי הקישור היחסיים של Fileset ב-BEP כשמציגים קובצי פלט. נדרשת -experimental_build_event_expand_filesets.
תגים: affects_outputs
ברירת מחדל של --experimental_build_event_upload_max_retries=<an integer>: "4"
מספר הפעמים המקסימלי שחברת Bazel מנסה להעלות אירוע build.
תגים: bazel_internal_configuration
ברירת מחדל של --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1s"
השהיה מינימלית עד לעיכוב מעריכי של ניסיונות חוזרים כאשר העלאה של BEP נכשלה. (מעריך: 1.6)
תגים: bazel_internal_configuration
ברירת מחדל של --experimental_build_event_upload_strategy=<a string>: תיאור
בחירה איך להעלות פריטי מידע שנוצרים בתהליך פיתוח (Artifact) המוזכרים בפרוטוקול של אירוע ה-build.
תגים: 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"
כולל את המאפיין הנוסף "out" באירועי הפעולה, שמכיל את נתיב ה-exe אל הפלט הראשי של הפעולה.
תגים: affects_outputs, bazel_monitoring
ברירת מחדל של --[no]experimental_profile_include_target_label: "false"
כוללת תווית יעד באירועי פעולה' נתוני פרופיל JSON.
תגים: affects_outputs, bazel_monitoring
ברירת מחדל של --[no]experimental_stream_log_file_uploads: "false"
אפשר להעביר העלאות של קובצי יומן ישירות לאחסון המרוחק, במקום לכתוב אותם בדיסק.
תגים: affects_outputs
ברירת מחדל של --experimental_workspace_rules_log_file=<a path>: תיאור
אפשר לתעד אירועים מסוימים של כללי Workspace בקובץ הזה כפרמטרים מופרדים של WorkspaceEvent.
ברירת מחדל של --[no]generate_json_trace_profile: "auto"
אם האפשרות מופעלת, Bazel יוצרת פרופיל build וכותבת פרופיל בפורמט JSON לקובץ בבסיס הפלט. צפייה בפרופיל על ידי טעינה אל chrome://trace. כברירת מחדל, Bazel כותבת את הפרופיל עבור כל הפקודות ושאילתות הדומות ל-build.
תגים: affects_outputs, bazel_monitoring
ברירת מחדל של --[no]heap_dump_on_oom: "false"
אם מדובר ב קובץ ה-Dump ייכתב כך: <פלט_בסיס>/<invocation_id>.heapdump.hprof. האפשרות הזו מחליפה ביעילות את -XX:+HeapDumpOnOutOfMemoryError, שלא משפיעה על מפני שאירועי OOM נתפסים ומופנה אוטומטית ל-Runtime#halt.
תגים: bazel_monitoring
ברירת מחדל של --[no]legacy_important_outputs: "true"
אפשר להשתמש בכך כדי להסתיר יצירה של שדה חשוב_פלט קודם באירוע Targetcomplete. נדרשים שילובים חשובים של Basel עד 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 לביצוע. הפרמטר השני הוא מספר השניות שיש להמתין בין מספרי GC.
תגים: bazel_monitoring
ברירת מחדל של --profile=<a path>: תיאור
אם המדיניות מוגדרת, פרופיל ב-Bazel וכתיבה של הנתונים בקובץ שצוין. כדי לנתח את הפרופיל, השתמשו בפרופיל Baz Analysis.
תגים: affects_outputs, bazel_monitoring
ברירת מחדל של --[no]slim_profile: "true"
כדי להקטין את פרופיל ה-JSON, צריך למזג אירועים אם הפרופיל גדול מדי.
תגים: affects_outputs, bazel_monitoring
ברירת מחדל של --starlark_cpu_profile=<a string>: ""
כותבים לקובץ שצוין פרופיל שימוש במעבד (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> שימושים מרובים
זוגות של מחרוזות מפתח-ערך מותאמים אישית שצריך לספק באירוע build.
תגים: terminal_output
ברירת מחדל של --color=<yes, no or auto>: "auto"
שימוש בפקדים של הטרמינל לצביעה של הפלט.
נצברו --config=<a string> שימושים מרובים
בוחרת קטעי config נוספים מקובצי ה-rc. עבור כל <command> היא גם שולפת את האפשרויות מתוך <command>:<config> אם קיים קטע כזה; אם הקטע הזה לא קיים בקובץ rc., ה-Blaze נכשל עם שגיאה. קטעי ה-config ושילובי הדגלים שהם מקבילים להם נמצאים בקובצי התצורה של כלים/*.blzerc.
ברירת מחדל של --curses=<yes, no or auto>: "auto"
יש לך אפשרות להשתמש בפקדי הסמן של הטרמינל כדי למזער את הפלט של הגלילה.
ברירת מחדל של --[no]enable_platform_specific_config: "false"
אם הערך הוא true, Bazel אוספת שורות config ספציפיות ל-OS-Bazelrc. לדוגמה, אם מערכת ההפעלה של המארח היא Linux ואתם מפעילים build של Bazel, Bazel לוקחת שורות שמתחילות ב-build:linux. מזהי ה-OS הנתמכים הם Linux , macos , Windows , Freebsd ו-openbsd. הפעלת סימון זה זהה לשימוש ב- --config=linux ב-Linux, --config=windows ב-Windows וכו'.
נצברו --experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.> שימושים מרובים
הגדרת עזרה לגבי פרטי כניסה לשימוש באחזור פרטי הכניסה של ההיקף (דומיין). פרטי כניסה מ-credentials Credentials מקבלים עדיפות על פני פרטי כניסה מ-<code>--google_default_credentials</code>, `--google_credentials` או <code>.netrc</code>. אפשר לראות אותם בכתובת https://github.com/bazelbuild/proposs22-z
ברירת מחדל של --experimental_credential_helper_cache_duration=<An immutable length of time.>: "30m"
ההגדרה קובעת את משך הזמן שבו פרטי הכניסה ששמורים ב'פרטי כניסה' יישמרו במטמון.
ברירת מחדל של --experimental_credential_helper_timeout=<An immutable length of time.>: "5s"
הגדרת הזמן הקצוב לתפוגה עבור 'פרטי הכניסה'. עוזרי הכניסה שלא יגיבו בזמן הקצוב לתפוגה ייכשלו.
ברירת מחדל של --[no]experimental_skymeld_ui: "false"
מוצגות גם התקדמות הניתוח וגם התקדמות שלב הביצוע, כששניהם פועלים בו-זמנית.
תגים: terminal_output
ברירת מחדל של --[no]experimental_windows_watchfs: "false"
אם הערך הוא true, מופעלת תמיכה ניסיונית ב-Windows עבור --watchfs. אחרת - Watchfsis is non-op ב-Windows. הקפידו להפעיל גם --watchfs.
ברירת מחדל של --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"
אם צריך להשתמש ב 'פרטי הכניסה שמוגדרים כברירת מחדל באפליקציית 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 יוצאים. אם פינגים מסוג keep-alive מופעלים באמצעות --grpc_keepalive_time, תם הזמן הקצוב (Bazel) של Bazel אם לא מתקבלת פינג אחרי פרק הזמן הזה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. אם פינגים פעילים נשארים מושבתים, המערכת מתעלמת מההגדרה הזו.
אם המדיניות מוגדרת כ-TRUE, `ctx.actions.symlink` לא יתיר קישור אוטומטי של קובץ לספרייה.
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_remove_rule_name_parameter: "true"
אם הערך הוא TRUE, לא ניתן לקרוא ל-'rule''עם הפרמטר 'name'.
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]progress_in_terminal_title: "false"
אפשר להציג את התקדמות הפקודה בכותרת הטרמינל. מועיל לראות למה ה-Bazal עושה כשיש כרטיסיות מרובות בטרמינל.
ברירת מחדל של --[no]show_progress: "true"
הצגת הודעות התקדמות במהלך ה-build.
ברירת מחדל של --show_progress_rate_limit=<a double>: "0.2"
מספר השניות המינימלי בין הודעות התקדמות בפלט.
ברירת מחדל של --[no]show_timestamps: "false"
הכללת חותמות זמן בהודעות
ברירת מחדל של --tls_certificate=<a string>: תיאור
יש לציין נתיב לאישור TLS שהוא מהימן לחתימה על אישורי שרת.
ברירת מחדל של --tls_client_certificate=<a string>: תיאור
ציון אישור הלקוח של TLS (אבטחת שכבת התעבורה) לשימוש. צריך גם לספק מפתח לקוח כדי להפעיל אימות לקוח.
ברירת מחדל של --tls_client_key=<a string>: תיאור
צריך לציין את מפתח הלקוח ב-TLS שבו רוצים להשתמש. צריך גם לספק אישור לקוח כדי להפעיל את אימות הלקוח.
ברירת מחדל של --ui_actions_shown=<an integer>: "8"
מספר הפעולות המקבילות שמוצגות בסרגל ההתקדמות המפורט. כל פעולה מוצגת בשורה נפרדת. בסרגל ההתקדמות מוצג תמיד לפחות סרגל אחד, וכל המספרים שקטנים מ-1 ממופים ל-1.
תגים: terminal_output
ברירת מחדל של --[no]watchfs: "false"
ב-Linux/macOS: אם המדיניות מוגדרת כ-TRUE, Bazel מנסה להשתמש בשירות הצפייה בקבצים של מערכת ההפעלה עבור שינויים מקומיים במקום לסרוק כל קובץ ולחפש שינוי. ב-Windows: הדגל הזה אינו פעיל כרגע, אך ניתן להפעיל אותו בשילוב עם -experimental_windows_watchfs. בכל מערכות ההפעלה: ההתנהגות לא מוגדרת אם סביבת העבודה נמצאת במערכת הקבצים של הקבצים, והעריכה מתבצעת במחשב מרוחק.

אפשרויות פרופיל לניתוח נתונים

אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
נצברו --distdir=<a path> שימושים מרובים
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים: bazel_internal_configuration
אם היא מוגדרת, המטמון של המאגר יקשר את הקובץ באופן ידני במקרה של היט מטמון, במקום העתקה. מטרת האחסון היא לחסוך מקום בכונן.
תגים: bazel_internal_configuration
ברירת מחדל של --[no]experimental_repository_cache_urls_as_default_canonical_id: "false"
אם הערך הוא TRUE, יש להשתמש במחרוזת שנגזרת מכתובות ה-URL של הורדות המאגר בתור ה-canonical_id אם לא צוין. במצב הזה, שינוי בכתובות ה-URL יוביל להורדה מחדש, גם אם המטמון מכיל הורדה עם אותו גיבוב. אפשר להשתמש בשיטה הזו כדי לאמת ששינויים בכתובת ה-URL לא גורמים להסתרה של מאגרים לא תקינים.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_repository_disable_download: "false"
אם היא מוגדרת, לא ניתן להוריד מאגרים חיצוניים.
תגים: 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 אוכפת קלטי build תקינים (הגדרות של כללים, שילובי דגל וכו'):
ברירת מחדל של --experimental_repository_hash_file=<a string>: ""
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים: affects_outputs, experimental
נצברו --experimental_verify_repository_rules=<a string> שימושים מרובים
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים: affects_outputs, experimental
האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
ברירת מחדל של --[no]experimental_allow_top_level_aspects_parameters: "true"
לא:
תגים: no_op, deprecated, experimental
אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
נצברו --allow_yanked_versions=<a string> שימושים מרובים
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים: loading_and_analysis
ברירת מחדל של --check_bazel_compatibility=<error, warning or off>: "error"
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים: loading_and_analysis
ברירת מחדל של --check_direct_dependencies=<off, warning or error>: "warning"
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים: loading_and_analysis
ברירת מחדל של --[no]ignore_dev_dependency: "false"
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-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]: תיאור
פלט פרופיל נתונים מלא בפרופיל
תגים: affects_outputs
ברירת מחדל של --[no]experimental_record_metrics_for_all_mnemonics: "false"
כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
ברירת מחדל של --experimental_resolved_file_instead_of_workspace=<a string>: ""
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים: changes_inputs
אפשרויות שמירה במטמון והפעלה:
ברירת מחדל של --experimental_downloader_config=<a string>: תיאור
מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
נצברו --override_repository=<an equals-separated mapping of repository name to path> שימושים מרובים
עוקפת מאגר עם ספרייה מקומית.

אפשרויות שאילתה

העברה בירושה את כל האפשרויות מיצירה.

אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
נצברו --distdir=<a path> שימושים מרובים
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים: bazel_internal_configuration
אם היא מוגדרת, המטמון של המאגר יקשר את הקובץ באופן ידני במקרה של היט מטמון, במקום העתקה. מטרת האחסון היא לחסוך מקום בכונן.
תגים: bazel_internal_configuration
ברירת מחדל של --[no]experimental_repository_cache_urls_as_default_canonical_id: "false"
אם הערך הוא TRUE, יש להשתמש במחרוזת שנגזרת מכתובות ה-URL של הורדות המאגר בתור ה-canonical_id אם לא צוין. במצב הזה, שינוי בכתובות ה-URL יוביל להורדה מחדש, גם אם המטמון מכיל הורדה עם אותו גיבוב. אפשר להשתמש בשיטה הזו כדי לאמת ששינויים בכתובת ה-URL לא גורמים להסתרה של מאגרים לא תקינים.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_repository_disable_download: "false"
אם היא מוגדרת, לא ניתן להוריד מאגרים חיצוניים.
תגים: 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 אוכפת קלטי build תקינים (הגדרות של כללים, שילובי דגל וכו'):
ברירת מחדל של --experimental_repository_hash_file=<a string>: ""
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים: affects_outputs, experimental
נצברו --experimental_verify_repository_rules=<a string> שימושים מרובים
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים: affects_outputs, experimental
האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
ברירת מחדל של --[no]experimental_allow_top_level_aspects_parameters: "true"
לא:
תגים: no_op, deprecated, experimental
אפשרויות הקשורות לפלט שאילתות וסמנטיקה:
ברירת מחדל של --aspect_deps=<off, conservative or precise>: "conservative"
איך לפתור בעיה של יחסי גובה-רוחב כאשר פורמט הפלט הוא בפורמט {xml,proto,record}. 'off' פירוש הדבר שלא נפתרים יחסי תלות ו'שמרני' (ברירת המחדל) מוסיפים את כל יחסי הגובה-רוחב המוצהרים, בין אם הם קיבלו את רמת התלויות הישירות ובין אם לא. חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, כך שהוא איטי יותר מהמצבים האחרים. כמו כן, אפילו מצב מדויק אינו מדויק לחלוטין: ההחלטה אם לחשב היבט מסוים נקבעת בשלב הניתוח, שאינו פועל במהלך &b3Query;'
תגים: build_file_semantics
ברירת מחדל של --[no]deduplicate_depsets: "true"
אפשר לבטל כפילויות של ילדים ללא עצים ב-dep_set_of_files בפלט הסופי (toto/textproto/json). הפעולה הזו לא מבטלת כפילויות של דיוורים שאינם משותפים הורה מיידי. המדיניות הזו לא משפיעה על הרשימה הסופית בפועל של פריטי מידע שנוצרו בתהליך פיתוח (Artifact) של הפעולות.
תגים: terminal_output
ברירת מחדל של --[no]graph:factored: "true"
אם הערך הוא True, התרשים ייקרא 'fact האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים: terminal_output
ברירת מחדל של --graph:node_limit=<an integer>: "512"
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; הערך 1- יגרום לכך שלא ייחתך. האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים: terminal_output
ברירת מחדל של --[no]implicit_deps: "true"
אם האפשרות הזאת מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלות שבו השאילתה פועלת. תלות משתמעת היא זו שלא צוינה במפורש בקובץ BUILD, אך נוספה על ידי ה-bazel. עבור שאילתה, אפשרות זו שולטת בסינון ערכות כלים שנפתרו.
תגים: build_file_semantics
ברירת מחדל של --[no]include_artifacts: "true"
כולל שמות של קלט ופלט של הפלט (גדול בפוטנציאל).
תגים: terminal_output
ברירת מחדל של --[no]include_aspects: "true"
aquery, שאילתה: האם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: no-op (מאפיינים תמיד במעקב).
תגים: terminal_output
ברירת מחדל של --[no]include_commandline: "true"
כולל את התוכן של שורות הפקודות לביצוע בפלט (גדול בפוטנציאל).
תגים: terminal_output
ברירת מחדל של --[no]include_file_write_contents: "false"
יש לכלול את תוכן הקובץ עבור הפעולות FileWrite ו-SourceSymlinkManifest (גדול בפוטנציאל).
תגים: terminal_output
ברירת מחדל של --[no]include_param_files: "false"
יש לכלול את התוכן של קובצי הפרמטרים שנעשה בהם שימוש בפקודה (פוטנציאליים). הערה: כשמפעילים את התכונה הזו, הסימון 'include_commandline' יופעל באופן אוטומטי.
תגים: terminal_output
ברירת מחדל של --[no]incompatible_display_source_file_location: "true"
True, כברירת מחדל, יוצג היעד של קובץ המקור. אם True, מציג את המיקום של שורה 1 של קובצי מקור בפלטי מיקום. הסימון הזה קיים רק למטרות העברה.
תגים: terminal_output, incompatible_change
ברירת מחדל של --[no]incompatible_package_group_includes_double_slash: "true"
אם האפשרות הזו מופעלת, בעת הפקת המאפיין 'packs' של package_group&, הסימן '//' הראשי לא יושמט.
תגים: terminal_output, incompatible_change
ברירת מחדל של --[no]infer_universe_scope: "false"
אם המדיניות set ו- לתשומת ליבכם, הערך של uniuni_scope כפי שהוסק עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, allalleps) הוא לא מה שאתם רוצים, לכן עליכם להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים ודוגמאות זמינים בכתובת https://bazel.build/reference/query#sky-query. אם --univers_scope מוגדר, המערכת מתעלמת מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'שאילתה' (כלומר, לא 'cquery').
תגים: loading_and_analysis
ברירת מחדל של --[no]line_terminator_null: "false"
אם כל פורמט יסתיים ב-\0 במקום בפורמט חדש.
תגים: terminal_output
ברירת מחדל של --[no]nodep_deps: "true"
אם המדיניות מופעלת, נקודות שפל מתוך "nodep" ייכללו בתרשים התלות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep". היא "visible". מריצים ומנתחים את הפלט של 'info Build-language' כדי ללמוד על כל המאפיינים "nodep"בשפת ה-build.
תגים: build_file_semantics
ברירת מחדל של --output=<a string>: "text"
הפורמט שבו יש להדפיס את תוצאות השאילתה. הערכים המותרים ל-query הם: text, textproto, Proto, jsonproto.
תגים: terminal_output
ברירת מחדל של --[no]proto:default_values: "true"
אם מוגדר כ-True, נכללים מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- --פלט=פרוטו
תגים: terminal_output
ברירת מחדל של --[no]proto:definition_stack: "false"
מאכלס את השדה Proto-stack, שמתעד כל מופע של כלל ה-Starstark שבו מוגדרת המחלקה בכלל.
תגים: terminal_output
ברירת מחדל של --[no]proto:flatten_selects: "true"
אם המדיניות מופעלת, מאפיינים ניתנים להגדרה שנוצרו על ידי Select() שטוחים. עבור סוגי רשימות, הייצוג השטוח הוא רשימה המכילה כל ערך של המפה שנבחרה פעם אחת בלבד. סוגי הפיגועים שטוחים איזה null.
תגים: build_file_semantics
ברירת מחדל של --[no]proto:include_synthetic_attribute_hash: "false"
אם רוצים לחשב ולאכלס את המאפיין $internal_attr_Hash.
תגים: terminal_output
ברירת מחדל של --[no]proto:instantiation_stack: "false"
אכלוס מחסנית קריאות של כל הנחיה. כדי לעשות זאת, יש צורך במקבץ סטאק
תגים: terminal_output
ברירת מחדל של --[no]proto:locations: "true"
אם בכלל, כדאי לשלוח פרטי מיקום בפלט אב.
תגים: terminal_output
ברירת מחדל של --proto:output_rule_attrs=<comma-separated list of options>: "all"
רשימת מאפיינים המופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להוציא פלט. האפשרות הזו רלוונטית ל--פלט=פרוטו.
תגים: terminal_output
ברירת מחדל של --[no]proto:rule_inputs_and_outputs: "true"
אפשר גם לאכלס את השדותכללי_קלט וכלל_פלט.
תגים: terminal_output
ברירת מחדל של --[no]relative_locations: "false"
אם הערך הוא TRUE, המיקום של קובצי BUILD ב-XML ובפלטי אב יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא יהיה עקבי בין מחשבים. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במכשירים שונים.
תגים: terminal_output
ברירת מחדל של --[no]skyframe_state: "false"
ללא צורך בניתוח נוסף, שולחים את תרשים הפעולה הנוכחי מ-Skyframe. הערה: ציון היעד באמצעות --skyframe_state אינו נתמך כרגע. הסימון הזה זמין רק באמצעות
תגים: terminal_output
ברירת מחדל של --[no]tool_deps: "true"
שאילתה: אם היא מושבתת, יחסי תלות ב-'מארח הגדרה' או 'execution' יעדים לא ייכללו בתרשים התלות שעליו פועלת השאילתה. קצה 'הגדרת תצורה למארחים' כזה מהכלל של #&39;proto_library' מפנה בדרך כלל למהדר הפרוטוקול, בדרך כלל מצביע על כלי שהופעל במהלך ה-build במקום על חלק מאותה תוכנית 'target' שאילתה: אם היא מושבתת, היא מסננת את כל היעדים שהוגדרו שחוצים מעבר של מארח או ביצוע, מהיעד שהוגדר ברמה העליונה שגילו את היעד שהוגדר. כלומר, אם היעד ברמה העליונה נמצא בתצורת היעד, יוחזרו רק יעדים שהוגדרו בתצורת היעד. אם היעד ברמה העליונה נמצא בתצורת המארח, יוחזרו רק יעדים שהוגדרו על ידי המארח. אפשרות זו לא תכלול שרשראות כלים שנפתרו.
תגים: build_file_semantics
ברירת מחדל של --universe_scope=<comma-separated list of options>: ""
קבוצה של דפוסי יעד (מופרדים באמצעות פסיקים) המופרדים בפסיקים. השאילתה עשויה להתבצע ביקום שהוגדר על ידי הסגירה העקיפה של היעדים שצוינו. האפשרות הזו משמשת לפקודות השאילתה ושאילתת השאילתה. עבור השאילתה, הקלט לאפשרות הזו הוא היעדים שבנו כל התשובות, ולכן האפשרות הזו עשויה להשפיע על התצורות והמעברים. אם אפשרות זו אינה מוגדרת, ההנחה היא שהיעדים ברמה העליונה הם היעדים המנותחים מביטוי השאילתה. הערה לגבי שאילתה: אם לא מציינים את האפשרות הזו, ייתכן שה-build לא יפעל אם לא ניתן ליצור יעדים מביטוי השאילתה עם האפשרויות ברמה העליונה.
תגים: loading_and_analysis
אפשרויות הקשורות לפלט Bzlmod וסמנטיקה:
נצברו --allow_yanked_versions=<a string> שימושים מרובים
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים: loading_and_analysis
ברירת מחדל של --check_bazel_compatibility=<error, warning or off>: "error"
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים: loading_and_analysis
ברירת מחדל של --check_direct_dependencies=<off, warning or error>: "warning"
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים: loading_and_analysis
ברירת מחדל של --[no]ignore_dev_dependency: "false"
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-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"
כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
ברירת מחדל של --experimental_resolved_file_instead_of_workspace=<a string>: ""
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים: changes_inputs
אפשרויות שמירה במטמון והפעלה:
ברירת מחדל של --experimental_downloader_config=<a string>: תיאור
מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
נצברו --override_repository=<an equals-separated mapping of repository name to path> שימושים מרובים
עוקפת מאגר עם ספרייה מקומית.
אפשרויות ששולטות בביצוע של גרסאות build:
רוצה לבצע קריאות ישירות למערכת הקבצים כדי ליצור עצים סימבוליים?
תגים: loading_and_analysis, execution, experimental
ברירת מחדל של --[no]experimental_remotable_source_manifests: "false"
האם אפשר לבצע פעולות שוטפות במניפסט המקור:
תגים: loading_and_analysis, execution, experimental
ברירת מחדל של --[no]experimental_split_coverage_postprocessing: "false"
אם הערך הוא true, Bazel תריץ עיבוד לאחר העיבוד לצורך בדיקה בתצוגה חדשה.
תגים: execution
ברירת מחדל של --[no]experimental_strict_fileset_output: "false"
אם האפשרות הזו מופעלת, קבוצות הקבצים יתייחסו לכל פריטי המידע שנוצרו בתהליך הפיתוח כקבצים רגילים. הם לא חוצה ספריות ולא יהיו רגישים לקישורים סימבוליים.
תגים: execution
ברירת מחדל של --modify_execution_info=<regex=[+-]key,regex=[+-]key,...>: ""
ניתן להוסיף או להסיר מפתחות מידע על ביצוע של פעולה על סמך הקובץ של הפעולה. רלוונטי רק לפעולות התומכות בפרטי הביצוע. פעולות נפוצות רבות תומכות בפרטי ביצוע, כמו Genrule, CppCompile, Javac, StarlarkAction, TestRunner. כשמציינים כמה ערכים, הסדר חשוב כי ביטויים רבים עשויים לחול על אותו אזכור. תחביר: "regex=[+-]key,regex=[+-]key,...". דוגמאות: '.*=+x,.*=-y,.*=+z' מוסיף את #&39;x' ו-'z' את פרטי הביצוע של #&39;y' ומסירים אותם. 'Genrule=+requires-x' add 'requires-x' לפרטי הביצוע של כל פעולות הז'אנר. '(?!Genrule).*=-requires-x' removed 'requires-x' מפרטי ההפעלה של כל הפעולות שאינן ז'אנר.
תגים: execution, affects_outputs, loading_and_analysis
--persistent_android_dex_desugar
הפעלה של עובדים ב-Android Dex ופעולות סוכר קבועות.
מתרחב אל:
--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=worker2
{1/2 --internal_persistent_busybox_tools
--persistent_multiplex_android_dex_desugar
הפעלה של עובדים עם Multiplex דק' ופעולות סוכר
מתרחב אל:
--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
הפעלה של מעבד משאבים (cast) עקבי ב-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-workers2
{1/2 --persistent_android_resource_processor
--persistent_multiplex_android_tools
הפעלת כלים עקביים ומוכפלים ב-Android (Dexs, הסרת ניפוי באגים, עיבוד משאבים).
מתרחבת אל:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar

תגים: host_machine_resource_optimizations, execution
אפשרויות שמגדירות את ה-chainch המשמש לביצוע הפעולה:
ברירת מחדל של --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>: תיאור
יעד grte_top ב-Android.
תגים: changes_inputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --android_manifest_merger=<legacy, android or force_android>: "android"
בחירת המיזוג של המניפסט לשימוש בכללי 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>: תיאור
מהדר היעד של Apple. שימושי לבחירת וריאציות של כלי עבודה (למשל: xcode-beta).
תגים: 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:coverage_report_מחולל"
המיקום של הקובץ הבינארי המשמש להפקת דוחות כיסוי. נכון לעכשיו זו צריכה להיות קבוצת קבצים הכוללת קובץ אחד, הקובץ הבינארי. ברירת המחדל היא '//tools/test:coverage_report_מחולל'.
תגים: changes_inputs, affects_outputs, loading_and_analysis
--coverage_support=<a build target label> ברירת מחדל: "@bazel_tools//tools/test:coverage_support"
המיקום של קובצי התמיכה הנדרשים על סמך הקלט של כל פעולת בדיקה שאוספת כיסוי קוד. ברירת המחדל היא '//tools/test:coverage_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>: תיאור
ההגדרה קובעת הטמעה מותאמת אישית של Malloc. ההגדרה הזו מבטלת את המאפיינים של Malאיך להשתמש בכללי build.
תגים: changes_inputs, affects_outputs
נצברו --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> שימושים מרובים
רשימה של ביטויים רגולריים המופרדים בפסיקים, שלכל אחד מהם יש קידומת (-) שלילי, מוקצית (=) לרשימה של יעדי ערך מופרדים בפסיקים. אם יעד מסוים לא תואם אף ביטוי שלילי וביטוי חיובי אחד לפחות, רזולוציית הכלים שלו תתבצע כאילו היא הצהירה על ערכי האילוץ כאילוצי ביצוע. דוגמה: //demo,-test=@platforms//cpus:x86_64 יתווסף #&39;x86_64' לכל יעד תחת //demo, מלבד אלה שהשם שלהם מכיל 'test'.
תגים: loading_and_analysis
ברירת מחדל של --[no]experimental_enable_objc_cc_deps: "true"
קבלת כללים מסוג objc_* שתלויים ב-cc_library וגורמת לקיום יחסי תלות של objc עם --cpu המוגדר כ-"ios_<--ios_cpu>" עבור כל ערך ב- --ios_multi_cpu.
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]experimental_include_xcode_execution_requirements: "false"
אם היא מוגדרת, מוסיפים את דרישת הביצוע "requires-xcode:{version}" לכל פעולת Xcode. אם גרסת ה-xcode כוללת תווית עם מקפים, צריך להוסיף גם "requires-xcode-label:{version_label}" דרישת ביצוע.
תגים: loses_incremental_state, loading_and_analysis, execution
ברירת מחדל של --[no]experimental_prefer_mutual_xcode: "true"
אם מוגדר True, יש להשתמש ב-Xcode העדכני ביותר שזמין גם מקומית וגם מרחוק. אם False, או אם אין גרסאות הדדיות זמינות, משתמשים בגרסת Xcode המקומית שנבחרה באמצעות xcode-select.
תגים: loses_incremental_state
נצברו --extra_execution_platforms=<comma-separated list of options> שימושים מרובים
הפלטפורמות הזמינות כפלטפורמות לביצוע פעולות. אפשר לציין פלטפורמות לפי יעד מדויק או כתבנית יעד. המערכת תתייחס לפלטפורמות האלה לפני אלה המוצהרות בקובץ ה-WORKSPACE על ידי sign_execution_platforms() .
תגים: execution
נצברו --extra_toolchains=<comma-separated list of options> שימושים מרובים
הכללים בנוגע לכלים של כלי עבודה שנלקחים בחשבון במהלך מציאת פתרון לכלים. ניתן לציין ערכות הכלים לפי יעד מדויק, או כתבנית יעד. חשוב לזכור את ערכות הכלים האלה לפני ההשקה שלהן בקובץ ה-WORKSPACE באמצעות record_toolchains() .
תגים: affects_outputs, changes_inputs, loading_and_analysis
ברירת מחדל של --grte_top=<a label>: תיאור
תווית לספריית ליבצ'ק שמסומנת. ערך ברירת המחדל נבחר על ידי רצועת הכלים, וכמעט אף פעם לא צריך לשנות אותו.
תגים: 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"
שימוש ברזולוציה של Toolchain כדי לבחור את ה-SDK ל-Android לכללי Android (סטארלרק ו-Native)
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_enable_apple_toolchain_resolution: "false"
שימוש ברזולוציית כלים כדי לבחור את ה-SDK של Apple לכללי התפוחים (Starlark ו-Native)
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_make_thinlto_command_lines_standalone: "true"
True
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain: "true"
אם הערך true, Bazel יתלונן כשמאפייני cc_toolchain.cpu ו-cc_toolchain.devguider מוגדרים (מידע נוסף זמין במאמר https://github.com/bazelbuild/bazel/issues/7075).
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_remove_legacy_whole_archive: "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' in to cc_common.configure_features (מידע נוסף בכתובת https://github.com/bazelbuild/bazel/issues/7793).
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]interface_shared_objects: "true"
שימוש באובייקטים משותפים בממשק אם הם נתמכים על ידי ערכת הכלים. כל שרשראות הכלים של ELF תומכות בשלב זה בהגדרה הזו.
תגים: loading_and_analysis, affects_outputs, affects_outputs
ברירת מחדל של --ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
ההגדרה קובעת את גרסת ה-SDK של iOS לפיתוח אפליקציות ל-iOS. אם לא צוין, נעשה שימוש בגרסת ברירת מחדל של iOS SDK מ-'xcode_version'.
תגים: loses_incremental_state
ברירת מחדל של --macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
ההגדרה קובעת את גרסת ה-macOS SDK שבה משתמשים כדי לבנות אפליקציות ל-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' (קובץ שנמצא מתחת לרמה הבסיסית (root) של סביבת עבודה).
תגים: 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 שבה משתמשים כדי ליצור אפליקציות TV. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של TV SDK מ-'xcode_version'.
תגים: loses_incremental_state
ברירת מחדל של --watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
ההגדרה קובעת את גרסת ה-SDK של WatchOS שבה משתמשים כדי לבנות אפליקציות שעון. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של WatchOS SDK מגרסה 'xcode_version'.
תגים: loses_incremental_state
ברירת מחדל של --xcode_version=<a string>: תיאור
אם צוין, נעשה שימוש ב-Xcode של הגרסה הנתונה לפעולות build רלוונטיות. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של הביצוע של Xcode.
תגים: loses_incremental_state
ברירת מחדל של --xcode_version_config=<a build target label>: "@bazel_tools//tools/cpp:host_xcodes"
התווית של הכלל xcode_config שיש להשתמש בה לבחירת הגרסה של Xcode בתצורת ה-build.
תגים: loses_incremental_state, loading_and_analysis
אפשרויות ששולטות בפלט של הפקודה:
ברירת מחדל של --[no]apple_enable_auto_dsym_dbg: "false"
אם צריך לאלץ יצירה של קובצי ניפוי באגים (.dSYM) עבור גרסאות build ל-dbg.
תגים: affects_outputs, action_command_lines
ברירת מחדל של --[no]apple_generate_dsym: "false"
האם ליצור קובצי ניפוי באגים ( .dSYM)?
תגים: affects_outputs, action_command_lines
אם הערך הוא true, יש ליצור יערות קישור ריצה עבור כל היעדים. אם False, כותבים מניפסטים רק כשהדבר אפשרי.
תגים: affects_outputs
ברירת מחדל של --[no]build_runfile_manifests: "true"
אם הערך הוא True, צריך לכתוב מניפסטים מסוג Runfiles בכל היעדים. אם FALSE, משמיטים אותן. הבדיקות המקומיות לא יפעלו אם הן יהיו שקריות.
תגים: affects_outputs
ברירת מחדל של --[no]build_test_dwp: "false"
אם האפשרות מופעלת, כשפותחים בדיקות C++ באופן סטטי ובצורה קפדנית, המערכת תיצור באופן אוטומטי גם קובץ .dwp עבור הקובץ הבינארי של הבדיקה.
תגים: loading_and_analysis, affects_outputs
ברירת מחדל של --cc_proto_library_header_suffixes=<comma-separated list of options>: ".pb.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"
אפשר לבצע פעולות נוספות על גרסאות API חלופיות של Java ב-proto_library.
תגים: affects_outputs, loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_proto_extra_actions: "false"
אפשר לבצע פעולות נוספות על גרסאות API חלופיות של Java ב-proto_library.
תגים: affects_outputs, loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_save_feature_state: "false"
שומרים את המצב של תכונות מופעלות ומבוקשות כפלט של הידור.
תגים: affects_outputs, experimental
ברירת מחדל של --fission=<a set of compilation modes>: "no"
ההגדרה קובעת אילו מצבי הידור משתמשים בפיקוח עבור אוספי +C+. יכולים להיות כל שילובים של {'speedbuild', 'dbg', 'opt'} או ערכים מיוחדים 'yes' כדי להפעיל את כל המצבים &&339;no' כדי להשבית את כל המצבים.
תגים: loading_and_analysis, action_command_lines, affects_outputs
ברירת מחדל של --[no]legacy_external_runfiles: "true"
אם המדיניות מוגדרת כ-TRUE, יש לבנות יערות סימבונק של Runruns עבור מאגרים חיצוניים בכפוף ל- .runfiles/wsname/external/repo (בנוסף ל- .runfiles/repo).
תגים: affects_outputs
ברירת מחדל של --[no]objc_generate_linkmap: "false"
ההגדרה קובעת אם ליצור קובץ מפת קישור.
תגים: affects_outputs
ברירת מחדל של --[no]save_temps: "false"
אם המדיניות מוגדרת, פלט זמני מ-gcc יישמר. דוגמאות לקובצי .s (קוד ליצירת מקטע), קובצי .i (C מעובד מראש) וקובצי .ii (C++ ). לפני העיבוד:
תגים: affects_outputs
אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לעצם קיומו:
נצברו --action_env=<a 'name=value' assignment with an optional value part> שימושים מרובים
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם הגדרת יעד. אפשר לציין משתנים לפי שם. במקרה כזה, הערך יילקח מסביבת ההפעלה, או מצמד name=value שקובע את הערך בלי קשר לסביבת ההפעלה. ניתן להשתמש באפשרות זו כמה פעמים. לאפשרויות המוגדרות לאותו משתנה, המנצחים האחרונים, האפשרויות המצטברות למשתנים שונים.
תגים: action_command_lines
ברירת מחדל של --android_cpu=<a string>: "armeabi-v7a"
מעבד ה-Android לטירגוט.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]android_databinding_use_androidx: "false"
יוצרים קובצי התאמת נתונים ל-AndroidX. האפשרות הזו משמשת רק לקישור נתונים v2.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --[no]android_databinding_use_v3_4_args: "false"
שימוש ב-Android Databining v2 עם ארגומנט 3.4.0
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --android_dynamic_mode=<off, default or fully>: "off"
קביעה אם קישורי +C+ של כללי Android יקושרו באופן דינמי כאשר cc_binary לא ייצור באופן מפורש ספרייה משותפת. 'default' פירוש הדבר שבסיס הפנים יבחר אם לקשר באופן דינמי. 'ly' כלומר כל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי ברובו.
תגים: affects_outputs, loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> כברירת מחדל: "alphabetical"
מגדיר את סדר המניפסטים שהועברו למיזוג המניפסט עבור קבצים בינאריים של Android. 'ALPHABETLY' פירושו שהמניפסטים ממוינים לפי הנתיב ביחס לרכיב ה-exe. ALPHABETical_BY_CONFIGURATION פירושו שהמניפסטים ממוינים לפי נתיבים ביחס לספריית התצורה בספריית הפלט. המשמעות של DEPENDENCY היא שמניפסטים מסודרים לפי כל ספרייה שנמצאת לפני המניפסטים של יחסי התלות שלה.
תגים: action_command_lines, execution
ברירת מחדל של --[no]android_resource_shrinking: "false"
הפעלת כיווץ משאבים ל-APK_android_binary שמשתמשים ב-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> שימושים מרובים
יש לציין את מצב קוד ה-API של Apple לצורך שלבי הידור שמטרגטים את ארכיטקטורת המכשירים. הערכים צריכים להיות בפורמט '[platform=]mode' כאשר הפלטפורמה (שחייבת להיות 'ios', 'macos', 'tvos' או 'watchos') היא אופציונלית. אם צוין, מצב מצב הקידוד חל על הפלטפורמה הזו באופן ספציפי. אם לא נתון, הוא חל על כל הפלטפורמות. המצב חייב להיות 'none', 'embedded_סמןs' או 'embedded' ייתכן שהאפשרות הזו תוצג כמה פעמים.
תגים: loses_incremental_state
ברירת מחדל של --[no]build_python_zip: "auto"
יצירת קובץ ZIP של קובץ הפעלה בצורת פיליון. ב-Windows, השבתה בפלטפורמות אחרות
תגים: affects_outputs
נצברו --catalyst_cpus=<comma-separated list of options> שימושים מרובים
רשימה של ארכיטקטורה המופרדת בפסיקים שבשבילה לבנות קבצים בינאריים של Apple Catalyst.
תגים: loses_incremental_state, loading_and_analysis
ברירת מחדל של --[no]collect_code_coverage: "false"
אם תציינו זאת, Bazel תפיק קוד אינסטרומנטציה (באמצעות אינסטרומנטציה אופליין, במידת האפשר) ותאסוף מידע על כיסוי במהלך הבדיקות. השינוי ישפיע רק על יעדים שתואמים לשיטה --instrumentation_filter. בדרך כלל, אין לציין אפשרות זו ישירות – 'Bazelcover' במקום זאת יש להשתמש בפקודה.
תגים: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] ברירת מחדל: "speedbuild"
מציינים את המצב שבו יוצג הקובץ הבינארי. ערכים: 'speedbuild', 'dbg', 'opt'.
תגים: affects_outputs, action_command_lines, explicit_in_output_path
נצברו --conlyopt=<a string> שימושים מרובים
אפשרות נוספת להעברה ל-cc במהלך הידור קובצי המקור של C.
תגים: action_command_lines, affects_outputs
נצברו --copt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-ccC.
תגים: action_command_lines, affects_outputs
ברירת מחדל של --cpu=<a string>: ""
מעבד היעד.
תגים: 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> שימושים מרובים
אפשרות נוספת להעברה ל-cc כשעורכים קובצי מקור ב-C++.
תגים: action_command_lines, affects_outputs
נצברו --define=<a 'name=value' assignment> שימושים מרובים
כל אפשרות --הגדרה מציינת מטלה למשתנה build.
תגים: changes_inputs, affects_outputs
ברירת מחדל של --dynamic_mode=<off, default or fully>: "default"
ההגדרה קובעת אם הקבצים הבינאריים מסוג C++ יקושרו באופן דינמי. 'default' פירושו ש-Bazel תבחר אם לקשר באופן דינמי. 'ly' כלומר כל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי ברובו.
תגים: loading_and_analysis, affects_outputs
ברירת מחדל של --[no]enable_fdo_profile_absolute_path: "true"
אם המדיניות מוגדרת, שימוש ב-fdo_lbolute_profile_path יגדיל את השגיאה.
תגים: affects_outputs
ברירת מחדל של --[no]enable_runfiles: "auto"
הפעלה של עץ קישור סימולטני (runfiles); כברירת מחדל, התכונה מושבתת ב-Windows, בפלטפורמות אחרות.
תגים: affects_outputs
נצברו --experimental_action_listener=<a build target label> שימושים מרובים
הוצא משימוש לטובת היבטים. אפשר להשתמש ב-action_listener כדי לצרף action_action לביצוע פעולות build קיימות.
תגים: execution, experimental
ברירת מחדל של --[no]experimental_android_compress_java_resources: "false"
דחיסת משאבים של Java ב-APK
תגים: affects_outputs, loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_android_databinding_v2: "false"
שימוש בגרסה 2 של קישור ל-Android
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --[no]experimental_android_resource_shrinking: "false"
הפעלת כיווץ משאבים ל-APK_android_binary שמשתמשים ב-ProGuard
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --[no]experimental_android_rewrite_dexes_with_rex: "false"
להשתמש בכלי Rex כדי לכתוב מחדש קובצי Dex
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --experimental_objc_fastbuild_options=<comma-separated list of options>: "-O0,-DDEBUG=1"
יש להשתמש במחרוזות האלה כאפשרויות מהדר dataLayer של objc Builder.
תגים: action_command_lines
ברירת מחדל של --[no]experimental_omitfp: "false"
אם המדיניות מוגדרת כ-True, יש להשתמש ב-libunhost עבור שחרור מחסניות (stackunack) ולהידור באמצעות -fomit-frame-pointer ו- -fסינכרוני-un Wind-tables.
תגים: action_command_lines, affects_outputs, experimental
ברירת מחדל של --[no]experimental_platform_in_output_dir: "false"
אם הערך הוא True, פלטפורמת היעד תשמש בשם של ספריית הפלט במקום ביחידת העיבוד המרכזית (CPU).
תגים: affects_outputs, experimental
ברירת מחדל של --[no]experimental_use_llvm_covmap: "false"
אם צוין, Bazel תיצור פרטי מפה של llvm-cov במקום gcov כש-collect_code_coverage מופעל.
תגים: 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"
אם רוצים ליצור פיצולים מסוג HWASAN.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --fdo_instrument=<a string>: תיאור
יצירת קבצים בינאריים עם אינסטרומנטציה של FDO. עם המהדר Clang/LLVM, הוא מקבל גם את שם הספרייה שמתחתיו יושלכו קובצי הפרופיל הגולמי בזמן הריצה.
תגים: affects_outputs
ברירת מחדל של --fdo_optimize=<a string>: תיאור
יש לך אפשרות להשתמש בפרטי הפרופיל ב-FDO כדי לבצע אופטימיזציה של האוסף. יש לציין את השם של קובץ 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"
אם המדיניות מופעלת, כל האוספים של C++ מייצרים קוד עצמאי למיקום ("-fPIC"), קישורים מעדיפים ספריות מוגדרות מראש של PIC על פני ספריות שאינן מסוג PIC, וקישורים מייצרים קובצי הפעלה שאינם תלויי מיקום ("-Pie").
תגים: loading_and_analysis, affects_outputs
נצברו --host_action_env=<a 'name=value' assignment with an optional value part> שימושים מרובים
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם תצורות מארח או ביצוע. אפשר לציין משתנים לפי שם. במקרה כזה, הערך יילקח מסביבת ההפעלה, או מצמד name=value שקובע את הערך בלי קשר לסביבת ההפעלה. ניתן להשתמש באפשרות זו כמה פעמים. לאפשרויות המוגדרות לאותו משתנה, המנצחים האחרונים, האפשרויות המצטברות למשתנים שונים.
תגים: action_command_lines
ברירת מחדל של --host_compilation_mode=<fastbuild, dbg or opt>: "opt"
ציון המצב שבו ייעשה שימוש בכלים ששימשו ליצירת ה-build. ערכים: 'speedbuild', 'dbg', 'opt'.
תגים: affects_outputs, action_command_lines
נצברו --host_conlyopt=<a string> שימושים מרובים
אפשרות נוספת להעברה ל-cc במהלך הידור קובצי המקור של C עבור כלי מארח.
תגים: action_command_lines, affects_outputs
נצברו --host_copt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-cc עבור כלי אירוח.
תגים: action_command_lines, affects_outputs
ברירת מחדל של --host_cpu=<a string>: ""
המעבד (CPU) המארח.
תגים: changes_inputs, affects_outputs
נצברו --host_cxxopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-cc עבור כלי אירוח.
תגים: action_command_lines, affects_outputs
ברירת מחדל של --host_force_python=<PY2 or PY3>: תיאור
עוקפת את הגרסה ב-Python של תצורת המארח. יכול להיות "PY2" או "PY3".
תגים: loading_and_analysis, affects_outputs
נצברו --host_linkopt=<a string> שימושים מרובים
אפשרות נוספת להעברה ל-cc בעת קישור כלים למארח.
תגים: 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"
אם אפשרות זו מופעלת, כל הספריות המקושרות מסוג C++ (DLL) שנוצרו על ידי cc_library ב-Windows יעברו שינוי שם ל-name_{Hash}.dll, שם הגיבוב מחושב על סמך ה-RepositoryName ונתיב החבילה DLL&#39. האפשרות הזו שימושית כשיש חבילה אחת שתלויה בכמה cc_library עם אותו שם (לדוגמה //foo/bar1:utils ו-//foo/bar2:utils).
תגים: loading_and_analysis, affects_outputs, incompatible_change
ברירת מחדל של --[no]incompatible_merge_genfiles_directory: "true"
אם המדיניות מוגדרת כ-True, ספריית הגנרטורים מקופלת בספריית 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"
כשהאפשרות 'כיסוי' מופעלת, המדיניות הזו קובעת אם לשקול כללים להגדרת אינסטרומנטציה. במהלך ההגדרה, המערכת מוסיפה אמצעי בדיקה שכוללים --instrumentation_filter. אחרת, כללי הבדיקה תמיד לא ייכללו באינסטרומנטציה של הכיסוי.
תגים: affects_outputs
ברירת מחדל --instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-/Javatests[/:],-/test/Java[/:]"
אם מפעילים את הכיסוי, המערכת מחילה רק כללים שהשמות שלהם נכללים במסנן שצוין לפי ביטוי רגולרי. כללים עם קידומת '-' אינם נכללים במקום זאת. לתשומת ליבכם: רק כללים שאינם בדיקות נמשכים לאינדקס, אלא אם מפעילים את --instrument_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_application. התוצאה היא קובץ בינארי אוניברסלי המכיל את כל הארכיטקטורה שצוינה.
תגים: loses_incremental_state, loading_and_analysis
ברירת מחדל של --[no]legacy_whole_archive: "true"
הוצאה משימוש, הוחלפה על ידי --incompatible_remove_Legacy_whole_archive (לפרטים נוספים: https://github.com/bazelbuild/bazel/issues/7362). במצב מופעל, יש להשתמש ב-allall-archive כדי להשתמש בכללים של cc_binary שיש להם linkshared=True וב-linkstatic=True או '-static' ב-linkopts. הערך הזה מיועד לתאימות לאחור בלבד. במקום זאת, עדיף להשתמש תמיד ב-linklink=1, היכן שנדרש.
תגים: action_command_lines, affects_outputs, deprecated
נצברו --linkopt=<a string> שימושים מרובים
אפשרות נוספת להעברה ל-cc בזמן הקישור.
תגים: 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"
אם המדיניות מוגדרת, ומצב העריכה מוגדר כך: 'dbg', GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC ו-GLIBCPP_CONCEPT_CHECKS.
תגים: action_command_lines
ברירת מחדל של --[no]objc_enable_binary_stripping: "false"
האם לבצע רצועות של סימנים וקוד לא פעיל בבינאריים מקושרים. אם בוחרים את הסימון הזה וגם את הסימון 'compilation_mode=opt', המערכת תסיר מחרוזות בינאריות.
תגים: action_command_lines
נצברו --objccopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-cc במהלך הידור קובצי המקור 'יעד-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> שימושים מרובים
אפשרויות נוספות להעברה סלקטיבית ל-cc כשעורכים קבצים מסוימים. ניתן להעביר את האפשרות הזו כמה פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. המונח regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (יש לעיין גם ב-(instrumentation_filter). האפשרות_1 עד Option_n מתייחסת לאפשרויות שרירותיות של שורות פקודה. אם אפשרות מכילה פסיק, צריך לצטט לוכסן הפוך. האפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --for
תגים: 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
ברירת מחדל של --platform_suffix=<a string>: תיאור
קביעת סיומת שתתווסף לספריית התצורה.
תגים: loses_incremental_state, affects_outputs, loading_and_analysis
ברירת מחדל של --propeller_optimize=<a build target label>: תיאור
יש להשתמש בפרטי פרופיל ה-Proproler כדי לבצע אופטימיזציה של יעד ה-build.פרופיל דו-שיח חייב להכיל לפחות אחד משני קבצים, פרופיל ב-cc ופרופיל ישן. הדגל הזה מקבל תווית build שחייבת להפנות לקובצי הקלט של פרופיל המדחף. לדוגמה, קובץ ה-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 עבור גרסאות build שעברו אופטימיזציה של Profeler.
תגים: affects_outputs
ברירת מחדל של --propeller_optimize_absolute_ld_profile=<a string>: תיאור
שם הנתיב המוחלט של קובץ ld_profile עבור גרסאות build שעברו אופטימיזציה ל-Propleler.
תגים: 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', '//package:target', '//package:target #
תגים: action_command_lines
ברירת מחדל של --[no]share_native_deps: "true"
אם True, ספריות מקוריות שמכילות פונקציונליות זהה ישותפו בין היעדים השונים
תגים: loading_and_analysis, affects_outputs
ברירת מחדל של --[no]stamp: "false"
פריטים בינאריים בחותמת עם התאריך, שם המשתמש, שם המארח, פרטי סביבת העבודה וכו'
תגים: affects_outputs
ברירת מחדל של --strip=<always, sometimes or never>: "sometimes"
ההגדרה קובעת אם להסיר בינאריים וספריות משותפות (באמצעות "-Wl,--strip-debug"). ערך ברירת המחדל של 'sometimes' פירושו רצועת אם if- --compilation_mode=fastbuild.
תגים: 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 TV.
תגים: loses_incremental_state, loading_and_analysis
ברירת מחדל של --tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
גרסת ה-TVOS תואמת מינימלית לסימולטורים וליעדים של היעד. אם לא צוין, נעשה שימוש ב-'tvos_sdk_version'.
תגים: loses_incremental_state
נצברו --watchos_cpus=<comma-separated list of options> שימושים מרובים
רשימה של ארכיטקטורה המופרדת בפסיקים שבשבילה לבנות קבצים בינאריים של AppleOS.
תגים: loses_incremental_state, loading_and_analysis
ברירת מחדל של --watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
גרסה מינימלית של WatchOS תואמת לסימולטורים ולסימולטורים מבוססי יעד. אם לא צוין, נעשה שימוש ב-'watchos_sdk_version'.
תגים: loses_incremental_state
ברירת מחדל של --xbinary_fdo=<a build target label>: תיאור
יש לך אפשרות להשתמש בפרטי הפרופיל ב-XbinaryFDO כדי לבצע אופטימיזציה של האוסף. קביעת השם של פרופיל בינארי כברירת מחדל. אם משתמשים באפשרות הזו יחד עם --fdo_instrument/--fdo_optimize/--fdo_profile, האפשרויות האלה תמיד יקבלו את הערך כאילו xbinary_fdo לא צוין.
תגים: affects_outputs
אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
ברירת מחדל של --auto_cpu_environment_group=<a build target label>: ""
מציינים את המאפייןEnvironment_group [קבוצת_סביבה] שישמש למיפוי אוטומטי של ערכי pu לערכי target_environment.
תגים: changes_inputs, loading_and_analysis, experimental
ברירת מחדל של --[no]check_licenses: "false"
צריך לוודא שמגבלות הרישוי שנקבעות על ידי חבילות תלויות לא מתנגשות עם מצבי ההפצה של היעדים שאתם יוצרים. כברירת מחדל, הרישיונות לא נבדקים.
תגים: build_file_semantics
ברירת מחדל של --[no]check_visibility: "true"
אם המדיניות מושבתת, שגיאות חשיפה בתלויות יעד יורדו לאזהרות.
תגים: build_file_semantics
ברירת מחדל של --[no]desugar_for_android: "true"
האם לבצע פענוח קוד בייט 8 של סוכר לפני פענוח הקוד?
תגים: affects_outputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]desugar_java8_libs: "false"
האם לכלול ספריות Java 8 נתמכות באפליקציות למכשירים מדור קודם.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --[no]enforce_constraints: "true"
לבדוק את הסביבות שבהן כל יעד תואם, ומדווח על שגיאות אם לכל יעד יש יחסי תלות שלא תומכים באותן סביבות
תגים: build_file_semantics
ברירת מחדל של --[no]experimental_allow_android_library_deps_without_srcs: "false"
סימון כדי לעזור במעבר מהמדיניות של אי-אפשר להשתמש בכללי android_library ללא כינויים באמצעות נקודות שפל. יש לנקות את המאגר כדי שההוצאה תתבצע כברירת מחדל.
תגים: eagerness_to_exit, loading_and_analysis
ברירת מחדל של --[no]experimental_check_desugar_deps: "true"
האם כדאי לבדוק שוב את ניפוי הבאגים הנכון ברמה הבינארית של Android.
תגים: eagerness_to_exit, loading_and_analysis, experimental
ברירת מחדל של --experimental_import_deps_checking=<off, warning or error>: "OFF"
כשהאפשרות מופעלת, בודקים אם התלות של aar_import הסתיימו. האכיפה הזו עלולה לפרוץ את הבנייה, או להוביל רק לאזהרות.
תגים: loading_and_analysis
ברירת מחדל של --experimental_strict_java_deps=<off, warn, error, strict or default>: "default"
אם הערך הוא true, המערכת בודקת שיעד של Java מצהיר במפורש על כל היעדים שנעשה בהם שימוש ישיר כתלויות.
תגים: build_file_semantics, eagerness_to_exit
ברירת מחדל של --[no]incompatible_check_testonly_for_output_files: "false"
אם האפשרות הזו מופעלת, יש לבדוק רק את היעדים הנדרשים שהם קובצי פלט, על ידי חיפוש הבדיקה בלבד של כלל היצירה. ההגדרה הזו תואמת לבדיקת הניראות.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_disable_native_android_rules: "false"
אם המדיניות מופעלת, השימוש הישיר בכללי Android המקוריים מושבת. יש להשתמש בכללי Starlark ל-Android בכתובת https://github.com/bazelbuild/rules_android
תגים: eagerness_to_exit, incompatible_change
ברירת מחדל של --[no]incompatible_disable_native_apple_binary_rule: "false"
לא צריך להשתמש בהגדרה הזו. אפשר לשמור כאן לצורך תאימות לאחור.
תגים: eagerness_to_exit, incompatible_change
ברירת מחדל של --[no]incompatible_force_strict_header_check_from_starlark: "true"
אם האפשרות מופעלת, ניתן להגדיר בדיקת כותרות מחמירה ב-Starlark API
תגים: loading_and_analysis, changes_inputs, incompatible_change
ברירת מחדל של --[no]incompatible_validate_top_level_header_inclusions: "true"
אם הדבר נכון, Bazel תוודא גם שההכללה של הספרייה היא ברמה העליונה (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/10047).
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]strict_filesets: "false"
אם האפשרות הזו מופעלת, קבצים שחוצים את גבולות החבילה מדווחים כשגיאות. הוא לא פועל כאשר Check_fileset_dependencies_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"
אלא אם האפשרות מושבתת, המערכת בודקת שיעד Proto_library מצהיר באופן מפורש על כל היעדים שנעשה בהם שימוש ב 'ייבוא ציבורי&#39.
תגים: build_file_semantics, eagerness_to_exit, incompatible_change
ברירת מחדל של --[no]strict_system_includes: "false"
אם הערך הוא True, צריך להצהיר גם על כותרות שנמצאות דרך נתיבים (-isystem).
תגים: loading_and_analysis, eagerness_to_exit
נצברו --target_environment=<a build target label> שימושים מרובים
מצהירה על סביבת היעד הזו. הערך חייב להיות תווית של כלל "enrinoment" אם צוין, כל היעדים ברמה העליונה חייבים להתאים לסביבה הזו.
תגים: changes_inputs
אפשרויות שמשפיעות על הפלט של החתימה של גרסת build:
ברירת מחדל של --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"
אם המדיניות מוגדרת ומצב האוסף לא 'opt' אפליקציות objc יכללו הרשאות לניפוי באגים בזמן החתימה.
תגים: changes_inputs
ברירת מחדל של --ios_signing_cert_name=<a string>: תיאור
שם האישור לשימוש בחתימת iOS. אם המדיניות לא מוגדרת, תוחזר לפרופיל ניהול התצורה. יכול להיות העדפת הזהות של אישור המפתח או מחרוזת המשנה של השם הנפוץ באישור, בהתאם לדף האדם של ה-Codesign &#39 (מפתח רישום).
תגים: action_command_lines
האפשרות הזו משפיעה על סמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו בקובצי BUILD, קובצי .bzl או קובצי WORKSPACE.:
ברירת מחדל של --[no]incompatible_disallow_legacy_py_provider: "true"
לא, המערכת תסיר אותה בקרוב.
תגים: loading_and_analysis, incompatible_change
אפשרויות שקובעות את אופן הפעולה של סביבת הבדיקה או של אופרטור הבדיקה:
ברירת מחדל של --[no]allow_analysis_failures: "false"
אם הערך מקבל את הערך 'true', כשל בניתוח של יעד הוא מפיץ את המופע של target&ailureInfo המכיל את תיאור השגיאה, במקום לגרום לכשל ב-build.
תגים: 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"
אם כשלים אמיתיים בפעולת dex2oat יגרמו לקריסה של המודל במקום לבצע Dex2oat בזמן ריצה של הבדיקה.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_android_use_parallel_dex2oat: "false"
משתמשים ב-dex2oat במקביל כדי להאיץ את android_test.
תגים: loading_and_analysis, host_machine_resource_optimizations, experimental
ברירת מחדל של --[no]ios_memleaks: "false"
הפעלה של בדיקת דליפות זיכרון ביעדי ios_test.
תגים: action_command_lines
ברירת מחדל של --ios_simulator_device=<a string>: תיאור
המכשיר להדמיית הפעלה של אפליקציה ל-iOS בסימולטור, לדוגמה 'iPhone 6'. ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים: 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 מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (ראו גם --instrumentation_filter). דוגמה: --runs_per_test=//foo/.*,-//foo/bar/.*@3 מריץ את כל הבדיקות ב-//foo/ אבל לא מתחת ל-foo/bar שלוש פעמים. ניתן להעביר את האפשרות הזו כמה פעמים. הארגומנט האחרון שהועבר תואם לעדיפות. אם אין תוצאות תואמות, הבדיקה תופעל פעם אחת בלבד.
נצברו --test_env=<a 'name=value' assignment with an optional value part> שימושים מרובים
ההגדרה קובעת משתני סביבה נוספים שיוחדרו לסביבת הרצה של הבדיקה. אפשר לציין משתנים לפי שם. במקרה כזה, הערך שלהם ייקרא מסביבת הלקוח ב-Bazel או באמצעות צמד name=value. אפשר להשתמש באפשרות הזו כמה פעמים כדי לציין כמה משתנים. בשימוש רק באמצעות הפקודה 'bazel' .
תגים: test_runner
ברירת מחדל של --test_timeout=<a single integer or comma-separated list of 4 integers>: "-1"
כדאי לשנות את ערכי ברירת המחדל של הזמן הקצוב לתפוגה של בדיקות (בדקות) אם יצוין ערך חיובי אחד שלם, הוא יחליף את כל הקטגוריות. אם ציינתם 4 מספרים שלמים המופרדים בפסיקים, הם יחליפו את הזמן הקצוב לתפוגה עבור קצר, בינוני, ארוך ותמידי (בסדר הזה). בכל אחד מהפורמטים, הערך 1- מורה ל-blaze להשתמש בברירות המחדל של הזמן הקצוב לתפוגה עבור קטגוריה זו.
ברירת מחדל של --tvos_simulator_device=<a string>: תיאור
המכשיר להדמיית הפעלה של אפליקציית tvOS בסימולטור, למשל 'Apple TV 1080p' ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים: test_runner
ברירת מחדל של --tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
גרסת ה-tvOS שפועלת בסימולטור בזמן הפעלה או בדיקה.
תגים: test_runner
ברירת מחדל של --watchos_simulator_device=<a string>: תיאור
המכשיר להדמיית הפעלה של אפליקציית WatchOS בסימולטור, למשל 'Apple Watch – 38mm' ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים: test_runner
ברירת מחדל של --watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
גרסת ה-watchOS שמופעלת בסימולטור כשמריצים או בודקים.
תגים: test_runner
ברירת מחדל של --[no]zip_undeclared_test_outputs: "true"
אם הערך הוא True, פלט של בדיקות לא מוצהרות יועברו לארכיון בקובץ ZIP.
תגים: test_runner
אפשרויות הקשורות לפלט שאילתות וסמנטיקה:
ברירת מחדל של --aspect_deps=<off, conservative or precise>: "conservative"
איך לפתור בעיה של יחסי גובה-רוחב כאשר פורמט הפלט הוא בפורמט {xml,proto,record}. 'off' פירוש הדבר שלא נפתרים יחסי תלות ו'שמרני' (ברירת המחדל) מוסיפים את כל יחסי הגובה-רוחב המוצהרים, בין אם הם קיבלו את רמת התלויות הישירות ובין אם לא. חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, כך שהוא איטי יותר מהמצבים האחרים. כמו כן, אפילו מצב מדויק אינו מדויק לחלוטין: ההחלטה אם לחשב היבט מסוים נקבעת בשלב הניתוח, שאינו פועל במהלך &b3Query;'
תגים: build_file_semantics
ברירת מחדל של --[no]deduplicate_depsets: "true"
אפשר לבטל כפילויות של ילדים ללא עצים ב-dep_set_of_files בפלט הסופי (toto/textproto/json). הפעולה הזו לא מבטלת כפילויות של דיוורים שאינם משותפים הורה מיידי. המדיניות הזו לא משפיעה על הרשימה הסופית בפועל של פריטי מידע שנוצרו בתהליך פיתוח (Artifact) של הפעולות.
תגים: terminal_output
ברירת מחדל של --[no]graph:factored: "true"
אם הערך הוא True, התרשים ייקרא 'fact האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים: terminal_output
ברירת מחדל של --graph:node_limit=<an integer>: "512"
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; הערך 1- יגרום לכך שלא ייחתך. האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים: terminal_output
ברירת מחדל של --[no]implicit_deps: "true"
אם האפשרות הזאת מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלות שבו השאילתה פועלת. תלות משתמעת היא זו שלא צוינה במפורש בקובץ BUILD, אך נוספה על ידי ה-bazel. עבור שאילתה, אפשרות זו שולטת בסינון ערכות כלים שנפתרו.
תגים: build_file_semantics
ברירת מחדל של --[no]include_artifacts: "true"
כולל שמות של קלט ופלט של הפלט (גדול בפוטנציאל).
תגים: terminal_output
ברירת מחדל של --[no]include_aspects: "true"
aquery, שאילתה: האם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: no-op (מאפיינים תמיד במעקב).
תגים: terminal_output
ברירת מחדל של --[no]include_commandline: "true"
כולל את התוכן של שורות הפקודות לביצוע בפלט (גדול בפוטנציאל).
תגים: terminal_output
ברירת מחדל של --[no]include_file_write_contents: "false"
יש לכלול את תוכן הקובץ עבור הפעולות FileWrite ו-SourceSymlinkManifest (גדול בפוטנציאל).
תגים: terminal_output
ברירת מחדל של --[no]include_param_files: "false"
יש לכלול את התוכן של קובצי הפרמטרים שנעשה בהם שימוש בפקודה (פוטנציאליים). הערה: כשמפעילים את התכונה הזו, הסימון 'include_commandline' יופעל באופן אוטומטי.
תגים: terminal_output
ברירת מחדל של --[no]incompatible_display_source_file_location: "true"
True, כברירת מחדל, יוצג היעד של קובץ המקור. אם True, מציג את המיקום של שורה 1 של קובצי מקור בפלטי מיקום. הסימון הזה קיים רק למטרות העברה.
תגים: terminal_output, incompatible_change
ברירת מחדל של --[no]incompatible_package_group_includes_double_slash: "true"
אם האפשרות הזו מופעלת, בעת הפקת המאפיין 'packs' של package_group&, הסימן '//' הראשי לא יושמט.
תגים: terminal_output, incompatible_change
ברירת מחדל של --[no]infer_universe_scope: "false"
אם המדיניות set ו- לתשומת ליבכם, הערך של uniuni_scope כפי שהוסק עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, allalleps) הוא לא מה שאתם רוצים, לכן עליכם להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים ודוגמאות זמינים בכתובת https://bazel.build/reference/query#sky-query. אם --univers_scope מוגדר, המערכת מתעלמת מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'שאילתה' (כלומר, לא 'cquery').
תגים: loading_and_analysis
ברירת מחדל של --[no]line_terminator_null: "false"
אם כל פורמט יסתיים ב-\0 במקום בפורמט חדש.
תגים: terminal_output
ברירת מחדל של --[no]nodep_deps: "true"
אם המדיניות מופעלת, נקודות שפל מתוך "nodep" ייכללו בתרשים התלות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep". היא "visible". מריצים ומנתחים את הפלט של 'info Build-language' כדי ללמוד על כל המאפיינים "nodep"בשפת ה-build.
תגים: build_file_semantics
ברירת מחדל של --output=<a string>: "text"
הפורמט שבו יש להדפיס את תוצאות השאילתה. הערכים המותרים ל-query הם: text, textproto, Proto, jsonproto.
תגים: terminal_output
ברירת מחדל של --[no]proto:default_values: "true"
אם מוגדר כ-True, נכללים מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- --פלט=פרוטו
תגים: terminal_output
ברירת מחדל של --[no]proto:definition_stack: "false"
מאכלס את השדה Proto-stack, שמתעד כל מופע של כלל ה-Starstark שבו מוגדרת המחלקה בכלל.
תגים: terminal_output
ברירת מחדל של --[no]proto:flatten_selects: "true"
אם המדיניות מופעלת, מאפיינים ניתנים להגדרה שנוצרו על ידי Select() שטוחים. עבור סוגי רשימות, הייצוג השטוח הוא רשימה המכילה כל ערך של המפה שנבחרה פעם אחת בלבד. סוגי הפיגועים שטוחים איזה null.
תגים: build_file_semantics
ברירת מחדל של --[no]proto:include_synthetic_attribute_hash: "false"
אם רוצים לחשב ולאכלס את המאפיין $internal_attr_Hash.
תגים: terminal_output
ברירת מחדל של --[no]proto:instantiation_stack: "false"
אכלוס מחסנית קריאות של כל הנחיה. כדי לעשות זאת, יש צורך במקבץ סטאק
תגים: terminal_output
ברירת מחדל של --[no]proto:locations: "true"
אם בכלל, כדאי לשלוח פרטי מיקום בפלט אב.
תגים: terminal_output
ברירת מחדל של --proto:output_rule_attrs=<comma-separated list of options>: "all"
רשימת מאפיינים המופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להוציא פלט. האפשרות הזו רלוונטית ל--פלט=פרוטו.
תגים: terminal_output
ברירת מחדל של --[no]proto:rule_inputs_and_outputs: "true"
אפשר גם לאכלס את השדותכללי_קלט וכלל_פלט.
תגים: terminal_output
ברירת מחדל של --[no]relative_locations: "false"
אם הערך הוא TRUE, המיקום של קובצי BUILD ב-XML ובפלטי אב יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא יהיה עקבי בין מחשבים. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במכשירים שונים.
תגים: terminal_output
ברירת מחדל של --[no]skyframe_state: "false"
ללא צורך בניתוח נוסף, שולחים את תרשים הפעולה הנוכחי מ-Skyframe. הערה: ציון היעד באמצעות --skyframe_state אינו נתמך כרגע. הסימון הזה זמין רק באמצעות
תגים: terminal_output
ברירת מחדל של --[no]tool_deps: "true"
שאילתה: אם היא מושבתת, יחסי תלות ב-'מארח הגדרה' או 'execution' יעדים לא ייכללו בתרשים התלות שעליו פועלת השאילתה. קצה 'הגדרת תצורה למארחים' כזה מהכלל של #&39;proto_library' מפנה בדרך כלל למהדר הפרוטוקול, בדרך כלל מצביע על כלי שהופעל במהלך ה-build במקום על חלק מאותה תוכנית 'target' שאילתה: אם היא מושבתת, היא מסננת את כל היעדים שהוגדרו שחוצים מעבר של מארח או ביצוע, מהיעד שהוגדר ברמה העליונה שגילו את היעד שהוגדר. כלומר, אם היעד ברמה העליונה נמצא בתצורת היעד, יוחזרו רק יעדים שהוגדרו בתצורת היעד. אם היעד ברמה העליונה נמצא בתצורת המארח, יוחזרו רק יעדים שהוגדרו על ידי המארח. אפשרות זו לא תכלול שרשראות כלים שנפתרו.
תגים: build_file_semantics
ברירת מחדל של --universe_scope=<comma-separated list of options>: ""
קבוצה של דפוסי יעד (מופרדים באמצעות פסיקים) המופרדים בפסיקים. השאילתה עשויה להתבצע ביקום שהוגדר על ידי הסגירה העקיפה של היעדים שצוינו. האפשרות הזו משמשת לפקודות השאילתה ושאילתת השאילתה. עבור השאילתה, הקלט לאפשרות הזו הוא היעדים שבנו כל התשובות, ולכן האפשרות הזו עשויה להשפיע על התצורות והמעברים. אם אפשרות זו אינה מוגדרת, ההנחה היא שהיעדים ברמה העליונה הם היעדים המנותחים מביטוי השאילתה. הערה לגבי שאילתה: אם לא מציינים את האפשרות הזו, ייתכן שה-build לא יפעל אם לא ניתן ליצור יעדים מביטוי השאילתה עם האפשרויות ברמה העליונה.
תגים: loading_and_analysis
אפשרויות שגורמות לאופטימיזציה של זמן ה-build:
ברירת מחדל של --[no]collapse_duplicate_defines: "false"
כשהאפשרות מופעלת, ההגדרות המיותרות יוסרו בשלב מוקדם. כדי למנוע אובדן מיותר של מטמון הניתוח לסוגים מסוימים של גרסאות build מקבילות.
תגים: loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]experimental_filter_library_jar_with_program_jar: "false"
יש לסנן את ProGuard ProgramJar כדי להסיר את כל הכיתות שנמצאות גם ב-LibraryJar.
תגים: action_command_lines
ברירת מחדל של --[no]experimental_inmemory_dotd_files: "true"
כשהאפשרות מופעלת, קובצי C++ .d יועברו בזיכרון ישירות מצומתי ה-build המרוחק במקום להיכתב לדיסק.
תגים: loading_and_analysis, execution, affects_outputs, experimental
ברירת מחדל של --[no]experimental_inmemory_jdeps_files: "true"
אם האפשרות מופעלת, קובצי התלויות (.jdeps) שנוצרו מהאוספים של Java יועברו בזיכרון ישירות מצומתי ה-build המרוחק במקום להיכתב לדיסק.
תגים: loading_and_analysis, execution, affects_outputs, experimental
ברירת מחדל של --[no]experimental_objc_include_scanning: "false"
האם לבצע סריקה עבור אובייקט C/C+ אובייקטיבי.
תגים: loading_and_analysis, execution, changes_inputs
ברירת מחדל של --[no]experimental_parse_headers_skipped_if_corresponding_srcs_found: "false"
אם התכונה parse_headers מופעלת, אם לא קיים מקור באותו שם יעד, היא לא יוצרת פעולת רינדור נפרדת של כותרת.
תגים: loading_and_analysis, affects_outputs
ברירת מחדל של --[no]experimental_retain_test_configuration_across_testonly: "false"
כשהאפשרות מופעלת, --trim_test_Configuration לא יקטע את תצורת הבדיקה של כללים שסומנו לבדיקה בלבד=1. כך אנחנו מצמצמים את הבעיות של התנגשות בין פעולות כאשר כללים שאינם בדיקות תלויים בכללים של cc_test. אין השפעה אם --trim_test_ Configuration היא FALSE.
תגים: loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]experimental_starlark_cc_import: "false"
אם ההגדרה מופעלת, אפשר להשתמש בגרסת Starlark של cc_import.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_unsupported_and_brittle_include_scanning: "false"
כדי לצמצם את קלט הקלט לאוסף C/C++ , יש לנתח #include שורות מקובצי קלט. כך אפשר לשפר את הביצועים ואת הצבירה על ידי הקטנת הגודל של עצי ההזנה של האוסף. עם זאת, היא עלולה לשבור גרסאות build כי הסורק של כלי העריכה לא מטמיע באופן מלא את הסמנטיקה של מעבד המידע (CPU) לפני העיבוד. באופן ספציפי, הוא לא מבין הוראות #include דינמיות ומתעלם מלוגיקה מותנית של עיבוד מראש. השימוש הוא באחריותך בלבד. כל בעיה הנוגעת לסימון זה ייסגר.
תגים: loading_and_analysis, execution, changes_inputs
ברירת מחדל של --[no]incremental_dexing: "true"
רוב העבודה על דקס נפתחת בנפרד בכל קובץ ב-Jar.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]objc_use_dotd_pruning: "true"
אם המדיניות מוגדרת, קובצי .d שנוצרו על ידי ה-Clang ישמשו לגיזום קבוצת הקלט הנכנסת מהדרים objc.
תגים: changes_inputs, loading_and_analysis
ברירת מחדל של --[no]process_headers_in_dependencies: "false"
כשיוצרים יעד //a:a, צריך לעבד כותרות בכל היעדים ש//a:a תלויים בהם (אם עיבוד הכותרת מופעל עבור Toolchain).
תגים: execution
ברירת מחדל של --[no]trim_test_configuration: "true"
כשהאפשרות מופעלת, האפשרויות שקשורות לבדיקה יימחקו מתחת לרמה העליונה של ה-build. כשהסימון הזה פעיל, לא ניתן ליצור בדיקות כתלויות של כללים שאינם בדיקות, אבל שינויים באפשרויות הקשורות לבדיקה לא יגרמו לניתוח מחדש של כללים שאינם בדיקות.
תגים: loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]use_singlejar_apkbuilder: "true"
האפשרות הזו הוצאה משימוש. לא חייבים להשתמש בה והיא תוסר בקרוב.
תגים: loading_and_analysis
אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום:
ברירת מחדל של --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
הדפסת מידע על תוצאות ניפוי באגים במהלך רזולוציה של הכלי. בסימון נעשה שימוש בביטוי רגולרי, שנבדק ביחס לסוגי כלי עבודה ויעדים ספציפיים, כדי לראות באיזה ניפוי באגים. אפשר להפריד בין ביטויים רגולריים באמצעות ביטויים רגולריים, ולאחר מכן כל ביטוי רגולרי מסומן בנפרד. הערה: הפלט של הדגל הזה מורכב מאוד וככל הנראה יועיל רק למומחים בפתרון בעיות בכלי.
תגים: terminal_output
אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
נצברו --flag_alias=<a 'name=value' flag alias> שימושים מרובים
מגדירים שם מקוצר לסימון Starlark. הוא צריך להזין צמד יחיד של מפתח-ערך בפורמט "<key>=<value>" כארגומנט.
תגים: changes_inputs
ברירת מחדל של --[no]incompatible_default_to_explicit_init_py: "false"
סימון זה משנה את התנהגות ברירת המחדל כך שקובצי __init__.py כבר לא נוצרים באופן אוטומטי בקבצים פועלים של יעדים ב-Python. באופן מדויק, אם יעד py_binary או py_test מוגדר מדור קודם, play_create_init מוגדר ל-"auto" (ברירת המחדל), הוא נחשב כ-false אם רק הסימון הזה מוגדר. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/10076.
תגים: affects_outputs, incompatible_change
ברירת מחדל של --[no]incompatible_py2_outputs_are_suffixed: "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_פלטs_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"
אם מוגדר כ-'auto', Bazel מריץ בדיקה מחדש אם ורק: (1) בזל מזהה שינויים בבדיקה או בתלויות שלה, (2) הבדיקה מסומנת כחיצונית, (3) התבקשו מספר ריצות בדיקה עם -runs_per_test או(4) הבדיקה נכשלה בעבר. אם הכתובת היא 'yes' , Bazel שומרת במטמון את כל תוצאות הבדיקה, מלבד בדיקות שסומנו כחיצוניות. אם הכתובת היא 'no', Bazel לא שומרת תוצאות בדיקה.
ברירת מחדל של --[no]experimental_cancel_concurrent_tests: "false"
True האפשרות הזו שימושית רק בשילוב עם --runs_per_test_detects_flakes.
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --[no]experimental_fetch_all_coverage_outputs: "false"
אם הערך הוא True, מערכת Bazel מאחזרת את כל ספריית נתוני הכיסוי עבור כל בדיקה במהלך תקופת כיסוי.
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --[no]experimental_generate_llvm_lcov: "false"
אם זה יהיה נכון, כיסוי לגבי קלנג ייצור דוח LCOV.
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --[no]experimental_j2objc_header_map: "true"
האם ליצור מפת כותרת של J2ObjC במקביל לתעתוק J2ObjC?
ברירת מחדל של --[no]experimental_j2objc_shorter_header_path: "false"
אם צריך ליצור עם נתיב כותרת קצר יותר (משתמשים ב-"_ios" במקום "_j2objc").
תגים: affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel> כברירת מחדל: "Javabuilder"
הפעלת ערכי נתיב מופחתים לאוספים של Java.
ברירת מחדל של --[no]experimental_limit_android_lint_to_android_constrained_java: "false"
מגבילים --experimental_run_android_lint_on_Java_rules לספריות תואמות ל-Android.
תגים: affects_outputs
ברירת מחדל של --[no]experimental_run_android_lint_on_java_rules: "false"
האם לאמת את מקורות Java_*?
תגים: affects_outputs
ברירת מחדל של --[no]explicit_java_test_deps: "false"
יש לציין באופן מפורש את התלות ב-JUnit או Hacrest ב-Java_test במקום לקבל בטעות נקודות דירוג מ-TestRunner&#39. בשלב זה מתאים לשימוש ב-Bazall.
ברירת מחדל של --host_java_launcher=<a build target label>: תיאור
מרכז האפליקציות של Java שמשמש את הכלים להפעלה במהלך build.
נצברו --host_javacopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-Java בעת יצירת כלים המופעלים במהלך build.
נצברו --host_jvmopt=<a string> שימושים מרובים
אפשרויות נוספות למעבר ל-Java VM במהלך בניית כלים שמופעלים במהלך ה-build. האפשרויות האלה יתווספו לאפשרויות ההפעלה של VM בכל יעד Java_binary.
ברירת מחדל של --[no]incompatible_exclusive_test_sandboxed: "false"
אם הערך הוא נכון, יופעלו בדיקות בלעדיות עם שיטת בידינג בארגז חול. מוסיפים תג 'local' כדי לאלץ הרצת בדיקה בלעדית באופן מקומי
תגים: incompatible_change
ברירת מחדל של --[no]incompatible_strict_action_env: "false"
אם הערך true, Bazel משתמשת בסביבה עם ערך סטטי של Path ולא יורשת את LD_LIBRARI_Path. משתמשים בפונקציה --action_env=ENV_VARIABLE אם רוצים לרשת בירושה משתני סביבה ספציפיים מהלקוח, אך חשוב לזכור שפעולה זו יכולה למנוע שמירה במטמון של משתמשים שונים אם נעשה שימוש במטמון משותף.
תגים: loading_and_analysis, incompatible_change
נצברו --j2objc_translation_flags=<comma-separated list of options> שימושים מרובים
אפשרויות נוספות למעבר לכלי J2ObjC.
--java_debug
המכונה הווירטואלית של Java בבדיקת Java ממתינה לחיבור לכלי ניפוי באגים התואם ל-JDWP (כגון jdb) לפני התחלת הבדיקה. משתמע -test_פלט=שידור.
הרחבה אל:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
ברירת מחדל של --[no]java_deps: "true"
יצירת פרטי תלות (כרגע, סוג ה-path של זמן הביצוע) לכל יעד Java.
ברירת מחדל של --[no]java_header_compilation: "true"
להיעזר באיג'רים ישירות מהמקור.
ברירת מחדל של --java_language_version=<a string>: "8"
גרסת השפה ב-Java
ברירת מחדל של --java_launcher=<a build target label>: תיאור
מרכז האפליקציות של Java לשימוש כשיוצרים קבצים בינאריים של Java. אם הדגל הזה מוגדר כמחרוזת ריקה, המערכת תשתמש במפעיל JDK. המאפיין "מרכז האפליקציות" מבטל את הסימון הזה.
ברירת מחדל של --java_runtime_version=<a string>: "local_jdk"
גרסת זמן הריצה של Java
נצברו --javacopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-Java.
נצברו --jvmopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-Java VM. האפשרויות האלה יתווספו לאפשרויות ההפעלה של VM בכל יעד Java_binary.
ברירת מחדל של --legacy_main_dex_list_generator=<a build target label>: תיאור
קביעת הקובץ הבינארי שבו יש להשתמש כדי ליצור את רשימת הכיתות שחייבות להיות בשרת ה-proxy הראשי במהלך הידור ה-Multiplexex הקודם.
נצברו --plugin=<a build target label> שימושים מרובים
יישומי פלאגין לשימוש ב-build. פועלים כרגע עם Java_plugins.
ברירת מחדל של --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() שמתארת איך להדר Cto++ Proto תגים: 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
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --proto_toolchain_for_javalite=<a build target label>: "@bazel_tools//tools/proto:Javalite_toolchain"
תווית Proto_lang_toolchain() שמתארת איך להדר פרוטומות של JavaLite
תגים: affects_outputs, loading_and_analysis
נצברו --protocopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה אל מהדר הפרוטוקול.
תגים: affects_outputs
ברירת מחדל של --[no]runs_per_test_detects_flakes: "false"
אם הערך מקבל את הערך True, כל פיצול שבו עובר ניסיון ריצה/ניסיון אחד לפחות ולפחות ניסיון ריצה אחד/ניסיון אחד נכשל, מקבל את הסטטוס FLAKY.
ברירת מחדל של --shell_executable=<a path>: תיאור
נתיב מוחלט להפעלה של קונכיות לשימוש בבזל. אם האפשרות הזו לא מוגדרת, המשתנה של סביבת 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_filter=<a string>: תיאור
קביעת מסנן להעברת למסגרת הבדיקה. משמש להגבלת הבדיקות. לתשומת ליבכם: אין לכך השפעה על היעדים המובנים.
ברירת מחדל של --test_result_expiration=<an integer>: "-1"
האפשרות הזו הוצאה משימוש ואין לה השפעה.
ברירת מחדל של --[no]test_runner_fail_fast: "false"
אם ההרצה לא תתבצע מהר, אפשר יהיה להריץ אותה. הרצת הבדיקה צריכה להפסיק את הביצוע אחרי הכשל הראשון.
ברירת מחדל של --test_sharding_strategy=<explicit or disabled>: "explicit"
יש לציין את השיטה לפיצול הבדיקה: 'explicit' כדי להשתמש בפיצול רק אם קיים המאפיין 'shard_count' 'disabled' לעולם לא להשתמש בפיצול בדיקה.
ברירת מחדל של --tool_java_language_version=<a string>: "8"
גרסת השפה של Java המשמשת לביצוע הכלים הנחוצים במהלך גרסת ה-build
ברירת מחדל של --tool_java_runtime_version=<a string>: "remotejdk_11"
גרסת זמן הריצה של Java המשמשת לביצוע כלים במהלך ה-build
ברירת מחדל של --[no]use_ijars: "true"
כשהאפשרות הזו מופעלת, הידור ה-Java משתמש בקונטיינרים של ממשק. כתוצאה מכך, האוסף המצטבר יהיה מהיר יותר, אבל הודעות השגיאה עשויות להיות שונות.

אפשרויות Build

אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
נצברו --distdir=<a path> שימושים מרובים
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים: bazel_internal_configuration
אם היא מוגדרת, המטמון של המאגר יקשר את הקובץ באופן ידני במקרה של היט מטמון, במקום העתקה. מטרת האחסון היא לחסוך מקום בכונן.
תגים: bazel_internal_configuration
ברירת מחדל של --[no]experimental_repository_cache_urls_as_default_canonical_id: "false"
אם הערך הוא TRUE, יש להשתמש במחרוזת שנגזרת מכתובות ה-URL של הורדות המאגר בתור ה-canonical_id אם לא צוין. במצב הזה, שינוי בכתובות ה-URL יוביל להורדה מחדש, גם אם המטמון מכיל הורדה עם אותו גיבוב. אפשר להשתמש בשיטה הזו כדי לאמת ששינויים בכתובת ה-URL לא גורמים להסתרה של מאגרים לא תקינים.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_repository_disable_download: "false"
אם היא מוגדרת, לא ניתן להוריד מאגרים חיצוניים.
תגים: 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
אפשרויות ששולטות בהפעלה של גרסת build:
ברירת מחדל של --[no]check_up_to_date: "false"
אין לבצע את ה-build, רק צריך לבדוק אם הוא מעודכן. אם כל היעדים עדכניים, ה-build הושלם בהצלחה. אם צריך לבצע שלב כלשהו, דיווח על שגיאה וה-build ייכשל.
תגים: execution
ברירת מחדל של --dynamic_local_execution_delay=<an integer>: "1000"
כמה אלפיות שנייה יש לדחות את הביצוע המקומי, אם ההפעלה מרחוק הייתה מהירה יותר במהלך build לפחות פעם אחת?
תגים: execution, host_machine_resource_optimizations
נצברו --dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment> שימושים מרובים
האסטרטגיות המקומיות, לפי סדר העדיפויות. עובר 'local' כפי שהמנמון מגדיר את ברירת המחדל לנגינה לא מוגדרת. מבצע [mnemonic=]local_strategi[,local_strategi,...]
תגים: execution, host_machine_resource_optimizations
נצברו --dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment> שימושים מרובים
האסטרטגיות המרוחקות שיש להשתמש בהן עבור המאפיין הרלוונטי. עובר 'שלט רחוק' כשמֶננה מוגדרת כברירת המחדל לנגינה לא מוגדרת. עובר [mnemonic=]remote_strategi[,remote_strategi,...]
תגים: execution, host_machine_resource_optimizations
ברירת מחדל של --experimental_docker_image=<a string>: ""
יש לציין שם של תמונת Docker (למשל "ubuntu:latest") שבו יש להשתמש כדי לבצע פעולה שמתבצעת בארגז חול בעת שימוש בשיטת Docker והפעולה עצמה לא מכילה מאפיין של תמונת מאגר ב-remote_execution_Assets בתיאור הפלטפורמה. הערך של הדגל הזה מועבר מילולית ל-'docker Run' לכן הוא תומך בתחביר ובמנגנונים זהים לאלה של Docker עצמה.
תגים: execution
ברירת מחדל של --[no]experimental_docker_use_customized_images: "true"
אם האפשרות הזו מופעלת, תהיה לך אפשרות להזריק את המזהה וה-id של המשתמש הנוכחי לתמונה ב-Docker לפני השימוש בה. פעולה זו נדרשת אם ה-build / הבדיקות תלויות במשתמש שיש לו שם וספריית בית בתוך מאגר התגים. פעולה זו מופעלת כברירת מחדל, אך ניתן להשבית אותה אם תכונת ההתאמה האישית האוטומטית של תמונות אינה פועלת במקרה שלך, או אם ידוע לך שאין צורך בה.
תגים: execution
ברירת מחדל של --[no]experimental_dynamic_exclude_tools: "true"
כשהאפשרות מוגדרת, יעדים שמוגדרים כ- "בכלי&מירכאות; לא כפופים לביצוע דינמי. סביר להניח שיעדים כאלה לא יחושבו באופן מצטבר, ולכן לא כדאי להוציא כסף על מחזורים מקומיים.
תגים: execution, host_machine_resource_optimizations
ברירת מחדל של --experimental_dynamic_local_load_factor=<a double>: "0"
לקבוע כמה עומס מביצוע דינמי לביצוע במכונה המקומית. הדגל הזה מתאים את מספר הפעולות בהפעלה דינמית שנתזמן בו-זמנית. הוא מבוסס על מספר המעבדים שמערכת Blaze מחשיבה כזמינים. ניתן לשלוט בהם באמצעות התכונה הניסיונית --local_cpu_resources. אם הסימון הזה הוא 0, כל הפעולות מתוכננות באופן מקומי. אם > 0, מספר הפעולות המתוזמנות באופן מקומי מוגבל במספר המעבדים הזמינים. אם < 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"
הפעלת ארגז חול מבוסס Docker. לאפשרות הזו אין השפעה אם Docker לא מותקן.
תגים: 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 כאשר ה-build פועל, והוא גדל לגודל שצוין בסימון הזה כאשר השרת לא פעיל.
תגים: host_machine_resource_optimizations, execution
ברירת מחדל של --experimental_sandboxfs_path=<a string>: "sandboxfs"
הנתיב לבינארי של ארגז החול צריך להיות בשימוש כאשר --experimental_use_sandboxfs נכון. אם השם הבסיסי הוא השם הבינארי הראשון שמופיע בשם הזה בנתיב Path Analytics.
תגים: host_machine_resource_optimizations, execution
ברירת מחדל של --[no]experimental_split_xml_generation: "true"
אם הדגל הזה הוגדר ופעולת בדיקה לא יוצרת קובץ Test.xml, Bazel משתמשת בפעולה נפרדת כדי ליצור קובץ דמה מסוג XML.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"
אם המדיניות מוגדרת כ-True, אין לטעון את השורש. יש לטעון רק את מה שסופק עם sandbox_add_Mountain_pair. קובצי קלט יקושרו באופן רציף לארגז החול במקום למקושר מארגז החול. אם קובצי הקלט של הפעולה ממוקמים במערכת קבצים שונה מארגז החול, קובצי הקלט יועתקו במקום זאת.
תגים: execution
ברירת מחדל של --[no]experimental_use_sandboxfs: "false"
משתמשים ב-Sandboxf כדי ליצור את הפעולות' מפעילים ספריות במקום לבנות עץ קישור סימבולי. אם "yes", הקובץ הבינארי שסופק על ידי -experimental_sandboxfs_path חייב להיות חוקי ולהתאים לגרסה נתמכת של sandboxfs. אם "auto", ייתכן שהקובץ הבינארי יהיה חסר או לא תואם.
תגים: host_machine_resource_optimizations, execution
ברירת מחדל של --[no]experimental_use_windows_sandbox: "false"
שימוש בארגז החול של Windows כדי להריץ פעולות. אם "yes", הקובץ הבינארי שסופק על ידי -experimental_windows_sandbox_path חייב להיות חוקי ולהתאים לגרסה נתמכת של sandboxf. אם "auto", ייתכן שהקובץ הבינארי יהיה חסר או לא תואם.
ברירת מחדל של --experimental_windows_sandbox_path=<a string>: "BazelSandbox.exe"
הנתיב לבינארי של ארגז החול של Windows שיש להשתמש בו ---experimental_use_windows_sandbox נכון. אם השם הבסיסי הוא השם הבינארי הראשון שמופיע בשם הזה בנתיב Path Analytics.
ברירת מחדל של --[no]experimental_worker_as_resource: "false"
כשהאפשרות מופעלת, העובדים מצרפים משאבים מ-Resource Manager.
תגים: execution, host_machine_resource_optimizations
ברירת מחדל של --[no]experimental_worker_cancellation: "false"
אם האפשרות הזו מופעלת, Bazel יכולה לשלוח בקשות ביטול לעובדים שתומכים בהן.
תגים: execution
ברירת מחדל של --[no]experimental_worker_multiplex: "true"
אם האפשרות הזו מופעלת, עובדים שתומכים בתכונת הכפל הניסיונית ישתמשו בתכונה הזו.
תגים: execution, host_machine_resource_optimizations
ברירת מחדל של --[no]experimental_worker_multiplex_sandboxing: "false"
אם האפשרות מופעלת, עובדי Multiplex יועברו לארגז חול באמצעות ספריית ארגז חול נפרדת לכל בקשת עבודה. רק עובדים שיש להם 'supports-multix-sandboxing' דרישה להפעלה בארגז חול.
תגים: execution
ברירת מחדל של --[no]experimental_worker_strict_flagfiles: "false"
אם המדיניות מופעלת, ארגומנטים של פעולות לעובדים שלא עומדים בדרישות של מפרט העובד יגרמו לשגיאה. בארגומנטים של עובדים חייב להיות ארגומנט @flagfile אחד בלבד בתור הארגומנטים של רשימת הארגומנטים.
תגים: execution
ברירת מחדל של --genrule_strategy=<comma-separated list of options>: ""
יש לציין כיצד לבצע יצירת כללי. הסימון הזה ייצא משימוש. במקום זאת, אפשר להשתמש ב- --spawn_strategi=<value> כדי לשלוט בכל הפעולות או ב--strategi=Genrule=<value> כדי לשלוט רק בכללים.
תגים: execution
נצברו --high_priority_workers=<a string> שימושים מרובים
מוניקה של עובדים שרוצים לפעול בעדיפות גבוהה. כאשר עובדים עם עדיפות גבוהה פועלים, כל שאר העובדים מווסתים.
תגים: execution
אם המדיניות מוגדרת כ-True ו- --incompatible_remote_symlinks הוא גם נכון, קישורים מסולסלים בפלטי פעולה מורשים להתנתק.
תגים: execution, incompatible_change
אם המדיניות מוגדרת כ-TRUE, Bazel תייצג קישורים סימבוליים בפלטי פעולות בפרוטוקול השמירה במטמון/הביצוע מרחוק. אחרת, יתבצע מעקב אחר קישורים סימבוליים ויוצגו כקבצים או כספריות. פרטים נוספים זמינים בדף #6631.
תגים: execution, incompatible_change
ברירת מחדל של --[no]incompatible_sandbox_hermetic_tmp: "false"
אם המדיניות מוגדרת כ-True, לכל ארגז חול של Linux תהיה ספרייה ייעודית ריקה שתותקן בתור /tmp ולא לשיתוף עם /tmp עם מערכת הקבצים של המארח. משתמשים ב- --sandbox_add_Mountain_pair=/tmp כדי להמשיך לראות את המארח /t33;s/tmp בכל ארגזי החול.
תגים: execution
ברירת מחדל של --[no]internal_spawn_scheduler: "false"
אפשרות מציין מיקום כדי שנוכל לדעת ב-Blaze אם מתזמן ההתרעה הופעל.
תגים: 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"
מספר המשימות במקביל. הפרמטר מכיל מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ואחריו אופציונלי (למשל, [-|*]<float>) למשל. "auto", "HOST_CPUS*.5". הערכים צריכים להיות בין 1 ל-5000. ערכים גדולים מ-2,500 עלולים לגרום לבעיות בזיכרון. "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"
מספר השרשורים המקבילים שיש להשתמש בהם בשלב הטעינה/הניתוח.נלקחים מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ובדרך כלל מוסיפים פעולה ([-|*]<float>) למשל. "auto", "HOST_CPUS*.5". "auto" מגדיר ברירת מחדל סבירה על סמך משאבים למארחים. הערך חייב להיות לפחות 1.
תגים: bazel_internal_configuration
ברירת מחדל של --[no]reuse_sandbox_directories: "false"
אם המדיניות מוגדרת כ-True, אפשר להשתמש שוב בספריות שבהן נעשה שימוש בהפעלה לא ב-Sandbox כדי להימנע מעלויות מיותרות להגדרה.
תגים: host_machine_resource_optimizations, execution
ברירת מחדל של --sandbox_base=<a string>: ""
מאפשרת ל-Sandbox ליצור את ספריות ארגז החול מתחת לנתיב הזה. אפשר לציין נתיב ב-tmpfs (כמו /run/shm) כדי לשפר את הביצועים לעיתים קרובות כאשר גרסאות build / בדיקות כוללות קובצי קלט רבים. הערה: יש צורך בשטח RAM מספיק ובשטח פנוי בכונן ה-tmpf כדי לשמור פלט וקובצי ביניים שנוצרו על ידי הפעלת פעולות.
תגים: host_machine_resource_optimizations, execution
ברירת מחדל של --[no]sandbox_explicit_pseudoterminal: "false"
הפעלה מפורשת של יצירת פסאודומינרליים לפעולות בארגז חול. בהפצה לינארית מסוימת צריך להגדיר את מזהה הקבוצה כ-&339;tty' בתוך ארגז החול כדי שפסאודומטרינים יפעלו. אם זה גורם לבעיות, המערכת יכולה להשבית את הסימון הזה כדי לאפשר שימוש בקבוצות אחרות.
תגים: execution
נצברו --sandbox_tmpfs_path=<an absolute path> שימושים מרובים
לפעולות בארגז חול, יש להציב ספרייה ריקה וכתיבה בנתיב המוחלט הזה (אם אין תמיכה בהטמעת ארגז החול, יש להתעלם ממנה).
תגים: host_machine_resource_optimizations, execution
ברירת מחדל של --spawn_strategy=<comma-separated list of options>: ""
מציינים כברירת מחדל איך יבוצעו פעולות ריבוי. מקבלת רשימת אסטרטגיות המופרדות בפסיקים, מהעדיפות הגבוהה ביותר לנמוכה. עבור כל פעולה, Bazel בוחרת את האסטרטגיה עם העדיפות הגבוהה ביותר שיכולה לבצע את הפעולה. ערך ברירת המחדל הוא "remote,work,sandboxed,local". פרטים נוספים זמינים בכתובת https://blog.bazel.build/2019/06/19/list-strategi.html.
תגים: execution
נצברו --strategy=<a '[name=]value1[,..,valueN]' assignment> שימושים מרובים
יש לציין איך להפיץ אוסף של פעולות הפקה אחרות. מקבלת רשימת אסטרטגיות המופרדות בפסיקים, מהעדיפות הגבוהה ביותר לנמוכה. עבור כל פעולה, Bazel בוחרת את האסטרטגיה עם העדיפות הגבוהה ביותר שיכולה לבצע את הפעולה. ערך ברירת המחדל הוא "remote,work,sandboxed,local". הדגל הזה מבטל את הערכים שהוגדרו על ידי --spawn_strategi (וכן --genrule_strategi אם משתמשים בהם ב-Genemonic Genrule). פרטים נוספים זמינים בכתובת https://blog.bazel.build/2019/06/19/list-strategi.html.
תגים: execution
נצברו --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> שימושים מרובים
כדאי לשנות את שיטת ה-Spמקו. לפרטים על התאמות של ביטוי רגולרי_filter יש לעיין בקטע --per_file_copt. נעשה שימוש ב-regex_filter הראשון שתואם לתיאור. אפשרות זו מבטלת סימונים אחרים לציון אסטרטגיה. דוגמה: --strategi_regexp=//foo.*\.cc,-//foo/bar=local הוא סימן להרצת פעולות באמצעות שיטה מקומית, אם התיאורים שלהן תואמים ל-//foo.*.cc אבל לא ל-//foo/bar. דוגמה: --strategi_regexp='Compiling.*/bar=local --strate יהיו
תגים: execution
נצברו --worker_extra_flag=<a 'name=value' assignment> שימושים מרובים
התרעות נוספות על פקודות שיועברו לתהליכים של עובדים, בנוסף ל- -persistent_worker, לפי זכרונות (לדוגמה --worker_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) יכולים לפעול אם משתמשים בשיטה 'worker' ניתן לציין את הערך [name=value] כדי להקצות ערך שונה לכל עובד. הפרמטר מכיל מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ואחריו אופציונלי (למשל, [-|*]<float>) למשל. "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"> שימושים מרובים
כמה בקשות של WorkRequest נדרשות למספר עובדים במקביל, אם משתמשים בשיטת 'worker' עם ניתן לציין את הערך [name=value] כדי להקצות ערך שונה לכל עובד. הפרמטר מכיל מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ואחריו אופציונלי (למשל, [-|*]<float>) למשל. "auto", "HOST_CPUS*.5". 'auto' מחשבת ברירת מחדל סבירה בהתאם לקיבולת המכונה. "=value" מגדיר ברירת מחדל לניבים לא מוגדרים.
תגים: execution, host_machine_resource_optimizations
ברירת מחדל של --[no]worker_quit_after_build: "false"
אם ההגדרה מופעלת, כל העובדים מפסיקים לאחר סיום ה-build.
תגים: execution, host_machine_resource_optimizations
ברירת מחדל של --[no]worker_sandboxing: "false"
כשהאפשרות מופעלת, העובדים יוצאו לסביבת ארגז חול.
תגים: execution
ברירת מחדל של --[no]worker_verbose: "false"
אם אפשרות זו מופעלת, הדפסה של הודעות מפורט כאשר העובדים מתחילים, נסגרים, ...
אפשרויות שמגדירות את כלי השירות המשמש לביצוע הפעולה:
ברירת מחדל של --[no]incompatible_disable_runtimes_filegroups: "false"
אין הוצאה משימוש.
תגים: action_command_lines, loading_and_analysis, deprecated, incompatible_change
ברירת מחדל של --[no]incompatible_dont_emit_static_libgcc: "true"
אין הוצאה משימוש.
תגים: action_command_lines, loading_and_analysis, deprecated, incompatible_change
No-op שהוצא משימוש.
תגים: action_command_lines, loading_and_analysis, deprecated, incompatible_change
אפשרויות ששולטות בפלט של הפקודה:
ברירת מחדל של --[no]build: "true"
יש לבצע את ההרכב. זו ההתנהגות הרגילה. ציון -nobuild גורם ל-build לעצור לפני ביצוע פעולות ה-build, ומחזיר אפס אם שלבי הטעינה והניתוח של החבילה הושלמו בהצלחה. מצב זה שימושי לבדיקת השלבים האלה.
תגים: execution, affects_outputs
ברירת מחדל של --[no]experimental_run_validations: "true"
יש להשתמש במקום זאת --run_validations.
תגים: execution, affects_outputs
ברירת מחדל של --[no]experimental_use_validation_aspect: "false"
האם להריץ פעולות אימות באמצעות היבט כלשהו (לשילוב במקביל עם בדיקות)?
תגים: execution, affects_outputs
נצברו --output_groups=<comma-separated list of options> שימושים מרובים
רשימה של שמות של קבוצות פלט המופרדים בפסיקים, שלכל אחד מהם יש קידומת + או -. קבוצה שקידומתה מתחילה ב-+ מתווספת לקבוצת ברירת המחדל של קבוצות פלט, ואילו קבוצה עם קידומת - תוסר מקבוצת ברירת המחדל. אם לפחות קבוצה אחת לא כוללת קידומת, המערכת תשמיט את קבוצת ברירת המחדל של קבוצות הפלט. לדוגמה,
תגים: execution, affects_outputs
ברירת מחדל של --[no]run_validations: "true"
האם להריץ פעולות אימות כחלק מה-build? פרטים נוספים זמינים בכתובת https://bazel.build/rules/rules#validation_actions
תגים: execution, affects_outputs
אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, וכך להשפיע על הערך שלו, בניגוד לעצם קיומו:
נצברו --aspects=<comma-separated list of options> שימושים מרובים
רשימת היבטים המופרדים בפסיקים, שיחולו על יעדים ברמה העליונה. ברשימה, אם היבט some_aspect מציין ספקי היבט נדרשים דרך additional_aspect_providers, אז ערך some_aspect יפעל לאחר כל היבט שהוזכר לפניו ברשימת ההיבטים שהספקים שלהם מפרסמים שמצייתים לספקי הצד הנדרשים. בנוסף, לרכיב no_aspect תהיה אפשרות להפעיל אחרי כל ההיבטים הנדרשים שצוינו. לאחר מכן, ל-some_aspect תהיה גישה לערכים של אותם היבטים. <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
סימון זה יקבע איך ינוהלו הקישורים הסימבוליים (הסמלים המקבילים שמופיעים בסביבת העבודה אחרי ה-build). ערכים אפשריים: רגילה (ברירת מחדל): כל סוג של קישור סימולציית נוחות ייווצר או יימחק, כפי שנקבע על ידי ה-build. נקי: כל הקישורים הסימבוליים יימחקו ללא תנאי. התעלמות: הקישורים הקטנים נשארים לבד. log_only: יצירת הודעות יומן כאילו הן #&39;normal' הועברו, אך לא מתבצעות בפועל פעולות של מערכת קבצים (שימושיות לכלים). לידיעתך, ניתן להשפיע רק על קישורים סימבוליים ששמותיהם נוצרים על ידי הערך הנוכחי, --symlink_prefix. אם הקידומת משתנה, כל קישור קיים קיים יישאר ריק.
תגים: affects_outputs
הסימון הזה קובע אם נפרסם את אירוע buildConvenienceSymlinksIdentified ל-BuildEventProtocol. אם הערך הוא true, ל-BuildEventProtocol תהיה רשומה עבור consoleSymlinksIdentified, הכוללת את כל קישורי הנוחות שנוצרו בסביבת העבודה שלך. אם הערך הוא FALSE, הרשומה נוחת SymlinksIdentified ב-BuildEventProtocol תהיה ריקה.
תגים: affects_outputs
נצברו --experimental_multi_cpu=<comma-separated list of options> שימושים מרובים
הוצא משימוש. לא.
תגים: affects_outputs, experimental
--remote_download_minimal
לא תתבצע הורדה של פלטי build מרוחקים אל המכונה המקומית. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=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' לא מורידה פלט של build מרחוק אל המכונה המקומית, חוץ מאלה הנדרשות על ידי פעולות מקומיות. אם המדיניות מוגדרת כ-'toplevel' היא פועלת כך'minimal' מלבד זאת, מתבצעת הורדה של פלט של יעדים ברמה העליונה למחשב המקומי. שתי האפשרויות יכולות לקצר משמעותית את זמני הבנייה אם רוחב הפס של הרשת הוא צוואר בקבוק.
תגים: affects_outputs
במקום להוריד פלט של build מרחוק, אפשר ליצור קישורים סימבוליים. ניתן לציין את יעד הקישורים המסמלים בצורת מחרוזת תבנית. מחרוזת התבנית הזו עשויה להכיל {hash} ו-{size_bytes} שמתרחבים לאובייקט ולגודל בבייטים, בהתאמה. הקישורים הסמליים האלה עשויים, למשל, להפנות למערכת קבצים של FUSE שטוענת אובייקטים מ-CAS לפי דרישה.
תגים: affects_outputs
--remote_download_toplevel
רק מכונה מקומית יכולה להוריד פלט מרחוק של יעדים ברמה העליונה. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=toplevel.
מתרחב אל:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel

תגים: affects_outputs
הקידומת שמצורפת לכל אחד מסמלי הקישור לנוחות שנוצרות אחרי גרסת ה-build. אם לא מופיעה, ערך ברירת המחדל הוא השם של כלי ה-build ואחריו מקף. אם הכתובת '/' מועברת, לא נוצר קישור סימולטני ולא נוצרת אזהרה. אזהרה: הפונקציונליות המיוחדת של '/' תוצא משימוש בקרוב. במקומה יש להשתמש ב- --experimental_convenience_symlinks=ignore.
תגים: affects_outputs
אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
ברירת מחדל של --[no]experimental_docker_privileged: "false"
אם האפשרות מופעלת, Bazel תעביר את הסימון 'בעדיפות' ל-'דוקטור בהרצה' בעת הרצת פעולות. יכול להיות שהדרישה הזו תדרוש את גרסת ה-build שלכם, אבל היא גם עלולה לפגוע בהימור.
תגים: execution
ברירת מחדל של --experimental_repository_hash_file=<a string>: ""
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים: affects_outputs, experimental
אם הערך הוא true, מתבצע מיפוי של היעדים של הקישורים הסמליים שצוינו כקלטים של פעולות בארגז החול. תכונה זו קיימת אך ורק כדי לעקוף כללי באגים שאינם עושים זאת בעצמם. יש להסיר אותה לאחר תיקון כל הכללים.
תגים: 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, המדיניות מאפשרת להשתמש בחלופה המשתמעת מהדור הקודם מארגז החול לשיטה מקומית. בסופו של דבר, הדגל הזה יוגדר כברירת מחדל כ-false ולאחר מכן יוגדר כ'לא-פעילות'. ניתן להשתמש במקום זאת ב---stratety, --spawn_strategi או --Dynamic_local_strategi כדי להגדיר חזרה למצב ראשוני.
תגים: 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"
הרשאת גישה לרשת כברירת מחדל לפעולות. ייתכן שהיא לא תפעל עם כל ההטמעות של ארגז החול.
ברירת מחדל של --[no]sandbox_fake_hostname: "false"
אפשר לשנות את שם המארח הנוכחי ל-'localhost' לפעולות בארגז חול.
תגים: execution
ברירת מחדל של --[no]sandbox_fake_username: "false"
אפשר לשנות את שם המשתמש הנוכחי ל-'nobody' לפעולות בארגז חול.
תגים: execution
נצברו --sandbox_writable_path=<a string> שימושים מרובים
לפעולות בארגז חול, יש ליצור ספרייה קיימת שניתן לכתוב בארגז החול (אם המערכת תומכת בהטמעה של ארגז החול, המערכת תתעלם ממנה).
תגים: execution
האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי .bzl או קובצי WORKSPACE.:
ברירת מחדל של --[no]experimental_allow_top_level_aspects_parameters: "true"
לא:
תגים: no_op, deprecated, experimental
ברירת מחדל של --[no]incompatible_config_setting_private_default_visibility: "false"
אם לא תואם_enforce_config_setting_visible=false, זו שגיאה. אחרת, אם הסימון הזה הוא false, כל הגדרת config_ללא מאפיין חשיפה בוטה היא //visible: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. אם הערך הוא False, כל config_setting גלויה לכל יעד. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים: loading_and_analysis, incompatible_change
אפשרויות שקובעות את אופן הפעולה של סביבת הבדיקה או של אופרטור הבדיקה:
ברירת מחדל של --[no]check_tests_up_to_date: "false"
אין להריץ בדיקות. יש לבדוק אם הן מעודכנות. אם כל תוצאות הבדיקות מעודכנות, הבדיקה הושלמה בהצלחה. אם יש צורך לבצע או להפעיל בדיקה כלשהי, מדווחת על שגיאה והבדיקה נכשלה. אם בוחרים באפשרות הזו, פירוש הדבר הוא --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'. אם מספר שלם, כל הבדיקות יופעלו עד N פעמים. אם 'default', יבוצע ניסיון בדיקה אחד בלבד בבדיקות רגילות ושלושה בבדיקות שסומנו באופן מפורש ככללי על ידי הכלל שלהם (Flaky=1). תחביר חלופי: regex_filter@flky_test_attempts. כאשר Flaky_test_attempts נמצא למעלה, ו-regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (ראו גם --runs_per_test). דוגמה: -flky_test_attempts=//foo/.*,-//foo/bar/.*@3 ניתן להעביר את האפשרות הזו כמה פעמים. הארגומנט האחרון שהועבר תואם לעדיפות. אם לא נמצאה התאמה, ההתנהגות היא כאילו '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"
המספר המקסימלי של משימות בדיקה מקומיות שפועלות בו-זמנית. הפרמטר מכיל מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ואחריו אופציונלי (למשל, [-|*]<float>) למשל. "auto", "HOST_CPUS*.5". 0 פירושו שמשאבים מקומיים יגבילו את מספר משימות הבדיקה המקומיות להפעלה בו-זמנית. ההגדרה הזו גדולה יותר מהערך של jobs היא לא אפקטיבית.
תגים: execution
ברירת מחדל של --[no]test_keep_going: "true"
כשהבדיקה מושבתת, כל הבדיקות שלא עברו יגרמו להפסקה של כל ה-build. כברירת מחדל, כל הבדיקות פועלות, גם אם חלק מהן לא עוברות.
תגים: execution
ברירת מחדל של --test_strategy=<a string>: ""
קביעת השיטה שבה רוצים להפעיל בדיקות.
תגים: execution
ברירת מחדל של --test_tmpdir=<a path>: תיאור
מפרט את הספרייה הזמנית הבסיסית עבור 'בדיקת B&z#39; לשימוש.
אפשרויות שקשורות לפלט של Bzlmod וסמנטיקה:
נצברו --allow_yanked_versions=<a string> שימושים מרובים
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים: loading_and_analysis
ברירת מחדל של --check_bazel_compatibility=<error, warning or off>: "error"
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים: loading_and_analysis
ברירת מחדל של --check_direct_dependencies=<off, warning or error>: "warning"
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים: loading_and_analysis
ברירת מחדל של --[no]ignore_dev_dependency: "false"
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-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"
הוצא משימוש. לא.
תגים: affects_outputs
ברירת מחדל של --[no]debug_spawn_scheduler: "false"
ברירת מחדל של --[no]experimental_bep_target_summary: "false"
אם רוצים לפרסם אירועי סיכום סיכום.
ברירת מחדל של --[no]experimental_build_event_expand_filesets: "false"
אם הערך הוא TRUE, מרחיבים את FilesApps ב-BEP כשמציגים קובצי פלט.
תגים: affects_outputs
אם הערך הוא True, יש לפתור בצורה מלאה את סמלי הקישור היחסיים של Fileset ב-BEP כשמציגים קובצי פלט. נדרשת -experimental_build_event_expand_filesets.
תגים: affects_outputs
ברירת מחדל של --experimental_build_event_upload_max_retries=<an integer>: "4"
מספר הפעמים המקסימלי שחברת Bazel מנסה להעלות אירוע build.
תגים: bazel_internal_configuration
ברירת מחדל של --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1s"
השהיה מינימלית עד לעיכוב מעריכי של ניסיונות חוזרים כאשר העלאה של BEP נכשלה. (מעריך: 1.6)
תגים: bazel_internal_configuration
ברירת מחדל של --experimental_build_event_upload_strategy=<a string>: תיאור
בחירה איך להעלות פריטי מידע שנוצרים בתהליך פיתוח (Artifact) המוזכרים בפרוטוקול של אירוע ה-build.
תגים: affects_outputs
ברירת מחדל של --[no]experimental_collect_local_sandbox_action_metrics: "true"
כשהאפשרות מופעלת, נתונים סטטיסטיים של הפעלה (כמו זמן המשתמש והמערכת) מתועדים עבור פעולות שבוצעו באופן מקומי ושנעשה בהן שימוש בארגז חול
תגים: execution
ברירת מחדל של --[no]experimental_docker_verbose: "false"
אם האפשרות מופעלת, Bazel תדפיס הודעות מפורטות יותר לגבי אסטרטגיית ארגז החול של Docker.
תגים: execution
ברירת מחדל של --[no]experimental_materialize_param_files_directly: "false"
אם יוצרים קובצי עזר, צריך לעשות זאת בכתיבה ישירה לדיסק.
תגים: execution
ברירת מחדל של --[no]experimental_record_metrics_for_all_mnemonics: "false"
כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
ברירת מחדל של --experimental_repository_resolved_file=<a string>: ""
אם לא ריק, כותבים ערך של Starlark עם הפרטים שנפתרו לגבי כל כללי המאגר של Starlark שבוצעו.
תגים: affects_outputs
ברירת מחדל של --[no]experimental_stream_log_file_uploads: "false"
אפשר להעביר העלאות של קובצי יומן ישירות לאחסון המרוחק, במקום לכתוב אותם בדיסק.
תגים: affects_outputs
ברירת מחדל של --explain=<a path>: תיאור
מערכת המודל גורמת להסבר על כל שלב בביצוע ה-build. ההסבר נכתב בקובץ היומן שצוין.
תגים: affects_outputs
ברירת מחדל של --[no]legacy_important_outputs: "true"
אפשר להשתמש בכך כדי להסתיר יצירה של שדה חשוב_פלט קודם באירוע Targetcomplete. נדרשים שילובים חשובים של Basel עד ResultStore.
תגים: affects_outputs
ברירת מחדל של --[no]materialize_param_files: "false"
כותבים קובצי פרמטרים בינוניים לעץ הפלט גם כשמשתמשים בביצוע פעולות מרחוק. שימושי לניפוי באגים בפעולות. זה מרמז על כך – subsubmands ו- --verbose_failures.
תגים: execution
ברירת מחדל של --max_config_changes_to_show=<an integer>: "3"
כשמוחקים את מטמון הניתוח עקב שינוי באפשרויות build, מוצג מספר נתון של שמות אפשרויות. אם המספר הנתון הוא 1-, כל האפשרויות שהשתנו יוצגו.
תגים: terminal_output
ברירת מחדל של --max_test_output_bytes=<an integer>: "-1"
ההגדרה קובעת את הגודל המרבי של יומן בדיקה לכל משתמש כאשר --test_פלט הוא 'שגיאות' או '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"
אתם יכולים לבחור מתי תרצו להדפיס הודעות של ביצוע מרחוק. הערכים התקינים הם 'כשל', כדי להדפיס רק כשלים, 'הצלחה' כדי להדפיס רק את ההצלחות, ו'הכול' כדי להדפיס תמיד.
תגים: terminal_output
ברירת מחדל של --[no]sandbox_debug: "false"
הפעלת תכונות ניפוי באגים לתכונה 'ארגז חול'. הדבר כולל שני דברים: קודם כול, התוכן הבסיסי של ארגז החול נשאר ללא שינוי לאחר יצירת build (ואם נעשה שימוש ב-Sandboxfs, מערכת הקבצים נשארת מותקנת במקום השני) ומדפיסה מידע נוסף על תוצאות ניפוי הבאגים במהלך הביצוע. פעולה זו יכולה לעזור למפתחים של כללי Bazel או Starlark עם כשלי ניפוי באגים בגלל קובצי קלט חסרים וכו'.
תגים: terminal_output
ברירת מחדל של --show_result=<an integer>: "1"
הצגת התוצאות של ה-build. עבור כל יעד, מציינים אם הוא הועלה, ואם כן, רשימה של קובצי פלט שנוצרו. הקבצים המודפסים הם מחרוזות נוחות להעתקה ולהדבקה למעטפת, כדי להפעיל אותן. כדי להשתמש באפשרות הזו, נדרש ארגומנט של מספר שלם, שהוא מספר הסף של היעדים שעליהם לא מדפיסים את פרטי התוצאה. לכן אפס גורם למחיקת ההודעה ו-MAX_INT גורם להדפסת התוצאה להופיע תמיד. ברירת המחדל היא אחת.
תגים: affects_outputs
--[no]subcommands [-s] ברירת מחדל: "false"
הצגת פקודות המשנה שבוצעו במהלך ה-build. סימונים קשורים: --execution_log_json_file, --execution_log_binary_file (לתיעוד פקודות משנה לקובץ בפורמט ידידותי לכלי).
תגים: terminal_output
ברירת מחדל של --test_output=<summary, errors, all or streamed>: "summary"
קביעת מצב הפלט הרצוי. הערכים החוקיים הם 'summary' לפלט סיכום של סטטוס בדיקה בלבד, 'errors' להדפסת יומני בדיקה גם עבור בדיקות שנכשלו, 'all' להדפסת יומנים עבור כל הבדיקות בזמן אמת (פעולה זו תאלץ את ביצוע הבדיקות באופן מקומי אחד בכל פעם --_).
תגים: test_runner, terminal_output, execution
ברירת מחדל של --test_summary=<short, terse, detailed, none or testcase>: "short"
ההגדרה היא הפורמט הרצוי של סיכום הבדיקה. ערכים חוקיים הם 'short' כדי להדפיס מידע רק על בדיקות שבוצעו, 'terse' כדי להדפיס מידע רק על בדיקות שנכשלו; 'detailed' כדי להדפיס סיכום מפורט בתרחיש של בדיקת בדיקה; אין להדפיס מידע מפורט על מקרים של מקרה בדיקה ו-39;
תגים: terminal_output
ברירת מחדל של --[no]verbose_explanations: "false"
יש להגדיל את המלל של ההסברים שהונפקו, אם ההסבר הזה מופעל. אין השפעה אם --Excel לא מופעל.
תגים: affects_outputs
ברירת מחדל של --[no]verbose_failures: "false"
אם פקודה לא מצליחה, מומלץ להדפיס את שורת הפקודה המלאה.
תגים: terminal_output
אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
נצברו --aspects_parameters=<a 'name=value' assignment> שימושים מרובים
ההגדרה קובעת את הערכים של הפרמטרים של היבטים בשורת הפקודה. כל ערך של פרמטר מצוין דרך <param_name>=<param_value> לדוגמה, 'my_param=my_val' כאשר 'my_param' הוא פרמטר של היבט כלשהו ב'רשימת ההיבטים' או שהוא נדרש על ידי היבט ברשימה. ניתן להשתמש באפשרות הזו כמה פעמים. עם זאת, אסור להקצות ערכים לאותו פרמטר יותר מפעם אחת.
תגים: loading_and_analysis
ברירת מחדל של --experimental_resolved_file_instead_of_workspace=<a string>: ""
אם הקובץ לא ריק, קראו את הקובץ שצוין ולא את קובץ ה-WORKSPACE
תגים: changes_inputs
ברירת מחדל של --target_pattern_file=<a string>: ""
אם אפשרות זו מוגדרת, גרסת ה-build תקרא תבניות מהקובץ שנקרא כאן, במקום בשורת הפקודה. שגיאה בציון קובץ כאן וגם בדפוסי שורת פקודה.
תגים: changes_inputs
אפשרויות שמירה במטמון והפעלה מרחוק:
ברירת מחדל של --experimental_downloader_config=<a string>: תיאור
מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
ברירת מחדל של --[no]experimental_guard_against_concurrent_changes: "false"
כדי להשבית את הבדיקה של קובצי קלט עבור פעולה מסוימת לפני שמעלים אותה למטמון מרוחק, יש להשבית את הזמן. ייתכנו מקרים שבהם הליבה של Linux מעכבת כתיבה של קבצים, מה שעלול לגרום לתוצאות חיוביות שקריות.
ברירת מחדל של --experimental_remote_build_event_upload=<all or minimal>: "all"
אם המדיניות מוגדרת כ-'all' כל הפלט המקומי שאליו מפנה BEP מועלה למטמון מרוחק. אם המדיניות מוגדרת כ-'minimal' פלטים מקומיים ש-BEP מפנה אליהם לא מועלים למטמון המרוחק, מלבד קבצים שחשובים לצרכנים של BEP (למשל יומני בדיקה ופרופיל תזמון). סכימת //:file משמשת לנתיבים של קבצים מקומיים וסכימת בייטstream:// משמשת לנתיבים של קבצים שהועלו (כבר). ברירת המחדל היא 'all'.
ברירת מחדל של --[no]experimental_remote_cache_async: "false"
אם הערך הוא TRUE, מטמון I/O מרוחק יתרחש ברקע במקום להיווצר כחלק מ-S מדויקת.
ברירת מחדל של --[no]experimental_remote_cache_compression: "false"
אם האפשרות מופעלת, אפשר לדחוס או לפרוס בועות של מטמון עם zstd.
ברירת מחדל של --experimental_remote_capture_corrupted_outputs=<a path>: תיאור
נתיב לספרייה שבה יילכו פלטים פגומים.
ברירת מחדל של --experimental_remote_downloader=<a string>: תיאור
URI של נקודת קצה ל-API של נכס מרוחק, שישמש כשרת proxy להורדה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. בכתובת: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
ברירת מחדל של --[no]experimental_remote_downloader_local_fallback: "false"
אם אתם רוצים לחזור לכלי ההורדה המקומי, אם ההורדה מרחוק נכשלה.
ברירת מחדל של --[no]experimental_remote_execution_keepalive: "false"
האם להשתמש ב-Keepalive בשיחות ביצוע מרחוק?
ברירת מחדל של --experimental_remote_grpc_log=<a path>: תיאור
אם צוין, נתיב לקובץ שבו יתבצע רישום של פרטים הקשורים לשיחת gRPC. היומן הזה מורכב מרצף של com.google.devtools.build.lib.remote.logging.remoteExecutionLog.LogEntry Protobufs עם כל הודעה המסומנת ב-varint המציין את גודל ההודעה הבאה עם פסיק.
ברירת מחדל של --[no]experimental_remote_mark_tool_inputs: "false"
אם היא מוגדרת כ-True, ה-Bazel יסמן את הקלט בתור קלט לכלי הפעולה מרחוק. אפשר להשתמש באפשרות הזאת כדי להטמיע עובדים קבועים מרחוק.
ברירת מחדל של --[no]experimental_remote_merkle_tree_cache: "false"
אם המדיניות מוגדרת כ-True, החישובים של עץ ה-Merkle יסונכרנו כדי לשפר את מהירות הבדיקה של ההיט המרוחק. ביצועי טביעת הרגל בזיכרון של המטמון נקבעים על ידי -experimental_remote_merkle_tree_cache_size.
ברירת מחדל של --experimental_remote_merkle_tree_cache_size=<a long integer>: "1000"
מספר עצי ה-Merkle שיש לזכור כדי לשפר את מהירות הבדיקה של ההיט המרוחק. אף על פי שהמטמון נחתך באופן אוטומטי בהתאם לטיפול בהפניות רכות של Java&#39, יכול להיות ששגיאות "חסרות זיכרון" עלולות להיווצר אם הן גבוהות מדי. אם המדיניות מוגדרת כ-0, גודל המטמון הוא בלתי מוגבל. הערך האופטימלי משתנה בהתאם לגודל הפרויקט. ערך ברירת המחדל הוא 1,000.
ברירת מחדל של --[no]incompatible_remote_build_event_upload_respect_no_cache: "false"
אם המדיניות מוגדרת כ-True, פלטים שאליהם מפנה BEP לא יועלו למטמון מרוחק אם לא ניתן יהיה לשמור במטמון את פעולת היצירה מרחוק.
ברירת מחדל של --[no]incompatible_remote_downloader_send_all_headers: "true"
האם לשלוח את כל הערכים של כותרת רבת-ערך להורדה מרחוק ולא רק הראשונה.
תגים: incompatible_change
ברירת מחדל של --[no]incompatible_remote_output_paths_relative_to_input_root: "false"
אם המדיניות מוגדרת כ-True, נתיבי הפלט הם יחסיים לשורש הקלט במקום לספרייה הפעילה.
תגים: incompatible_change
ברירת מחדל של --[no]incompatible_remote_results_ignore_disk: "true"
אם המדיניות מוגדרת כ-True, --noremote_upload_local_results ו--noremote_Accept_cached לא יחולו על מטמון הדיסק. אם נעשה שימוש במטמון משולב: --noremote_upload_local_results יגרום לכתיבה של תוצאות במטמון הדיסק, אבל לא להעלאה למטמון המרוחק. --noremote_confirm_cached יוביל לבדיקה של Bazel בתוצאות החיפוש במטמון הדיסק, אבל לא במטמון המרוחק. פעולות ללא הפעלה מרחוק יכולות לפגוע במטמון הדיסק. פרטים נוספים זמינים בדף #8216.
תגים: incompatible_change
ברירת מחדל של --[no]remote_accept_cached: "true"
האם לקבל תוצאות של פעולות שנשמרו במטמון מרחוק?
ברירת מחדל של --remote_bytestream_uri_prefix=<a string>: תיאור
שם המארח ושם המופע לשימוש ב-URI של בייט-בייט שכתובים במקורות נתונים של אירועים. אפשר להגדיר את האפשרות הזו כשמבצעים גרסאות build באמצעות שרת proxy. כתוצאה מכך, הערכים של -remote_executor ו--remote_instance_name לא תואמים יותר לשם הקנוני של שירות הביצוע מרחוק. אם היא לא מוגדרת, ברירת המחדל היא "${hostname}/${instance_name}".
ברירת מחדל של --remote_cache=<a string>: תיאור
URI של נקודת קצה לשמירה במטמון. הסכימות הנתמכות הן http, https, grpc, grpcs (grpc עם TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. מציינים grpc://, http:// או Unix: כדי להשבית TLS. כדאי לעיין בכתובת 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_properties.
תגים: affects_outputs
ברירת מחדל של --remote_default_platform_properties=<a string>: ""
מגדירים את מאפייני הפלטפורמה שמוגדרים כברירת מחדל ל-API לביצוע מרחוק, אם פלטפורמת הביצוע לא מוגדרת עדיין Remote_execution_property. המערכת תשתמש בערך הזה גם אם פלטפורמת המארח נבחרה כפלטפורמת ההפעלה לביצוע מרחוק.
נצברו --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>: תיאור
מארח או מתארח:יציאה של נקודת קצה להפעלה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. צריך לציין grpc:// או Unix: כדי להשבית TLS.
נצברו --remote_header=<a 'name=value' assignment> שימושים מרובים
יש לציין כותרת שתיכלל בבקשות: --remote_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
ברירת מחדל של --remote_instance_name=<a string>: ""
הערך שמועבר כ-Instance_name ב-API לביצוע מרחוק.
ברירת מחדל של --[no]remote_local_fallback: "false"
האם לחזור לשיטה עצמאית של הפעלה מקומית אם ביצוע ההעברה מרחוק נכשל?
ברירת מחדל של --remote_local_fallback_strategy=<a string>: "local"
לא, הוצא משימוש. פרטים נוספים זמינים בכתובת 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>: תיאור
מתחברים למטמון המרוחק דרך שרת proxy. כרגע אפשר להשתמש בסימון הזה רק כדי להגדיר שקע דומיין (Unix:/path/to/socket) ב-Unix:
ברירת מחדל של --remote_result_cache_priority=<an integer>: "0"
העדיפות היחסית של פעולות מרוחקות שנשמרו במטמון מרוחק. הסמנטיקה של ערכי העדיפות הספציפית היא תלויה בשרת.
ברירת מחדל של --remote_retries=<an integer>: "5"
מספר הניסיונות המקסימלי לנסות שוב שגיאה זמנית. אם המדיניות מוגדרת כ-0, ניסיונות חוזרים מושבתים.
ברירת מחדל של --remote_timeout=<An immutable length of time.>: "60s"
משך הזמן המרבי להמתנה לביצוע מרחוק ולשיחות במטמון. למטמון REST, זהו גם החיבור וגם הזמן הקצוב לתפוגה של קריאה. אפשר להשתמש ביחידות הבאות: ימים (d), שעות (h), דקות (m), שניות (s) ואלפיות שנייה (אלפיות השנייה). אם משמיטים את היחידה, הערך מפורש כשניות.
ברירת מחדל של --[no]remote_upload_local_results: "true"
האם להעלות למטמון המרוחק תוצאות של פעולות שבוצעו באופן מקומי?
ברירת מחדל של --[no]remote_verify_downloads: "true"
אם היא מוגדרת כ-true, Bazel תחשב את סכום הגיבוב של כל ההורדות המרוחקות ותשליך את הערכים השמורים במטמון מרחוק אם הם לא תואמים לערך הצפוי.
אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
ברירת מחדל של --auto_output_filter=<none, all, packages or subpackages>: "none"
אם לא בשדה ‘פלט_מסנן’, הערך של האפשרות הזו משמש ליצירת מסנן באופן אוטומטי. הערכים המותרים הם 'none' (בלי לסנן שום דבר / הצגת הכול), 'all' (סינון הכול / לא להציג שום דבר), 'packages' (כולל פלט מכללים בחבילות המוזכרים בשורת הפקודה Blaze), וגם 'subpackages' (כמו 'packages&#include9); עבור 'packs' 'subpackages' ערכים //Java/foo ו-//Javatests/foo כאל חבילה אחת)'
ברירת מחדל של --[no]build_manual_tests: "false"
מתבצעת יצירה של יעדי בדיקה מתויגים 'ידני' 'ידני' הבדיקות לא מעובדות. אם רוצים להשתמש באפשרות הזו, צריך לבנות אותה (אבל לא לבצע אותה).
ברירת מחדל של --build_tag_filters=<comma-separated list of options>: ""
ההגדרה מציינת רשימת תגים המופרדים בפסיקים. לפני כל תג אפשר להוסיף '-' כדי לציין תגים מוחרגים. רק היעדים האלה יווצרו שכוללים לפחות תג כלול אחד ולא מכילים תגים שאינם נכללים. האפשרות הזו לא משפיעה על קבוצת הבדיקות שמופעלות באמצעות הפקודה 'test' או שאינן כפופות לאפשרויות סינון הבדיקה, למשל '--test_tag_filters'
ברירת מחדל של --[no]build_tests_only: "false"
אם צוין, המערכת תבנה רק כללים מסוג *_test ו-test_Suite המערכת תתעלם מיעדים אחרים שצוינו בשורת הפקודה. כברירת מחדל, כל מה שהתבקש ייבנה.
ברירת מחדל של --combined_report=<none or lcov>: "none"
ההגדרה קובעת את סוג דוח הכיסוי המצטבר. בשלב זה, רק LCOV נתמך.
ברירת מחדל של --[no]compile_one_dependency: "false"
יוצרים תלות אחת של קובצי הארגומנטים. זו פעולה שימושית לבדיקת קובצי מקור ב-IDE, למשל על ידי בניית יעד יחיד שתלוי בקובץ המקור כדי לזהות שגיאות בהקדם האפשרי במחזור העריכה/בנייה/בדיקה. הארגומנט הזה משפיע על האופן שבו כל הארגומנטים שאינם מסמנים מתפרשים. במקום לטרגט אותם כדי לבנות אותם, הם שמות הקבצים של המקור. עבור כל שם קובץ מקור יווצר יעד שרירותי שתלוי בו.
ברירת מחדל של --deleted_packages=<comma-separated list of package names>: ""
רשימה של שמות של חבילות, מופרדים בפסיקים, שמערכת ה-build תתייחס אליהם שאינם קיימים, גם אם הם מוצגים במקום כלשהו בנתיב החבילה. כדאי להשתמש באפשרות הזו כשמוחקים חבילת משנה 'x/y' של חבילה קיימת 'x' לדוגמה, לאחר מחיקת x/y/BUILD בלקוח, מערכת ה-build עשויה להתלונן אם היא תיתקל בתווית '//x:y/z' אם היא עדיין מסופקת על ידי ערך package_path אחר. ציון [delete_packs x/y] מונע את הבעיה הזו.
ברירת מחדל של --[no]discard_analysis_cache: "false"
אפשר למחוק את מטמון הניתוח מיד אחרי ששלב הניתוח מסתיים. מפחית את השימוש בזיכרון בכ-10%, אבל הופך את ה-build של מצטבר יותר לאט יותר.
ברירת מחדל של --disk_cache=<a path>: תיאור
נתיב לספרייה שבה Bazel יכולה לקרוא ולכתוב פעולות ופלטי פעולות. אם הספרייה לא קיימת, היא תיווצר.
ברירת מחדל של --embed_label=<a one-line string>: ""
הטמעת גרסה קודמת של בקרה על גרסה או תווית בינארית
ברירת מחדל של --execution_log_binary_file=<a path>: תיאור
עליך לרשום את הסדינים שבוצעו בקובץ הזה כפרוטוקולים של ספרדים מופרדים, בהתאם לכתובת src/main/protobuf/spawn.proto. תחילה כותבים את היומן בלי סדר, ואז בסוף ההפעלה הם ממוינים בסדר קבוע (יכול להיות מצריך מעבד וזיכרון). סימונים קשורים: --execution_log_json_file (פורמט json של טקסט שהוזמן), --experimental_execution_log_file (פורמט בינארי לא מורשה), --subcommands (להצגת פקודות משנה בפלט מסוף).
ברירת מחדל של --execution_log_json_file=<a path>: תיאור
עליך לתעד את הסדינים שבוצעו בקובץ הזה כייצוג json של פרוטוסים מופרדים בפסיקים, בהתאם ל- src/main/protobuf/spawn.proto. תחילה כותבים את היומן בלי סדר, ואז בסוף ההפעלה הם ממוינים בסדר קבוע (יכול להיות מצריך מעבד וזיכרון). סימונים קשורים: סימונים קשורים: --execution_log_binary_file (פורמט בינארי בינארי שהוזמן), --experimental_execution_log_file (פורמט Protobuf בינארי ללא הזמנה), --subcommands (להצגת פקודות משנה בפלט מסוף).
ברירת מחדל של --[no]expand_test_suites: "true"
מומלץ להרחיב את יעדי test_Suite לבדיקות ההרכב שלהם לפני הניתוח. אם הדגל הזה מופעל (ברירת המחדל), דפוסי יעד שליליים יחולו על הבדיקות השייכות לחבילת הבדיקה, אחרת הם לא יפעלו. השבתה של הסימון הזה שימושית כשמחילים היבטים ברמה העליונה בשורת הפקודה: ואז אפשר לנתח מטרות בדיקה של suite.
תגים: loading_and_analysis
נצברו --experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.> שימושים מרובים
הגדרת עזרה לגבי פרטי כניסה לשימוש באחזור פרטי הכניסה של ההיקף (דומיין). פרטי כניסה מ-credentials Credentials מקבלים עדיפות על פני פרטי כניסה מ-<code>--google_default_credentials</code>, `--google_credentials` או <code>.netrc</code>. אפשר לראות אותם בכתובת https://github.com/bazelbuild/proposs22-z
ברירת מחדל של --experimental_credential_helper_cache_duration=<An immutable length of time.>: "30m"
ההגדרה קובעת את משך הזמן שבו פרטי הכניסה ששמורים ב'פרטי כניסה' יישמרו במטמון.
ברירת מחדל של --experimental_credential_helper_timeout=<An immutable length of time.>: "5s"
הגדרת הזמן הקצוב לתפוגה עבור 'פרטי הכניסה'. עוזרי הכניסה שלא יגיבו בזמן הקצוב לתפוגה ייכשלו.
ברירת מחדל של --experimental_execution_log_file=<a path>: תיאור
עליך לרשום את הסדינים שבוצעו בקובץ הזה כפרוטוקולים של ספרדים מופרדים, בהתאם לכתובת src/main/protobuf/spawn.proto. הקובץ הזה נכתב לפי סדר הביצוע של סדונים. סימונים קשורים: --execution_log_binary_file (פורמט בינארי בינארי שהובטח), --execution_log_json_file (פורמט json של טקסט שהוזמן), --subcommands (להצגת פקודות משנה בפלט מסוף).
ברירת מחדל של --[no]experimental_execution_log_spawn_metrics: "false"
הכללת מדדי S מרכזן ביומן הביצוע.
ברירת מחדל של --experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: ""
הוצא משימוש לטובת היבטים. מסננים של קבוצות יעדים שעבורן אפשר לתזמן פעולות נוספות.
ברירת מחדל של --[no]experimental_extra_action_top_level_only: "false"
הוצא משימוש לטובת היבטים. תזמון פעולות נוספות מסוג action_actions רק ביעדים ברמה עליונה.
ברירת מחדל של --[no]experimental_prioritize_local_actions: "true"
אם הן מוגדרות, פעולות שניתן להפעיל באופן מקומי מקבלים רק הזדמנות ראשונה לרכוש משאבים, עובדים באופן דינמי מקבלים הזדמנות שנייה, ופעולות נפרדות שמתבצעות באופן דינמי ומתבצעות לאחרונה.
תגים: execution
--experimental_spawn_scheduler
מפעילים ביצוע דינמי על ידי הרצת פעולות באופן מקומי וגם מרחוק. Bazel מצטיינת בכל פעולה מקומית ומרוחקת, ובוחרת את הפעולה שמסתיימת ראשונה. אם פעולה תומכת בעובדים, הפעולה המקומית תתבצע במצב עובד קבוע. כדי להפעיל ביצוע דינמי של רכיב פעולה ספציפי, יש להשתמש בסימונים '--internal_spawn_scheduler' וב-'--strategi=<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"
אם צריך להשתמש ב 'פרטי הכניסה שמוגדרים כברירת מחדל באפליקציית 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 יוצאים. אם פינגים מסוג keep-alive מופעלים באמצעות --grpc_keepalive_time, תם הזמן הקצוב (Bazel) של Bazel אם לא מתקבלת פינג אחרי פרק הזמן הזה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. אם פינגים פעילים נשארים מושבתים, המערכת מתעלמת מההגדרה הזו.
ברירת מחדל של --[no]ignore_unsupported_sandboxing: "false"
אין להדפיס אזהרה כשאין תמיכה במערכת הזו בארגז חול.
ברירת מחדל של --[no]incompatible_dont_use_javasourceinfoprovider: "false"
לא:
תגים: incompatible_change
ברירת מחדל של --local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>: "HOST_CPUS"
יש להגדיר באופן מפורש את המספר הכולל של ליבות מעבד (CPU) מקומיות שזמינות ל-Bazel להוצאה על פעולות build שמבוצעות באופן מקומי. משתנה מספר שלם, או "HOST_CPUS" ואופציונלית גם [-|*]<float> (למשל, HOST_CPUS*.5 כדי להשתמש במחצית מליבות המעבד (CPU) הזמינות. כברירת מחדל, ("HOST_CPUS" ), Bazel תשלח שאילתה לתצורת המערכת כדי להעריך את מספר הליבות של המעבד (CPU).
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.> ברירת מחדל: "HOST_RAM*.67"
יש להגדיר במפורש את סך כל זיכרון ה-RAM המארח המקומי (ב-MB) הזמין ל-Bazel להוצאה על פעולות build שמבוצעות באופן מקומי. משתנה מספר שלם, או "HOST_RAM" ואופציונלית מופיע [-|*]<float> (למשל, HOST_RAM*.5 כדי להשתמש בחצי מזיכרון ה-RAM הזמין). כברירת מחדל, ("HOST_RAM*.67" ), Bazel תשלח שאילתה לתצורת המערכת כדי להעריך את כמות ה-RAM הזמינה, ומשתמשת ב-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"
אם מופעל, גורם ל-Bazel להדפיס הודעות &&;טעינת חבילה:".
ברירת מחדל של --test_lang_filters=<comma-separated list of options>: ""
קביעת רשימה של שפות בדיקה המופרדות בפסיקים. אפשר להוסיף לפני כל שפה את המילים " '-' כדי לציין שפות מוחרגות. יימצאו רק יעדי הבדיקה שנכתבו בשפות שצוינו. השם המשמש לכל שפה צריך להיות זהה לתחילית השפה בכלל *_test, למשל, אחד מהתווים #&39;cc', 'Java', 'py' וכו'. האפשרות הזו משפיעה על --build_tests_only ועל פקודת הבדיקה.
ברירת מחדל של --test_size_filters=<comma-separated list of values: small, medium, large or enormous>: ""
ההגדרה מציינת רשימה של גודלי בדיקה המופרדים בפסיקים. לפני כל גודל אפשר להוסיף לפני #&39;-' כדי לציין גדלים שאינם נכללים. יימצאו רק יעדי בדיקה המכילים לפחות גודל כולל אחד ואינם מכילים גדלים שלא נכללו. האפשרות הזו משפיעה על ההתנהגות של --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 (אבטחת שכבת התעבורה) לשימוש. צריך גם לספק מפתח לקוח כדי להפעיל אימות לקוח.
ברירת מחדל של --tls_client_key=<a string>: תיאור
צריך לציין את מפתח הלקוח ב-TLS שבו רוצים להשתמש. צריך גם לספק אישור לקוח כדי להפעיל את אימות הלקוח.
ברירת מחדל של --workspace_status_command=<path>: ""
מוצגת פקודה בהתחלה של גרסת ה-build כדי לספק מידע על סטטוס סביבת העבודה בצורת צמדי מפתח/ערך. לעיון במפרט המלא, יש לעיין במדריך למשתמש. לדוגמה, אפשר לעיין גם בכלים/buildstamp/get_workspace_status.
אפשרויות ששולטות בביצוע של גרסאות build:
ברירת מחדל של --[no]check_up_to_date: "false"
אין לבצע את ה-build, רק צריך לבדוק אם הוא מעודכן. אם כל היעדים עדכניים, ה-build הושלם בהצלחה. אם צריך לבצע שלב כלשהו, דיווח על שגיאה וה-build ייכשל.
תגים: execution
רוצה לבצע קריאות ישירות למערכת הקבצים כדי ליצור עצים סימבוליים?
תגים: loading_and_analysis, execution, experimental
ברירת מחדל של --[no]experimental_remotable_source_manifests: "false"
האם אפשר לבצע פעולות שוטפות במניפסט המקור:
תגים: loading_and_analysis, execution, experimental
ברירת מחדל של --[no]experimental_split_coverage_postprocessing: "false"
אם הערך הוא true, Bazel תריץ עיבוד לאחר העיבוד לצורך בדיקה בתצוגה חדשה.
תגים: execution
ברירת מחדל של --[no]experimental_split_xml_generation: "true"
אם הדגל הזה הוגדר ופעולת בדיקה לא יוצרת קובץ Test.xml, Bazel משתמשת בפעולה נפרדת כדי ליצור קובץ דמה מסוג XML.xml שמכיל את יומן הבדיקה. אחרת, Bazel יוצרת test.xml כחלק מפעולת הבדיקה.
תגים: execution
ברירת מחדל של --[no]experimental_strict_fileset_output: "false"
אם האפשרות הזו מופעלת, קבוצות הקבצים יתייחסו לכל פריטי המידע שנוצרו בתהליך הפיתוח כקבצים רגילים. הם לא חוצה ספריות ולא יהיו רגישים לקישורים סימבוליים.
תגים: execution
ברירת מחדל של --genrule_strategy=<comma-separated list of options>: ""
יש לציין כיצד לבצע יצירת כללי. הסימון הזה ייצא משימוש. במקום זאת, אפשר להשתמש ב- --spawn_strategi=<value> כדי לשלוט בכל הפעולות או ב--strategi=Genrule=<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"
מספר המשימות במקביל. הפרמטר מכיל מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ואחריו אופציונלי (למשל, [-|*]<float>) למשל. "auto", "HOST_CPUS*.5". הערכים צריכים להיות בין 1 ל-5000. ערכים גדולים מ-2,500 עלולים לגרום לבעיות בזיכרון. "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"
מספר השרשורים המקבילים שיש להשתמש בהם בשלב הטעינה/הניתוח.נלקחים מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ובדרך כלל מוסיפים פעולה ([-|*]<float>) למשל. "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' מוסיף את #&39;x' ו-'z' את פרטי הביצוע של #&39;y' ומסירים אותם. 'Genrule=+requires-x' add 'requires-x' לפרטי הביצוע של כל פעולות הז'אנר. '(?!Genrule).*=-requires-x' removed 'requires-x' מפרטי ההפעלה של כל הפעולות שאינן ז'אנר.
תגים: execution, affects_outputs, loading_and_analysis
--persistent_android_dex_desugar
הפעלה של עובדים ב-Android Dex ופעולות סוכר קבועות.
מתרחב אל:
--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=worker2
{1/2 --internal_persistent_busybox_tools
--persistent_multiplex_android_dex_desugar
הפעלה של עובדים עם Multiplex דק' ופעולות סוכר
מתרחב אל:
--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
הפעלה של מעבד משאבים (cast) עקבי ב-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-workers2
{1/2 --persistent_android_resource_processor
--persistent_multiplex_android_tools
הפעלת כלים עקביים ומוכפלים ב-Android (Dexs, הסרת ניפוי באגים, עיבוד משאבים).
מתרחב אל:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar

תגים: host_machine_resource_optimizations, execution
ברירת מחדל של --spawn_strategy=<comma-separated list of options>: ""
מציינים כברירת מחדל איך יבוצעו פעולות ריבוי. מקבלת רשימת אסטרטגיות המופרדות בפסיקים, מהעדיפות הגבוהה ביותר לנמוכה. עבור כל פעולה, Bazel בוחרת את האסטרטגיה עם העדיפות הגבוהה ביותר שיכולה לבצע את הפעולה. ערך ברירת המחדל הוא "remote,work,sandboxed,local". פרטים נוספים זמינים בכתובת https://blog.bazel.build/2019/06/19/list-strategi.html.
תגים: execution
נצברו --strategy=<a '[name=]value1[,..,valueN]' assignment> שימושים מרובים
יש לציין איך להפיץ אוסף של פעולות הפקה אחרות. מקבלת רשימת אסטרטגיות המופרדות בפסיקים, מהעדיפות הגבוהה ביותר לנמוכה. עבור כל פעולה, Bazel בוחרת את האסטרטגיה עם העדיפות הגבוהה ביותר שיכולה לבצע את הפעולה. ערך ברירת המחדל הוא "remote,work,sandboxed,local". הדגל הזה מבטל את הערכים שהוגדרו על ידי --spawn_strategi (וכן --genrule_strategi אם משתמשים בהם ב-Genemonic Genrule). פרטים נוספים זמינים בכתובת https://blog.bazel.build/2019/06/19/list-strategi.html.
תגים: execution
נצברו --strategy_regexp=<a '<RegexFilter>=value[,value]' assignment> שימושים מרובים
כדאי לשנות את שיטת ה-Spמקו. לפרטים על התאמות של ביטוי רגולרי_filter יש לעיין בקטע --per_file_copt. נעשה שימוש ב-regex_filter הראשון שתואם לתיאור. אפשרות זו מבטלת סימונים אחרים לציון אסטרטגיה. דוגמה: --strategi_regexp=//foo.*\.cc,-//foo/bar=local הוא סימן להרצת פעולות באמצעות שיטה מקומית, אם התיאורים שלהן תואמים ל-//foo.*.cc אבל לא ל-//foo/bar. דוגמה: --strategi_regexp='Compiling.*/bar=local --strate יהיו
תגים: 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>: תיאור
יעד grte_top ב-Android.
תגים: changes_inputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --android_manifest_merger=<legacy, android or force_android>: "android"
בחירת המיזוג של המניפסט לשימוש בכללי 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>: תיאור
מהדר היעד של Apple. שימושי לבחירת וריאציות של כלי עבודה (למשל: xcode-beta).
תגים: 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:coverage_report_מחולל"
המיקום של הקובץ הבינארי המשמש להפקת דוחות כיסוי. נכון לעכשיו זו צריכה להיות קבוצת קבצים הכוללת קובץ אחד, הקובץ הבינארי. ברירת המחדל היא '//tools/test:coverage_report_מחולל'.
תגים: changes_inputs, affects_outputs, loading_and_analysis
--coverage_support=<a build target label> ברירת מחדל: "@bazel_tools//tools/test:coverage_support"
המיקום של קובצי התמיכה הנדרשים על סמך הקלט של כל פעולת בדיקה שאוספת כיסוי קוד. ברירת המחדל היא '//tools/test:coverage_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>: תיאור
ההגדרה קובעת הטמעה מותאמת אישית של Malloc. ההגדרה הזו מבטלת את המאפיינים של Malאיך להשתמש בכללי build.
תגים: changes_inputs, affects_outputs
נצברו --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> שימושים מרובים
רשימה של ביטויים רגולריים המופרדים בפסיקים, שלכל אחד מהם יש קידומת (-) שלילי, מוקצית (=) לרשימה של יעדי ערך מופרדים בפסיקים. אם יעד מסוים לא תואם אף ביטוי שלילי וביטוי חיובי אחד לפחות, רזולוציית הכלים שלו תתבצע כאילו היא הצהירה על ערכי האילוץ כאילוצי ביצוע. דוגמה: //demo,-test=@platforms//cpus:x86_64 יתווסף #&39;x86_64' לכל יעד תחת //demo, מלבד אלה שהשם שלהם מכיל 'test'.
תגים: loading_and_analysis
ברירת מחדל של --[no]experimental_enable_objc_cc_deps: "true"
קבלת כללים מסוג objc_* שתלויים ב-cc_library וגורמת לקיום יחסי תלות של objc עם --cpu המוגדר כ-"ios_<--ios_cpu>" עבור כל ערך ב- --ios_multi_cpu.
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]experimental_include_xcode_execution_requirements: "false"
אם היא מוגדרת, מוסיפים את דרישת הביצוע "requires-xcode:{version}" לכל פעולת Xcode. אם גרסת ה-xcode כוללת תווית עם מקפים, צריך להוסיף גם "requires-xcode-label:{version_label}" דרישת ביצוע.
תגים: loses_incremental_state, loading_and_analysis, execution
ברירת מחדל של --[no]experimental_prefer_mutual_xcode: "true"
אם מוגדר True, יש להשתמש ב-Xcode העדכני ביותר שזמין גם מקומית וגם מרחוק. אם False, או אם אין גרסאות הדדיות זמינות, משתמשים בגרסת Xcode המקומית שנבחרה באמצעות xcode-select.
תגים: loses_incremental_state
נצברו --extra_execution_platforms=<comma-separated list of options> שימושים מרובים
הפלטפורמות הזמינות כפלטפורמות לביצוע פעולות. אפשר לציין פלטפורמות לפי יעד מדויק או כתבנית יעד. המערכת תתייחס לפלטפורמות האלה לפני אלה המוצהרות בקובץ ה-WORKSPACE על ידי sign_execution_platforms() .
תגים: execution
נצברו --extra_toolchains=<comma-separated list of options> שימושים מרובים
הכללים בנוגע לכלים של כלי עבודה שנלקחים בחשבון במהלך מציאת פתרון לכלים. ניתן לציין ערכות הכלים לפי יעד מדויק, או כתבנית יעד. חשוב לזכור את ערכות הכלים האלה לפני ההשקה שלהן בקובץ ה-WORKSPACE באמצעות record_toolchains() .
תגים: affects_outputs, changes_inputs, loading_and_analysis
ברירת מחדל של --grte_top=<a label>: תיאור
תווית לספריית ליבצ'ק שמסומנת. ערך ברירת המחדל נבחר על ידי רצועת הכלים, וכמעט אף פעם לא צריך לשנות אותו.
תגים: 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"
שימוש ברזולוציה של Toolchain כדי לבחור את ה-SDK ל-Android לכללי Android (סטארלרק ו-Native)
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_enable_apple_toolchain_resolution: "false"
שימוש ברזולוציית כלים כדי לבחור את ה-SDK של Apple לכללי התפוחים (Starlark ו-Native)
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_make_thinlto_command_lines_standalone: "true"
True
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain: "true"
אם הערך true, Bazel יתלונן כשמאפייני cc_toolchain.cpu ו-cc_toolchain.devguider מוגדרים (מידע נוסף זמין במאמר https://github.com/bazelbuild/bazel/issues/7075).
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_remove_legacy_whole_archive: "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' in to cc_common.configure_features (מידע נוסף בכתובת https://github.com/bazelbuild/bazel/issues/7793).
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]interface_shared_objects: "true"
שימוש באובייקטים משותפים בממשק אם הם נתמכים על ידי ערכת הכלים. כל שרשראות הכלים של ELF תומכות בשלב זה בהגדרה הזו.
תגים: loading_and_analysis, affects_outputs, affects_outputs
ברירת מחדל של --ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
ההגדרה קובעת את גרסת ה-SDK של iOS לפיתוח אפליקציות ל-iOS. אם לא צוין, נעשה שימוש בגרסת ברירת מחדל של iOS SDK מ-'xcode_version'.
תגים: loses_incremental_state
ברירת מחדל של --macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
ההגדרה קובעת את גרסת ה-macOS SDK שבה משתמשים כדי לבנות אפליקציות ל-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' (קובץ שנמצא מתחת לרמה הבסיסית (root) של סביבת עבודה).
תגים: 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 שבה משתמשים כדי ליצור אפליקציות TV. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של TV SDK מ-'xcode_version'.
תגים: loses_incremental_state
ברירת מחדל של --watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
ההגדרה קובעת את גרסת ה-SDK של WatchOS שבה משתמשים כדי לבנות אפליקציות שעון. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של WatchOS SDK מגרסה 'xcode_version'.
תגים: loses_incremental_state
ברירת מחדל של --xcode_version=<a string>: תיאור
אם צוין, נעשה שימוש ב-Xcode של הגרסה הנתונה לפעולות build רלוונטיות. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של הביצוע של Xcode.
תגים: loses_incremental_state
ברירת מחדל של --xcode_version_config=<a build target label>: "@bazel_tools//tools/cpp:host_xcodes"
התווית של הכלל xcode_config שיש להשתמש בה לבחירת הגרסה של Xcode בתצורת ה-build.
תגים: loses_incremental_state, loading_and_analysis
אפשרויות ששולטות בפלט של הפקודה:
ברירת מחדל של --[no]apple_enable_auto_dsym_dbg: "false"
אם צריך לאלץ יצירה של קובצי ניפוי באגים (.dSYM) עבור גרסאות build ל-dbg.
תגים: affects_outputs, action_command_lines
ברירת מחדל של --[no]apple_generate_dsym: "false"
האם ליצור קובצי ניפוי באגים ( .dSYM)?
תגים: affects_outputs, action_command_lines
ברירת מחדל של --[no]build: "true"
יש לבצע את ההרכב. זו ההתנהגות הרגילה. ציון -nobuild גורם ל-build לעצור לפני ביצוע פעולות ה-build, ומחזיר אפס אם שלבי הטעינה והניתוח של החבילה הושלמו בהצלחה. מצב זה שימושי לבדיקת השלבים האלה.
תגים: execution, affects_outputs
אם הערך הוא true, יש ליצור יערות קישור ריצה עבור כל היעדים. אם False, כותבים מניפסטים רק כשהדבר אפשרי.
תגים: affects_outputs
ברירת מחדל של --[no]build_runfile_manifests: "true"
אם הערך הוא True, צריך לכתוב מניפסטים מסוג Runfiles בכל היעדים. אם FALSE, משמיטים אותן. הבדיקות המקומיות לא יפעלו אם הן יהיו שקריות.
תגים: affects_outputs
ברירת מחדל של --[no]build_test_dwp: "false"
אם האפשרות מופעלת, כשפותחים בדיקות C++ באופן סטטי ובצורה קפדנית, המערכת תיצור באופן אוטומטי גם קובץ .dwp עבור הקובץ הבינארי של הבדיקה.
תגים: loading_and_analysis, affects_outputs
ברירת מחדל של --cc_proto_library_header_suffixes=<comma-separated list of options>: ".pb.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"
אפשר לבצע פעולות נוספות על גרסאות API חלופיות של Java ב-proto_library.
תגים: affects_outputs, loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_proto_extra_actions: "false"
אפשר לבצע פעולות נוספות על גרסאות API חלופיות של Java ב-proto_library.
תגים: affects_outputs, loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_run_validations: "true"
יש להשתמש במקום זאת --run_validations.
תגים: execution, affects_outputs
ברירת מחדל של --[no]experimental_save_feature_state: "false"
שומרים את המצב של תכונות מופעלות ומבוקשות כפלט של הידור.
תגים: affects_outputs, experimental
ברירת מחדל של --[no]experimental_use_validation_aspect: "false"
האם להריץ פעולות אימות באמצעות היבט כלשהו (לשילוב במקביל עם בדיקות)?
תגים: execution, affects_outputs
ברירת מחדל של --fission=<a set of compilation modes>: "no"
ההגדרה קובעת אילו מצבי הידור משתמשים בפיקוח עבור אוספי +C+. יכולים להיות כל שילובים של {'speedbuild', 'dbg', 'opt'} או ערכים מיוחדים 'yes' כדי להפעיל את כל המצבים &&339;no' כדי להשבית את כל המצבים.
תגים: loading_and_analysis, action_command_lines, affects_outputs
ברירת מחדל של --[no]legacy_external_runfiles: "true"
אם המדיניות מוגדרת כ-TRUE, יש לבנות יערות סימבונק של Runruns עבור מאגרים חיצוניים בכפוף ל- .runfiles/wsname/external/repo (בנוסף ל- .runfiles/repo).
תגים: affects_outputs
ברירת מחדל של --[no]objc_generate_linkmap: "false"
ההגדרה קובעת אם ליצור קובץ מפת קישור.
תגים: affects_outputs
נצברו --output_groups=<comma-separated list of options> שימושים מרובים
רשימה של שמות של קבוצות פלט המופרדים בפסיקים, שלכל אחד מהם יש קידומת + או -. קבוצה שקידומתה מתחילה ב-+ מתווספת לקבוצת ברירת המחדל של קבוצות פלט, ואילו קבוצה עם קידומת - תוסר מקבוצת ברירת המחדל. אם לפחות קבוצה אחת לא כוללת קידומת, המערכת תשמיט את קבוצת ברירת המחדל של קבוצות הפלט. לדוגמה,
תגים: execution, affects_outputs
ברירת מחדל של --[no]run_validations: "true"
האם להריץ פעולות אימות כחלק מה-build? פרטים נוספים זמינים בכתובת https://bazel.build/rules/rules#validation_actions
תגים: execution, affects_outputs
ברירת מחדל של --[no]save_temps: "false"
אם המדיניות מוגדרת, פלט זמני מ-gcc יישמר. דוגמאות לקובצי .s (קוד ליצירת מקטע), קובצי .i (C מעובד מראש) וקובצי .ii (C++ ). לפני העיבוד:
תגים: affects_outputs
אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לעצם קיומו:
נצברו --action_env=<a 'name=value' assignment with an optional value part> שימושים מרובים
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם הגדרת יעד. אפשר לציין משתנים לפי שם. במקרה כזה, הערך יילקח מסביבת ההפעלה, או מצמד name=value שקובע את הערך בלי קשר לסביבת ההפעלה. ניתן להשתמש באפשרות זו כמה פעמים. לאפשרויות המוגדרות לאותו משתנה, המנצחים האחרונים, האפשרויות המצטברות למשתנים שונים.
תגים: action_command_lines
ברירת מחדל של --android_cpu=<a string>: "armeabi-v7a"
מעבד ה-Android לטירגוט.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]android_databinding_use_androidx: "false"
יוצרים קובצי התאמת נתונים ל-AndroidX. האפשרות הזו משמשת רק לקישור נתונים v2.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --[no]android_databinding_use_v3_4_args: "false"
שימוש ב-Android Databining v2 עם ארגומנט 3.4.0
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --android_dynamic_mode=<off, default or fully>: "off"
קביעה אם קישורי +C+ של כללי Android יקושרו באופן דינמי כאשר cc_binary לא ייצור באופן מפורש ספרייה משותפת. 'default' פירוש הדבר שבסיס הפנים יבחר אם לקשר באופן דינמי. 'ly' כלומר כל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי ברובו.
תגים: affects_outputs, loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> כברירת מחדל: "alphabetical"
מגדיר את סדר המניפסטים שהועברו למיזוג המניפסט עבור קבצים בינאריים של Android. 'ALPHABETLY' פירושו שהמניפסטים ממוינים לפי הנתיב ביחס לרכיב ה-exe. ALPHABETical_BY_CONFIGURATION פירושו שהמניפסטים ממוינים לפי נתיבים ביחס לספריית התצורה בספריית הפלט. המשמעות של DEPENDENCY היא שמניפסטים מסודרים לפי כל ספרייה שנמצאת לפני המניפסטים של יחסי התלות שלה.
תגים: action_command_lines, execution
ברירת מחדל של --[no]android_resource_shrinking: "false"
הפעלת כיווץ משאבים ל-APK_android_binary שמשתמשים ב-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> שימושים מרובים
יש לציין את מצב קוד ה-API של Apple לצורך שלבי הידור שמטרגטים את ארכיטקטורת המכשירים. הערכים צריכים להיות בפורמט '[platform=]mode' כאשר הפלטפורמה (שחייבת להיות 'ios', 'macos', 'tvos' או 'watchos') היא אופציונלית. אם צוין, מצב מצב הקידוד חל על הפלטפורמה הזו באופן ספציפי. אם לא נתון, הוא חל על כל הפלטפורמות. המצב חייב להיות 'none', 'embedded_סמןs' או 'embedded' ייתכן שהאפשרות הזו תוצג כמה פעמים.
תגים: loses_incremental_state
נצברו --aspects=<comma-separated list of options> שימושים מרובים
רשימת היבטים המופרדים בפסיקים, שיחולו על יעדים ברמה העליונה. ברשימה, אם היבט some_aspect מציין ספקי היבט נדרשים דרך additional_aspect_providers, אז ערך some_aspect יפעל לאחר כל היבט שהוזכר לפניו ברשימת ההיבטים שהספקים שלהם מפרסמים שמצייתים לספקי הצד הנדרשים. בנוסף, לרכיב no_aspect תהיה אפשרות להפעיל אחרי כל ההיבטים הנדרשים שצוינו. לאחר מכן, ל-some_aspect תהיה גישה לערכים של אותם היבטים. <bzl-file-label>%<aspect_name>, לדוגמה '//tools:my_def.bzl%my_aspect', כאשר 'my_aspect' הוא ערך ברמה עליונה מכלי קובץ/my_def.bzl
ברירת מחדל של --[no]build_python_zip: "auto"
יצירת קובץ ZIP של קובץ הפעלה בצורת פיליון. ב-Windows, השבתה בפלטפורמות אחרות
תגים: affects_outputs
נצברו --catalyst_cpus=<comma-separated list of options> שימושים מרובים
רשימה של ארכיטקטורה המופרדת בפסיקים שבשבילה לבנות קבצים בינאריים של Apple Catalyst.
תגים: loses_incremental_state, loading_and_analysis
ברירת מחדל של --[no]collect_code_coverage: "false"
אם תציינו זאת, Bazel תפיק קוד אינסטרומנטציה (באמצעות אינסטרומנטציה אופליין, במידת האפשר) ותאסוף מידע על כיסוי במהלך הבדיקות. השינוי ישפיע רק על יעדים שתואמים לשיטה --instrumentation_filter. בדרך כלל, אין לציין אפשרות זו ישירות – 'Bazelcover' במקום זאת יש להשתמש בפקודה.
תגים: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] ברירת מחדל: "speedbuild"
מציינים את המצב שבו יוצג הקובץ הבינארי. ערכים: 'speedbuild', 'dbg', 'opt'.
תגים: affects_outputs, action_command_lines, explicit_in_output_path
נצברו --conlyopt=<a string> שימושים מרובים
אפשרות נוספת להעברה ל-cc במהלך הידור קובצי המקור של C.
תגים: action_command_lines, affects_outputs
נצברו --copt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-ccC.
תגים: action_command_lines, affects_outputs
ברירת מחדל של --cpu=<a string>: ""
מעבד היעד.
תגים: 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> שימושים מרובים
אפשרות נוספת להעברה ל-cc כשעורכים קובצי מקור ב-C++.
תגים: action_command_lines, affects_outputs
נצברו --define=<a 'name=value' assignment> שימושים מרובים
כל אפשרות --הגדרה מציינת מטלה למשתנה build.
תגים: changes_inputs, affects_outputs
ברירת מחדל של --dynamic_mode=<off, default or fully>: "default"
ההגדרה קובעת אם הקבצים הבינאריים מסוג C++ יקושרו באופן דינמי. 'default' פירושו ש-Bazel תבחר אם לקשר באופן דינמי. 'ly' כלומר כל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי ברובו.
תגים: loading_and_analysis, affects_outputs
ברירת מחדל של --[no]enable_fdo_profile_absolute_path: "true"
אם המדיניות מוגדרת, שימוש ב-fdo_lbolute_profile_path יגדיל את השגיאה.
תגים: affects_outputs
ברירת מחדל של --[no]enable_runfiles: "auto"
הפעלה של עץ קישור סימולטני (runfiles); כברירת מחדל, התכונה מושבתת ב-Windows, בפלטפורמות אחרות.
תגים: affects_outputs
נצברו --experimental_action_listener=<a build target label> שימושים מרובים
הוצא משימוש לטובת היבטים. אפשר להשתמש ב-action_listener כדי לצרף action_action לביצוע פעולות build קיימות.
תגים: execution, experimental
ברירת מחדל של --[no]experimental_android_compress_java_resources: "false"
דחיסת משאבים של Java ב-APK
תגים: affects_outputs, loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_android_databinding_v2: "false"
שימוש בגרסה 2 של קישור ל-Android
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --[no]experimental_android_resource_shrinking: "false"
הפעלת כיווץ משאבים ל-APK_android_binary שמשתמשים ב-ProGuard
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --[no]experimental_android_rewrite_dexes_with_rex: "false"
להשתמש בכלי Rex כדי לכתוב מחדש קובצי Dex
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
סימון זה יקבע איך ינוהלו הקישורים הסימבוליים (הסמלים המקבילים שמופיעים בסביבת העבודה אחרי ה-build). ערכים אפשריים: רגילה (ברירת מחדל): כל סוג של קישור סימולציית נוחות ייווצר או יימחק, כפי שנקבע על ידי ה-build. נקי: כל הקישורים הסימבוליים יימחקו ללא תנאי. התעלמות: הקישורים הקטנים נשארים לבד. log_only: יצירת הודעות יומן כאילו הן #&39;normal' הועברו, אך לא מתבצעות בפועל פעולות של מערכת קבצים (שימושיות לכלים). לידיעתך, ניתן להשפיע רק על קישורים סימבוליים ששמותיהם נוצרים על ידי הערך הנוכחי, --symlink_prefix. אם הקידומת משתנה, כל קישור קיים קיים יישאר ריק.
תגים: affects_outputs
הסימון הזה קובע אם נפרסם את אירוע buildConvenienceSymlinksIdentified ל-BuildEventProtocol. אם הערך הוא true, ל-BuildEventProtocol תהיה רשומה עבור consoleSymlinksIdentified, הכוללת את כל קישורי הנוחות שנוצרו בסביבת העבודה שלך. אם הערך הוא FALSE, הרשומה נוחת SymlinksIdentified ב-BuildEventProtocol תהיה ריקה.
תגים: affects_outputs
נצברו --experimental_multi_cpu=<comma-separated list of options> שימושים מרובים
הוצא משימוש. לא.
תגים: affects_outputs, experimental
ברירת מחדל של --experimental_objc_fastbuild_options=<comma-separated list of options>: "-O0,-DDEBUG=1"
יש להשתמש במחרוזות האלה כאפשרויות מהדר dataLayer של objc Builder.
תגים: action_command_lines
ברירת מחדל של --[no]experimental_omitfp: "false"
אם המדיניות מוגדרת כ-True, יש להשתמש ב-libunhost עבור שחרור מחסניות (stackunack) ולהידור באמצעות -fomit-frame-pointer ו- -fסינכרוני-un Wind-tables.
תגים: action_command_lines, affects_outputs, experimental
ברירת מחדל של --[no]experimental_platform_in_output_dir: "false"
אם הערך הוא True, פלטפורמת היעד תשמש בשם של ספריית הפלט במקום ביחידת העיבוד המרכזית (CPU).
תגים: affects_outputs, experimental
ברירת מחדל של --[no]experimental_use_llvm_covmap: "false"
אם צוין, Bazel תיצור פרטי מפה של llvm-cov במקום gcov כש-collect_code_coverage מופעל.
תגים: 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"
אם רוצים ליצור פיצולים מסוג HWASAN.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --fdo_instrument=<a string>: תיאור
יצירת קבצים בינאריים עם אינסטרומנטציה של FDO. עם המהדר Clang/LLVM, הוא מקבל גם את שם הספרייה שמתחתיו יושלכו קובצי הפרופיל הגולמי בזמן הריצה.
תגים: affects_outputs
ברירת מחדל של --fdo_optimize=<a string>: תיאור
יש לך אפשרות להשתמש בפרטי הפרופיל ב-FDO כדי לבצע אופטימיזציה של האוסף. יש לציין את השם של קובץ 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"
אם המדיניות מופעלת, כל האוספים של C++ מייצרים קוד עצמאי למיקום ("-fPIC"), קישורים מעדיפים ספריות מוגדרות מראש של PIC על פני ספריות שאינן מסוג PIC, וקישורים מייצרים קובצי הפעלה שאינם תלויי מיקום ("-Pie").
תגים: loading_and_analysis, affects_outputs
נצברו --host_action_env=<a 'name=value' assignment with an optional value part> שימושים מרובים
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם תצורות מארח או ביצוע. אפשר לציין משתנים לפי שם. במקרה כזה, הערך יילקח מסביבת ההפעלה, או מצמד name=value שקובע את הערך בלי קשר לסביבת ההפעלה. ניתן להשתמש באפשרות זו כמה פעמים. לאפשרויות המוגדרות לאותו משתנה, המנצחים האחרונים, האפשרויות המצטברות למשתנים שונים.
תגים: action_command_lines
ברירת מחדל של --host_compilation_mode=<fastbuild, dbg or opt>: "opt"
ציון המצב שבו ייעשה שימוש בכלים ששימשו ליצירת ה-build. ערכים: 'speedbuild', 'dbg', 'opt'.
תגים: affects_outputs, action_command_lines
נצברו --host_conlyopt=<a string> שימושים מרובים
אפשרות נוספת להעברה ל-cc במהלך הידור קובצי המקור של C עבור כלי מארח.
תגים: action_command_lines, affects_outputs
נצברו --host_copt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-cc עבור כלי אירוח.
תגים: action_command_lines, affects_outputs
ברירת מחדל של --host_cpu=<a string>: ""
המעבד (CPU) המארח.
תגים: changes_inputs, affects_outputs
נצברו --host_cxxopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-cc עבור כלי אירוח.
תגים: action_command_lines, affects_outputs
ברירת מחדל של --host_force_python=<PY2 or PY3>: תיאור
עוקפת את הגרסה ב-Python של תצורת המארח. יכול להיות "PY2" או "PY3".
תגים: loading_and_analysis, affects_outputs
נצברו --host_linkopt=<a string> שימושים מרובים
אפשרות נוספת להעברה ל-cc בעת קישור כלים למארח.
תגים: 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"
אם אפשרות זו מופעלת, כל הספריות המקושרות מסוג C++ (DLL) שנוצרו על ידי cc_library ב-Windows יעברו שינוי שם ל-name_{Hash}.dll, שם הגיבוב מחושב על סמך ה-RepositoryName ונתיב החבילה DLL&#39. האפשרות הזו שימושית כשיש חבילה אחת שתלויה בכמה cc_library עם אותו שם (לדוגמה //foo/bar1:utils ו-//foo/bar2:utils).
תגים: loading_and_analysis, affects_outputs, incompatible_change
ברירת מחדל של --[no]incompatible_merge_genfiles_directory: "true"
אם המדיניות מוגדרת כ-True, ספריית הגנרטורים מקופלת בספריית 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"
כשהאפשרות 'כיסוי' מופעלת, המדיניות הזו קובעת אם לשקול כללים להגדרת אינסטרומנטציה. במהלך ההגדרה, המערכת מוסיפה אמצעי בדיקה שכוללים --instrumentation_filter. אחרת, כללי הבדיקה תמיד לא ייכללו באינסטרומנטציה של הכיסוי.
תגים: affects_outputs
ברירת מחדל --instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-/Javatests[/:],- /test/Java[/:]"
אם מפעילים את הכיסוי, המערכת מחילה רק כללים שהשמות שלהם נכללים במסנן שצוין לפי ביטוי רגולרי. כללים עם קידומת '-' אינם נכללים במקום זאת. לתשומת ליבכם: רק כללים שאינם בדיקות נמשכים לאינדקס, אלא אם מפעילים את --instrument_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_application. התוצאה היא קובץ בינארי אוניברסלי המכיל את כל הארכיטקטורה שצוינה.
תגים: loses_incremental_state, loading_and_analysis
ברירת מחדל של --[no]legacy_whole_archive: "true"
הוצאה משימוש, הוחלפה על ידי --incompatible_remove_Legacy_whole_archive (לפרטים נוספים: https://github.com/bazelbuild/bazel/issues/7362). במצב מופעל, יש להשתמש ב-allall-archive כדי להשתמש בכללים של cc_binary שיש להם linkshared=True וב-linkstatic=True או '-static' ב-linkopts. הערך הזה מיועד לתאימות לאחור בלבד. במקום זאת, עדיף להשתמש תמיד ב-linklink=1, היכן שנדרש.
תגים: action_command_lines, affects_outputs, deprecated
נצברו --linkopt=<a string> שימושים מרובים
אפשרות נוספת להעברה ל-cc בזמן הקישור.
תגים: 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"
אם המדיניות מוגדרת, ומצב העריכה מוגדר כך: 'dbg', GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC ו-GLIBCPP_CONCEPT_CHECKS.
תגים: action_command_lines
ברירת מחדל של --[no]objc_enable_binary_stripping: "false"
האם לבצע רצועות של סימנים וקוד לא פעיל בבינאריים מקושרים. אם בוחרים את הסימון הזה וגם את הסימון 'compilation_mode=opt', המערכת תסיר מחרוזות בינאריות.
תגים: action_command_lines
נצברו --objccopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-cc במהלך הידור קובצי המקור 'יעד-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> שימושים מרובים
אפשרויות נוספות להעברה סלקטיבית ל-cc כשעורכים קבצים מסוימים. ניתן להעביר את האפשרות הזו כמה פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. המונח regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (יש לעיין גם ב-(instrumentation_filter). האפשרות_1 עד Option_n מתייחסת לאפשרויות שרירותיות של שורות פקודה. אם אפשרות מכילה פסיק, צריך לצטט לוכסן הפוך. האפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --for
תגים: 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
ברירת מחדל של --platform_suffix=<a string>: תיאור
קביעת סיומת שתתווסף לספריית התצורה.
תגים: loses_incremental_state, affects_outputs, loading_and_analysis
ברירת מחדל של --propeller_optimize=<a build target label>: תיאור
יש להשתמש בפרטי פרופיל ה-Proproler כדי לבצע אופטימיזציה של יעד ה-build.פרופיל דו-שיח חייב להכיל לפחות אחד משני קבצים, פרופיל ב-cc ופרופיל ישן. הדגל הזה מקבל תווית build שחייבת להפנות לקובצי הקלט של פרופיל המדחף. לדוגמה, קובץ ה-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 עבור גרסאות build שעברו אופטימיזציה של Profeler.
תגים: affects_outputs
ברירת מחדל של --propeller_optimize_absolute_ld_profile=<a string>: תיאור
שם הנתיב המוחלט של קובץ ld_profile עבור גרסאות build שעברו אופטימיזציה ל-Propleler.
תגים: 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', '//package:target', '//package:target #
תגים: action_command_lines
ברירת מחדל של --[no]share_native_deps: "true"
אם True, ספריות מקוריות שמכילות פונקציונליות זהה ישותפו בין היעדים השונים
תגים: loading_and_analysis, affects_outputs
ברירת מחדל של --[no]stamp: "false"
פריטים בינאריים בחותמת עם התאריך, שם המשתמש, שם המארח, פרטי סביבת העבודה וכו'
תגים: affects_outputs
ברירת מחדל של --strip=<always, sometimes or never>: "sometimes"
ההגדרה קובעת אם להסיר בינאריים וספריות משותפות (באמצעות "-Wl,--strip-debug"). ערך ברירת המחדל של 'sometimes' פירושו רצועת אם if- --compilation_mode=fastbuild.
תגים: affects_outputs
נצברו --stripopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה כאשר יוצרים קובץ בינארי של '<name>.stripped'
תגים: action_command_lines, affects_outputs
נצברו --swiftcopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה לאוסף של Swift.
תגים: action_command_lines
הקידומת שמצורפת לכל אחד מסמלי הקישור לנוחות שנוצרות אחרי גרסת ה-build. אם לא מופיעה, ערך ברירת המחדל הוא השם של כלי ה-build ואחריו מקף. אם הכתובת '/' מועברת, לא נוצר קישור סימולטני ולא נוצרת אזהרה. אזהרה: הפונקציונליות המיוחדת של '/' תוצא משימוש בקרוב. במקומה יש להשתמש ב- --experimental_convenience_symlinks=ignore.
תגים: affects_outputs
נצברו --tvos_cpus=<comma-separated list of options> שימושים מרובים
רשימה של ארכיטקטורה שמופרדת בפסיקים שבשבילה צריך לבנות קבצים בינאריים של Apple TV.
תגים: loses_incremental_state, loading_and_analysis
ברירת מחדל של --tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
גרסת ה-TVOS תואמת מינימלית לסימולטורים וליעדים של היעד. אם לא צוין, נעשה שימוש ב-'tvos_sdk_version'.
תגים: loses_incremental_state
נצברו --watchos_cpus=<comma-separated list of options> שימושים מרובים
רשימה של ארכיטקטורה המופרדת בפסיקים שבשבילה לבנות קבצים בינאריים של AppleOS.
תגים: loses_incremental_state, loading_and_analysis
ברירת מחדל של --watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
גרסה מינימלית של WatchOS תואמת לסימולטורים ולסימולטורים מבוססי יעד. אם לא צוין, נעשה שימוש ב-'watchos_sdk_version'.
תגים: loses_incremental_state
ברירת מחדל של --xbinary_fdo=<a build target label>: תיאור
יש לך אפשרות להשתמש בפרטי הפרופיל ב-XbinaryFDO כדי לבצע אופטימיזציה של האוסף. קביעת השם של פרופיל בינארי כברירת מחדל. אם משתמשים באפשרות הזו יחד עם --fdo_instrument/--fdo_optimize/--fdo_profile, האפשרויות האלה תמיד יקבלו את הערך כאילו xbinary_fdo לא צוין.
תגים: affects_outputs
אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
ברירת מחדל של --auto_cpu_environment_group=<a build target label>: ""
מציינים את המאפייןEnvironment_group [קבוצת_סביבה] שישמש למיפוי אוטומטי של ערכי pu לערכי target_environment.
תגים: changes_inputs, loading_and_analysis, experimental
ברירת מחדל של --[no]check_licenses: "false"
צריך לוודא שמגבלות הרישוי שנקבעות על ידי חבילות תלויות לא מתנגשות עם מצבי ההפצה של היעדים שאתם יוצרים. כברירת מחדל, הרישיונות לא נבדקים.
תגים: build_file_semantics
ברירת מחדל של --[no]check_visibility: "true"
אם המדיניות מושבתת, שגיאות חשיפה בתלויות יעד יורדו לאזהרות.
תגים: build_file_semantics
ברירת מחדל של --[no]desugar_for_android: "true"
האם לבצע פענוח קוד בייט 8 של סוכר לפני פענוח הקוד?
תגים: affects_outputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]desugar_java8_libs: "false"
האם לכלול ספריות Java 8 נתמכות באפליקציות למכשירים מדור קודם.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --[no]enforce_constraints: "true"
לבדוק את הסביבות שבהן כל יעד תואם, ומדווח על שגיאות אם לכל יעד יש יחסי תלות שלא תומכים באותן סביבות
תגים: build_file_semantics
ברירת מחדל של --[no]experimental_allow_android_library_deps_without_srcs: "false"
סימון כדי לעזור במעבר מהמדיניות של אי-אפשר להשתמש בכללי android_library ללא כינויים באמצעות נקודות שפל. יש לנקות את המאגר כדי שההוצאה תתבצע כברירת מחדל.
תגים: eagerness_to_exit, loading_and_analysis
ברירת מחדל של --[no]experimental_check_desugar_deps: "true"
האם כדאי לבדוק שוב את ניפוי הבאגים הנכון ברמה הבינארית של Android.
תגים: eagerness_to_exit, loading_and_analysis, experimental
ברירת מחדל של --experimental_import_deps_checking=<off, warning or error>: "OFF"
כשהאפשרות מופעלת, בודקים אם התלות של aar_import הסתיימו. האכיפה הזו עלולה לפרוץ את הבנייה, או להוביל רק לאזהרות.
תגים: loading_and_analysis
ברירת מחדל של --experimental_strict_java_deps=<off, warn, error, strict or default>: "default"
אם הערך הוא true, המערכת בודקת שיעד של Java מצהיר במפורש על כל היעדים שנעשה בהם שימוש ישיר כתלויות.
תגים: build_file_semantics, eagerness_to_exit
ברירת מחדל של --[no]incompatible_check_testonly_for_output_files: "false"
אם האפשרות הזו מופעלת, יש לבדוק רק את היעדים הנדרשים שהם קובצי פלט, על ידי חיפוש הבדיקה בלבד של כלל היצירה. ההגדרה הזו תואמת לבדיקת הניראות.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_disable_native_android_rules: "false"
אם המדיניות מופעלת, השימוש הישיר בכללי Android המקוריים מושבת. יש להשתמש בכללי Starlark ל-Android בכתובת https://github.com/bazelbuild/rules_android
תגים: eagerness_to_exit, incompatible_change
ברירת מחדל של --[no]incompatible_disable_native_apple_binary_rule: "false"
לא צריך להשתמש בהגדרה הזו. אפשר לשמור כאן לצורך תאימות לאחור.
תגים: eagerness_to_exit, incompatible_change
ברירת מחדל של --[no]incompatible_force_strict_header_check_from_starlark: "true"
אם האפשרות מופעלת, ניתן להגדיר בדיקת כותרות מחמירה ב-Starlark API
תגים: loading_and_analysis, changes_inputs, incompatible_change
ברירת מחדל של --[no]incompatible_validate_top_level_header_inclusions: "true"
אם הדבר נכון, Bazel תוודא גם שההכללה של הספרייה היא ברמה העליונה (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/10047).
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]strict_filesets: "false"
אם האפשרות הזו מופעלת, קבצים שחוצים את גבולות החבילה מדווחים כשגיאות. הוא לא פועל כאשר Check_fileset_dependencies_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"
אלא אם האפשרות מושבתת, המערכת בודקת שיעד Proto_library מצהיר באופן מפורש על כל היעדים שנעשה בהם שימוש ב 'ייבוא ציבורי&#39.
תגים: build_file_semantics, eagerness_to_exit, incompatible_change
ברירת מחדל של --[no]strict_system_includes: "false"
אם הערך הוא True, צריך להצהיר גם על כותרות שנמצאות דרך נתיבים (-isystem).
תגים: loading_and_analysis, eagerness_to_exit
נצברו --target_environment=<a build target label> שימושים מרובים
מצהירה על סביבת היעד הזו. הערך חייב להיות תווית של כלל "enrinoment" אם צוין, כל היעדים ברמה העליונה חייבים להתאים לסביבה הזו.
תגים: changes_inputs
אפשרויות שמשפיעות על הפלט של החתימה של גרסת build:
ברירת מחדל של --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"
אם המדיניות מוגדרת ומצב האוסף לא 'opt' אפליקציות objc יכללו הרשאות לניפוי באגים בזמן החתימה.
תגים: changes_inputs
ברירת מחדל של --ios_signing_cert_name=<a string>: תיאור
שם האישור לשימוש בחתימת iOS. אם המדיניות לא מוגדרת, תוחזר לפרופיל ניהול התצורה. יכול להיות העדפת הזהות של אישור המפתח או מחרוזת המשנה של השם הנפוץ באישור, בהתאם לדף האדם של ה-Codesign &#39 (מפתח רישום).
תגים: action_command_lines
האפשרות הזו משפיעה על סמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו בקובצי BUILD, קובצי .bzl או קובצי WORKSPACE.:
ברירת מחדל של --[no]incompatible_config_setting_private_default_visibility: "false"
אם לא תואם_enforce_config_setting_visible=false, זו שגיאה. אחרת, אם הסימון הזה הוא false, כל הגדרת config_ללא מאפיין חשיפה בוטה היא //visible:public. אם הסימון הזה נכון, המאפיין config_setting תואם ללוגיקה של הרשאות הגישה שדומה לכל הכללים האחרים. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12933.
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_disallow_legacy_py_provider: "true"
לא, המערכת תסיר אותה בקרוב.
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_enforce_config_setting_visibility: "true"
אם המדיניות מוגדרת כ-True, יש לאכוף את הרשאות הגישה מסוג config_setting. אם הערך הוא False, כל config_setting גלויה לכל יעד. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים: loading_and_analysis, incompatible_change
אפשרויות שקובעות את אופן הפעולה של סביבת הבדיקה או של אופרטור הבדיקה:
ברירת מחדל של --[no]allow_analysis_failures: "false"
אם הערך מקבל את הערך 'true', כשל בניתוח של יעד הוא מפיץ את המופע של target&ailureInfo המכיל את תיאור השגיאה, במקום לגרום לכשל ב-build.
תגים: 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"
אם כשלים אמיתיים בפעולת dex2oat יגרמו לקריסה של המודל במקום לבצע Dex2oat בזמן ריצה של הבדיקה.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]check_tests_up_to_date: "false"
אין להריץ בדיקות. יש לבדוק אם הן מעודכנות. אם כל תוצאות הבדיקות מעודכנות, הבדיקה הושלמה בהצלחה. אם יש צורך לבצע או להפעיל בדיקה כלשהי, מדווחת על שגיאה והבדיקה נכשלה. אם בוחרים באפשרות הזו, פירוש הדבר הוא --check_up_to_date.
תגים: execution
ברירת מחדל של --[no]experimental_android_use_parallel_dex2oat: "false"
משתמשים ב-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'. אם מספר שלם, כל הבדיקות יופעלו עד N פעמים. אם 'default', יבוצע ניסיון בדיקה אחד בלבד בבדיקות רגילות ושלושה בבדיקות שסומנו באופן מפורש ככללי על ידי הכלל שלהם (Flaky=1). תחביר חלופי: regex_filter@flky_test_attempts. כאשר Flaky_test_attempts נמצא למעלה, ו-regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (ראו גם --runs_per_test). דוגמה: -flky_test_attempts=//foo/.*,-//foo/bar/.*@3 ניתן להעביר את האפשרות הזו כמה פעמים. הארגומנט האחרון שהועבר תואם לעדיפות. אם לא נמצאה התאמה, ההתנהגות היא כאילו 'default' לעיל.
תגים: execution
ברירת מחדל של --[no]ios_memleaks: "false"
הפעלה של בדיקת דליפות זיכרון ביעדי ios_test.
תגים: action_command_lines
ברירת מחדל של --ios_simulator_device=<a string>: תיאור
המכשיר להדמיית הפעלה של אפליקציה ל-iOS בסימולטור, לדוגמה 'iPhone 6'. ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים: 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"
המספר המקסימלי של משימות בדיקה מקומיות שפועלות בו-זמנית. הפרמטר מכיל מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ואחריו אופציונלי (למשל, [-|*]<float>) למשל. "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 מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (ראו גם --instrumentation_filter). דוגמה: --runs_per_test=//foo/.*,-//foo/bar/.*@3 מריץ את כל הבדיקות ב-//foo/ אבל לא מתחת ל-foo/bar שלוש פעמים. ניתן להעביר את האפשרות הזו כמה פעמים. הארגומנט האחרון שהועבר תואם לעדיפות. אם אין תוצאות תואמות, הבדיקה תופעל פעם אחת בלבד.
נצברו --test_env=<a 'name=value' assignment with an optional value part> שימושים מרובים
ההגדרה קובעת משתני סביבה נוספים שיוחדרו לסביבת הרצה של הבדיקה. אפשר לציין משתנים לפי שם. במקרה כזה, הערך שלהם ייקרא מסביבת הלקוח ב-Bazel או באמצעות צמד name=value. אפשר להשתמש באפשרות הזו כמה פעמים כדי לציין כמה משתנים. בשימוש רק באמצעות הפקודה 'bazel' .
תגים: test_runner
ברירת מחדל של --[no]test_keep_going: "true"
כשהבדיקה מושבתת, כל הבדיקות שלא עברו יגרמו להפסקה של כל ה-build. כברירת מחדל, כל הבדיקות פועלות, גם אם חלק מהן לא עוברות.
תגים: execution
ברירת מחדל של --test_strategy=<a string>: ""
קביעת השיטה שבה רוצים להפעיל בדיקות.
תגים: execution
ברירת מחדל של --test_timeout=<a single integer or comma-separated list of 4 integers>: "-1"
כדאי לשנות את ערכי ברירת המחדל של הזמן הקצוב לתפוגה של בדיקות (בדקות) אם יצוין ערך חיובי אחד שלם, הוא יחליף את כל הקטגוריות. אם ציינתם 4 מספרים שלמים המופרדים בפסיקים, הם יחליפו את הזמן הקצוב לתפוגה עבור קצר, בינוני, ארוך ותמידי (בסדר הזה). בכל אחד מהפורמטים, הערך 1- מורה ל-blaze להשתמש בברירות המחדל של הזמן הקצוב לתפוגה עבור קטגוריה זו.
ברירת מחדל של --test_tmpdir=<a path>: תיאור
מפרט את הספרייה הזמנית הבסיסית עבור 'בדיקת B&z#39; לשימוש.
ברירת מחדל של --tvos_simulator_device=<a string>: תיאור
המכשיר להדמיית הפעלה של אפליקציית tvOS בסימולטור, למשל 'Apple TV 1080p' ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים: test_runner
ברירת מחדל של --tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
גרסת ה-tvOS שפועלת בסימולטור בזמן הפעלה או בדיקה.
תגים: test_runner
ברירת מחדל של --watchos_simulator_device=<a string>: תיאור
המכשיר להדמיית הפעלה של אפליקציית WatchOS בסימולטור, למשל 'Apple Watch – 38mm' ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים: test_runner
ברירת מחדל של --watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
גרסת ה-watchOS שמופעלת בסימולטור כשמריצים או בודקים.
תגים: test_runner
ברירת מחדל של --[no]zip_undeclared_test_outputs: "true"
אם הערך הוא True, פלט של בדיקות לא מוצהרות יועברו לארכיון בקובץ ZIP.
תגים: test_runner
אפשרויות שגורמות לאופטימיזציה של זמן ה-build:
ברירת מחדל של --[no]collapse_duplicate_defines: "false"
כשהאפשרות מופעלת, ההגדרות המיותרות יוסרו בשלב מוקדם. כדי למנוע אובדן מיותר של מטמון הניתוח לסוגים מסוימים של גרסאות build מקבילות.
תגים: loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]experimental_filter_library_jar_with_program_jar: "false"
יש לסנן את ProGuard ProgramJar כדי להסיר את כל הכיתות שנמצאות גם ב-LibraryJar.
תגים: action_command_lines
ברירת מחדל של --[no]experimental_inmemory_dotd_files: "true"
כשהאפשרות מופעלת, קובצי C++ .d יועברו בזיכרון ישירות מצומתי ה-build המרוחק במקום להיכתב לדיסק.
תגים: loading_and_analysis, execution, affects_outputs, experimental
ברירת מחדל של --[no]experimental_inmemory_jdeps_files: "true"
אם האפשרות מופעלת, קובצי התלויות (.jdeps) שנוצרו מהאוספים של Java יועברו בזיכרון ישירות מצומתי ה-build המרוחק במקום להיכתב לדיסק.
תגים: loading_and_analysis, execution, affects_outputs, experimental
ברירת מחדל של --[no]experimental_objc_include_scanning: "false"
האם לבצע סריקה עבור אובייקט C/C+ אובייקטיבי.
תגים: loading_and_analysis, execution, changes_inputs
ברירת מחדל של --[no]experimental_parse_headers_skipped_if_corresponding_srcs_found: "false"
אם התכונה parse_headers מופעלת, אם לא קיים מקור באותו שם יעד, היא לא יוצרת פעולת רינדור נפרדת של כותרת.
תגים: loading_and_analysis, affects_outputs
ברירת מחדל של --[no]experimental_retain_test_configuration_across_testonly: "false"
כשהאפשרות מופעלת, --trim_test_Configuration לא יקטע את תצורת הבדיקה של כללים שסומנו לבדיקה בלבד=1. כך אנחנו מצמצמים את הבעיות של התנגשות בין פעולות כאשר כללים שאינם בדיקות תלויים בכללים של cc_test. אין השפעה אם --trim_test_ Configuration היא FALSE.
תגים: loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]experimental_starlark_cc_import: "false"
אם ההגדרה מופעלת, אפשר להשתמש בגרסת Starlark של cc_import.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_unsupported_and_brittle_include_scanning: "false"
כדי לצמצם את קלט הקלט לאוסף C/C++ , יש לנתח #include שורות מקובצי קלט. כך אפשר לשפר את הביצועים ואת הצבירה על ידי הקטנת הגודל של עצי ההזנה של האוסף. עם זאת, היא עלולה לשבור גרסאות build כי הסורק של כלי העריכה לא מטמיע באופן מלא את הסמנטיקה של מעבד המידע (CPU) לפני העיבוד. באופן ספציפי, הוא לא מבין הוראות #include דינמיות ומתעלם מלוגיקה מותנית של עיבוד מראש. השימוש הוא באחריותך בלבד. כל בעיה הנוגעת לסימון זה ייסגר.
תגים: loading_and_analysis, execution, changes_inputs
ברירת מחדל של --[no]incremental_dexing: "true"
רוב העבודה על דקס נפתחת בנפרד בכל קובץ ב-Jar.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]objc_use_dotd_pruning: "true"
אם המדיניות מוגדרת, קובצי .d שנוצרו על ידי ה-Clang ישמשו לגיזום קבוצת הקלט הנכנסת מהדרים objc.
תגים: changes_inputs, loading_and_analysis
ברירת מחדל של --[no]process_headers_in_dependencies: "false"
כשיוצרים יעד //a:a, צריך לעבד כותרות בכל היעדים ש //a:a תלויים בהם (אם עיבוד הכותרת מופעל עבור Toolchain).
תגים: execution
ברירת מחדל של --[no]trim_test_configuration: "true"
כשהאפשרות מופעלת, האפשרויות שקשורות לבדיקה יימחקו מתחת לרמה העליונה של ה-build. כשהסימון הזה פעיל, לא ניתן ליצור בדיקות כתלויות של כללים שאינם בדיקות, אבל שינויים באפשרויות הקשורות לבדיקה לא יגרמו לניתוח מחדש של כללים שאינם בדיקות.
תגים: loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]use_singlejar_apkbuilder: "true"
האפשרות הזו הוצאה משימוש. לא חייבים להשתמש בה והיא תוסר בקרוב.
תגים: loading_and_analysis
אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום:
ברירת מחדל של --[no]announce: "false"
הוצא משימוש. לא.
תגים: affects_outputs
ברירת מחדל של --[no]experimental_bep_target_summary: "false"
אם רוצים לפרסם אירועי סיכום סיכום.
ברירת מחדל של --[no]experimental_build_event_expand_filesets: "false"
אם הערך הוא TRUE, מרחיבים את FilesApps ב-BEP כשמציגים קובצי פלט.
תגים: affects_outputs
אם הערך הוא True, יש לפתור בצורה מלאה את סמלי הקישור היחסיים של Fileset ב-BEP כשמציגים קובצי פלט. נדרשת -experimental_build_event_expand_filesets.
תגים: affects_outputs
ברירת מחדל של --experimental_build_event_upload_max_retries=<an integer>: "4"
מספר הפעמים המקסימלי שחברת Bazel מנסה להעלות אירוע build.
תגים: bazel_internal_configuration
ברירת מחדל של --experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>: "1s"
השהיה מינימלית עד לעיכוב מעריכי של ניסיונות חוזרים כאשר העלאה של BEP נכשלה. (מעריך: 1.6)
תגים: bazel_internal_configuration
ברירת מחדל של --experimental_build_event_upload_strategy=<a string>: תיאור
בחירה איך להעלות פריטי מידע שנוצרים בתהליך פיתוח (Artifact) המוזכרים בפרוטוקול של אירוע ה-build.
תגים: affects_outputs
ברירת מחדל של --[no]experimental_materialize_param_files_directly: "false"
אם יוצרים קובצי עזר, צריך לעשות זאת בכתיבה ישירה לדיסק.
תגים: execution
ברירת מחדל של --[no]experimental_stream_log_file_uploads: "false"
אפשר להעביר העלאות של קובצי יומן ישירות לאחסון המרוחק, במקום לכתוב אותם בדיסק.
תגים: affects_outputs
ברירת מחדל של --explain=<a path>: תיאור
מערכת המודל גורמת להסבר על כל שלב בביצוע ה-build. ההסבר נכתב בקובץ היומן שצוין.
תגים: affects_outputs
ברירת מחדל של --[no]legacy_important_outputs: "true"
אפשר להשתמש בכך כדי להסתיר יצירה של שדה חשוב_פלט קודם באירוע Targetcomplete. נדרשים שילובים חשובים של Basel עד ResultStore.
תגים: affects_outputs
ברירת מחדל של --[no]materialize_param_files: "false"
כותבים קובצי פרמטרים בינוניים לעץ הפלט גם כשמשתמשים בביצוע פעולות מרחוק. שימושי לניפוי באגים בפעולות. זה מרמז על כך – subsubmands ו- --verbose_failures.
תגים: execution
ברירת מחדל של --max_config_changes_to_show=<an integer>: "3"
כשמוחקים את מטמון הניתוח עקב שינוי באפשרויות build, מוצג מספר נתון של שמות אפשרויות. אם המספר הנתון הוא 1-, כל האפשרויות שהשתנו יוצגו.
תגים: terminal_output
ברירת מחדל של --max_test_output_bytes=<an integer>: "-1"
ההגדרה קובעת את הגודל המרבי של יומן בדיקה לכל משתמש כאשר --test_פלט הוא 'שגיאות' או '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"
הצגת התוצאות של ה-build. עבור כל יעד, מציינים אם הוא הועלה, ואם כן, רשימה של קובצי פלט שנוצרו. הקבצים המודפסים הם מחרוזות נוחות להעתקה ולהדבקה למעטפת, כדי להפעיל אותן. כדי להשתמש באפשרות הזו, נדרש ארגומנט של מספר שלם, שהוא מספר הסף של היעדים שעליהם לא מדפיסים את פרטי התוצאה. לכן אפס גורם למחיקת ההודעה ו-MAX_INT גורם להדפסת התוצאה להופיע תמיד. ברירת המחדל היא אחת.
תגים: affects_outputs
--[no]subcommands [-s] ברירת מחדל: "false"
הצגת פקודות המשנה שבוצעו במהלך ה-build. סימונים קשורים: --execution_log_json_file, --execution_log_binary_file (לתיעוד פקודות משנה לקובץ בפורמט ידידותי לכלי).
תגים: terminal_output
ברירת מחדל של --test_output=<summary, errors, all or streamed>: "summary"
קביעת מצב הפלט הרצוי. הערכים החוקיים הם 'summary' לפלט סיכום של סטטוס בדיקה בלבד, 'errors' להדפסת יומני בדיקה גם עבור בדיקות שנכשלו, 'all' להדפסת יומנים עבור כל הבדיקות בזמן אמת (פעולה זו תאלץ את ביצוע הבדיקות באופן מקומי אחד בכל פעם --_).
תגים: test_runner, terminal_output, execution
ברירת מחדל של --test_summary=<short, terse, detailed, none or testcase>: "short"
ההגדרה היא הפורמט הרצוי של סיכום הבדיקה. ערכים חוקיים הם 'short' כדי להדפיס מידע רק על בדיקות שבוצעו, 'terse' כדי להדפיס מידע רק על בדיקות שנכשלו; 'detailed' כדי להדפיס סיכום מפורט בתרחיש של בדיקת בדיקה; אין להדפיס מידע מפורט על מקרים של מקרה בדיקה ו-39;
תגים: terminal_output
ברירת מחדל של --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
הדפסת מידע על תוצאות ניפוי באגים במהלך רזולוציה של הכלי. בסימון נעשה שימוש בביטוי רגולרי, שנבדק ביחס לסוגי כלי עבודה ויעדים ספציפיים, כדי לראות באיזה ניפוי באגים. אפשר להפריד בין ביטויים רגולריים באמצעות ביטויים רגולריים, ולאחר מכן כל ביטוי רגולרי מסומן בנפרד. הערה: הפלט של הדגל הזה מורכב מאוד וככל הנראה יועיל רק למומחים בפתרון בעיות בכלי.
תגים: terminal_output
ברירת מחדל של --[no]verbose_explanations: "false"
יש להגדיל את המלל של ההסברים שהונפקו, אם ההסבר הזה מופעל. אין השפעה אם --Excel לא מופעל.
תגים: affects_outputs
ברירת מחדל של --[no]verbose_failures: "false"
אם פקודה לא מצליחה, מומלץ להדפיס את שורת הפקודה המלאה.
תגים: terminal_output
אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
נצברו --aspects_parameters=<a 'name=value' assignment> שימושים מרובים
ההגדרה קובעת את הערכים של הפרמטרים של היבטים בשורת הפקודה. כל ערך של פרמטר מצוין דרך <param_name>=<param_value> לדוגמה, 'my_param=my_val' כאשר 'my_param' הוא פרמטר של היבט כלשהו ב'רשימת ההיבטים' או שהוא נדרש על ידי היבט ברשימה. ניתן להשתמש באפשרות הזו כמה פעמים. עם זאת, אסור להקצות ערכים לאותו פרמטר יותר מפעם אחת.
תגים: loading_and_analysis
נצברו --flag_alias=<a 'name=value' flag alias> שימושים מרובים
מגדירים שם מקוצר לסימון Starlark. הוא צריך להזין צמד יחיד של מפתח-ערך בפורמט "<key>=<value>" כארגומנט.
תגים: changes_inputs
ברירת מחדל של --[no]incompatible_default_to_explicit_init_py: "false"
סימון זה משנה את התנהגות ברירת המחדל כך שקובצי __init__.py כבר לא נוצרים באופן אוטומטי בקבצים פועלים של יעדים ב-Python. באופן מדויק, אם יעד py_binary או py_test מוגדר מדור קודם, play_create_init מוגדר ל-"auto" (ברירת המחדל), הוא נחשב כ-false אם רק הסימון הזה מוגדר. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/10076.
תגים: affects_outputs, incompatible_change
ברירת מחדל של --[no]incompatible_py2_outputs_are_suffixed: "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_פלטs_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>: ""
אם אפשרות זו מוגדרת, גרסת ה-build תקרא תבניות מהקובץ שנקרא כאן, במקום בשורת הפקודה. שגיאה בציון קובץ כאן וגם בדפוסי שורת פקודה.
תגים: changes_inputs
אפשרויות שונות, ללא שיוך לקטגוריה אחרת:
ברירת מחדל של --[no]build_manual_tests: "false"
מתבצעת יצירה של יעדי בדיקה מתויגים 'ידני' 'ידני' הבדיקות לא מעובדות. אם רוצים להשתמש באפשרות הזו, צריך לבנות אותה (אבל לא לבצע אותה).
ברירת מחדל של --build_tag_filters=<comma-separated list of options>: ""
ההגדרה מציינת רשימת תגים המופרדים בפסיקים. לפני כל תג אפשר להוסיף '-' כדי לציין תגים מוחרגים. רק היעדים האלה יווצרו שכוללים לפחות תג כלול אחד ולא מכילים תגים שאינם נכללים. האפשרות הזו לא משפיעה על קבוצת הבדיקות שמופעלות באמצעות הפקודה 'test' או שאינן כפופות לאפשרויות סינון הבדיקה, למשל '--test_tag_filters'
ברירת מחדל של --[no]build_tests_only: "false"
אם צוין, המערכת תבנה רק כללים מסוג *_test ו-test_Suite המערכת תתעלם מיעדים אחרים שצוינו בשורת הפקודה. כברירת מחדל, כל מה שהתבקש ייבנה.
--[no]cache_test_results [-t] ברירת מחדל: "auto"
אם מוגדר כ-'auto', Bazel מריץ בדיקה מחדש אם ורק: (1) בזל מזהה שינויים בבדיקה או בתלויות שלה, (2) הבדיקה מסומנת כחיצונית, (3) התבקשו מספר ריצות בדיקה עם -runs_per_test או(4) הבדיקה נכשלה בעבר. אם הכתובת היא 'yes' , Bazel שומרת במטמון את כל תוצאות הבדיקה, מלבד בדיקות שסומנו כחיצוניות. אם הכתובת היא 'no', Bazel לא שומרת תוצאות בדיקה.
ברירת מחדל של --[no]compile_one_dependency: "false"
יוצרים תלות אחת של קובצי הארגומנטים. זו פעולה שימושית לבדיקת קובצי מקור ב-IDE, למשל על ידי בניית יעד יחיד שתלוי בקובץ המקור כדי לזהות שגיאות בהקדם האפשרי במחזור העריכה/בנייה/בדיקה. הארגומנט הזה משפיע על האופן שבו כל הארגומנטים שאינם מסמנים מתפרשים. במקום לטרגט אותם כדי לבנות אותם, הם שמות הקבצים של המקור. עבור כל שם קובץ מקור יווצר יעד שרירותי שתלוי בו.
ברירת מחדל של --deleted_packages=<comma-separated list of package names>: ""
רשימה של שמות של חבילות, מופרדים בפסיקים, שמערכת ה-build תתייחס אליהם שאינם קיימים, גם אם הם מוצגים במקום כלשהו בנתיב החבילה. כדאי להשתמש באפשרות הזו כשמוחקים חבילת משנה 'x/y' של חבילה קיימת 'x' לדוגמה, לאחר מחיקת x/y/BUILD בלקוח, מערכת ה-build עשויה להתלונן אם היא תיתקל בתווית '//x:y/z' אם היא עדיין מסופקת על ידי ערך package_path אחר. ציון [delete_packs x/y] מונע את הבעיה הזו.
ברירת מחדל של --[no]discard_analysis_cache: "false"
אפשר למחוק את מטמון הניתוח מיד אחרי ששלב הניתוח מסתיים. מפחית את השימוש בזיכרון בכ-10%, אבל הופך את ה-build של מצטבר יותר לאט יותר.
ברירת מחדל של --execution_log_binary_file=<a path>: תיאור
עליך לרשום את הסדינים שבוצעו בקובץ הזה כפרוטוקולים של ספרדים מופרדים, בהתאם לכתובת src/main/protobuf/spawn.proto. תחילה כותבים את היומן בלי סדר, ואז בסוף ההפעלה הם ממוינים בסדר קבוע (יכול להיות מצריך מעבד וזיכרון). סימונים קשורים: --execution_log_json_file (פורמט json של טקסט שהוזמן), --experimental_execution_log_file (פורמט בינארי לא מורשה), --subcommands (להצגת פקודות משנה בפלט מסוף).
ברירת מחדל של --execution_log_json_file=<a path>: תיאור
עליך לתעד את הסדינים שבוצעו בקובץ הזה כייצוג json של פרוטוסים מופרדים בפסיקים, בהתאם ל- src/main/protobuf/spawn.proto. תחילה כותבים את היומן בלי סדר, ואז בסוף ההפעלה הם ממוינים בסדר קבוע (יכול להיות מצריך מעבד וזיכרון). סימונים קשורים: סימונים קשורים: --execution_log_binary_file (פורמט בינארי בינארי שהוזמן), --experimental_execution_log_file (פורמט Protobuf בינארי ללא הזמנה), --subcommands (להצגת פקודות משנה בפלט מסוף).
ברירת מחדל של --[no]expand_test_suites: "true"
מומלץ להרחיב את יעדי test_Suite לבדיקות ההרכב שלהם לפני הניתוח. אם הדגל הזה מופעל (ברירת המחדל), דפוסי יעד שליליים יחולו על הבדיקות השייכות לחבילת הבדיקה, אחרת הם לא יפעלו. השבתה של הסימון הזה שימושית כשמחילים היבטים ברמה העליונה בשורת הפקודה: ואז אפשר לנתח מטרות בדיקה של suite.
תגים: loading_and_analysis
ברירת מחדל של --[no]experimental_cancel_concurrent_tests: "false"
True האפשרות הזו שימושית רק בשילוב עם --runs_per_test_detects_flakes.
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --experimental_execution_log_file=<a path>: תיאור
עליך לרשום את הסדינים שבוצעו בקובץ הזה כפרוטוקולים של ספרדים מופרדים, בהתאם לכתובת src/main/protobuf/spawn.proto. הקובץ הזה נכתב לפי סדר הביצוע של סדונים. סימונים קשורים: --execution_log_binary_file (פורמט בינארי בינארי שהובטח), --execution_log_json_file (פורמט json של טקסט שהוזמן), --subcommands (להצגת פקודות משנה בפלט מסוף).
ברירת מחדל של --[no]experimental_execution_log_spawn_metrics: "false"
הכללת מדדי S מרכזן ביומן הביצוע.
ברירת מחדל של --experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: ""
הוצא משימוש לטובת היבטים. מסננים של קבוצות יעדים שעבורן אפשר לתזמן פעולות נוספות.
ברירת מחדל של --[no]experimental_extra_action_top_level_only: "false"
הוצא משימוש לטובת היבטים. תזמון פעולות נוספות מסוג action_actions רק ביעדים ברמה עליונה.
ברירת מחדל של --[no]experimental_fetch_all_coverage_outputs: "false"
אם הערך הוא True, מערכת Bazel מאחזרת את כל ספריית נתוני הכיסוי עבור כל בדיקה במהלך תקופת כיסוי.
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --[no]experimental_generate_llvm_lcov: "false"
אם זה יהיה נכון, כיסוי לגבי קלנג ייצור דוח LCOV.
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --[no]experimental_j2objc_header_map: "true"
האם ליצור מפת כותרת של J2ObjC במקביל לתעתוק J2ObjC?
ברירת מחדל של --[no]experimental_j2objc_shorter_header_path: "false"
אם צריך ליצור עם נתיב כותרת קצר יותר (משתמשים ב-"_ios" במקום "_j2objc").
תגים: affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel> כברירת מחדל: "Javabuilder"
הפעלת ערכי נתיב מופחתים לאוספים של Java.
ברירת מחדל של --[no]experimental_limit_android_lint_to_android_constrained_java: "false"
מגבילים --experimental_run_android_lint_on_Java_rules לספריות תואמות ל-Android.
תגים: affects_outputs
ברירת מחדל של --[no]experimental_prioritize_local_actions: "true"
אם הן מוגדרות, פעולות שניתן להפעיל באופן מקומי מקבלים רק הזדמנות ראשונה לרכוש משאבים, עובדים באופן דינמי מקבלים הזדמנות שנייה, ופעולות נפרדות שמתבצעות באופן דינמי ומתבצעות לאחרונה.
תגים: execution
ברירת מחדל של --[no]experimental_run_android_lint_on_java_rules: "false"
האם לאמת את מקורות Java_*?
תגים: affects_outputs
ברירת מחדל של --[no]explicit_java_test_deps: "false"
יש לציין באופן מפורש את התלות ב-JUnit או Hacrest ב-Java_test במקום לקבל בטעות נקודות דירוג מ-TestRunner&#39. בשלב זה מתאים לשימוש ב-Bazall.
ברירת מחדל של --host_java_launcher=<a build target label>: תיאור
מרכז האפליקציות של Java שמשמש את הכלים להפעלה במהלך build.
נצברו --host_javacopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-Java בעת יצירת כלים המופעלים במהלך build.
נצברו --host_jvmopt=<a string> שימושים מרובים
אפשרויות נוספות למעבר ל-Java VM במהלך בניית כלים שמופעלים במהלך ה-build. האפשרויות האלה יתווספו לאפשרויות ההפעלה של VM בכל יעד Java_binary.
ברירת מחדל של --[no]incompatible_exclusive_test_sandboxed: "false"
אם הערך הוא נכון, יופעלו בדיקות בלעדיות עם שיטת בידינג בארגז חול. מוסיפים תג 'local' כדי לאלץ הרצת בדיקה בלעדית באופן מקומי
תגים: incompatible_change
ברירת מחדל של --[no]incompatible_strict_action_env: "false"
אם הערך true, Bazel משתמשת בסביבה עם ערך סטטי של Path ולא יורשת את LD_LIBRARI_Path. משתמשים בפונקציה --action_env=ENV_VARIABLE אם רוצים לרשת בירושה משתני סביבה ספציפיים מהלקוח, אך חשוב לזכור שפעולה זו יכולה למנוע שמירה במטמון של משתמשים שונים אם נעשה שימוש במטמון משותף.
תגים: loading_and_analysis, incompatible_change
נצברו --j2objc_translation_flags=<comma-separated list of options> שימושים מרובים
אפשרויות נוספות למעבר לכלי J2ObjC.
--java_debug
המכונה הווירטואלית של Java בבדיקת Java ממתינה לחיבור לכלי ניפוי באגים התואם ל-JDWP (כגון jdb) לפני התחלת הבדיקה. משתמע -test_פלט=שידור.
הרחבה אל:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
ברירת מחדל של --[no]java_deps: "true"
יצירת פרטי תלות (כרגע, סוג ה-path של זמן הביצוע) לכל יעד Java.
ברירת מחדל של --[no]java_header_compilation: "true"
להיעזר באיג'רים ישירות מהמקור.
ברירת מחדל של --java_language_version=<a string>: "8"
גרסת השפה ב-Java
ברירת מחדל של --java_launcher=<a build target label>: תיאור
מרכז האפליקציות של Java לשימוש כשיוצרים קבצים בינאריים של Java. אם הדגל הזה מוגדר כמחרוזת ריקה, המערכת תשתמש במפעיל JDK. המאפיין "מרכז האפליקציות" מבטל את הסימון הזה.
ברירת מחדל של --java_runtime_version=<a string>: "local_jdk"
גרסת זמן הריצה של Java
נצברו --javacopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-Java.
נצברו --jvmopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-Java VM. האפשרויות האלה יתווספו לאפשרויות ההפעלה של VM בכל יעד Java_binary.
ברירת מחדל של --legacy_main_dex_list_generator=<a build target label>: תיאור
קביעת הקובץ הבינארי שבו יש להשתמש כדי ליצור את רשימת הכיתות שחייבות להיות בשרת ה-proxy הראשי במהלך הידור ה-Multiplexex הקודם.
ברירת מחדל של --local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>: "HOST_CPUS"
יש להגדיר באופן מפורש את המספר הכולל של ליבות מעבד (CPU) מקומיות שזמינות ל-Bazel להוצאה על פעולות build שמבוצעות באופן מקומי. משתנה מספר שלם, או "HOST_CPUS" ואופציונלית גם [-|*]<float> (למשל, HOST_CPUS*.5 כדי להשתמש במחצית מליבות המעבד (CPU) הזמינות. כברירת מחדל, ("HOST_CPUS" ), Bazel תשלח שאילתה לתצורת המערכת כדי להעריך את מספר הליבות של המעבד (CPU).
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.> ברירת מחדל: "HOST_RAM*.67"
יש להגדיר במפורש את סך כל זיכרון ה-RAM המארח המקומי (ב-MB) הזמין ל-Bazel להוצאה על פעולות build שמבוצעות באופן מקומי. משתנה מספר שלם, או "HOST_RAM" ואופציונלית מופיע [-|*]<float> (למשל, HOST_RAM*.5 כדי להשתמש בחצי מזיכרון ה-RAM הזמין). כברירת מחדל, ("HOST_RAM*.67" ), Bazel תשלח שאילתה לתצורת המערכת כדי להעריך את כמות ה-RAM הזמינה, ומשתמשת ב-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> שימושים מרובים
יישומי פלאגין לשימוש ב-build. פועלים כרגע עם Java_plugins.
ברירת מחדל של --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() שמתארת איך להדר Cto++ Proto תגים: 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
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --proto_toolchain_for_javalite=<a build target label>: "@bazel_tools//tools/proto:Javalite_toolchain"
תווית Proto_lang_toolchain() שמתארת איך להדר פרוטומות של JavaLite
תגים: affects_outputs, loading_and_analysis
נצברו --protocopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה אל מהדר הפרוטוקול.
תגים: affects_outputs
ברירת מחדל של --[no]runs_per_test_detects_flakes: "false"
אם הערך מקבל את הערך True, כל פיצול שבו עובר ניסיון ריצה/ניסיון אחד לפחות ולפחות ניסיון ריצה אחד/ניסיון אחד נכשל, מקבל את הסטטוס FLAKY.
ברירת מחדל של --shell_executable=<a path>: תיאור
נתיב מוחלט להפעלה של קונכיות לשימוש בבזל. אם האפשרות הזו לא מוגדרת, המשתנה של סביבת 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"
אם מופעל, גורם ל-Bazel להדפיס הודעות &&;טעינת חבילה:".
נצברו --test_arg=<a string> שימושים מרובים
קביעת אפשרויות וארגומנטים נוספים שצריך להעביר לקובץ ההפעלה של הבדיקה. ניתן להשתמש מספר פעמים כדי לציין כמה ארגומנטים. אם יבוצעו כמה בדיקות, כל אחת מהן תקבל ארגומנטים זהים. בשימוש רק באמצעות הפקודה 'bazel' .
ברירת מחדל של --test_filter=<a string>: תיאור
קביעת מסנן להעברת למסגרת הבדיקה. משמש להגבלת הבדיקות. לתשומת ליבכם: אין לכך השפעה על היעדים המובנים.
ברירת מחדל של --test_lang_filters=<comma-separated list of options>: ""
קביעת רשימה של שפות בדיקה המופרדות בפסיקים. אפשר להוסיף לפני כל שפה את המילים " '-' כדי לציין שפות מוחרגות. יימצאו רק יעדי הבדיקה שנכתבו בשפות שצוינו. השם המשמש לכל שפה צריך להיות זהה לתחילית השפה בכלל *_test, למשל, אחד מהתווים #&39;cc', 'Java', 'py' וכו'. האפשרות הזו משפיעה על --build_tests_only ועל פקודת הבדיקה.
ברירת מחדל של --test_result_expiration=<an integer>: "-1"
האפשרות הזו הוצאה משימוש ואין לה השפעה.
ברירת מחדל של --[no]test_runner_fail_fast: "false"
אם ההרצה לא תתבצע מהר, אפשר יהיה להריץ אותה. הרצת הבדיקה צריכה להפסיק את הביצוע אחרי הכשל הראשון.
ברירת מחדל של --test_sharding_strategy=<explicit or disabled>: "explicit"
יש לציין את השיטה לפיצול הבדיקה: 'explicit' כדי להשתמש בפיצול רק אם קיים המאפיין 'shard_count' 'disabled' לעולם לא להשתמש בפיצול בדיקה.
ברירת מחדל של --test_size_filters=<comma-separated list of values: small, medium, large or enormous>: ""
ההגדרה מציינת רשימה של גודלי בדיקה המופרדים בפסיקים. לפני כל גודל אפשר להוסיף לפני #&39;-' כדי לציין גדלים שאינם נכללים. יימצאו רק יעדי בדיקה המכילים לפחות גודל כולל אחד ואינם מכילים גדלים שלא נכללו. האפשרות הזו משפיעה על ההתנהגות של --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"
גרסת השפה של Java המשמשת לביצוע הכלים הנחוצים במהלך גרסת ה-build
ברירת מחדל של --tool_java_runtime_version=<a string>: "remotejdk_11"
גרסת זמן הריצה של Java המשמשת לביצוע כלים במהלך ה-build
ברירת מחדל של --[no]use_ijars: "true"
כשהאפשרות הזו מופעלת, הידור ה-Java משתמש בקונטיינרים של ממשק. כתוצאה מכך, האוסף המצטבר יהיה מהיר יותר, אבל הודעות השגיאה עשויות להיות שונות.

אפשרויות סימון כקנוניות

העברה בירושה את כל האפשרויות מיצירה.

אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
נצברו --distdir=<a path> שימושים מרובים
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים: bazel_internal_configuration
אם היא מוגדרת, המטמון של המאגר יקשר את הקובץ באופן ידני במקרה של היט מטמון, במקום העתקה. מטרת האחסון היא לחסוך מקום בכונן.
תגים: bazel_internal_configuration
ברירת מחדל של --[no]experimental_repository_cache_urls_as_default_canonical_id: "false"
אם הערך הוא TRUE, יש להשתמש במחרוזת שנגזרת מכתובות ה-URL של הורדות המאגר בתור ה-canonical_id אם לא צוין. במצב הזה, שינוי בכתובות ה-URL יוביל להורדה מחדש, גם אם המטמון מכיל הורדה עם אותו גיבוב. אפשר להשתמש בשיטה הזו כדי לאמת ששינויים בכתובת ה-URL לא גורמים להסתרה של מאגרים לא תקינים.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_repository_disable_download: "false"
אם היא מוגדרת, לא ניתן להוריד מאגרים חיצוניים.
תגים: 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"
פלט של המדיניות הקנונית, לאחר הרחבה וסינון. כדי לשמור על פלט נקי, הארגומנטים של פקודות קנוניות לא יוצגו כאשר אפשרות זו מוגדרת כ-true. חשוב לשים לב שהפקודה שצוינה על ידי --for_command משפיעה על המדיניות המסוננים, ואם לא צוינה הפקודה, פקודת ברירת המחדל היא 'build'
תגים: affects_outputs, terminal_output
ברירת מחדל של --[no]show_warnings: "false"
אזהרות של מנתח הפלט לשגיאה רגילה (למשל, לגבי אפשרויות סימון מתנגשות).
תגים: 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 או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
ברירת מחדל של --[no]experimental_allow_top_level_aspects_parameters: "true"
לא:
תגים: no_op, deprecated, experimental
ברירת מחדל של --[no]incompatible_config_setting_private_default_visibility: "false"
אם לא תואם_enforce_config_setting_visible=false, זו שגיאה. אחרת, אם הסימון הזה הוא false, כל הגדרת config_ללא מאפיין חשיפה בוטה היא //visible: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. אם הערך הוא False, כל config_setting גלויה לכל יעד. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים: loading_and_analysis, incompatible_change
אפשרויות שקשורות לפלט Bzlmod וסמנטיקה:
נצברו --allow_yanked_versions=<a string> שימושים מרובים
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים: loading_and_analysis
ברירת מחדל של --check_bazel_compatibility=<error, warning or off>: "error"
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים: loading_and_analysis
ברירת מחדל של --check_direct_dependencies=<off, warning or error>: "warning"
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים: loading_and_analysis
ברירת מחדל של --[no]ignore_dev_dependency: "false"
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-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"
כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
ברירת מחדל של --experimental_resolved_file_instead_of_workspace=<a string>: ""
אם הקובץ לא ריק, קראו את הקובץ שצוין ולא את קובץ ה-WORKSPACE
תגים: changes_inputs
ברירת מחדל של --for_command=<a string>: "build"
פקודה שעבורה האפשרויות צריכות להיות קנוניות.
תגים: affects_outputs, terminal_output
ברירת מחדל של --invocation_policy=<a string>: ""
יישום של מדיניות הפעלה באפשרויות הקנוניות.
תגים: affects_outputs, terminal_output
אפשרויות שמירה במטמון והפעלה:
ברירת מחדל של --experimental_downloader_config=<a string>: תיאור
מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
ברירת מחדל של --deleted_packages=<comma-separated list of package names>: ""
רשימה של שמות של חבילות, מופרדים בפסיקים, שמערכת ה-build תתייחס אליהם שאינם קיימים, גם אם הם מוצגים במקום כלשהו בנתיב החבילה. כדאי להשתמש באפשרות הזו כשמוחקים חבילת משנה 'x/y' של חבילה קיימת 'x' לדוגמה, לאחר מחיקת x/y/BUILD בלקוח, מערכת ה-build עשויה להתלונן אם היא תיתקל בתווית '//x:y/z' אם היא עדיין מסופקת על ידי ערך package_path אחר. ציון [delete_packs 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"
אם מופעל, גורם ל-Bazel להדפיס הודעות &&;טעינת חבילה:".

אפשרויות ניקוי

העברה בירושה את כל האפשרויות מיצירה.

אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
נצברו --distdir=<a path> שימושים מרובים
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים: bazel_internal_configuration
אם היא מוגדרת, המטמון של המאגר יקשר את הקובץ באופן ידני במקרה של היט מטמון, במקום העתקה. מטרת האחסון היא לחסוך מקום בכונן.
תגים: bazel_internal_configuration
ברירת מחדל של --[no]experimental_repository_cache_urls_as_default_canonical_id: "false"
אם הערך הוא TRUE, יש להשתמש במחרוזת שנגזרת מכתובות ה-URL של הורדות המאגר בתור ה-canonical_id אם לא צוין. במצב הזה, שינוי בכתובות ה-URL יוביל להורדה מחדש, גם אם המטמון מכיל הורדה עם אותו גיבוב. אפשר להשתמש בשיטה הזו כדי לאמת ששינויים בכתובת ה-URL לא גורמים להסתרה של מאגרים לא תקינים.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_repository_disable_download: "false"
אם היא מוגדרת, לא ניתן להוריד מאגרים חיצוניים.
תגים: 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"
אם הערך הוא True, ניקוי הפלט הוא אסינכרוני. כשהפקודה הזו תסתיים, אפשר יהיה לבצע פקודות חדשות באותו לקוח, אף על פי שהמחיקה עשויה להתבצע ברקע.
תגים: host_machine_resource_optimizations
ברירת מחדל של --[no]expunge: "false"
אם המדיניות מוגדרת כ-True, ניקוי של עץ העבודה המקורי של ה-Bazal הזה כולל את כל הקבצים הזמניים שנוצרו ברקע ויצירה של קובצי פלט. במקרה כזה, שרת ה-Bazel פועל.
תגים: host_machine_resource_optimizations
--expunge_async
אם צוין, ניקוי באופן אסינכרוני של כל עץ העבודה של מופע הבסיס הזה, שכולל את כל קובצי ה-Bazal שנוצרו באופן זמני ובניית קובצי פלט, ומפסיק את שרת ה-Bazal אם הוא פועל. כשהפקודה הזו תסתיים, אפשר יהיה לבצע פקודות חדשות באותו לקוח, אף על פי שהמחיקה עשויה להתבצע ברקע.
מתרחב אל:
--expunge
--async

תגים: host_machine_resource_optimizations
אם הערך הוא True, כל הקישורים הסימטריים בסביבת העבודה עם הקידומת 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 או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
ברירת מחדל של --[no]experimental_allow_top_level_aspects_parameters: "true"
לא:
תגים: no_op, deprecated, experimental
אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
נצברו --allow_yanked_versions=<a string> שימושים מרובים
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים: loading_and_analysis
ברירת מחדל של --check_bazel_compatibility=<error, warning or off>: "error"
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים: loading_and_analysis
ברירת מחדל של --check_direct_dependencies=<off, warning or error>: "warning"
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים: loading_and_analysis
ברירת מחדל של --[no]ignore_dev_dependency: "false"
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-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"
כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
ברירת מחדל של --experimental_resolved_file_instead_of_workspace=<a string>: ""
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים: changes_inputs
אפשרויות שמירה במטמון והפעלה:
ברירת מחדל של --experimental_downloader_config=<a string>: תיאור
מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
נצברו --override_repository=<an equals-separated mapping of repository name to path> שימושים מרובים
עוקפת מאגר עם ספרייה מקומית.

אפשרויות הגדרה

אפשרויות כיסוי

העברה בירושה את כל האפשרויות מבדיקה.

אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
נצברו --distdir=<a path> שימושים מרובים
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים: bazel_internal_configuration
אם היא מוגדרת, המטמון של המאגר יקשר את הקובץ באופן ידני במקרה של היט מטמון, במקום העתקה. מטרת האחסון היא לחסוך מקום בכונן.
תגים: bazel_internal_configuration
ברירת מחדל של --[no]experimental_repository_cache_urls_as_default_canonical_id: "false"
אם הערך הוא TRUE, יש להשתמש במחרוזת שנגזרת מכתובות ה-URL של הורדות המאגר בתור ה-canonical_id אם לא צוין. במצב הזה, שינוי בכתובות ה-URL יוביל להורדה מחדש, גם אם המטמון מכיל הורדה עם אותו גיבוב. אפשר להשתמש בשיטה הזו כדי לאמת ששינויים בכתובת ה-URL לא גורמים להסתרה של מאגרים לא תקינים.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_repository_disable_download: "false"
אם היא מוגדרת, לא ניתן להוריד מאגרים חיצוניים.
תגים: 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 אוכפת קלטי build תקינים (הגדרות של כללים, שילובי דגל וכו'):
ברירת מחדל של --experimental_repository_hash_file=<a string>: ""
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים: affects_outputs, experimental
נצברו --experimental_verify_repository_rules=<a string> שימושים מרובים
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים: affects_outputs, experimental
האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
ברירת מחדל של --[no]experimental_allow_top_level_aspects_parameters: "true"
לא:
תגים: no_op, deprecated, experimental
אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
נצברו --allow_yanked_versions=<a string> שימושים מרובים
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים: loading_and_analysis
ברירת מחדל של --check_bazel_compatibility=<error, warning or off>: "error"
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים: loading_and_analysis
ברירת מחדל של --check_direct_dependencies=<off, warning or error>: "warning"
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים: loading_and_analysis
ברירת מחדל של --[no]ignore_dev_dependency: "false"
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-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"
כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
ברירת מחדל של --experimental_resolved_file_instead_of_workspace=<a string>: ""
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים: changes_inputs
אפשרויות שמירה במטמון והפעלה:
ברירת מחדל של --experimental_downloader_config=<a string>: תיאור
מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
נצברו --override_repository=<an equals-separated mapping of repository name to path> שימושים מרובים
עוקפת מאגר עם ספרייה מקומית.

אפשרויות שאילתה

העברה בירושה את כל האפשרויות מבדיקה.

אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
נצברו --distdir=<a path> שימושים מרובים
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים: bazel_internal_configuration
אם היא מוגדרת, המטמון של המאגר יקשר את הקובץ באופן ידני במקרה של היט מטמון, במקום העתקה. מטרת האחסון היא לחסוך מקום בכונן.
תגים: bazel_internal_configuration
ברירת מחדל של --[no]experimental_repository_cache_urls_as_default_canonical_id: "false"
אם הערך הוא TRUE, יש להשתמש במחרוזת שנגזרת מכתובות ה-URL של הורדות המאגר בתור ה-canonical_id אם לא צוין. במצב הזה, שינוי בכתובות ה-URL יוביל להורדה מחדש, גם אם המטמון מכיל הורדה עם אותו גיבוב. אפשר להשתמש בשיטה הזו כדי לאמת ששינויים בכתובת ה-URL לא גורמים להסתרה של מאגרים לא תקינים.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_repository_disable_download: "false"
אם היא מוגדרת, לא ניתן להוריד מאגרים חיצוניים.
תגים: 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 אוכפת קלטי build תקינים (הגדרות של כללים, שילובי דגל וכו'):
ברירת מחדל של --experimental_repository_hash_file=<a string>: ""
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים: affects_outputs, experimental
נצברו --experimental_verify_repository_rules=<a string> שימושים מרובים
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים: affects_outputs, experimental
האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
ברירת מחדל של --[no]experimental_allow_top_level_aspects_parameters: "true"
לא:
תגים: no_op, deprecated, experimental
אפשרויות הקשורות לפלט שאילתות וסמנטיקה:
ברירת מחדל של --aspect_deps=<off, conservative or precise>: "conservative"
איך לפתור בעיה של יחסי גובה-רוחב כאשר פורמט הפלט הוא בפורמט {xml,proto,record}. 'off' פירוש הדבר שלא נפתרים יחסי תלות ו'שמרני' (ברירת המחדל) מוסיפים את כל יחסי הגובה-רוחב המוצהרים, בין אם הם קיבלו את רמת התלויות הישירות ובין אם לא. חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, כך שהוא איטי יותר מהמצבים האחרים. כמו כן, אפילו מצב מדויק אינו מדויק לחלוטין: ההחלטה אם לחשב היבט מסוים נקבעת בשלב הניתוח, שאינו פועל במהלך &b3Query;'
תגים: build_file_semantics
ברירת מחדל של --[no]graph:factored: "true"
אם הערך הוא True, התרשים ייקרא 'fact האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים: terminal_output
ברירת מחדל של --graph:node_limit=<an integer>: "512"
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; הערך 1- יגרום לכך שלא ייחתך. האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים: terminal_output
ברירת מחדל של --[no]implicit_deps: "true"
אם האפשרות הזאת מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלות שבו השאילתה פועלת. תלות משתמעת היא זו שלא צוינה במפורש בקובץ BUILD, אך נוספה על ידי ה-bazel. עבור שאילתה, אפשרות זו שולטת בסינון ערכות כלים שנפתרו.
תגים: build_file_semantics
ברירת מחדל של --[no]include_aspects: "true"
aquery, שאילתה: האם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: no-op (מאפיינים תמיד במעקב).
תגים: terminal_output
ברירת מחדל של --[no]incompatible_display_source_file_location: "true"
True, כברירת מחדל, יוצג היעד של קובץ המקור. אם True, מציג את המיקום של שורה 1 של קובצי מקור בפלטי מיקום. הסימון הזה קיים רק למטרות העברה.
תגים: terminal_output, incompatible_change
ברירת מחדל של --[no]incompatible_package_group_includes_double_slash: "true"
אם האפשרות הזו מופעלת, בעת הפקת המאפיין 'packs' של package_group&, הסימן '//' הראשי לא יושמט.
תגים: terminal_output, incompatible_change
ברירת מחדל של --[no]infer_universe_scope: "false"
אם המדיניות set ו- לתשומת ליבכם, הערך של uniuni_scope כפי שהוסק עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, allalleps) הוא לא מה שאתם רוצים, לכן עליכם להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים ודוגמאות זמינים בכתובת https://bazel.build/reference/query#sky-query. אם --univers_scope מוגדר, המערכת מתעלמת מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'שאילתה' (כלומר, לא 'cquery').
תגים: loading_and_analysis
ברירת מחדל של --[no]line_terminator_null: "false"
אם כל פורמט יסתיים ב-\0 במקום בפורמט חדש.
תגים: terminal_output
ברירת מחדל של --[no]nodep_deps: "true"
אם המדיניות מופעלת, נקודות שפל מתוך "nodep" ייכללו בתרשים התלות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep". היא "visible". מריצים ומנתחים את הפלט של 'info Build-language' כדי ללמוד על כל המאפיינים "nodep"בשפת ה-build.
תגים: build_file_semantics
ברירת מחדל של --output=<a string>: "label"
הפורמט שבו יש להדפיס את תוצאות השאילתה. הערכים המותרים ל-cquery הם: label, label_kind, textproto, passs, proto, jsonproto. אם בוחרים 'transitions' צריך גם לציין את האפשרות --transitions=(lite|full).
תגים: terminal_output
ברירת מחדל של --[no]proto:default_values: "true"
אם מוגדר כ-True, נכללים מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- --פלט=פרוטו
תגים: terminal_output
ברירת מחדל של --[no]proto:definition_stack: "false"
מאכלס את השדה Proto-stack, שמתעד כל מופע של כלל ה-Starstark שבו מוגדרת המחלקה בכלל.
תגים: terminal_output
ברירת מחדל של --[no]proto:flatten_selects: "true"
אם המדיניות מופעלת, מאפיינים ניתנים להגדרה שנוצרו על ידי Select() שטוחים. עבור סוגי רשימות, הייצוג השטוח הוא רשימה המכילה כל ערך של המפה שנבחרה פעם אחת בלבד. סוגי הפיגועים שטוחים איזה null.
תגים: build_file_semantics
ברירת מחדל של --[no]proto:include_configurations: "true"
כשהפרוטוקול מופעל, פלט אב יכלול מידע על ההגדרות. כאשר המדיניות מושבתת,פורמט הפלט אב השאילתה דומה לפורמט פלט שאילתה.
תגים: affects_outputs
ברירת מחדל של --[no]proto:include_synthetic_attribute_hash: "false"
אם רוצים לחשב ולאכלס את המאפיין $internal_attr_Hash.
תגים: terminal_output
ברירת מחדל של --[no]proto:instantiation_stack: "false"
אכלוס מחסנית קריאות של כל הנחיה. כדי לעשות זאת, יש צורך במקבץ סטאק
תגים: terminal_output
ברירת מחדל של --[no]proto:locations: "true"
אם בכלל, כדאי לשלוח פרטי מיקום בפלט אב.
תגים: terminal_output
ברירת מחדל של --proto:output_rule_attrs=<comma-separated list of options>: "all"
רשימת מאפיינים המופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להוציא פלט. האפשרות הזו רלוונטית ל--פלט=פרוטו.
תגים: terminal_output
ברירת מחדל של --[no]proto:rule_inputs_and_outputs: "true"
אפשר גם לאכלס את השדותכללי_קלט וכלל_פלט.
תגים: terminal_output
ברירת מחדל של --[no]relative_locations: "false"
אם הערך הוא TRUE, המיקום של קובצי BUILD ב-XML ובפלטי אב יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא יהיה עקבי בין מחשבים. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במכשירים שונים.
תגים: terminal_output
ברירת מחדל של --show_config_fragments=<off, direct or transitive>: "off"
הצגת קטעי התצורה הנדרשים על ידי כלל והתלות העקיפות שלו. אפשרות זו יכולה לעזור לכם להעריך עד כמה אפשר לחתוך תרשים יעד שהוגדר.
תגים: affects_outputs
ברירת מחדל של --starlark:expr=<a string>: ""
ביטוי Starlark לעיצוב של כל יעד שמוגדר במצב cquery's --pla=starlark. היעד שהוגדר מוגבל ל-'target' אם לא צוין --starlar:expr or --starlark:file, האפשרות הזו תוגדר כברירת מחדל ל-'str(target.label)' אירעה שגיאה לציון גם -starstark:expr וגם --starlark:file.
תגים: terminal_output
ברירת מחדל של --starlark:file=<a string>: ""
שם של קובץ שמגדיר פונקציית Starlark שנקראת 'format', מתוך ארגומנט אחד, שחל על כל יעד מוגדר כדי לעצב אותו כמחרוזת. אירעה שגיאה לציון גם -starstark:expr וגם --starlark:file. לקבלת עזרה נוספת --
תגים: terminal_output
ברירת מחדל של --[no]tool_deps: "true"
שאילתה: אם היא מושבתת, יחסי תלות ב-'מארח הגדרה' או 'execution' יעדים לא ייכללו בתרשים התלות שעליו פועלת השאילתה. קצה 'הגדרת תצורה למארחים' כזה מהכלל של #&39;proto_library' מפנה בדרך כלל למהדר הפרוטוקול, בדרך כלל מצביע על כלי שהופעל במהלך ה-build במקום על חלק מאותה תוכנית 'target' שאילתה: אם היא מושבתת, היא מסננת את כל היעדים שהוגדרו שחוצים מעבר של מארח או ביצוע, מהיעד שהוגדר ברמה העליונה שגילו את היעד שהוגדר. כלומר, אם היעד ברמה העליונה נמצא בתצורת היעד, יוחזרו רק יעדים שהוגדרו בתצורת היעד. אם היעד ברמה העליונה נמצא בתצורת המארח, יוחזרו רק יעדים שהוגדרו על ידי המארח. אפשרות זו לא תכלול שרשראות כלים שנפתרו.
תגים: build_file_semantics
ברירת מחדל של --transitions=<full, lite or none>: "none"
הפורמט שבו השאילתה תדפיס את פרטי המעבר.
תגים: affects_outputs
ברירת מחדל של --universe_scope=<comma-separated list of options>: ""
קבוצה של דפוסי יעד (מופרדים באמצעות פסיקים) המופרדים בפסיקים. השאילתה עשויה להתבצע ביקום שהוגדר על ידי הסגירה העקיפה של היעדים שצוינו. האפשרות הזו משמשת לפקודות השאילתה ושאילתת השאילתה. עבור השאילתה, הקלט לאפשרות הזו הוא היעדים שבנו כל התשובות, ולכן האפשרות הזו עשויה להשפיע על התצורות והמעברים. אם אפשרות זו אינה מוגדרת, ההנחה היא שהיעדים ברמה העליונה הם היעדים המנותחים מביטוי השאילתה. הערה לגבי שאילתה: אם לא מציינים את האפשרות הזו, ייתכן שה-build לא יפעל אם לא ניתן ליצור יעדים מביטוי השאילתה עם האפשרויות ברמה העליונה.
תגים: loading_and_analysis
אפשרויות הקשורות לפלט Bzlmod וסמנטיקה:
נצברו --allow_yanked_versions=<a string> שימושים מרובים
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים: loading_and_analysis
ברירת מחדל של --check_bazel_compatibility=<error, warning or off>: "error"
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים: loading_and_analysis
ברירת מחדל של --check_direct_dependencies=<off, warning or error>: "warning"
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים: loading_and_analysis
ברירת מחדל של --[no]ignore_dev_dependency: "false"
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-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"
כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
ברירת מחדל של --experimental_resolved_file_instead_of_workspace=<a string>: ""
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים: changes_inputs
אפשרויות שמירה במטמון והפעלה:
ברירת מחדל של --experimental_downloader_config=<a string>: תיאור
מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
נצברו --override_repository=<an equals-separated mapping of repository name to path> שימושים מרובים
עוקפת מאגר עם ספרייה מקומית.
אפשרויות ששולטות בביצוע של גרסאות build:
רוצה לבצע קריאות ישירות למערכת הקבצים כדי ליצור עצים סימבוליים?
תגים: loading_and_analysis, execution, experimental
ברירת מחדל של --[no]experimental_remotable_source_manifests: "false"
האם אפשר לבצע פעולות שוטפות במניפסט המקור:
תגים: loading_and_analysis, execution, experimental
ברירת מחדל של --[no]experimental_split_coverage_postprocessing: "false"
אם הערך הוא true, Bazel תריץ עיבוד לאחר העיבוד לצורך בדיקה בתצוגה חדשה.
תגים: execution
ברירת מחדל של --[no]experimental_strict_fileset_output: "false"
אם האפשרות הזו מופעלת, קבוצות הקבצים יתייחסו לכל פריטי המידע שנוצרו בתהליך הפיתוח כקבצים רגילים. הם לא חוצה ספריות ולא יהיו רגישים לקישורים סימבוליים.
תגים: execution
ברירת מחדל של --modify_execution_info=<regex=[+-]key,regex=[+-]key,...>: ""
ניתן להוסיף או להסיר מפתחות מידע על ביצוע של פעולה על סמך הקובץ של הפעולה. רלוונטי רק לפעולות התומכות בפרטי הביצוע. פעולות נפוצות רבות תומכות בפרטי ביצוע, כמו Genrule, CppCompile, Javac, StarlarkAction, TestRunner. כשמציינים כמה ערכים, הסדר חשוב כי ביטויים רבים עשויים לחול על אותו אזכור. תחביר: "regex=[+-]key,regex=[+-]key,...". דוגמאות: '.*=+x,.*=-y,.*=+z' מוסיף את #&39;x' ו-'z' את פרטי הביצוע של #&39;y' ומסירים אותם. 'Genrule=+requires-x' add 'requires-x' לפרטי הביצוע של כל פעולות הז'אנר. '(?!Genrule).*=-requires-x' removed 'requires-x' מפרטי ההפעלה של כל הפעולות שאינן ז'אנר.
תגים: execution, affects_outputs, loading_and_analysis
--persistent_android_dex_desugar
הפעלה של עובדים ב-Android Dex ופעולות סוכר קבועות.
מתרחב אל:
--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=worker2
{1/2 --internal_persistent_busybox_tools
--persistent_multiplex_android_dex_desugar
הפעלה של עובדים עם Multiplex דק' ופעולות סוכר
מתרחב אל:
--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
הפעלה של מעבד משאבים (cast) עקבי ב-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-workers2
{1/2 --persistent_android_resource_processor
--persistent_multiplex_android_tools
הפעלת כלים עקביים ומוכפלים ב-Android (Dexs, הסרת ניפוי באגים, עיבוד משאבים).
מתרחבת אל:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar

תגים: host_machine_resource_optimizations, execution
אפשרויות שמגדירות את ה-chainch המשמש לביצוע הפעולה:
ברירת מחדל של --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>: תיאור
יעד grte_top ב-Android.
תגים: changes_inputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --android_manifest_merger=<legacy, android or force_android>: "android"
בחירת המיזוג של המניפסט לשימוש בכללי 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>: תיאור
מהדר היעד של Apple. שימושי לבחירת וריאציות של כלי עבודה (למשל: xcode-beta).
תגים: 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:coverage_report_מחולל"
המיקום של הקובץ הבינארי המשמש להפקת דוחות כיסוי. נכון לעכשיו זו צריכה להיות קבוצת קבצים הכוללת קובץ אחד, הקובץ הבינארי. ברירת המחדל היא '//tools/test:coverage_report_מחולל'.
תגים: changes_inputs, affects_outputs, loading_and_analysis
--coverage_support=<a build target label> ברירת מחדל: "@bazel_tools//tools/test:coverage_support"
המיקום של קובצי התמיכה הנדרשים על סמך הקלט של כל פעולת בדיקה שאוספת כיסוי קוד. ברירת המחדל היא '//tools/test:coverage_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>: תיאור
ההגדרה קובעת הטמעה מותאמת אישית של Malloc. ההגדרה הזו מבטלת את המאפיינים של Malאיך להשתמש בכללי build.
תגים: changes_inputs, affects_outputs
נצברו --experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment> שימושים מרובים
רשימה של ביטויים רגולריים המופרדים בפסיקים, שלכל אחד מהם יש קידומת (-) שלילי, מוקצית (=) לרשימה של יעדי ערך מופרדים בפסיקים. אם יעד מסוים לא תואם אף ביטוי שלילי וביטוי חיובי אחד לפחות, רזולוציית הכלים שלו תתבצע כאילו היא הצהירה על ערכי האילוץ כאילוצי ביצוע. דוגמה: //demo,-test=@platforms//cpus:x86_64 יתווסף #&39;x86_64' לכל יעד תחת //demo, מלבד אלה שהשם שלהם מכיל 'test'.
תגים: loading_and_analysis
ברירת מחדל של --[no]experimental_enable_objc_cc_deps: "true"
קבלת כללים מסוג objc_* שתלויים ב-cc_library וגורמת לקיום יחסי תלות של objc עם --cpu המוגדר כ-"ios_<--ios_cpu>" עבור כל ערך ב- --ios_multi_cpu.
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]experimental_include_xcode_execution_requirements: "false"
אם היא מוגדרת, מוסיפים את דרישת הביצוע "requires-xcode:{version}" לכל פעולת Xcode. אם גרסת ה-xcode כוללת תווית עם מקפים, צריך להוסיף גם "requires-xcode-label:{version_label}" דרישת ביצוע.
תגים: loses_incremental_state, loading_and_analysis, execution
ברירת מחדל של --[no]experimental_prefer_mutual_xcode: "true"
אם מוגדר True, יש להשתמש ב-Xcode העדכני ביותר שזמין גם מקומית וגם מרחוק. אם False, או אם אין גרסאות הדדיות זמינות, משתמשים בגרסת Xcode המקומית שנבחרה באמצעות xcode-select.
תגים: loses_incremental_state
נצברו --extra_execution_platforms=<comma-separated list of options> שימושים מרובים
הפלטפורמות הזמינות כפלטפורמות לביצוע פעולות. אפשר לציין פלטפורמות לפי יעד מדויק או כתבנית יעד. המערכת תתייחס לפלטפורמות האלה לפני אלה המוצהרות בקובץ ה-WORKSPACE על ידי sign_execution_platforms() .
תגים: execution
נצברו --extra_toolchains=<comma-separated list of options> שימושים מרובים
הכללים בנוגע לכלים של כלי עבודה שנלקחים בחשבון במהלך מציאת פתרון לכלים. ניתן לציין ערכות הכלים לפי יעד מדויק, או כתבנית יעד. חשוב לזכור את ערכות הכלים האלה לפני ההשקה שלהן בקובץ ה-WORKSPACE באמצעות record_toolchains() .
תגים: affects_outputs, changes_inputs, loading_and_analysis
ברירת מחדל של --grte_top=<a label>: תיאור
תווית לספריית ליבצ'ק שמסומנת. ערך ברירת המחדל נבחר על ידי רצועת הכלים, וכמעט אף פעם לא צריך לשנות אותו.
תגים: 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"
שימוש ברזולוציה של Toolchain כדי לבחור את ה-SDK ל-Android לכללי Android (סטארלרק ו-Native)
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_enable_apple_toolchain_resolution: "false"
שימוש ברזולוציית כלים כדי לבחור את ה-SDK של Apple לכללי התפוחים (Starlark ו-Native)
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_make_thinlto_command_lines_standalone: "true"
True
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain: "true"
אם הערך true, Bazel יתלונן כשמאפייני cc_toolchain.cpu ו-cc_toolchain.devguider מוגדרים (מידע נוסף זמין במאמר https://github.com/bazelbuild/bazel/issues/7075).
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]incompatible_remove_legacy_whole_archive: "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' in to cc_common.configure_features (מידע נוסף בכתובת https://github.com/bazelbuild/bazel/issues/7793).
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]interface_shared_objects: "true"
שימוש באובייקטים משותפים בממשק אם הם נתמכים על ידי ערכת הכלים. כל שרשראות הכלים של ELF תומכות בשלב זה בהגדרה הזו.
תגים: loading_and_analysis, affects_outputs, affects_outputs
ברירת מחדל של --ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
ההגדרה קובעת את גרסת ה-SDK של iOS לפיתוח אפליקציות ל-iOS. אם לא צוין, נעשה שימוש בגרסת ברירת מחדל של iOS SDK מ-'xcode_version'.
תגים: loses_incremental_state
ברירת מחדל של --macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
ההגדרה קובעת את גרסת ה-macOS SDK שבה משתמשים כדי לבנות אפליקציות ל-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' (קובץ שנמצא מתחת לרמה הבסיסית (root) של סביבת עבודה).
תגים: 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 שבה משתמשים כדי ליצור אפליקציות TV. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של TV SDK מ-'xcode_version'.
תגים: loses_incremental_state
ברירת מחדל של --watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
ההגדרה קובעת את גרסת ה-SDK של WatchOS שבה משתמשים כדי לבנות אפליקציות שעון. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של WatchOS SDK מגרסה 'xcode_version'.
תגים: loses_incremental_state
ברירת מחדל של --xcode_version=<a string>: תיאור
אם צוין, נעשה שימוש ב-Xcode של הגרסה הנתונה לפעולות build רלוונטיות. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של הביצוע של Xcode.
תגים: loses_incremental_state
ברירת מחדל של --xcode_version_config=<a build target label>: "@bazel_tools//tools/cpp:host_xcodes"
התווית של הכלל xcode_config שיש להשתמש בה לבחירת הגרסה של Xcode בתצורת ה-build.
תגים: loses_incremental_state, loading_and_analysis
אפשרויות ששולטות בפלט של הפקודה:
ברירת מחדל של --[no]apple_enable_auto_dsym_dbg: "false"
אם צריך לאלץ יצירה של קובצי ניפוי באגים (.dSYM) עבור גרסאות build ל-dbg.
תגים: affects_outputs, action_command_lines
ברירת מחדל של --[no]apple_generate_dsym: "false"
האם ליצור קובצי ניפוי באגים ( .dSYM)?
תגים: affects_outputs, action_command_lines
אם הערך הוא true, יש ליצור יערות קישור ריצה עבור כל היעדים. אם False, כותבים מניפסטים רק כשהדבר אפשרי.
תגים: affects_outputs
ברירת מחדל של --[no]build_runfile_manifests: "true"
אם הערך הוא True, צריך לכתוב מניפסטים מסוג Runfiles בכל היעדים. אם FALSE, משמיטים אותן. הבדיקות המקומיות לא יפעלו אם הן יהיו שקריות.
תגים: affects_outputs
ברירת מחדל של --[no]build_test_dwp: "false"
אם האפשרות מופעלת, כשפותחים בדיקות C++ באופן סטטי ובצורה קפדנית, המערכת תיצור באופן אוטומטי גם קובץ .dwp עבור הקובץ הבינארי של הבדיקה.
תגים: loading_and_analysis, affects_outputs
ברירת מחדל של --cc_proto_library_header_suffixes=<comma-separated list of options>: ".pb.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"
אפשר לבצע פעולות נוספות על גרסאות API חלופיות של Java ב-proto_library.
תגים: affects_outputs, loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_proto_extra_actions: "false"
אפשר לבצע פעולות נוספות על גרסאות API חלופיות של Java ב-proto_library.
תגים: affects_outputs, loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_save_feature_state: "false"
שומרים את המצב של תכונות מופעלות ומבוקשות כפלט של הידור.
תגים: affects_outputs, experimental
ברירת מחדל של --fission=<a set of compilation modes>: "no"
ההגדרה קובעת אילו מצבי הידור משתמשים בפיקוח עבור אוספי +C+. יכולים להיות כל שילובים של {'speedbuild', 'dbg', 'opt'} או ערכים מיוחדים 'yes' כדי להפעיל את כל המצבים &&339;no' כדי להשבית את כל המצבים.
תגים: loading_and_analysis, action_command_lines, affects_outputs
ברירת מחדל של --[no]legacy_external_runfiles: "true"
אם המדיניות מוגדרת כ-TRUE, יש לבנות יערות סימבונק של Runruns עבור מאגרים חיצוניים בכפוף ל- .runfiles/wsname/external/repo (בנוסף ל- .runfiles/repo).
תגים: affects_outputs
ברירת מחדל של --[no]objc_generate_linkmap: "false"
ההגדרה קובעת אם ליצור קובץ מפת קישור.
תגים: affects_outputs
ברירת מחדל של --[no]save_temps: "false"
אם המדיניות מוגדרת, פלט זמני מ-gcc יישמר. דוגמאות לקובצי .s (קוד ליצירת מקטע), קובצי .i (C מעובד מראש) וקובצי .ii (C++ ). לפני העיבוד:
תגים: affects_outputs
אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לעצם קיומו:
נצברו --action_env=<a 'name=value' assignment with an optional value part> שימושים מרובים
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם הגדרת יעד. אפשר לציין משתנים לפי שם. במקרה כזה, הערך יילקח מסביבת ההפעלה, או מצמד name=value שקובע את הערך בלי קשר לסביבת ההפעלה. ניתן להשתמש באפשרות זו כמה פעמים. לאפשרויות המוגדרות לאותו משתנה, המנצחים האחרונים, האפשרויות המצטברות למשתנים שונים.
תגים: action_command_lines
ברירת מחדל של --android_cpu=<a string>: "armeabi-v7a"
מעבד ה-Android לטירגוט.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]android_databinding_use_androidx: "false"
יוצרים קובצי התאמת נתונים ל-AndroidX. האפשרות הזו משמשת רק לקישור נתונים v2.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --[no]android_databinding_use_v3_4_args: "false"
שימוש ב-Android Databining v2 עם ארגומנט 3.4.0
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --android_dynamic_mode=<off, default or fully>: "off"
קביעה אם קישורי +C+ של כללי Android יקושרו באופן דינמי כאשר cc_binary לא ייצור באופן מפורש ספרייה משותפת. 'default' פירוש הדבר שבסיס הפנים יבחר אם לקשר באופן דינמי. 'ly' כלומר כל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי ברובו.
תגים: affects_outputs, loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency> כברירת מחדל: "alphabetical"
מגדיר את סדר המניפסטים שהועברו למיזוג המניפסט עבור קבצים בינאריים של Android. 'ALPHABETLY' פירושו שהמניפסטים ממוינים לפי הנתיב ביחס לרכיב ה-exe. ALPHABETical_BY_CONFIGURATION פירושו שהמניפסטים ממוינים לפי נתיבים ביחס לספריית התצורה בספריית הפלט. המשמעות של DEPENDENCY היא שמניפסטים מסודרים לפי כל ספרייה שנמצאת לפני המניפסטים של יחסי התלות שלה.
תגים: action_command_lines, execution
ברירת מחדל של --[no]android_resource_shrinking: "false"
הפעלת כיווץ משאבים ל-APK_android_binary שמשתמשים ב-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> שימושים מרובים
יש לציין את מצב קוד ה-API של Apple לצורך שלבי הידור שמטרגטים את ארכיטקטורת המכשירים. הערכים צריכים להיות בפורמט '[platform=]mode' כאשר הפלטפורמה (שחייבת להיות 'ios', 'macos', 'tvos' או 'watchos') היא אופציונלית. אם צוין, מצב מצב הקידוד חל על הפלטפורמה הזו באופן ספציפי. אם לא נתון, הוא חל על כל הפלטפורמות. המצב חייב להיות 'none', 'embedded_סמןs' או 'embedded' ייתכן שהאפשרות הזו תוצג כמה פעמים.
תגים: loses_incremental_state
ברירת מחדל של --[no]build_python_zip: "auto"
יצירת קובץ ZIP של קובץ הפעלה בצורת פיליון. ב-Windows, השבתה בפלטפורמות אחרות
תגים: affects_outputs
נצברו --catalyst_cpus=<comma-separated list of options> שימושים מרובים
רשימה של ארכיטקטורה המופרדת בפסיקים שבשבילה לבנות קבצים בינאריים של Apple Catalyst.
תגים: loses_incremental_state, loading_and_analysis
ברירת מחדל של --[no]collect_code_coverage: "false"
אם תציינו זאת, Bazel תפיק קוד אינסטרומנטציה (באמצעות אינסטרומנטציה אופליין, במידת האפשר) ותאסוף מידע על כיסוי במהלך הבדיקות. השינוי ישפיע רק על יעדים שתואמים לשיטה --instrumentation_filter. בדרך כלל, אין לציין אפשרות זו ישירות – 'Bazelcover' במקום זאת יש להשתמש בפקודה.
תגים: affects_outputs
--compilation_mode=<fastbuild, dbg or opt> [-c] ברירת מחדל: "speedbuild"
מציינים את המצב שבו יוצג הקובץ הבינארי. ערכים: 'speedbuild', 'dbg', 'opt'.
תגים: affects_outputs, action_command_lines, explicit_in_output_path
נצברו --conlyopt=<a string> שימושים מרובים
אפשרות נוספת להעברה ל-cc במהלך הידור קובצי המקור של C.
תגים: action_command_lines, affects_outputs
נצברו --copt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-ccC.
תגים: action_command_lines, affects_outputs
ברירת מחדל של --cpu=<a string>: ""
מעבד היעד.
תגים: 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> שימושים מרובים
אפשרות נוספת להעברה ל-cc כשעורכים קובצי מקור ב-C++.
תגים: action_command_lines, affects_outputs
נצברו --define=<a 'name=value' assignment> שימושים מרובים
כל אפשרות --הגדרה מציינת מטלה למשתנה build.
תגים: changes_inputs, affects_outputs
ברירת מחדל של --dynamic_mode=<off, default or fully>: "default"
ההגדרה קובעת אם הקבצים הבינאריים מסוג C++ יקושרו באופן דינמי. 'default' פירושו ש-Bazel תבחר אם לקשר באופן דינמי. 'ly' כלומר כל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי ברובו.
תגים: loading_and_analysis, affects_outputs
ברירת מחדל של --[no]enable_fdo_profile_absolute_path: "true"
אם המדיניות מוגדרת, שימוש ב-fdo_lbolute_profile_path יגדיל את השגיאה.
תגים: affects_outputs
ברירת מחדל של --[no]enable_runfiles: "auto"
הפעלה של עץ קישור סימולטני (runfiles); כברירת מחדל, התכונה מושבתת ב-Windows, בפלטפורמות אחרות.
תגים: affects_outputs
נצברו --experimental_action_listener=<a build target label> שימושים מרובים
הוצא משימוש לטובת היבטים. אפשר להשתמש ב-action_listener כדי לצרף action_action לביצוע פעולות build קיימות.
תגים: execution, experimental
ברירת מחדל של --[no]experimental_android_compress_java_resources: "false"
דחיסת משאבים של Java ב-APK
תגים: affects_outputs, loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_android_databinding_v2: "false"
שימוש בגרסה 2 של קישור ל-Android
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --[no]experimental_android_resource_shrinking: "false"
הפעלת כיווץ משאבים ל-APK_android_binary שמשתמשים ב-ProGuard
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --[no]experimental_android_rewrite_dexes_with_rex: "false"
להשתמש בכלי Rex כדי לכתוב מחדש קובצי Dex
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --experimental_objc_fastbuild_options=<comma-separated list of options>: "-O0,-DDEBUG=1"
יש להשתמש במחרוזות האלה כאפשרויות מהדר dataLayer של objc Builder.
תגים: action_command_lines
ברירת מחדל של --[no]experimental_omitfp: "false"
אם המדיניות מוגדרת כ-True, יש להשתמש ב-libunhost עבור שחרור מחסניות (stackunack) ולהידור באמצעות -fomit-frame-pointer ו- -fסינכרוני-un Wind-tables.
תגים: action_command_lines, affects_outputs, experimental
ברירת מחדל של --[no]experimental_platform_in_output_dir: "false"
אם הערך הוא True, פלטפורמת היעד תשמש בשם של ספריית הפלט במקום ביחידת העיבוד המרכזית (CPU).
תגים: affects_outputs, experimental
ברירת מחדל של --[no]experimental_use_llvm_covmap: "false"
אם צוין, Bazel תיצור פרטי מפה של llvm-cov במקום gcov כש-collect_code_coverage מופעל.
תגים: 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"
אם רוצים ליצור פיצולים מסוג HWASAN.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --fdo_instrument=<a string>: תיאור
יצירת קבצים בינאריים עם אינסטרומנטציה של FDO. עם המהדר Clang/LLVM, הוא מקבל גם את שם הספרייה שמתחתיו יושלכו קובצי הפרופיל הגולמי בזמן הריצה.
תגים: affects_outputs
ברירת מחדל של --fdo_optimize=<a string>: תיאור
יש לך אפשרות להשתמש בפרטי הפרופיל ב-FDO כדי לבצע אופטימיזציה של האוסף. יש לציין את השם של קובץ 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"
אם המדיניות מופעלת, כל האוספים של C++ מייצרים קוד עצמאי למיקום ("-fPIC"), קישורים מעדיפים ספריות מוגדרות מראש של PIC על פני ספריות שאינן מסוג PIC, וקישורים מייצרים קובצי הפעלה שאינם תלויי מיקום ("-Pie").
תגים: loading_and_analysis, affects_outputs
נצברו --host_action_env=<a 'name=value' assignment with an optional value part> שימושים מרובים
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם תצורות מארח או ביצוע. אפשר לציין משתנים לפי שם. במקרה כזה, הערך יילקח מסביבת ההפעלה, או מצמד name=value שקובע את הערך בלי קשר לסביבת ההפעלה. ניתן להשתמש באפשרות זו כמה פעמים. לאפשרויות המוגדרות לאותו משתנה, המנצחים האחרונים, האפשרויות המצטברות למשתנים שונים.
תגים: action_command_lines
ברירת מחדל של --host_compilation_mode=<fastbuild, dbg or opt>: "opt"
ציון המצב שבו ייעשה שימוש בכלים ששימשו ליצירת ה-build. ערכים: 'speedbuild', 'dbg', 'opt'.
תגים: affects_outputs, action_command_lines
נצברו --host_conlyopt=<a string> שימושים מרובים
אפשרות נוספת להעברה ל-cc במהלך הידור קובצי המקור של C עבור כלי מארח.
תגים: action_command_lines, affects_outputs
נצברו --host_copt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-cc עבור כלי אירוח.
תגים: action_command_lines, affects_outputs
ברירת מחדל של --host_cpu=<a string>: ""
המעבד (CPU) המארח.
תגים: changes_inputs, affects_outputs
נצברו --host_cxxopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-cc עבור כלי אירוח.
תגים: action_command_lines, affects_outputs
ברירת מחדל של --host_force_python=<PY2 or PY3>: תיאור
עוקפת את הגרסה ב-Python של תצורת המארח. יכול להיות "PY2" או "PY3".
תגים: loading_and_analysis, affects_outputs
נצברו --host_linkopt=<a string> שימושים מרובים
אפשרות נוספת להעברה ל-cc בעת קישור כלים למארח.
תגים: 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"
אם אפשרות זו מופעלת, כל הספריות המקושרות מסוג C++ (DLL) שנוצרו על ידי cc_library ב-Windows יעברו שינוי שם ל-name_{Hash}.dll, שם הגיבוב מחושב על סמך ה-RepositoryName ונתיב החבילה DLL&#39. האפשרות הזו שימושית כשיש חבילה אחת שתלויה בכמה cc_library עם אותו שם (לדוגמה //foo/bar1:utils ו-//foo/bar2:utils).
תגים: loading_and_analysis, affects_outputs, incompatible_change
ברירת מחדל של --[no]incompatible_merge_genfiles_directory: "true"
אם המדיניות מוגדרת כ-True, ספריית הגנרטורים מקופלת בספריית 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"
כשהאפשרות 'כיסוי' מופעלת, המדיניות הזו קובעת אם לשקול כללים להגדרת אינסטרומנטציה. במהלך ההגדרה, המערכת מוסיפה אמצעי בדיקה שכוללים --instrumentation_filter. אחרת, כללי הבדיקה תמיד לא ייכללו באינסטרומנטציה של הכיסוי.
תגים: affects_outputs
ברירת מחדל --instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-/Javatests[/:],- /test/Java[/:]"
אם מפעילים את הכיסוי, המערכת מחילה רק כללים שהשמות שלהם נכללים במסנן שצוין לפי ביטוי רגולרי. כללים עם קידומת '-' אינם נכללים במקום זאת. לתשומת ליבכם: רק כללים שאינם בדיקות נמשכים לאינדקס, אלא אם מפעילים את --instrument_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_application. התוצאה היא קובץ בינארי אוניברסלי המכיל את כל הארכיטקטורה שצוינה.
תגים: loses_incremental_state, loading_and_analysis
ברירת מחדל של --[no]legacy_whole_archive: "true"
הוצאה משימוש, הוחלפה על ידי --incompatible_remove_Legacy_whole_archive (לפרטים נוספים: https://github.com/bazelbuild/bazel/issues/7362). במצב מופעל, יש להשתמש ב-allall-archive כדי להשתמש בכללים של cc_binary שיש להם linkshared=True וב-linkstatic=True או '-static' ב-linkopts. הערך הזה מיועד לתאימות לאחור בלבד. במקום זאת, עדיף להשתמש תמיד ב-linklink=1, היכן שנדרש.
תגים: action_command_lines, affects_outputs, deprecated
נצברו --linkopt=<a string> שימושים מרובים
אפשרות נוספת להעברה ל-cc בזמן הקישור.
תגים: 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"
אם המדיניות מוגדרת, ומצב העריכה מוגדר כך: 'dbg', GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC ו-GLIBCPP_CONCEPT_CHECKS.
תגים: action_command_lines
ברירת מחדל של --[no]objc_enable_binary_stripping: "false"
האם לבצע רצועות של סימנים וקוד לא פעיל בבינאריים מקושרים. אם בוחרים את הסימון הזה וגם את הסימון 'compilation_mode=opt', המערכת תסיר מחרוזות בינאריות.
תגים: action_command_lines
נצברו --objccopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-cc במהלך הידור קובצי המקור 'יעד-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> שימושים מרובים
אפשרויות נוספות להעברה סלקטיבית ל-cc כשעורכים קבצים מסוימים. ניתן להעביר את האפשרות הזו כמה פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. המונח regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (יש לעיין גם ב-(instrumentation_filter). האפשרות_1 עד Option_n מתייחסת לאפשרויות שרירותיות של שורות פקודה. אם אפשרות מכילה פסיק, צריך לצטט לוכסן הפוך. האפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --for
תגים: 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
ברירת מחדל של --platform_suffix=<a string>: תיאור
קביעת סיומת שתתווסף לספריית התצורה.
תגים: loses_incremental_state, affects_outputs, loading_and_analysis
ברירת מחדל של --propeller_optimize=<a build target label>: תיאור
יש להשתמש בפרטי פרופיל ה-Proproler כדי לבצע אופטימיזציה של יעד ה-build.פרופיל דו-שיח חייב להכיל לפחות אחד משני קבצים, פרופיל ב-cc ופרופיל ישן. הדגל הזה מקבל תווית build שחייבת להפנות לקובצי הקלט של פרופיל המדחף. לדוגמה, קובץ ה-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 עבור גרסאות build שעברו אופטימיזציה של Profeler.
תגים: affects_outputs
ברירת מחדל של --propeller_optimize_absolute_ld_profile=<a string>: תיאור
שם הנתיב המוחלט של קובץ ld_profile עבור גרסאות build שעברו אופטימיזציה ל-Propleler.
תגים: 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', '//package:target', '//package:target #
תגים: action_command_lines
ברירת מחדל של --[no]share_native_deps: "true"
אם True, ספריות מקוריות שמכילות פונקציונליות זהה ישותפו בין היעדים השונים
תגים: loading_and_analysis, affects_outputs
ברירת מחדל של --[no]stamp: "false"
פריטים בינאריים בחותמת עם התאריך, שם המשתמש, שם המארח, פרטי סביבת העבודה וכו'
תגים: affects_outputs
ברירת מחדל של --strip=<always, sometimes or never>: "sometimes"
ההגדרה קובעת אם להסיר בינאריים וספריות משותפות (באמצעות "-Wl,--strip-debug"). ערך ברירת המחדל של 'sometimes' פירושו רצועת אם if- --compilation_mode=fastbuild.
תגים: 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 TV.
תגים: loses_incremental_state, loading_and_analysis
ברירת מחדל של --tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
גרסת ה-TVOS תואמת מינימלית לסימולטורים וליעדים של היעד. אם לא צוין, נעשה שימוש ב-'tvos_sdk_version'.
תגים: loses_incremental_state
נצברו --watchos_cpus=<comma-separated list of options> שימושים מרובים
רשימה של ארכיטקטורה המופרדת בפסיקים שבשבילה לבנות קבצים בינאריים של AppleOS.
תגים: loses_incremental_state, loading_and_analysis
ברירת מחדל של --watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
גרסה מינימלית של WatchOS תואמת לסימולטורים ולסימולטורים מבוססי יעד. אם לא צוין, נעשה שימוש ב-'watchos_sdk_version'.
תגים: loses_incremental_state
ברירת מחדל של --xbinary_fdo=<a build target label>: תיאור
יש לך אפשרות להשתמש בפרטי הפרופיל ב-XbinaryFDO כדי לבצע אופטימיזציה של האוסף. קביעת השם של פרופיל בינארי כברירת מחדל. אם משתמשים באפשרות הזו יחד עם --fdo_instrument/--fdo_optimize/--fdo_profile, האפשרויות האלה תמיד יקבלו את הערך כאילו xbinary_fdo לא צוין.
תגים: affects_outputs
אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
ברירת מחדל של --auto_cpu_environment_group=<a build target label>: ""
מציינים את המאפייןEnvironment_group [קבוצת_סביבה] שישמש למיפוי אוטומטי של ערכי pu לערכי target_environment.
תגים: changes_inputs, loading_and_analysis, experimental
ברירת מחדל של --[no]check_licenses: "false"
צריך לוודא שמגבלות הרישוי שנקבעות על ידי חבילות תלויות לא מתנגשות עם מצבי ההפצה של היעדים שאתם יוצרים. כברירת מחדל, הרישיונות לא נבדקים.
תגים: build_file_semantics
ברירת מחדל של --[no]check_visibility: "true"
אם המדיניות מושבתת, שגיאות חשיפה בתלויות יעד יורדו לאזהרות.
תגים: build_file_semantics
ברירת מחדל של --[no]desugar_for_android: "true"
האם לבצע פענוח קוד בייט 8 של סוכר לפני פענוח הקוד?
תגים: affects_outputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]desugar_java8_libs: "false"
האם לכלול ספריות Java 8 נתמכות באפליקציות למכשירים מדור קודם.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state, experimental
ברירת מחדל של --[no]enforce_constraints: "true"
לבדוק את הסביבות שבהן כל יעד תואם, ומדווח על שגיאות אם לכל יעד יש יחסי תלות שלא תומכים באותן סביבות
תגים: build_file_semantics
ברירת מחדל של --[no]experimental_allow_android_library_deps_without_srcs: "false"
סימון כדי לעזור במעבר מהמדיניות של אי-אפשר להשתמש בכללי android_library ללא כינויים באמצעות נקודות שפל. יש לנקות את המאגר כדי שההוצאה תתבצע כברירת מחדל.
תגים: eagerness_to_exit, loading_and_analysis
ברירת מחדל של --[no]experimental_check_desugar_deps: "true"
האם כדאי לבדוק שוב את ניפוי הבאגים הנכון ברמה הבינארית של Android.
תגים: eagerness_to_exit, loading_and_analysis, experimental
ברירת מחדל של --experimental_import_deps_checking=<off, warning or error>: "OFF"
כשהאפשרות מופעלת, בודקים אם התלות של aar_import הסתיימו. האכיפה הזו עלולה לפרוץ את הבנייה, או להוביל רק לאזהרות.
תגים: loading_and_analysis
ברירת מחדל של --experimental_strict_java_deps=<off, warn, error, strict or default>: "default"
אם הערך הוא true, המערכת בודקת שיעד של Java מצהיר במפורש על כל היעדים שנעשה בהם שימוש ישיר כתלויות.
תגים: build_file_semantics, eagerness_to_exit
ברירת מחדל של --[no]incompatible_check_testonly_for_output_files: "false"
אם האפשרות הזו מופעלת, יש לבדוק רק את היעדים הנדרשים שהם קובצי פלט, על ידי חיפוש הבדיקה בלבד של כלל היצירה. ההגדרה הזו תואמת לבדיקת הניראות.
תגים: build_file_semantics, incompatible_change
ברירת מחדל של --[no]incompatible_disable_native_android_rules: "false"
אם המדיניות מופעלת, השימוש הישיר בכללי Android המקוריים מושבת. יש להשתמש בכללי Starlark ל-Android בכתובת https://github.com/bazelbuild/rules_android
תגים: eagerness_to_exit, incompatible_change
ברירת מחדל של --[no]incompatible_disable_native_apple_binary_rule: "false"
לא צריך להשתמש בהגדרה הזו. אפשר לשמור כאן לצורך תאימות לאחור.
תגים: eagerness_to_exit, incompatible_change
ברירת מחדל של --[no]incompatible_force_strict_header_check_from_starlark: "true"
אם האפשרות מופעלת, ניתן להגדיר בדיקת כותרות מחמירה ב-Starlark API
תגים: loading_and_analysis, changes_inputs, incompatible_change
ברירת מחדל של --[no]incompatible_validate_top_level_header_inclusions: "true"
אם הדבר נכון, Bazel תוודא גם שההכללה של הספרייה היא ברמה העליונה (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/10047).
תגים: loading_and_analysis, incompatible_change
ברירת מחדל של --[no]strict_filesets: "false"
אם האפשרות הזו מופעלת, קבצים שחוצים את גבולות החבילה מדווחים כשגיאות. הוא לא פועל כאשר Check_fileset_dependencies_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"
אלא אם האפשרות מושבתת, המערכת בודקת שיעד Proto_library מצהיר באופן מפורש על כל היעדים שנעשה בהם שימוש ב 'ייבוא ציבורי&#39.
תגים: build_file_semantics, eagerness_to_exit, incompatible_change
ברירת מחדל של --[no]strict_system_includes: "false"
אם הערך הוא True, צריך להצהיר גם על כותרות שנמצאות דרך נתיבים (-isystem).
תגים: loading_and_analysis, eagerness_to_exit
נצברו --target_environment=<a build target label> שימושים מרובים
מצהירה על סביבת היעד הזו. הערך חייב להיות תווית של כלל "enrinoment" אם צוין, כל היעדים ברמה העליונה חייבים להתאים לסביבה הזו.
תגים: changes_inputs
אפשרויות שמשפיעות על הפלט של החתימה של גרסת build:
ברירת מחדל של --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"
אם המדיניות מוגדרת ומצב האוסף לא 'opt' אפליקציות objc יכללו הרשאות לניפוי באגים בזמן החתימה.
תגים: changes_inputs
ברירת מחדל של --ios_signing_cert_name=<a string>: תיאור
שם האישור לשימוש בחתימת iOS. אם המדיניות לא מוגדרת, תוחזר לפרופיל ניהול התצורה. יכול להיות העדפת הזהות של אישור המפתח או מחרוזת המשנה של השם הנפוץ באישור, בהתאם לדף האדם של ה-Codesign &#39 (מפתח רישום).
תגים: action_command_lines
האפשרות הזו משפיעה על סמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו בקובצי BUILD, קובצי .bzl או קובצי WORKSPACE.:
ברירת מחדל של --[no]incompatible_disallow_legacy_py_provider: "true"
לא, המערכת תסיר אותה בקרוב.
תגים: loading_and_analysis, incompatible_change
אפשרויות שקובעות את אופן הפעולה של סביבת הבדיקה או של אופרטור הבדיקה:
ברירת מחדל של --[no]allow_analysis_failures: "false"
אם הערך מקבל את הערך 'true', כשל בניתוח של יעד הוא מפיץ את המופע של target&ailureInfo המכיל את תיאור השגיאה, במקום לגרום לכשל ב-build.
תגים: 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"
אם כשלים אמיתיים בפעולת dex2oat יגרמו לקריסה של המודל במקום לבצע Dex2oat בזמן ריצה של הבדיקה.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_android_use_parallel_dex2oat: "false"
משתמשים ב-dex2oat במקביל כדי להאיץ את android_test.
תגים: loading_and_analysis, host_machine_resource_optimizations, experimental
ברירת מחדל של --[no]ios_memleaks: "false"
הפעלה של בדיקת דליפות זיכרון ביעדי ios_test.
תגים: action_command_lines
ברירת מחדל של --ios_simulator_device=<a string>: תיאור
המכשיר להדמיית הפעלה של אפליקציה ל-iOS בסימולטור, לדוגמה 'iPhone 6'. ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים: 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 מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (ראו גם --instrumentation_filter). דוגמה: --runs_per_test=//foo/.*,-//foo/bar/.*@3 מריץ את כל הבדיקות ב-//foo/ אבל לא מתחת ל-foo/bar שלוש פעמים. ניתן להעביר את האפשרות הזו כמה פעמים. הארגומנט האחרון שהועבר תואם לעדיפות. אם אין תוצאות תואמות, הבדיקה תופעל פעם אחת בלבד.
נצברו --test_env=<a 'name=value' assignment with an optional value part> שימושים מרובים
ההגדרה קובעת משתני סביבה נוספים שיוחדרו לסביבת הרצה של הבדיקה. אפשר לציין משתנים לפי שם. במקרה כזה, הערך שלהם ייקרא מסביבת הלקוח ב-Bazel או באמצעות צמד name=value. אפשר להשתמש באפשרות הזו כמה פעמים כדי לציין כמה משתנים. בשימוש רק באמצעות הפקודה 'bazel' .
תגים: test_runner
ברירת מחדל של --test_timeout=<a single integer or comma-separated list of 4 integers>: "-1"
כדאי לשנות את ערכי ברירת המחדל של הזמן הקצוב לתפוגה של בדיקות (בדקות) אם יצוין ערך חיובי אחד שלם, הוא יחליף את כל הקטגוריות. אם ציינתם 4 מספרים שלמים המופרדים בפסיקים, הם יחליפו את הזמן הקצוב לתפוגה עבור קצר, בינוני, ארוך ותמידי (בסדר הזה). בכל אחד מהפורמטים, הערך 1- מורה ל-blaze להשתמש בברירות המחדל של הזמן הקצוב לתפוגה עבור קטגוריה זו.
ברירת מחדל של --tvos_simulator_device=<a string>: תיאור
המכשיר להדמיית הפעלה של אפליקציית tvOS בסימולטור, למשל 'Apple TV 1080p' ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים: test_runner
ברירת מחדל של --tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
גרסת ה-tvOS שפועלת בסימולטור בזמן הפעלה או בדיקה.
תגים: test_runner
ברירת מחדל של --watchos_simulator_device=<a string>: תיאור
המכשיר להדמיית הפעלה של אפליקציית WatchOS בסימולטור, למשל 'Apple Watch – 38mm' ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים: test_runner
ברירת מחדל של --watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>: תיאור
גרסת ה-watchOS שמופעלת בסימולטור כשמריצים או בודקים.
תגים: test_runner
ברירת מחדל של --[no]zip_undeclared_test_outputs: "true"
אם הערך הוא True, פלט של בדיקות לא מוצהרות יועברו לארכיון בקובץ ZIP.
תגים: test_runner
אפשרויות הקשורות לפלט שאילתות וסמנטיקה:
ברירת מחדל של --aspect_deps=<off, conservative or precise>: "conservative"
איך לפתור בעיה של יחסי גובה-רוחב כאשר פורמט הפלט הוא בפורמט {xml,proto,record}. 'off' פירוש הדבר שלא נפתרים יחסי תלות ו'שמרני' (ברירת המחדל) מוסיפים את כל יחסי הגובה-רוחב המוצהרים, בין אם הם קיבלו את רמת התלויות הישירות ובין אם לא. חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, כך שהוא איטי יותר מהמצבים האחרים. כמו כן, אפילו מצב מדויק אינו מדויק לחלוטין: ההחלטה אם לחשב היבט מסוים נקבעת בשלב הניתוח, שאינו פועל במהלך &b3Query;'
תגים: build_file_semantics
ברירת מחדל של --[no]graph:factored: "true"
אם הערך הוא True, התרשים ייקרא 'fact האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים: terminal_output
ברירת מחדל של --graph:node_limit=<an integer>: "512"
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; הערך 1- יגרום לכך שלא ייחתך. האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים: terminal_output
ברירת מחדל של --[no]implicit_deps: "true"
אם האפשרות הזאת מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלות שבו השאילתה פועלת. תלות משתמעת היא זו שלא צוינה במפורש בקובץ BUILD, אך נוספה על ידי ה-bazel. עבור שאילתה, אפשרות זו שולטת בסינון ערכות כלים שנפתרו.
תגים: build_file_semantics
ברירת מחדל של --[no]include_aspects: "true"
aquery, שאילתה: האם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: no-op (מאפיינים תמיד במעקב).
תגים: terminal_output
ברירת מחדל של --[no]incompatible_display_source_file_location: "true"
True, כברירת מחדל, יוצג היעד של קובץ המקור. אם True, מציג את המיקום של שורה 1 של קובצי מקור בפלטי מיקום. הסימון הזה קיים רק למטרות העברה.
תגים: terminal_output, incompatible_change
ברירת מחדל של --[no]incompatible_package_group_includes_double_slash: "true"
אם האפשרות הזו מופעלת, בעת הפקת המאפיין 'packs' של package_group&, הסימן '//' הראשי לא יושמט.
תגים: terminal_output, incompatible_change
ברירת מחדל של --[no]infer_universe_scope: "false"
אם המדיניות set ו- לתשומת ליבכם, הערך של uniuni_scope כפי שהוסק עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, allalleps) הוא לא מה שאתם רוצים, לכן עליכם להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים ודוגמאות זמינים בכתובת https://bazel.build/reference/query#sky-query. אם --univers_scope מוגדר, המערכת מתעלמת מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'שאילתה' (כלומר, לא 'cquery').
תגים: loading_and_analysis
ברירת מחדל של --[no]line_terminator_null: "false"
אם כל פורמט יסתיים ב-\0 במקום בפורמט חדש.
תגים: terminal_output
ברירת מחדל של --[no]nodep_deps: "true"
אם המדיניות מופעלת, נקודות שפל מתוך "nodep" ייכללו בתרשים התלות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep". היא "visible". מריצים ומנתחים את הפלט של 'info Build-language' כדי ללמוד על כל המאפיינים "nodep"בשפת ה-build.
תגים: build_file_semantics
ברירת מחדל של --output=<a string>: "label"
הפורמט שבו יש להדפיס את תוצאות השאילתה. הערכים המותרים ל-cquery הם: label, label_kind, textproto, passs, proto, jsonproto. אם בוחרים 'transitions' צריך גם לציין את האפשרות --transitions=(lite|full).
תגים: terminal_output
ברירת מחדל של --[no]proto:default_values: "true"
אם מוגדר כ-True, נכללים מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- --פלט=פרוטו
תגים: terminal_output
ברירת מחדל של --[no]proto:definition_stack: "false"
מאכלס את השדה Proto-stack, שמתעד כל מופע של כלל ה-Starstark שבו מוגדרת המחלקה בכלל.
תגים: terminal_output
ברירת מחדל של --[no]proto:flatten_selects: "true"
אם המדיניות מופעלת, מאפיינים ניתנים להגדרה שנוצרו על ידי Select() שטוחים. עבור סוגי רשימות, הייצוג השטוח הוא רשימה המכילה כל ערך של המפה שנבחרה פעם אחת בלבד. סוגי הפיגועים שטוחים איזה null.
תגים: build_file_semantics
ברירת מחדל של --[no]proto:include_configurations: "true"
כשהפרוטוקול מופעל, פלט אב יכלול מידע על ההגדרות. כאשר המדיניות מושבתת,פורמט הפלט אב השאילתה דומה לפורמט פלט שאילתה.
תגים: affects_outputs
ברירת מחדל של --[no]proto:include_synthetic_attribute_hash: "false"
אם רוצים לחשב ולאכלס את המאפיין $internal_attr_Hash.
תגים: terminal_output
ברירת מחדל של --[no]proto:instantiation_stack: "false"
אכלוס מחסנית קריאות של כל הנחיה. כדי לעשות זאת, יש צורך במקבץ סטאק
תגים: terminal_output
ברירת מחדל של --[no]proto:locations: "true"
אם בכלל, כדאי לשלוח פרטי מיקום בפלט אב.
תגים: terminal_output
ברירת מחדל של --proto:output_rule_attrs=<comma-separated list of options>: "all"
רשימת מאפיינים המופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להוציא פלט. האפשרות הזו רלוונטית ל--פלט=פרוטו.
תגים: terminal_output
ברירת מחדל של --[no]proto:rule_inputs_and_outputs: "true"
אפשר גם לאכלס את השדותכללי_קלט וכלל_פלט.
תגים: terminal_output
ברירת מחדל של --[no]relative_locations: "false"
אם הערך הוא TRUE, המיקום של קובצי BUILD ב-XML ובפלטי אב יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא יהיה עקבי בין מחשבים. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במכשירים שונים.
תגים: terminal_output
ברירת מחדל של --show_config_fragments=<off, direct or transitive>: "off"
הצגת קטעי התצורה הנדרשים על ידי כלל והתלות העקיפות שלו. אפשרות זו יכולה לעזור לכם להעריך עד כמה אפשר לחתוך תרשים יעד שהוגדר.
תגים: affects_outputs
ברירת מחדל של --starlark:expr=<a string>: ""
ביטוי Starlark לעיצוב של כל יעד שמוגדר במצב cquery's --pla=starlark. היעד שהוגדר מוגבל ל-'target' אם לא צוין --starlar:expr or --starlark:file, האפשרות הזו תוגדר כברירת מחדל ל-'str(target.label)' אירעה שגיאה לציון גם -starstark:expr וגם --starlark:file.
תגים: terminal_output
ברירת מחדל של --starlark:file=<a string>: ""
שם של קובץ שמגדיר פונקציית Starlark שנקראת 'format', מתוך ארגומנט אחד, שחל על כל יעד מוגדר כדי לעצב אותו כמחרוזת. אירעה שגיאה לציון גם -starstark:expr וגם --starlark:file. לקבלת עזרה נוספת --
תגים: terminal_output
ברירת מחדל של --[no]tool_deps: "true"
שאילתה: אם היא מושבתת, יחסי תלות ב-'מארח הגדרה' או 'execution' יעדים לא ייכללו בתרשים התלות שעליו פועלת השאילתה. קצה 'הגדרת תצורה למארחים' כזה מהכלל של #&39;proto_library' מפנה בדרך כלל למהדר הפרוטוקול, בדרך כלל מצביע על כלי שהופעל במהלך ה-build במקום על חלק מאותה תוכנית 'target' שאילתה: אם היא מושבתת, היא מסננת את כל היעדים שהוגדרו שחוצים מעבר של מארח או ביצוע, מהיעד שהוגדר ברמה העליונה שגילו את היעד שהוגדר. כלומר, אם היעד ברמה העליונה נמצא בתצורת היעד, יוחזרו רק יעדים שהוגדרו בתצורת היעד. אם היעד ברמה העליונה נמצא בתצורת המארח, יוחזרו רק יעדים שהוגדרו על ידי המארח. אפשרות זו לא תכלול שרשראות כלים שנפתרו.
תגים: build_file_semantics
ברירת מחדל של --transitions=<full, lite or none>: "none"
הפורמט שבו השאילתה תדפיס את פרטי המעבר.
תגים: affects_outputs
ברירת מחדל של --universe_scope=<comma-separated list of options>: ""
קבוצה של דפוסי יעד (מופרדים באמצעות פסיקים) המופרדים בפסיקים. השאילתה עשויה להתבצע ביקום שהוגדר על ידי הסגירה העקיפה של היעדים שצוינו. האפשרות הזו משמשת לפקודות השאילתה ושאילתת השאילתה. עבור השאילתה, הקלט לאפשרות הזו הוא היעדים שבנו כל התשובות, ולכן האפשרות הזו עשויה להשפיע על התצורות והמעברים. אם אפשרות זו אינה מוגדרת, ההנחה היא שהיעדים ברמה העליונה הם היעדים המנותחים מביטוי השאילתה. הערה לגבי שאילתה: אם לא מציינים את האפשרות הזו, ייתכן שה-build לא יפעל אם לא ניתן ליצור יעדים מביטוי השאילתה עם האפשרויות ברמה העליונה.
תגים: loading_and_analysis
אפשרויות שגורמות לאופטימיזציה של זמן ה-build:
ברירת מחדל של --[no]collapse_duplicate_defines: "false"
כשהאפשרות מופעלת, ההגדרות המיותרות יוסרו בשלב מוקדם. כדי למנוע אובדן מיותר של מטמון הניתוח לסוגים מסוימים של גרסאות build מקבילות.
תגים: loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]experimental_filter_library_jar_with_program_jar: "false"
יש לסנן את ProGuard ProgramJar כדי להסיר את כל הכיתות שנמצאות גם ב-LibraryJar.
תגים: action_command_lines
ברירת מחדל של --[no]experimental_inmemory_dotd_files: "true"
כשהאפשרות מופעלת, קובצי C++ .d יועברו בזיכרון ישירות מצומתי ה-build המרוחק במקום להיכתב לדיסק.
תגים: loading_and_analysis, execution, affects_outputs, experimental
ברירת מחדל של --[no]experimental_inmemory_jdeps_files: "true"
אם האפשרות מופעלת, קובצי התלויות (.jdeps) שנוצרו מהאוספים של Java יועברו בזיכרון ישירות מצומתי ה-build המרוחק במקום להיכתב לדיסק.
תגים: loading_and_analysis, execution, affects_outputs, experimental
ברירת מחדל של --[no]experimental_objc_include_scanning: "false"
האם לבצע סריקה עבור אובייקט C/C+ אובייקטיבי.
תגים: loading_and_analysis, execution, changes_inputs
ברירת מחדל של --[no]experimental_parse_headers_skipped_if_corresponding_srcs_found: "false"
אם התכונה parse_headers מופעלת, אם לא קיים מקור באותו שם יעד, היא לא יוצרת פעולת רינדור נפרדת של כותרת.
תגים: loading_and_analysis, affects_outputs
ברירת מחדל של --[no]experimental_retain_test_configuration_across_testonly: "false"
כשהאפשרות מופעלת, --trim_test_Configuration לא יקטע את תצורת הבדיקה של כללים שסומנו לבדיקה בלבד=1. כך אנחנו מצמצמים את הבעיות של התנגשות בין פעולות כאשר כללים שאינם בדיקות תלויים בכללים של cc_test. אין השפעה אם --trim_test_ Configuration היא FALSE.
תגים: loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]experimental_starlark_cc_import: "false"
אם ההגדרה מופעלת, אפשר להשתמש בגרסת Starlark של cc_import.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_unsupported_and_brittle_include_scanning: "false"
כדי לצמצם את קלט הקלט לאוסף C/C++ , יש לנתח #include שורות מקובצי קלט. כך אפשר לשפר את הביצועים ואת הצבירה על ידי הקטנת הגודל של עצי ההזנה של האוסף. עם זאת, היא עלולה לשבור גרסאות build כי הסורק של כלי העריכה לא מטמיע באופן מלא את הסמנטיקה של מעבד המידע (CPU) לפני העיבוד. באופן ספציפי, הוא לא מבין הוראות #include דינמיות ומתעלם מלוגיקה מותנית של עיבוד מראש. השימוש הוא באחריותך בלבד. כל בעיה הנוגעת לסימון זה ייסגר.
תגים: loading_and_analysis, execution, changes_inputs
ברירת מחדל של --[no]incremental_dexing: "true"
רוב העבודה על דקס נפתחת בנפרד בכל קובץ ב-Jar.
תגים: affects_outputs, loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]objc_use_dotd_pruning: "true"
אם המדיניות מוגדרת, קובצי .d שנוצרו על ידי ה-Clang ישמשו לגיזום קבוצת הקלט הנכנסת מהדרים objc.
תגים: changes_inputs, loading_and_analysis
ברירת מחדל של --[no]process_headers_in_dependencies: "false"
כשיוצרים יעד //a:a, צריך לעבד כותרות בכל היעדים ש //a:a תלויים בהם (אם עיבוד הכותרת מופעל עבור Toolchain).
תגים: execution
ברירת מחדל של --[no]trim_test_configuration: "true"
כשהאפשרות מופעלת, האפשרויות שקשורות לבדיקה יימחקו מתחת לרמה העליונה של ה-build. כשהסימון הזה פעיל, לא ניתן ליצור בדיקות כתלויות של כללים שאינם בדיקות, אבל שינויים באפשרויות הקשורות לבדיקה לא יגרמו לניתוח מחדש של כללים שאינם בדיקות.
תגים: loading_and_analysis, loses_incremental_state
ברירת מחדל של --[no]use_singlejar_apkbuilder: "true"
האפשרות הזו הוצאה משימוש. לא חייבים להשתמש בה והיא תוסר בקרוב.
תגים: loading_and_analysis
אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום:
ברירת מחדל של --toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: "-.*"
הדפסת מידע על תוצאות ניפוי באגים במהלך רזולוציה של הכלי. בסימון נעשה שימוש בביטוי רגולרי, שנבדק ביחס לסוגי כלי עבודה ויעדים ספציפיים, כדי לראות באיזה ניפוי באגים. אפשר להפריד בין ביטויים רגולריים באמצעות ביטויים רגולריים, ולאחר מכן כל ביטוי רגולרי מסומן בנפרד. הערה: הפלט של הדגל הזה מורכב מאוד וככל הנראה יועיל רק למומחים בפתרון בעיות בכלי.
תגים: terminal_output
אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
נצברו --flag_alias=<a 'name=value' flag alias> שימושים מרובים
מגדירים שם מקוצר לסימון Starlark. הוא צריך להזין צמד יחיד של מפתח-ערך בפורמט "<key>=<value>" כארגומנט.
תגים: changes_inputs
ברירת מחדל של --[no]incompatible_default_to_explicit_init_py: "false"
סימון זה משנה את התנהגות ברירת המחדל כך שקובצי __init__.py כבר לא נוצרים באופן אוטומטי בקבצים פועלים של יעדים ב-Python. באופן מדויק, אם יעד py_binary או py_test מוגדר מדור קודם, play_create_init מוגדר ל-"auto" (ברירת המחדל), הוא נחשב כ-false אם רק הסימון הזה מוגדר. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/10076.
תגים: affects_outputs, incompatible_change
ברירת מחדל של --[no]incompatible_py2_outputs_are_suffixed: "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_פלטs_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"
אם מוגדר כ-'auto', Bazel מריץ בדיקה מחדש אם ורק: (1) בזל מזהה שינויים בבדיקה או בתלויות שלה, (2) הבדיקה מסומנת כחיצונית, (3) התבקשו מספר ריצות בדיקה עם -runs_per_test או(4) הבדיקה נכשלה בעבר. אם הכתובת היא 'yes' , Bazel שומרת במטמון את כל תוצאות הבדיקה, מלבד בדיקות שסומנו כחיצוניות. אם הכתובת היא 'no', Bazel לא שומרת תוצאות בדיקה.
ברירת מחדל של --[no]experimental_cancel_concurrent_tests: "false"
True האפשרות הזו שימושית רק בשילוב עם --runs_per_test_detects_flakes.
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --[no]experimental_fetch_all_coverage_outputs: "false"
אם הערך הוא True, מערכת Bazel מאחזרת את כל ספריית נתוני הכיסוי עבור כל בדיקה במהלך תקופת כיסוי.
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --[no]experimental_generate_llvm_lcov: "false"
אם זה יהיה נכון, כיסוי לגבי קלנג ייצור דוח LCOV.
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --[no]experimental_j2objc_header_map: "true"
האם ליצור מפת כותרת של J2ObjC במקביל לתעתוק J2ObjC?
ברירת מחדל של --[no]experimental_j2objc_shorter_header_path: "false"
אם צריך ליצור עם נתיב כותרת קצר יותר (משתמשים ב-"_ios" במקום "_j2objc").
תגים: affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel> כברירת מחדל: "Javabuilder"
הפעלת ערכי נתיב מופחתים לאוספים של Java.
ברירת מחדל של --[no]experimental_limit_android_lint_to_android_constrained_java: "false"
מגבילים --experimental_run_android_lint_on_Java_rules לספריות תואמות ל-Android.
תגים: affects_outputs
ברירת מחדל של --[no]experimental_run_android_lint_on_java_rules: "false"
האם לאמת את מקורות Java_*?
תגים: affects_outputs
ברירת מחדל של --[no]explicit_java_test_deps: "false"
יש לציין באופן מפורש את התלות ב-JUnit או Hacrest ב-Java_test במקום לקבל בטעות נקודות דירוג מ-TestRunner&#39. בשלב זה מתאים לשימוש ב-Bazall.
ברירת מחדל של --host_java_launcher=<a build target label>: תיאור
מרכז האפליקציות של Java שמשמש את הכלים להפעלה במהלך build.
נצברו --host_javacopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-Java בעת יצירת כלים המופעלים במהלך build.
נצברו --host_jvmopt=<a string> שימושים מרובים
אפשרויות נוספות למעבר ל-Java VM במהלך בניית כלים שמופעלים במהלך ה-build. האפשרויות האלה יתווספו לאפשרויות ההפעלה של VM בכל יעד Java_binary.
ברירת מחדל של --[no]incompatible_exclusive_test_sandboxed: "false"
אם הערך הוא נכון, יופעלו בדיקות בלעדיות עם שיטת בידינג בארגז חול. מוסיפים תג 'local' כדי לאלץ הרצת בדיקה בלעדית באופן מקומי
תגים: incompatible_change
ברירת מחדל של --[no]incompatible_strict_action_env: "false"
אם הערך true, Bazel משתמשת בסביבה עם ערך סטטי של Path ולא יורשת את LD_LIBRARI_Path. משתמשים בפונקציה --action_env=ENV_VARIABLE אם רוצים לרשת בירושה משתני סביבה ספציפיים מהלקוח, אך חשוב לזכור שפעולה זו יכולה למנוע שמירה במטמון של משתמשים שונים אם נעשה שימוש במטמון משותף.
תגים: loading_and_analysis, incompatible_change
נצברו --j2objc_translation_flags=<comma-separated list of options> שימושים מרובים
אפשרויות נוספות למעבר לכלי J2ObjC.
--java_debug
המכונה הווירטואלית של Java בבדיקת Java ממתינה לחיבור לכלי ניפוי באגים התואם ל-JDWP (כגון jdb) לפני התחלת הבדיקה. משתמע -test_פלט=שידור.
הרחבה אל:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
ברירת מחדל של --[no]java_deps: "true"
יצירת פרטי תלות (כרגע, סוג ה-path של זמן הביצוע) לכל יעד Java.
ברירת מחדל של --[no]java_header_compilation: "true"
להיעזר באיג'רים ישירות מהמקור.
ברירת מחדל של --java_language_version=<a string>: "8"
גרסת השפה ב-Java
ברירת מחדל של --java_launcher=<a build target label>: תיאור
מרכז האפליקציות של Java לשימוש כשיוצרים קבצים בינאריים של Java. אם הדגל הזה מוגדר כמחרוזת ריקה, המערכת תשתמש במפעיל JDK. המאפיין "מרכז האפליקציות" מבטל את הסימון הזה.
ברירת מחדל של --java_runtime_version=<a string>: "local_jdk"
גרסת זמן הריצה של Java
נצברו --javacopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-Java.
נצברו --jvmopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה ל-Java VM. האפשרויות האלה יתווספו לאפשרויות ההפעלה של VM בכל יעד Java_binary.
ברירת מחדל של --legacy_main_dex_list_generator=<a build target label>: תיאור
קביעת הקובץ הבינארי שבו יש להשתמש כדי ליצור את רשימת הכיתות שחייבות להיות בשרת ה-proxy הראשי במהלך הידור ה-Multiplexex הקודם.
נצברו --plugin=<a build target label> שימושים מרובים
יישומי פלאגין לשימוש ב-build. פועלים כרגע עם Java_plugins.
ברירת מחדל של --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() שמתארת איך להדר Cto++ Proto תגים: 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
תגים: affects_outputs, loading_and_analysis
ברירת מחדל של --proto_toolchain_for_javalite=<a build target label>: "@bazel_tools//tools/proto:Javalite_toolchain"
תווית Proto_lang_toolchain() שמתארת איך להדר פרוטומות של JavaLite
תגים: affects_outputs, loading_and_analysis
נצברו --protocopt=<a string> שימושים מרובים
אפשרויות נוספות להעברה אל מהדר הפרוטוקול.
תגים: affects_outputs
ברירת מחדל של --[no]runs_per_test_detects_flakes: "false"
אם הערך מקבל את הערך True, כל פיצול שבו עובר ניסיון ריצה/ניסיון אחד לפחות ולפחות ניסיון ריצה אחד/ניסיון אחד נכשל, מקבל את הסטטוס FLAKY.
ברירת מחדל של --shell_executable=<a path>: תיאור
נתיב מוחלט להפעלה של קונכיות לשימוש בבזל. אם האפשרות הזו לא מוגדרת, המשתנה של סביבת 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_filter=<a string>: תיאור
קביעת מסנן להעברת למסגרת הבדיקה. משמש להגבלת הבדיקות. לתשומת ליבכם: אין לכך השפעה על היעדים המובנים.
ברירת מחדל של --test_result_expiration=<an integer>: "-1"
האפשרות הזו הוצאה משימוש ואין לה השפעה.
ברירת מחדל של --[no]test_runner_fail_fast: "false"
אם ההרצה לא תתבצע מהר, אפשר יהיה להריץ אותה. הרצת הבדיקה צריכה להפסיק את הביצוע אחרי הכשל הראשון.
ברירת מחדל של --test_sharding_strategy=<explicit or disabled>: "explicit"
יש לציין את השיטה לפיצול הבדיקה: 'explicit' כדי להשתמש בפיצול רק אם קיים המאפיין 'shard_count' 'disabled' לעולם לא להשתמש בפיצול בדיקה.
ברירת מחדל של --tool_java_language_version=<a string>: "8"
גרסת השפה של Java המשמשת לביצוע הכלים הנחוצים במהלך גרסת ה-build
ברירת מחדל של --tool_java_runtime_version=<a string>: "remotejdk_11"
גרסת זמן הריצה של Java המשמשת לביצוע כלים במהלך ה-build
ברירת מחדל של --[no]use_ijars: "true"
כשהאפשרות הזו מופעלת, הידור ה-Java משתמש בקונטיינרים של ממשק. כתוצאה מכך, האוסף המצטבר יהיה מהיר יותר, אבל הודעות השגיאה עשויות להיות שונות.

אפשרויות Dump

אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
נצברו --distdir=<a path> שימושים מרובים
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים: bazel_internal_configuration
אם היא מוגדרת, המטמון של המאגר יקשר את הקובץ באופן ידני במקרה של היט מטמון, במקום העתקה. מטרת האחסון היא לחסוך מקום בכונן.
תגים: bazel_internal_configuration
ברירת מחדל של --[no]experimental_repository_cache_urls_as_default_canonical_id: "false"
אם הערך הוא TRUE, יש להשתמש במחרוזת שנגזרת מכתובות ה-URL של הורדות המאגר בתור ה-canonical_id אם לא צוין. במצב הזה, שינוי בכתובות ה-URL יוביל להורדה מחדש, גם אם המטמון מכיל הורדה עם אותו גיבוב. אפשר להשתמש בשיטה הזו כדי לאמת ששינויים בכתובת ה-URL לא גורמים להסתרה של מאגרים לא תקינים.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_repository_disable_download: "false"
אם היא מוגדרת, לא ניתן להוריד מאגרים חיצוניים.
תגים: experimental
ברירת מחדל של --experimental_repository_downloader_retries=<an integer>: "0"
מספר הניסיונות המקסימלי לנסות שוב שגיאת הורדה. אם המדיניות מוגדרת כ-0, ניסיונות חוזרים מושבתים.
תגים: experimental
ברירת מחדל של --experimental_scale_timeouts=<a double>: "1.0"
התאמה של כל הזמן הקצוב לתפוגה בכללים של מאגר הכוכב של Starlark, לפי הגורם הזה. כך אפשר לגרום למאגרים חיצוניים לפעול במחשבים באיטיות רבה יותר ממחבר הכלל, בלי לשנות את קוד המקור
תגים: bazel_internal_configuration, experimental
ברירת מחדל של --http_timeout_scaling=<a double>: "1.0"
התאמה של כל הזמן הקצוב לתפוגה הקשור להורדות http לפי הגורם הנתון
תגים: bazel_internal_configuration
ברירת מחדל של --repository_cache=<a path>: תיאור
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים: bazel_internal_configuration
אפשרויות ששולטות בפלט של הפקודה:
ברירת מחדל של --[no]action_cache: "false"

תגים: bazel_monitoring
ברירת מחדל של --[no]packages: "false"
שלילה של תוכן מטמון החבילה.
תגים: bazel_monitoring
ברירת מחדל של --[no]rule_classes: "false"
מחלקת מחלקות כללים.
תגים: bazel_monitoring
ברירת מחדל של --[no]rules: "false"
להשליך כללים, כולל ספירה ושימוש בזיכרון (אם מתבצע מעקב אחר הזיכרון).
תגים: bazel_monitoring
ברירת מחדל של --skyframe=<off, summary, count, deps or rdeps>: "off"

תגים: bazel_monitoring
ברירת מחדל של --skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>: ".*"
מסנן Regex של שמות SkyKey לפלט. בשימוש רק עם --skyframe=deps, epps.
תגים: bazel_monitoring
ברירת מחדל של --skylark_memory=<a string>: תיאור
נתיב Dump של הזיכרון תואם לפרופיל שצוין. מידע נוסף זמין בכתובת https://github.com/google/pprof.
תגים: bazel_monitoring
אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
ברירת מחדל של --experimental_repository_hash_file=<a string>: ""
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים: affects_outputs, experimental
נצברו --experimental_verify_repository_rules=<a string> שימושים מרובים
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים: affects_outputs, experimental
האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
ברירת מחדל של --[no]experimental_allow_top_level_aspects_parameters: "true"
לא:
תגים: no_op, deprecated, experimental
אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
נצברו --allow_yanked_versions=<a string> שימושים מרובים
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים: loading_and_analysis
ברירת מחדל של --check_bazel_compatibility=<error, warning or off>: "error"
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים: loading_and_analysis
ברירת מחדל של --check_direct_dependencies=<off, warning or error>: "warning"
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים: loading_and_analysis
ברירת מחדל של --[no]ignore_dev_dependency: "false"
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-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"
כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
ברירת מחדל של --experimental_resolved_file_instead_of_workspace=<a string>: ""
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים: changes_inputs
אפשרויות שמירה במטמון והפעלה:
ברירת מחדל של --experimental_downloader_config=<a string>: תיאור
מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
נצברו --override_repository=<an equals-separated mapping of repository name to path> שימושים מרובים
עוקפת מאגר עם ספרייה מקומית.

אפשרויות אחזור

אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
נצברו --distdir=<a path> שימושים מרובים
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים: bazel_internal_configuration
אם היא מוגדרת, המטמון של המאגר יקשר את הקובץ באופן ידני במקרה של היט מטמון, במקום העתקה. מטרת האחסון היא לחסוך מקום בכונן.
תגים: bazel_internal_configuration
ברירת מחדל של --[no]experimental_repository_cache_urls_as_default_canonical_id: "false"
אם הערך הוא TRUE, יש להשתמש במחרוזת שנגזרת מכתובות ה-URL של הורדות המאגר בתור ה-canonical_id אם לא צוין. במצב הזה, שינוי בכתובות ה-URL יוביל להורדה מחדש, גם אם המטמון מכיל הורדה עם אותו גיבוב. אפשר להשתמש בשיטה הזו כדי לאמת ששינויים בכתובת ה-URL לא גורמים להסתרה של מאגרים לא תקינים.
תגים: loading_and_analysis, experimental
ברירת מחדל של --[no]experimental_repository_disable_download: "false"
אם היא מוגדרת, לא ניתן להוריד מאגרים חיצוניים.
תגים: 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
אפשרויות ששולטות בהפעלה של גרסת build:
אם המדיניות מוגדרת כ-True ו- --incompatible_remote_symlinks הוא גם נכון, קישורים מסולסלים בפלטי פעולה מורשים להתנתק.
תגים: execution, incompatible_change
אם המדיניות מוגדרת כ-TRUE, Bazel תייצג קישורים סימבוליים בפלטי פעולות בפרוטוקול השמירה במטמון/הביצוע מרחוק. אחרת, יתבצע מעקב אחר קישורים סימבוליים ויוצגו כקבצים או כספריות. פרטים נוספים זמינים בדף #6631.
תגים: execution, incompatible_change
--[no]keep_going [-k] ברירת מחדל: "false"
אפשר להמשיך כמה שיותר אחרי השגיאה. לא ניתן לנתח את היעד שנכשל או את היעד שתלוי בו, אבל יש דרישות מוקדמות נוספות ליעדים האלה.
תגים: eagerness_to_exit
ברירת מחדל של --loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">: "auto"
מספר השרשורים המקבילים שיש להשתמש בהם בשלב הטעינה/הניתוח.נלקחים מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ובדרך כלל מוסיפים פעולה ([-|*]<float>) למשל. "auto", "HOST_CPUS*.5". "auto" מגדיר ברירת מחדל סבירה על סמך משאבים למארחים. הערך חייב להיות לפחות 1.
תגים: bazel_internal_configuration
אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לקיומו:
ברירת מחדל של --bep_maximum_open_remote_upload_files=<an integer>: "-1"
המספר המקסימלי של קבצים פתוחים מותר במהלך העלאת תוכן של BEP.
תגים: affects_outputs
--remote_download_minimal
לא תתבצע הורדה של פלטי build מרוחקים אל המכונה המקומית. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=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' לא מורידה פלט של build מרחוק אל המכונה המקומית, חוץ מאלה הנדרשות על ידי פעולות מקומיות. אם המדיניות מוגדרת כ-'toplevel' היא פועלת כך'minimal' מלבד זאת, מתבצעת הורדה של פלט של יעדים ברמה העליונה למחשב המקומי. שתי האפשרויות יכולות לקצר משמעותית את זמני הבנייה אם רוחב הפס של הרשת הוא צוואר בקבוק.
תגים: affects_outputs
במקום להוריד פלט של build מרחוק, אפשר ליצור קישורים סימבוליים. ניתן לציין את יעד הקישורים המסמלים בצורת מחרוזת תבנית. מחרוזת התבנית הזו עשויה להכיל {hash} ו-{size_bytes} שמתרחבים לאובייקט ולגודל בבייטים, בהתאמה. הקישורים הסמליים האלה עשויים, למשל, להפנות למערכת קבצים של FUSE שטוענת אובייקטים מ-CAS לפי דרישה.
תגים: affects_outputs
--remote_download_toplevel
רק מכונה מקומית יכולה להוריד פלט מרחוק של יעדים ברמה העליונה. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=toplevel.
מתרחבת אל:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel

תגים: affects_outputs
אפשרויות שמשפיעות על רמת האכיפה התקינה של Bazel על קלט קלט (הגדרות של כללים, שילובי דגל וכו'):
ברירת מחדל של --experimental_repository_hash_file=<a string>: ""
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים: affects_outputs, experimental
נצברו --experimental_verify_repository_rules=<a string> שימושים מרובים
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים: affects_outputs, experimental
האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
ברירת מחדל של --[no]experimental_allow_top_level_aspects_parameters: "true"
לא:
תגים: no_op, deprecated, experimental
ברירת מחדל של --[no]incompatible_config_setting_private_default_visibility: "false"
אם לא תואם_enforce_config_setting_visible=false, זו שגיאה. אחרת, אם הסימון הזה הוא false, כל הגדרת config_ללא מאפיין חשיפה בוטה היא //visible: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. אם הערך הוא False, כל config_setting גלויה לכל יעד. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים: loading_and_analysis, incompatible_change
אפשרויות שקשורות לפלט Bzlmod וסמנטיקה:
נצברו --allow_yanked_versions=<a string> שימושים מרובים
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים: loading_and_analysis
ברירת מחדל של --check_bazel_compatibility=<error, warning or off>: "error"
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים: loading_and_analysis
ברירת מחדל של --check_direct_dependencies=<off, warning or error>: "warning"
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים: loading_and_analysis
ברירת מחדל של --[no]ignore_dev_dependency: "false"
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-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"
כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
ברירת מחדל של --experimental_repository_resolved_file=<a string>: ""
אם לא ריק, כותבים ערך של Starlark עם הפרטים שנפתרו לגבי כל כללי המאגר של Starlark שבוצעו.
תגים: affects_outputs
ברירת מחדל של --remote_print_execution_messages=<failure, success or all>: "failure"
אתם יכולים לבחור מתי תרצו להדפיס הודעות של ביצוע מרחוק. הערכים התקינים הם 'כשל', כדי להדפיס רק כשלים, 'הצלחה' כדי להדפיס רק את ההצלחות, ו'הכול' כדי להדפיס תמיד.
תגים: terminal_output
אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
ברירת מחדל של --experimental_resolved_file_instead_of_workspace=<a string>: ""
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים: changes_inputs
אפשרויות שמירה במטמון והפעלה:
ברירת מחדל של --experimental_downloader_config=<a string>: תיאור
מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
ברירת מחדל של --[no]experimental_guard_against_concurrent_changes: "false"
כדי להשבית את הבדיקה של קובצי קלט עבור פעולה מסוימת לפני שמעלים אותה למטמון מרוחק, יש להשבית את הזמן. ייתכנו מקרים שבהם הליבה של Linux מעכבת כתיבה של קבצים, מה שעלול לגרום לתוצאות חיוביות שקריות.
ברירת מחדל של --experimental_remote_build_event_upload=<all or minimal>: "all"
אם המדיניות מוגדרת כ-'all' כל הפלט המקומי שאליו מפנה BEP מועלה למטמון מרוחק. אם המדיניות מוגדרת כ-'minimal' פלטים מקומיים ש-BEP מפנה אליהם לא מועלים למטמון המרוחק, מלבד קבצים שחשובים לצרכנים של BEP (למשל יומני בדיקה ופרופיל תזמון). סכימת //:file משמשת לנתיבים של קבצים מקומיים וסכימת בייטstream:// משמשת לנתיבים של קבצים שהועלו (כבר). ברירת המחדל היא 'all'.
ברירת מחדל של --[no]experimental_remote_cache_async: "false"
אם הערך הוא TRUE, מטמון I/O מרוחק יתרחש ברקע במקום להיווצר כחלק מ-S מדויקת.
ברירת מחדל של --[no]experimental_remote_cache_compression: "false"
אם האפשרות מופעלת, אפשר לדחוס או לפרוס בועות של מטמון עם zstd.
ברירת מחדל של --experimental_remote_capture_corrupted_outputs=<a path>: תיאור
נתיב לספרייה שבה יילכו פלטים פגומים.
ברירת מחדל של --experimental_remote_downloader=<a string>: תיאור
URI של נקודת קצה ל-API של נכס מרוחק, שישמש כשרת proxy להורדה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. בכתובת: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
ברירת מחדל של --[no]experimental_remote_downloader_local_fallback: "false"
אם אתם רוצים לחזור לכלי ההורדה המקומי, אם ההורדה מרחוק נכשלה.
ברירת מחדל של --[no]experimental_remote_execution_keepalive: "false"
האם להשתמש ב-Keepalive בשיחות ביצוע מרחוק?
ברירת מחדל של --experimental_remote_grpc_log=<a path>: תיאור
אם צוין, נתיב לקובץ שבו יתבצע רישום של פרטים הקשורים לשיחת gRPC. היומן הזה מורכב מרצף של com.google.devtools.build.lib.remote.logging.remoteExecutionLog.LogEntry Protobufs עם כל הודעה המסומנת ב-varint המציין את גודל ההודעה הבאה עם פסיק.
ברירת מחדל של --[no]experimental_remote_mark_tool_inputs: "false"
אם היא מוגדרת כ-True, ה-Bazel יסמן את הקלט בתור קלט לכלי הפעולה מרחוק. אפשר להשתמש באפשרות הזאת כדי להטמיע עובדים קבועים מרחוק.
ברירת מחדל של --[no]experimental_remote_merkle_tree_cache: "false"
אם המדיניות מוגדרת כ-True, החישובים של עץ ה-Merkle יסונכרנו כדי לשפר את מהירות הבדיקה של ההיט המרוחק. ביצועי טביעת הרגל בזיכרון של המטמון נקבעים על ידי -experimental_remote_merkle_tree_cache_size.
ברירת מחדל של --experimental_remote_merkle_tree_cache_size=<a long integer>: "1000"
מספר עצי ה-Merkle שיש לזכור כדי לשפר את מהירות הבדיקה של ההיט המרוחק. אף על פי שהמטמון נחתך באופן אוטומטי בהתאם לטיפול בהפניות רכות של Java&#39, יכול להיות ששגיאות "חסרות זיכרון" עלולות להיווצר אם הן גבוהות מדי. אם המדיניות מוגדרת כ-0, גודל המטמון הוא בלתי מוגבל. הערך האופטימלי משתנה בהתאם לגודל הפרויקט. ערך ברירת המחדל הוא 1,000.
ברירת מחדל של --[no]incompatible_remote_build_event_upload_respect_no_cache: "false"
אם המדיניות מוגדרת כ-True, פלטים שאליהם מפנה BEP לא יועלו למטמון מרוחק אם לא ניתן יהיה לשמור במטמון את פעולת היצירה מרחוק.
ברירת מחדל של --[no]incompatible_remote_downloader_send_all_headers: "true"
האם לשלוח את כל הערכים של כותרת רבת-ערך להורדה מרחוק ולא רק הראשונה.
תגים: incompatible_change
ברירת מחדל של --[no]incompatible_remote_output_paths_relative_to_input_root: "false"
אם המדיניות מוגדרת כ-True, נתיבי הפלט הם יחסיים לשורש הקלט במקום לספרייה הפעילה.
תגים: incompatible_change
ברירת מחדל של --[no]incompatible_remote_results_ignore_disk: "true"
אם המדיניות מוגדרת כ-True, --noremote_upload_local_results ו--noremote_Accept_cached לא יחולו על מטמון הדיסק. אם נעשה שימוש במטמון משולב: --noremote_upload_local_results יגרום לכתיבה של תוצאות במטמון הדיסק, אבל לא להעלאה למטמון המרוחק. --noremote_confirm_cached יוביל לבדיקה של Bazel בתוצאות החיפוש במטמון הדיסק, אבל לא במטמון המרוחק. פעולות ללא הפעלה מרחוק יכולות לפגוע במטמון הדיסק. פרטים נוספים זמינים בדף #8216.
תגים: incompatible_change
ברירת מחדל של --[no]remote_accept_cached: "true"
האם לקבל תוצאות של פעולות שנשמרו במטמון מרחוק?
ברירת מחדל של --remote_bytestream_uri_prefix=<a string>: תיאור
שם המארח ושם המופע לשימוש ב-URI של בייט-בייט שכתובים במקורות נתונים של אירועים. אפשר להגדיר את האפשרות הזו כשמבצעים גרסאות build באמצעות שרת proxy. כתוצאה מכך, הערכים של -remote_executor ו--remote_instance_name לא תואמים יותר לשם הקנוני של שירות הביצוע מרחוק. אם היא לא מוגדרת, ברירת המחדל היא "${hostname}/${instance_name}".
ברירת מחדל של --remote_cache=<a string>: תיאור
URI של נקודת קצה לשמירה במטמון. הסכימות הנתמכות הן http, https, grpc, grpcs (grpc עם TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. מציינים grpc://, http:// או Unix: כדי להשבית TLS. כדאי לעיין בכתובת 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_properties.
תגים: affects_outputs
ברירת מחדל של --remote_default_platform_properties=<a string>: ""
מגדירים את מאפייני הפלטפורמה שמוגדרים כברירת מחדל ל-API לביצוע מרחוק, אם פלטפורמת הביצוע לא מוגדרת עדיין Remote_execution_property. המערכת תשתמש בערך הזה גם אם פלטפורמת המארח נבחרה כפלטפורמת ההפעלה לביצוע מרחוק.
נצברו --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>: תיאור
מארח או מתארח:יציאה של נקודת קצה להפעלה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. צריך לציין grpc:// או Unix: כדי להשבית TLS.
נצברו --remote_header=<a 'name=value' assignment> שימושים מרובים
יש לציין כותרת שתיכלל בבקשות: --remote_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
ברירת מחדל של --remote_instance_name=<a string>: ""
הערך שמועבר כ-Instance_name ב-API לביצוע מרחוק.
ברירת מחדל של --[no]remote_local_fallback: "false"
האם לחזור לשיטה עצמאית של הפעלה מקומית אם ביצוע ההעברה מרחוק נכשל?
ברירת מחדל של --remote_local_fallback_strategy=<a string>: "local"
לא, הוצא משימוש. פרטים נוספים זמינים בכתובת 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>: תיאור
מתחברים למטמון המרוחק דרך שרת proxy. כרגע אפשר להשתמש בסימון הזה רק כדי להגדיר שקע דומיין (Unix:/path/to/socket) ב-Unix:
ברירת מחדל של --remote_result_cache_priority=<an integer>: "0"
העדיפות היחסית של פעולות מרוחקות שנשמרו במטמון מרוחק. הסמנטיקה של ערכי העדיפות הספציפית היא תלויה בשרת.
ברירת מחדל של --remote_retries=<an integer>: "5"
מספר הניסיונות המקסימלי לנסות שוב שגיאה זמנית. אם המדיניות מוגדרת כ-0, ניסיונות חוזרים מושבתים.
ברירת מחדל של --remote_timeout=<An immutable length of time.>: "60s"
משך הזמן המרבי להמתנה לביצוע מרחוק ולשיחות במטמון. למטמון REST, זהו גם החיבור וגם הזמן הקצוב לתפוגה של קריאה. אפשר להשתמש ביחידות הבאות: ימים (d), שעות (h), דקות (m), שניות (s) ואלפיות שנייה (אלפיות השנייה). אם משמיטים את היחידה, הערך מפורש כשניות.
ברירת מחדל של --[no]remote_upload_local_results: "true"
האם להעלות למטמון המרוחק תוצאות של פעולות שבוצעו באופן מקומי?
ברירת מחדל של --[no]remote_verify_downloads: "true"
אם היא מוגדרת כ-true, Bazel תחשב את סכום הגיבוב של כל ההורדות המרוחקות ותשליך את הערכים השמורים במטמון מרחוק אם הם לא תואמים לערך הצפוי.
אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
ברירת מחדל של --deleted_packages=<comma-separated list of package names>: ""
רשימה של שמות של חבילות, מופרדים בפסיקים, שמערכת ה-build תתייחס אליהם שאינם קיימים, גם אם הם מוצגים במקום כלשהו בנתיב החבילה. כדאי להשתמש באפשרות הזו כשמוחקים חבילת משנה 'x/y' של חבילה קיימת 'x' לדוגמה, לאחר מחיקת x/y/BUILD בלקוח, מערכת ה-build עשויה להתלונן אם היא תיתקל בתווית '//x:y/z' אם היא עדיין מסופקת על ידי ערך package_path אחר. ציון [delete_packs x/y] מונע את הבעיה הזו.
ברירת מחדל של --disk_cache=<a path>: תיאור
נתיב לספרייה שבה Bazel יכולה לקרוא ולכתוב פעולות ופלטי פעולות. אם הספרייה לא קיימת, היא תיווצר.
נצברו --experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.> שימושים מרובים
הגדרת עזרה לגבי פרטי כניסה לשימוש באחזור פרטי הכניסה של ההיקף (דומיין). פרטי כניסה מ-credentials Credentials מקבלים קדימות על פני פרטי כניסה מ-<code>--google_default_credentials</code>, `--google_credentials' או <code>.netrc</code>. אפשר לראות אותם בכתובת https://github.com/bazelbuild/proposs22sper-help-credential-credential-credential-credential-login-s
ברירת מחדל של --experimental_credential_helper_cache_duration=<An immutable length of time.>: "30m"
ההגדרה קובעת את משך הזמן שבו פרטי הכניסה ששמורים ב'פרטי כניסה' יישמרו במטמון.
ברירת מחדל של --experimental_credential_helper_timeout=<An immutable length of time.>: "5s"
הגדרת הזמן הקצוב לתפוגה עבור 'פרטי הכניסה'. עוזרי הכניסה שלא יגיבו בזמן הקצוב לתפוגה ייכשלו.
ברירת מחדל של --google_auth_scopes=<comma-separated list of options>: "https://www.googleapis.com/auth/cloud-platform"
רשימה של היקפי אימות ב-Google Cloud, המופרדים באמצעות פסיקים.
ברירת מחדל של