bazel [<startup options>] <command> [<args>]או
bazel [<startup options>] <command> [<args>] -- [<target patterns>]ניתן לעיין במדריך המשתמש>התחביר של דפוסי יעדים.
תחביר אופציונלי
ניתן להעביר אפשרויות ל-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 |
הצגת פרטי זמן ריצה על שרת ה-bazel. |
license |
מדפיס את הרישיון של התוכנה הזו. |
mobile-install |
התקנת יעדים לניידים. |
print_action |
מדפיס את שורות הפקודה עבור הידור קובץ. |
query |
ביצוע שאילתה בתרשים תלות. |
run |
מפעיל את היעד שצוין. |
shutdown |
מפסיק את שרת ה-bazel. |
sync |
סנכרון כל המאגרים שצוינו בקובץ סביבת העבודה |
test |
יוצר ומריץ את יעדי הבדיקה שצוינו. |
version |
מדפיס פרטי גרסה של bzel. |
אפשרויות הפעלה
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--[no]autodetect_server_javabase
כברירת מחדל: "true"-
כשמעבירים -noautodetect_server_JavaScriptbase, 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. המדיניות הזו שימושית לעומסי עבודה שאינם אינטראקטיביים, אך לא מעוניינים להוריד את הערך הנחמד שלהם. לעיון ב 'man 2 sced_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"-
אם זה נכון, צריך לרשום את פרטי ניפוי הבאגים מהלקוח ל-std. שינוי האפשרות הזו לא יגרום להפעלה מחדש של השרת.
תגים: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"-
השבתת כל קובצי ה-SR, ללא קשר לערכים של סימונים אחרים המשמשים לשינוי מעגלים, גם אם הסימונים האלה מופיעים מאוחר יותר ברשימת האפשרויות להפעלה.
תגים: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 לשרת ה-bazel בזמן ההפעלה ב-macOS. סימון זה לא משפיע על כל הפלטפורמות האחרות, אבל הוא נתמך כדי לוודא שאפשר לשתף קובצי ARC ביניהם ללא שינויים. הערכים האפשריים הם: משתמש-אינטראקטיבי, ביוזמת המשתמש, ברירת מחדל, כלי עזר ורקע.
תגים:host_machine_resource_optimizations
--max_idle_secs=<integer>
כברירת מחדל: "10800"-
מספר השניות ששרת ה-build ימתין למצב 'לא פעיל' לפני הכיבוי. אפס פירושו שהשרת אף פעם לא ייסגר. האפשרות הזו נקראת רק בזמן ההפעלה של השרת. שינוי האפשרות הזו לא יגרום להפעלה מחדש של השרת.
תגים:eagerness_to_exit
,loses_incremental_state
- ברירת מחדל של
--output_base=<path>
: הצגת תיאור -
אם המדיניות מוגדרת, היא מציינת את מיקום הפלט שבו ייכתבו כל פלט ה-build. אחרת, המיקום יהיה ${OUTPUT_ROOT}/_laze_${USER}/${MD5_OF_WORKSPACE_ROOT}. הערה: אם תציינו אפשרות אחרת מהערך 'הפעלה ב-Bazel' הבאה עבור הערך הזה, סביר להניח שתפעילו שרת Bazel חדש נוסף. Bazel מפעילה שרת אחד בלבד לכל בסיס פלט שצוין. בדרך כלל יש בסיס פלט אחד לכל סביבת עבודה – עם זאת, באמצעות אפשרות זו עשויים להיות בסיסים מרובים של פלט לכל סביבת עבודה, ולכן תפעילו מספר גרסאות build עבור אותו לקוח בו-זמנית באותו מחשב. הוראות לשימוש בכיבוי של שרת Bazel&&399;bazel
תגים:affects_outputs
,loses_incremental_state
- ברירת מחדל של
--output_user_root=<path>
: הצגת תיאור -
הספרייה הספציפית למשתמש שתחתיה כל פלטי build כתובים; כברירת מחדל, זוהי פונקציה של $USER, אבל על ידי ציון פלט קבוע, ניתן לשתף פלט בצורה משותפת בין משתמשים המשתפים פעולה.
תגים:affects_outputs
,loses_incremental_state
--[no]preemptible
כברירת מחדל: "false"-
אם הערך הוא True, ניתן להוציא את הפקודה מראש אם מתחילה פקודה אחרת.
תגים:eagerness_to_exit
- ברירת מחדל של
--server_jvm_out=<path>
: הצגת תיאור -
המיקום שבו יש לכתוב את הפלט של השרת של ה-JVM&. אם המדיניות לא מוגדרת, ברירת המחדל היא מיקום ב-Output_base.
תגים: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"-
אם הדבר נכון, מערכת Bazel מנסה להשתמש בשירות הצפייה בקבצים במערכת ההפעלה כדי לבצע שינויים מקומיים, במקום לסרוק את כל הקבצים.
תגים:deprecated
--[no]windows_enable_symlinks
כברירת מחדל: "false"-
אם קישורים אמיתיים ומשמעותיים יופקו ב-Windows במקום בהעתקת הקובץ. צריך להפעיל את מצב 'מפתח' של Windows ואת 1703 ומעלה של Windows 10.
תגים:bazel_internal_configuration
--[no]workspace_rc
כברירת מחדל: "true"-
אפשר לחפש את קובץ ה-bazelrc של סביבת העבודה בכתובת $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>
כברירת מחדל: ""- אפשרות נוחות להוסיף מספר התרעות ההפעלה מסוג JVM ספציפיות לניפוי באגים/ניפוי באגים. ל-Bazel יש רשימה של ערכים מוכרים שהיא ממפה לדגימות הסטארט-אפ של JVM בתוך הקוד, וייתכן שהיא מחפשת קבצים מסוימים בתוך הקוד של קבצים מסוימים.
--server_javabase=<jvm path>
כברירת מחדל: ""- נתיב ל-JVM המשמש לביצוע Bazel עצמו.
אפשרויות נפוצות לכל הפקודות
- אפשרויות השולטות בביצוע גרסאות:
--experimental_oom_more_eagerly_threshold=<an integer>
כברירת מחדל: "100"-
אם הדגל הזה מוגדר לערך הקטן מ-100, Bazel יבצע OOM אם לאחר שני פריטים מלאים של GC' יותר מאחוז הזה של הערימה (דור קודם) עדיין נמצא בתפוסה.
תגים:host_machine_resource_optimizations
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
default: "1048576"-
הגודל המקסימלי של קובצי sTDout / std שיהיו מודפסים במסוף. -1 אינו מרמז על הגבלה.
תגים:execution
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, ולהשפיע על הערך שלו, במקום הקיום שלו:
- נצברו
--repo_env=<a 'name=value' assignment with an optional value part>
שימושים מרובים -
ההגדרה מציינת משתני סביבה נוספים שיהיו זמינים רק לכללים של מאגר נתונים. חשוב לזכור שכללי מאגרים רואים את הסביבה המלאה בכל זאת, אבל כך ניתן להעביר את פרטי התצורה למאגרים באמצעות אפשרויות בלי לבטל את תרשים הפעולות.
תגים:action_command_lines
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build, שאליו ניתן לגשת לקובצי BUILD, קובצי .bzl או WORKSPACE.
--[no]experimental_action_resource_set
כברירת מחדל: "true"-
אם היא מוגדרת כ-true, ctx.actions.run() ו-ctx.actions.run_shell() מקבלים פרמטרResource_set לביצוע מקומי. אחרת, ברירת המחדל תהיה 250 MB של זיכרון ומעבד אחד.
תגים:execution
,build_file_semantics
,experimental
-
אם היא מוגדרת כ-true, התגים יופצו מיעד לפעולות " #39"; אחרת התגים לא יופצו. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/8830.
תגים:build_file_semantics
,experimental
-
אם המדיניות מוגדרת כ-True, המאפיינים של הכללים והשיטות של 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_google_legacy_api
כברירת מחדל: "false"-
אם היא מוגדרת כ-true, המערכת חושפת מספר חלקים ניסיוניים של Starlark API הנוגעים לקוד מדור קודם של Google.
תגים:loading_and_analysis
,experimental
--[no]experimental_platforms_api
כברירת מחדל: "false"-
אם היא מוגדרת כ-true, מפעילים מספר ממשקי API שקשורים ל-Starlark הקשורים לניפוי באגים.
תגים:loading_and_analysis
,experimental
--[no]experimental_repo_remote_exec
כברירת מחדל: "false"-
אם המדיניות מוגדרת כ-True, ל-מאגר_rule יש יכולות מסוימות של ביצוע מרחוק.
תגים:build_file_semantics
,loading_and_analysis
,experimental
--[no]experimental_sibling_repository_layout
כברירת מחדל: "false"-
אם היא מוגדרת כ-true, מאגרים לא ראשיים נטועים כקישורים כמאגר למאגר הראשי של הביצוע. כלומר, כל המאגרים הם צאצאים ישירים של ספריית $Output_base/execution_root. יש לכך תופעות לוואי של פינוי $Output_base/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"-
צריך לבדוק את תוקף הרכיבים שנוספו לתיבות בתוך כל המבנים. הרכיבים חייבים להיות ללא שינוי, אך בעבר המרכיב(dep=...) של הבונה הפרטי שכח לבדוק אותם. יש להשתמש בצמידים במקום ברשימות ברכיבי שיפוע. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/10313.
תגים:build_file_semantics
,incompatible_change
--[no]incompatible_depset_for_libraries_to_link_getter
כברירת מחדל: "true"-
כשהאפשרות מוגדרת כ-TRUE, מערכת Bazel כבר לא מחזירה רשימה מהכתובת link_context.libraries_to_link אלא במקום זאת מוגדר מערך ספרות.
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_managed_directories
כברירת מחדל: "true"-
אם היא מוגדרת כ-True, המאפיין של סביבת העבודה(managed_directories=) מושבת.
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_disable_starlark_host_transitions
כברירת מחדל: "false"-
אם היא מוגדרת כ-true, מאפייני הכללים לא יכולים להגדיר 'cfg = "host"'. צריך להגדיר כללים '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_disable_third_party_license_checking
כברירת מחדל: "true"-
אם הערך הוא True, מושבת כל הלוגיקה של בדיקת הרישיונות
תגים: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, הפרמטרים local.existing_rule ו-Native.existing_rules מחזירים אובייקטים פשוטים של תצוגה שאינה משתנה ולא מכרעים משתנים.
תגים:build_file_semantics
,loading_and_analysis
,incompatible_change
--[no]incompatible_java_common_parameters
כברירת מחדל: "true"-
אם המדיניות מוגדרת כ-True, יוסרו הפרמטרים של המארח_פלט_של ו-host_Javabase ב-pack_source ו-host_JavaScriptbase.
תגים:build_file_semantics
,incompatible_change
--[no]incompatible_linkopts_to_linklibs
כברירת מחדל: "true"-
אם היא מוגדרת כ-true, ה-linkouts המוגדרים כברירת מחדל בארגז הכלים המוגדר כברירת מחדל מועברים כ-linkils במקום קישורים ל-cc_toolschain_config
תגים:action_command_lines
,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-ability.md
תגים:build_file_semantics
,incompatible_change
--[no]incompatible_no_rule_outputs_param
כברירת מחדל: "false"-
אם היא מוגדרת כ-True, משביתה את הפרמטר `Outputs` בפונקציה `rule()` Starlark.
תגים:build_file_semantics
,incompatible_change
--[no]incompatible_require_linker_input_cc_api
כברירת מחדל: "true"-
אם המדיניות מוגדרת כ-true, הכלל Create_linking_context יחייב linker_inputs במקום Inputs_to_link. גם הכלים הישנים של link_context יושבתו, ורק הקישור link__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_struct_has_no_methods
כברירת מחדל: "false"-
השבתת השיטות to_json ו-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, ההיבט ברמה העליונה יכבד את הספקים הנדרשים והיא תפעל רק על יעדים ברמה העליונה שהכללים של החברה בנוגע אליהם עומדים בכללים של #&99; הספקים הרשומים עומדים בדרישות של הספקים האלה.
תגים: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) שמעליו ייכשל ה-conpset() .
תגים:loading_and_analysis
- אפשרויות שגורמות לאופטימיזציה של זמן ה-build:
--[no]incompatible_do_not_split_linking_cmdline
כברירת מחדל: "true"-
אם הערך הוא true, Bazel לא משנה עוד את הסימונים של שורת הפקודה המשמשים לקישור, וגם לא מחליטה באופן סלקטיבי אילו סימונים עוברים לקובץ הפרמטר ואילו לא. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/7670.
תגים:loading_and_analysis
,incompatible_change
--[no]keep_state_after_build
כברירת מחדל: "true"-
אם הערך הוא False, התכונה Blaze תמחק את מצב הזיכרון מה-build עם סיום ה-build. לגרסאות build עוקבות לא יהיה ערך מצטבר לגבי זה.
תגים:loses_incremental_state
--skyframe_high_water_mark_threshold=<an integer>
כברירת מחדל: "85"-
סימון להגדרה מתקדמת של מנוע Skyframe הפנימי של Bazel. אם Bazel מזהה את השימוש באחוזים של הערימה (heap) שנותרה בערך הסף הזה, היא מבטלת את המצב הזמני של Skyframe. השינוי הזה מאפשר לך לצמצם את ההשפעה על פונקציית GC לצורך מיצוי זמן הקיר, כאשר כתובות ה-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"-
האם אפשר להודיע על אפשרויות מעגל?
תגים: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 תניח נקודות GRP.
תגים:affects_outputs
--[no]bes_check_preceding_lifecycle_events
כברירת מחדל: "false"-
ההגדרה של השדה test_preceding_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_outerr_buffer_size=<an integer>
כברירת מחדל: "10240"-
ההגדרה קובעת את הגודל המרבי של ה-stdout או ה-std לצפייה במאגר הנתונים הזמני, לפני שדווח על כך כאירוע התקדמות. פעולות כתיבה נפרדות עדיין מדווחות באירוע יחיד, גם אם הן גדולות מהערך שצוין עד -bes_outerr_chunk_size.
תגים:affects_outputs
--bes_outerr_chunk_size=<an integer>
default: "1048576"-
ההגדרה קובעת את הגודל המקסימלי של האפקט stdout או std.
תגים:affects_outputs
- ברירת מחדל של
--bes_proxy=<a string>
: הצגת תיאור - יש להתחבר לשירות ליצור אירועים באמצעות שרת proxy. בשלב זה, ניתן להשתמש בסימון הזה רק כדי להגדיר שקע דומיין Unix (unix:/path/to/socket).
--bes_results_url=<a string>
כברירת מחדל: ""-
ההגדרה קובעת את כתובת ה-URL הבסיסית שבה המשתמש יכול לראות את המידע המשודר לקצה העורפי של BES. Bazel תייצר פלט של כתובת ה-URL שתצורף למסוף על ידי מזהה ההפעלה.
תגים:terminal_output
--bes_timeout=<An immutable length of time.>
כברירת מחדל: "0s"-
ההגדרה קובעת את משך הזמן שבו ההעלאה בפורמט BES/BEP תסתיים עם סיום ה-build והבדיקות. זמן קצוב לתפוגה הוא מספר טבעי ואחריו יחידה: ימים (d), שעות (h), דקות (m), שניות (s) ואלפיות שנייה (ms). ערך ברירת המחדל הוא '0' כלומר, אין זמן קצוב לתפוגה.
תגים:affects_outputs
--build_event_binary_file=<a string>
כברירת מחדל: ""-
אם הקובץ לא ריק, יש לכתוב ייצוג בינארי של ערכים מופרדים בפסיקים של פרוטוקול האירוע של Build. המשמעות של האפשרות הזו היא --bes_upload_mode=Wait_for_upload_complete.
תגים:affects_outputs
--[no]build_event_binary_file_path_conversion
כברירת מחדל: "true"-
אפשר להמיר נתיבים בייצוג של קבצים בינאריים של פרוטוקול אירוע Build ל-URI תקף יותר בכל העולם; אם האפשרות מושבתת, תמיד ייעשה שימוש בסכימת הקובץ:// URI
תגים:affects_outputs
--build_event_json_file=<a string>
כברירת מחדל: ""-
אם הקובץ לא ריק, צריך לכתוב את הסדרה שלו ב-JSON כפרוטוקול ל-build של האירוע.
תגים:affects_outputs
--[no]build_event_json_file_path_conversion
כברירת מחדל: "true"-
אפשר להמיר נתיבים בייצוג של קובץ json של פרוטוקול אירוע 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 גלובלי חוקי יותר כשאפשר. אם האפשרות מושבתת, הסכימה של file:// URI תמיד תשמש
תגים:affects_outputs
--[no]experimental_announce_profile_path
כברירת מחדל: "false"-
אם האפשרות מופעלת, המערכת מוסיפה ליומן את נתיב פרופיל ה-JSON.
תגים:affects_outputs
,bazel_monitoring
--[no]experimental_bep_target_summary
כברירת מחדל: "false"- אם רוצים לפרסם אירועי Target סיכום.
--[no]experimental_build_event_expand_filesets
כברירת מחדל: "false"-
אם הקובץ מוגדר כ-True, יש להרחיב את Fileslet ב-BEP כשמציגים קובצי פלט.
תגים:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
כברירת מחדל: "false"-
אם הערך הוא True, יש לסמן באופן מלא את הסמלים היחסיים של Fileset ב-BEP כשמציגים קובצי פלט. יש צורך ב--Experimental_build_event_expand_filesets.
תגים:affects_outputs
- ברירת מחדל של
--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, 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 or unknown>
שימושים מרובים -
קביעת משימות פרופיל נוספות שייכללו בפרופיל.
תגים:affects_outputs
,bazel_monitoring
--[no]experimental_profile_include_primary_output
כברירת מחדל: "false"-
כולל את המאפיין "out" באירועי פעולה המכיל את נתיב ה-exec לפלט הראשי של הפעולה'.
תגים: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 כקובצי proxy מופרדים ב-WorkspaceEvent.
--[no]generate_json_trace_profile
כברירת מחדל: "auto"-
אם האפשרות מופעלת, אפליקציית Bazel יוצרת פרופיל build וכותבת פרופיל בפורמט JSON לקובץ בבסיס הפלט. כדי להציג את הפרופיל, טוענים ל-chrome://tracing. כברירת מחדל, Bazel כותבת את הפרופיל לכל הפקודות והשאילתות הדומות ל-build.
תגים:affects_outputs
,bazel_monitoring
--[no]heap_dump_on_oom
כברירת מחדל: "false"-
אם רוצים לפלט באופן ידני תמונת מצב של ערימה (heap) אם נשלף קובץ OOM (כולל OOM בגלל הסיבה: – experimental_oom_more_eagerly_threshold). המזבלה תיכתב כך <Output_base>/<invocation_id>.heapdump.hprof. האפשרות הזו מחליפה בפועל את -XX:+HeapDumpOnOutOfMemoryError, שאין לה השפעה כי OOMs נקלט ומופנה מחדש אל Runtime#halt.
תגים:bazel_monitoring
--[no]legacy_important_outputs
כברירת מחדל: "true"-
אפשר להשתמש באפשרות זו כדי למנוע יצירה של שדה חשוב_פלטים קודם באירוע Targetcomplete. נדרשים שילובs
תגים:affects_outputs
--logging=<0 <= an integer <= 6>
כברירת מחדל: "3"-
רמת הרישום ביומן.
תגים:affects_outputs
--memory_profile_stable_heap_parameters=<two integers, separated by a comma>
כברירת מחדל: "1,0"-
כוונון הפרופיל של הערימה (heap) של הערימה היציבה בסוף הבנייה. צריכים להיות שני מספרים שלמים המופרדים בפסיקים. הפרמטר הראשון הוא מספר GC לביצוע. הפרמטר השני הוא מספר השניות שיש להמתין בין GC.
תגים:bazel_monitoring
- ברירת מחדל של
--profile=<a path>
: הצגת תיאור -
אם המדיניות מוגדרת, יוצרים פרופיל Bazel וכותבים נתונים לקובץ שצוין. אפשר להשתמש ב-Bazel Analysis Profile כדי לנתח את הפרופיל.
תגים:affects_outputs
,bazel_monitoring
--[no]slim_profile
כברירת מחדל: "true"-
אם הפרופיל גדול מדי, אפשר להקטין את הפרופיל של JSON על ידי מיזוג אירועים.
תגים:affects_outputs
,bazel_monitoring
--starlark_cpu_profile=<a string>
כברירת מחדל: ""-
כותב לקובץ שצוין פרופיל שימוש במעבד עבור כל השרשורים של 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
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות::
--all_incompatible_changes
-
לא, מתבצעת הסרה. אפשר לעיין כאן: https://github.com/bazelbuild/bazel/issues/13892
תגים:no_op
,incompatible_change
- נצברו
--build_metadata=<a 'name=value' assignment>
שימושים מרובים -
צמדים של מחרוזת מפתח-ערך בהתאמה אישית שיש לספק באירוע build.
תגים:terminal_output
--color=<yes, no or auto>
כברירת מחדל: "auto"- ניתן להשתמש בפקדי המסוף כדי לשנות את צבע הפלט.
- נצברו
--config=<a string>
שימושים מרובים - בוחרת קטעי config נוספים מקובצי ה-rc; עבור כל <command> הוא גם מאחזר אפשרויות מתוך <command>:<config> אם קטע כזה קיים; אם הקטע הזה לא קיים בקובץ rc, 'בלז' נכשל עם שגיאה. קטעי ה-config והשילובים המקבילים שלהם ממוקמים בקובצי התצורה 'כלים/*.blzerc'.
--curses=<yes, no or auto>
כברירת מחדל: "auto"- ניתן להשתמש בפקדי הסמן של המסוף כדי למזער את פלט הגלילה.
--[no]enable_platform_specific_config
כברירת מחדל: "false"- אם הערך הוא true, Bazel אוספת שורות תצורה ספציפיות ל-host-OS מקובצי bazelrc. לדוגמה, אם מערכת ההפעלה של המארח היא Linux ואתם מפעילים גרסת bazel, ה-Bazel אוספת שורות המתחילות ב-build:linux. מזהי ה-OS הנתמכים הם Linux, macos, Windows, freebsd ו-openbsd. הפעלת הדגל הזה זהה לשימוש ב- --config=linux ב-Linux, --config=windows ב-Windows וכו'.
--[no]experimental_windows_watchfs
כברירת מחדל: "false"- אם הערך הוא True, מופעל תמיכה ניסיונית של Windows עבור --watchfs. אחרת --watchfsis is no 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 אחת בהמתנה. זמנים מתייחסים לרמת פירוט של שנייה. שגיאה בהגדרה של ערך שאינו שנייה. כברירת מחדל, פינגים פעילים. לפני שמפעילים את ההגדרה הזו, צריך לתאם עם הבעלים של השירות.
--grpc_keepalive_timeout=<An immutable length of time.>
כברירת מחדל: "20s"- הגדרת זמן קצוב לתפוגה של חיבורים פעילים של gRPC. אם פינגים מסוג keep-alive מופעלים באמצעות --grpc_keepalive_time, סימן ש-Bazel תם הזמן הקצוב לחיבור אם הוא לא מקבל תשובה בפינגים אחרי פרק הזמן הזה. זמנים מתייחסים לרמת פירוט של שנייה. שגיאה בהגדרה של ערך שאינו שנייה. אם פינגים פעילים נשמרים, המערכת תתעלם מההגדרה הזו.
--[no]progress_in_terminal_title
כברירת מחדל: "false"- אפשר להציג את התקדמות הפקודה בכותרת של המסוף. מועיל לראות מה קורה במצב בסיסי כאשר יש לך כמה כרטיסיות מסוף.
--[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. בכל מערכת הפעלה: ההתנהגות לא מוגדרת אם סביבת העבודה נמצאת במערכת קבצים ברשת, והקבצים עורכים במחשב מרוחק.
ניתוח פרופיל
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--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
תגים:no_op
,deprecated
,experimental
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת המחדל של
--dump=<text or raw>
[-d
]: תיאור -
פלט קובץ של נתוני פרופיל מלא בפורמט הקריא אנושי 'text' בפורמט 'raw'
תגים: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` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות שאילתה
היא מקבלת בירושה את כל האפשרויות מ-build.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--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
תגים:no_op
,deprecated
,experimental
- אפשרויות הקשורות לפלט שאילתה ולסמנטיקה:
--aspect_deps=<off, conservative or precise>
כברירת מחדל: "שמרי"-
איך לפתור בעיות של יחס גובה-רוחב כשפורמט הפלט הוא {xml,proto,record}. 'off' כלומר, לא תלויות יחסי גובה-רוחב, 'שמרני' (ברירת המחדל) פירוש הדבר שכל התלות המוצהרות ביחס להיבטים מתווספות, בין אם הן קיבלו את סיווג הכללים תלויות חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, ולכן הוא איטי יותר מהמצבים האחרים. כמו כן, גם מצב מדויק אינו מדויק לגמרי: ההחלטה אם לחשב היבט מתקבלת על שלב בשלב הניתוח, שאינו פועל במהלך 'שאילתה'
תגים:build_file_semantics
--[no]deduplicate_depsets
כברירת מחדל: "true"-
צריך לבטל כפילויות של ילדים ללא עלים בדף dep_set_of_files בפלט הסופי של proto/textproto/json. הפעולה הזו לא מבטלת כפילויות של דיפסות שלא חולקות הורה מיידי. פעולה זו לא משפיעה על הרשימה הסופית הסופית של פריטי קלט של הפעולות.
תגים:terminal_output
--[no]graph:factored
כברירת מחדל: "true"-
אם הערך הוא True, התרשים יוסר אפשרות זו רלוונטית רק ל- --Output=graph.
תגים:terminal_output
--graph:node_limit=<an integer>
כברירת מחדל: "512"-
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; -1 פירושו חיתוך. אפשרות זו רלוונטית רק ל- --Output=graph.
תגים:terminal_output
--[no]implicit_deps
כברירת מחדל: "true"-
אם אפשרות זו מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלויות שבו השאילתה פועלת. תלות משתמעת היא לא מצוינת במפורש בקובץ BUILD, אבל מתווספת על ידי Bazel. עבור שאילתה, אפשרות זו שולטת בסינון מחזיקי כלים שנפתרו.
תגים:build_file_semantics
--[no]include_artifacts
כברירת מחדל: "true"-
כולל שמות של הקלט והפלט של הפעולות בפלט (אולי בעתיד).
תגים:terminal_output
--[no]include_aspects
כברירת מחדל: "true"-
query, cquery: אם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: לא-תפעול (תמיד מתבצע מעקב אחר היבטים).
תגים:terminal_output
--[no]include_commandline
כברירת מחדל: "true"-
כוללת את התוכן של שורות פקודות הפעולה בפלט (אולי בעתיד).
תגים:terminal_output
--[no]include_param_files
כברירת מחדל: "false"-
יש לכלול את תוכן קובצי הפרמטרים שנעשה בהם שימוש בפקודה (פוטנציאלית). הערה: הפעלה של סימון זה תפעיל את התכונה הניסיונית --include_commandline באופן אוטומטי.
תגים:terminal_output
--[no]incompatible_display_source_file_location
כברירת מחדל: "true"-
ברירת המחדל היא הצגת היעד של קובץ המקור. אם הערך הוא True, מוצג המיקום של שורה 1 של קובצי המקור בפלט המיקום. הסימון הזה קיים רק למטרות מיגרציה.
תגים:terminal_output
,incompatible_change
--[no]infer_universe_scope
כברירת מחדל: "false"-
אם היא מוגדרת ו-unis_scope לא מוגדרת, הערך של לתשומת ליבכם, הערך --universe_scope שמתקבל עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, 'allrdeps')) עשוי להיות לא מה שאתם רוצים, ולכן מומלץ להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים נוספים ודוגמאות זמינים בכתובת https://bazel.build/versions/reference/query#sky-query אם --universe_scope מוגדר, המערכת תתעלם מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'query' (כלומר, לא 'cquery`).
תגים:loading_and_analysis
--[no]line_terminator_null
כברירת מחדל: "false"-
אם כל פורמט יסתיים ב-\0 במקום בשורה חדשה.
תגים:terminal_output
--[no]nodep_deps
כברירת מחדל: "true"-
אם המדיניות מופעלת, נקודות מדדים של "nodep" ייכללו בתרשים התלויות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep" &"ability" אפשר להריץ ולנתח את הפלט של 'info-language' כדי לקבל מידע על כל המאפיינים "nodep" בשפת הבנייה.
תגים:build_file_semantics
--output=<a string>
כברירת מחדל: "text"-
הפורמט שבו יש להדפיס את תוצאות השאילתות. הערכים המותרים לשאילתת החיפוש הם: טקסט, טקסטפרו, פרוטו, jsonproto.
תגים:terminal_output
--[no]proto:default_values
כברירת מחדל: "true"-
אם הערך הוא True, המערכת תכללו מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- -Output=proto
תגים:terminal_output
--[no]proto:definition_stack
כברירת מחדל: "false"-
אכלוס השדה proto-stack של הפרוטוקול, שבו מתועדת כל מופע של כלל ה-Starlark ברגע שהוגדרה המחלקה לכלל.
תגים: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"-
רשימת מאפיינים מופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להפיק פלט אף מאפיין. אפשרות זו רלוונטית ל--Output=proto.
תגים:terminal_output
--[no]proto:rule_inputs_and_outputs
כברירת מחדל: "true"-
האם אפשר לאכלס את השדותכלל_קלט וכלל_פלט.
תגים:terminal_output
--[no]relative_locations
כברירת מחדל: "false"-
אם הערך הוא True, המיקום של קובצי BUILD בפלט XML ו-Proto יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא עקבי במכונות שונות. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במחשבים שונים.
תגים:terminal_output
--[no]skyframe_state
כברירת מחדל: "false"-
בלי לבצע ניתוח נוסף, משחררים את תרשים הפעולות הנוכחי מ-Skyframe. הערה: אין כרגע תמיכה בציון יעד באמצעות --skyframe_state. הסימון הזה זמין רק באמצעות
תגים:terminal_output
--[no]tool_deps
כברירת מחדל: "true"-
שאילתה: אם היא מושבתת, יחסי תלות ב&&39;תצורת מארח' או 'execution' יעדים לא ייכללו בתרשים התלויות שבו השאילתה פועלת. קצה 'הגדרת מארח' תלות, כמו הכלל מכל &&39;proto_library' לרוב, המהדר של הפרוטוקול, מצביע על כלי שנערך במהלך הבנייה ולא על חלק מאותה תוכנית 'target'
שאילתה: אם אפשרות זו מושבתת, מסננים את כל היעדים שהוגדרו שעוברים את המארח או את ההעברה מהיעד ברמה העליונה שגילו את היעד המוגדר. כלומר, אם היעד ברמה העליונה נכלל בהגדרת הטירגוט, יוחזרו רק יעדים שהוגדרו. אם היעד ברמה העליונה נמצא בתצורת המארח, יוחזרו רק יעדים שהוגדרו על ידי המארח. אפשרות זו לא תחריג מחזיקי כלים שנפתרו.
תגים:build_file_semantics
--universe_scope=<comma-separated list of options>
כברירת מחדל: ""-
קבוצה של דפוסי יעד מופרדים בפסיקים (תוספתיים וירידה). השאילתה יכולה להתבצע ביקום המוגדר על ידי הסגירה העקיפה של היעדים שצוינו. האפשרות הזו משמשת לפקודות השאילתה ולשאילתות השאילתה.
בשאילתה מסוג 'שאילתה', הקלט באפשרות זו הוא היעדים המובנים בכל התשובות, לכן האפשרות הזו עשויה להשפיע על ההגדרות ועל המעברים. אם אפשרות זו לא צוינה, היעדים ברמה העליונה נחשבים כיעדים ולנתח אותם מתוך ביטוי השאילתה. הערה: לגבי שאילתה, אם לא מציינים את האפשרות הזו, ייתכן שה-build של התוכנה ייפגע אם לא ניתן יהיה לבנות יעדים מתוך ביטוי השאילתה עם אפשרויות ברמה עליונה.
תגים:loading_and_analysis
- אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום ביומן:
--[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` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
- אפשרויות ששולטות בביצוע גרסאות:
--[no]experimental_inprocess_symlink_creation
כברירת מחדל: "false"-
האם אפשר להתקשר ישירות למערכת קבצים כדי ליצור עצים סימליים
תגים: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"-
אם האפשרות הזו מופעלת, Files יתייחסו לכל פריטי הפלט כקבצים רגילים. הם לא יעבירו ספריות ורגישים לקישורים.
תגים:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
כברירת מחדל: ""-
הוספה או הסרה של מפתחות מתוך פרטי הביצוע של הפעולה, על סמך פעולת הפעולה. חל רק על פעולות שתומכות בפרטי הביצוע. פעולות נפוצות רבות תומכות בפרטי ביצוע, כמו Genrule, CppCompile, Javac, StarlarkAction, TestRunner. כשמציינים ערכים מרובים, הסדר חשוב כי ביטויים רגולריים רבים עשויים לחול על אותו אמצעי.
תחביר: "regex=[ +-]key,regex=[+-]key,...".
לדוגמה:
'.*=+x,.*=-y,.*=+z' מוסיף 'x' &'z ' אל ומסירים את פרטי הביצוע של ##99;y'
'Genrule=+requires-x'add 'requires-x' לפרטי הביצוע של כל פעולות הז'אנר.
'(?!Genrule).*=-requires-x' removed 'requires-x' מנתוני הביצוע של כל הפעולות שאינן כלליות.
תגים:execution
,affects_outputs
,loading_and_analysis
--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=ManifestMerger=worker
- ברירת מחדל של
--android_compiler=<a string>
: הצגת תיאור -
מהדר היעד של Android.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_crosstool_top=<a build target label>
: "//external:android/crosstools" -
המיקום של מהדר 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"-
קביעת SDK/פלטפורמה של Android שמשמשת לבניית אפליקציות ל-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:toolschain" -
התווית של חבילת הכלים השונים לשימוש בכללי 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_variable"-
המיקום של הקובץ הבינארי המשמש ליצירת דוחות כיסוי. נכון לעכשיו זו חייבת להיות קבוצת קבצים שמכילה קובץ אחד, הקובץ הבינארי. ברירת המחדל היא '//tools/test:coverage_report_variable'.
תגים: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:toolschain" -
התווית של חבילת הכלי המוצלב שבה יש להשתמש כדי להרכיב קוד C++.
תגים:loading_and_analysis
,changes_inputs
,affects_outputs
- ברירת מחדל של
--custom_malloc=<a build target label>
: הצגת תיאור -
ציון של הטמעה מותאמת אישית של Malloc. ההגדרה הזו מבטלת את המאפיינים של Malloc בכללי Build.
תגים:changes_inputs
,affects_outputs
- נצברו
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
שימושים מרובים -
רשימה של ביטויים רגולריים המופרדים בפסיקים, שאפשר להוסיף להם את הסימן - (ביטוי שלילי) כדי להקצות אותם (=) לרשימה של יעדי ערך אילוץ שמופרדים בפסיקים. אם יעד מסוים לא תואם לאף ביטוי שלילי ולפחות ביטוי חיובי אחד, רזולוציית הכלי תבוצע כאילו הוא הצהיר שערכי האילוץ הם אילוצי הביצוע. דוגמה: //demo,-test=@platforms//cpus:x86_64 יתווסף אל 'x86_64' לכל יעד השייך ל-//demo מלבד אלה שהשם שלהם מכיל 'test'.
תגים:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
כברירת מחדל: "true"-
מתן אפשרות לכללים 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 על ידיenroll_execution_platforms().
תגים:execution
- נצברו
--extra_toolchains=<comma-separated list of options>
שימושים מרובים -
הכללים של כלי הכלים שיש להתייחס אליהם במהלך פתרון הבעיות בכלי. ניתן לציין מחזיקי כלים לפי יעד מדויק, או כתבנית יעד. שרשראות הכלים האלה יילקחו בחשבון לפני הרשומות של קובץ ה-WORKSPACE על ידיenroll_toolschains().
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--grte_top=<a label>
: הצגת תיאור -
תווית לספריית Libc בצ'ק-אין. ערך ברירת המחדל נבחר על ידי ארגז הכלים של הכלי המוצלב, וכמעט לא תצטרכו לעקוף אותו.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_compiler=<a string>
: הצגת תיאור -
מהדר C++ המשמש לאיסוף הידור. המערכת מתעלמת מהפרמטר הזה אם --host_crosstools_top לא מוגדר.
תגים:loading_and_analysis
,execution
- ברירת מחדל של
--host_crosstool_top=<a build target label>
: הצגת תיאור -
כברירת מחדל, גם אפשרויות ה- --פיינק מהלך --ורכיב המהדר -- משמשות גם להגדרת המארח. אם סימון זה מופיע, ה-Bazel משתמש ב-libc ובמהדר המוגדר כברירת מחדל עבור ה-crosstools_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 לא תפעיל את &&39;host' 'nonhost' את C++ Toolchain (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/7407).
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
כברירת מחדל: "false"-
שימוש ברזולוציה של Toolchain כדי לבחור את ה-SDK ל-Android לכללי Android (Starlark ו-Native)
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
כברירת מחדל: "false"-
שימוש ברזולוציית כלים כדי לבחור את ה-SDK של Apple לכללי תפוחים (Starlark ומותאמות)
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
כברירת מחדל: "true"-
אם הערך הוא true, Bazel תשתמש שוב בשורות של פעולת הקישור ל-C++ כדי להוסיף לשורות הפקודה של Lto באינדקס (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/6791).
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
כברירת מחדל: "true"-
אם הערך הוא true, Bazel מתלונן כאשר מוגדרים המאפיינים cc_toolschain.cpu ו-cc_toolschain.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"-
אם הדבר נכון, מערכת Bazel תדרוש 'ctx'
תגים:loading_and_analysis
,incompatible_change
-
שימוש באובייקטים משותפים בממשק, אם הם נתמכים על ידי הכלי הזה. כל מחזיקי הכלים של ELF תומכים בשלב זה בהגדרה הזו.
תגים:loading_and_analysis
,affects_outputs
,affects_outputs
- ברירת מחדל של
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: הצגת תיאור -
ההגדרה קובעת את גרסת ה-SDK של iOS שבה משתמשים כדי ליצור אפליקציות ל-iOS. אם לא צוין, נעשה שימוש בגרסת ה-SDK ל-iOS המוגדרת כברירת מחדל מ-'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: הצגת תיאור -
הגדרה של גרסת ה-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' (קובץ שנמצא מתחת לבסיס של סביבת העבודה).
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
כברירת מחדל: ""-
התוויות של כללי הפלטפורמה שמתארות את פלטפורמות היעד של הפקודה הנוכחית.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--python2_path=<a string>
: הצגת תיאור -
הוצא משימוש, no-op. הושבת על ידי `--incompliance_use_python_toolschains`.
תגים:no_op
,deprecated
- ברירת מחדל של
--python3_path=<a string>
: הצגת תיאור -
הוצא משימוש, no-op. הושבת על ידי `--incompliance_use_python_toolschains`.
תגים:no_op
,deprecated
- ברירת מחדל של
--python_path=<a string>
: הצגת תיאור -
הנתיב המוחלט של כלי התרגום של Python הופעל להפעלת יעדים ב-Python בפלטפורמת היעד. הוצא משימוש; הושבת על ידי --incompliance_use_python_toolschains.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--python_top=<a build target label>
: הצגת תיאור -
התווית של py_runtime שמייצגת את תרגום ה-Python שהופעל כדי להפעיל יעדי Python בפלטפורמת היעד. הוצא משימוש; הושבת על ידי --incompliance_use_python_toolschains.
תגים: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 שבה רוצים להשתמש כדי ליצור אפליקציות טלוויזיה. אם לא צוין אחרת, המערכת משתמשת בגרסת ברירת המחדל של ה-SDK של tvOS מאת 'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: הצגת תיאור -
קביעת הגרסה של ה-SDK של WatchOS שבה רוצים להשתמש כדי ליצור אפליקציות WatchOS. אם לא צוין אחרת, המערכת תשתמש בגרסת ה-SDK שהוגדרה ל-watchOS כברירת מחדל מהכתובת 'xcode_version'
תגים:loses_incremental_state
- ברירת מחדל של
--xcode_version=<a string>
: הצגת תיאור -
אם צוין, נעשה שימוש ב-Xcode של הגרסה הנתונה לפעולות build רלוונטיות. אם לא צוין אחרת, נעשה שימוש בגרסת ברירת המחדל של ה-Xcoder.
תגים: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_runfile_links
כברירת מחדל: "true"-
אם זה מוגדר, יש לבנות יערות קישורים של קובצי ריצה עבור כל היעדים. אם הערך הוא False, יש לכתוב מניפסטים רק כאשר הדבר אפשרי.
תגים:affects_outputs
--[no]build_runfile_manifests
כברירת מחדל: "true"-
אם הערך הוא true, יש לכתוב מניפסטים של Runruns בכל היעדים. אם הם שגויים, יש להשמיט אותם. בדיקות מקומיות ייכשלו כשהן הוגדרו כ-False.
תגים:affects_outputs
--[no]build_test_dwp
כברירת מחדל: "false"-
אם המדיניות מופעלת, כשיוצרים בדיקות C++ באופן סטטי ובהשהיה, קובץ ה-dvp של הקובץ הבינארי של הבדיקה יהיה גם הוא נבנה באופן אוטומטי.
תגים: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++ וקישורים. אפשר לשלב כל שילוב של {'quickbuild', 'dbg', 'opt'} או את הערכים המיוחדים 'yes' כדי להשבית את כל המצבים &&339;no' כדי להשבית את כל המצבים.
תגים:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]legacy_external_runfiles
כברירת מחדל: "true"-
אם פעולה זו מוגדרת כ-TRUE, יש לבנות יערות סימבול של Run Runlinks עבור מאגרים חיצוניים בסיומת .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>
שימושים מרובים -
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם הגדרת יעד. אפשר לציין משתנים לפי שם, ובמקרה כזה הערך יילקח מסביבת ההפעלה, או מצמד של שם=ערך שמגדיר את הערך ללא קשר לסביבת ההפעלה. ניתן להשתמש באפשרות הזו מספר פעמים. אם מגדירים את אותו משתנה, נצברות הווריאציות האחרונות וגם צוברים את האפשרויות השונות.
תגים: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 Databind 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' פירושו ש-Bazel תבחר אם לקשר באופן דינמי. 'LY' פירושו שכל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי בעיקר.
תגים:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
כברירת מחדל: "alphabetical"-
הגדרת הסדר של המניפסטים שהועברו למיזוג של המניפסט עבור קבצים בינאריים של Android. ALPHABETICAL כלומר מניפסטים ממוינים לפי נתיב ביחס ל-executroot. 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>
שימושים מרובים -
יש לציין את מצב הסיביות של Apple לשלבי ההידור שמטרגטים את ארכיטקטורות המכשירים. הערכים צריכים להיות בפורמט '[platform=]mode' כאשר הפלטפורמה (חייבת להיות 'ios', 'macos', 'tvos' או 'watchos' ) היא אופציונלית. אם ציינתם קוד כזה, הוא מיושם באופן ספציפי עבור הפלטפורמה הזו. אם הוא חסר, הוא חל על כל הפלטפורמות. המצב חייב להיות &&39;none', 'embedded_טושים' או 'embedded' ייתכן שהאפשרות הזו תוצג כמה פעמים.
תגים:loses_incremental_state
--[no]build_python_zip
כברירת מחדל: "auto"-
בניית מיקוד לקובץ python שניתן להפעלה; ב-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. בדרך כלל אין לציין אפשרות זו ישירות – 'כיסוי פנים' יש להשתמש בפקודה במקום זאת.
תגים:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ברירת מחדל: "quickbuild"-
ציון המצב שבו הקובץ הבינארי יהיה מובנה. Value: 'quickbuild', 'dbg', 'opt'.
תגים:affects_outputs
,action_command_lines
,explicit_in_output_path
- נצברו
--conlyopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc בעת הידור קובצי מקור ב-C.
תגים:action_command_lines
,affects_outputs
- נצברו
--copt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-GCC.
תגים: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>
: הצגת תיאור -
cscsff_profile שמייצג את הפרופיל הרגיש של ההקשר שישמש לאופטימיזציה.
תגים:affects_outputs
- נצברו
--cxxopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-GCC במהלך הידור קובצי מקור ב-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"-
הפעלה של עץ סימולט של קובצי הפעלה; כברירת מחדל, האפשרות מושבתת ב-Windows, בפלטפורמות אחרות.
תגים:affects_outputs
- נצברו
--experimental_action_listener=<a build target label>
שימושים מרובים -
הוצא משימוש בשל היבטים. אפשר להשתמש ב-action_listener כדי לצרף additional_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"-
להשתמש בגרסה ל-Android של קישור נתונים גרסה 2
תגים: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" -
המערכת משתמשת במחרוזות האלה כאפשרויות מהדר OBJC לבנייה מהירה.
תגים:action_command_lines
--[no]experimental_omitfp
כברירת מחדל: "false"-
True
תגים: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 כשמפעילים את collections_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 המכיל פרופיל אוטומטי. הדגל הזה מקבל גם קבצים שצוינו כתוויות, לדוגמה //foo/bar:file.afdo. תוויות כאלה חייבות להפנות לקובצי קלט. ייתכן שתצטרכו להוסיף הוראת Export_files לחבילה המתאימה כדי שהקובץ יהיה גלוי ל-Bazel. אפשר גם לקבל קובץ פרופיל LLVM גולמי או שנוסף לאינדקס. הסימון הזה יוחלף על ידי כלל 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>
שימושים מרובים -
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם הגדרות מארח או הפעלה. אפשר לציין משתנים לפי שם, ובמקרה כזה הערך יילקח מסביבת ההפעלה, או מצמד של שם=ערך שמגדיר את הערך ללא קשר לסביבת ההפעלה. ניתן להשתמש באפשרות הזו מספר פעמים. אם מגדירים את אותו משתנה, נצברות הווריאציות האחרונות וגם צוברים את האפשרויות השונות.
תגים:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
כברירת מחדל: "opt"-
יש לציין את המצב שבו ייעשה שימוש בכלים שנוצרו במהלך ה-build. Value: 'quickbuild', 'dbg', 'opt'.
תגים:affects_outputs
,action_command_lines
- נצברו
--host_conlyopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-gcc במהלך הידור קובצי מקור ל-C עבור כלי מארח.
תגים:action_command_lines
,affects_outputs
- נצברו
--host_copt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה אל GCC עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
--host_cpu=<a string>
כברירת מחדל: ""-
יחידת העיבוד המרכזית (CPU) של המארח.
תגים:changes_inputs
,affects_outputs
- נצברו
--host_cxxopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה אל GCC עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_force_python=<PY2 or PY3>
: הצגת תיאור -
ההגדרה הזו מבטלת את גרסת Python של תצורת המארח. יכול להיות "PY2" או "PY3".
תגים:loading_and_analysis
,affects_outputs
- נצברו
--host_linkopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-ccC כשמקשרים כלים למארחים.
תגים: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>
שימושים מרובים -
אפשרויות נוספות להעברה ל-wifc עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
כברירת מחדל: "true"-
אם האפשרות מופעלת, כל הספריות המקושרות (DLL) של C++ שנוצרו על ידי cc_library ב-Windows ישתנו ל-name_{hash}.dll, והחישוב שלהן מבוסס על ה-RepositoryName ונתיב החבילה DLL'. האפשרות הזו שימושית כשיש חבילה אחת שתלויה במספר יחידות, cc_library בשם זהה (למשל //foo/bar1:utils ו-//foo/bar2:utils).
תגים:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
כברירת מחדל: "true"-
אם הערך הוא True, ספריית קובצי הקיפול מורכבת ממאגר הספרייה.
תגים:affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
כברירת מחדל: "false"-
אם הערך הוא 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>
default: "-/JavaScripttests[/:],-/test/javascript[/:]"-
כשהכיסוי מופעל, המערכת תשלב רק כללים עם שמות שכלולים במסנן המבוסס על ביטויים רגולריים (regex). כללים עם קידומת '-' אינם נכללים במקום זאת. לידיעתכם, ניתן להשתמש רק בכללים שאינם בדיקות, אלא אם התכונה ininument_test_targets מופעלת.
תגים:affects_outputs
--ios_cpu=<a string>
כברירת מחדל: "x86_64"-
ההגדרה כוללת טירגוט של יחידת העיבוד המרכזית (CPU) ב-iOS.
תגים:no_op
,deprecated
- ברירת מחדל של
--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"-
הוצא משימוש, הוחלף על ידי --incompliance_remove_Legacy_whole_archive (לפרטים: https://github.com/bazelbuild/bazel/issues/7362). כאשר הוא פועל, יש להשתמש ב- --all-archive עבור כללים cc_binary שיש להם linkshared=1 וכן linkstatic=1 או '-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>
שימושים מרובים -
אפשרויות נוספות להעברה לאוסף של יעד C.
תגים:action_command_lines
- נצברו
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
שימושים מרובים -
אפשרויות נוספות להעברה סלקטיבית ל-GCC במהלך הידור קבצים מסוימים. ניתן להעביר את האפשרות הזו מספר פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. כאשר regex_filter מייצג רשימה של הכללת והחרגה של דפוסי ביטויים רגולריים (ראו גם -instrumentation_filter). option_1 to option_n מייצגת אפשרויות של שורת פקודה שרירותית. אם אפשרות מכילה פסיק, יש לצטט אותו לוכסן הפוך. אפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 מוסיפה את אפשרות שורת הפקודה -O0 לשורת הפקודה של gcc בכל קובצי ה-עותקים ב-//foo/ פרט ל-bar.cc.
תגים:action_command_lines
,affects_outputs
- נצברו
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
שימושים מרובים -
אפשרויות נוספות להעברה סלקטיבית אל קצה עורפי LTO (בקטע --features=thin_lto) במהלך הידור אובייקטים עורפים. ניתן להעביר את האפשרות הזו מספר פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. כאשר regex_filter מייצג רשימה של הכללה והחרגה של דפוסים רגולריים של ביטויים רגולריים (Option_1) אל option_n, לציון אפשרויות של שורת פקודה שרירותית. אם אפשרות מכילה פסיק, יש לצטט אותו לוכסן הפוך. אפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 מוסיף את אפשרות שורת הפקודה -O0 לשורת הפקודה LTO בקצה העורפי של כל קובצי o ב-//foo/ מלבד Bar.o.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--platform_suffix=<a string>
: הצגת תיאור -
קביעת סיומת להוספה לספריית התצורה.
תגים:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ברירת מחדל של
--propeller_optimize=<a build target label>
: הצגת תיאור -
יש להשתמש בפרטי פרופיל המדחף כדי לבצע אופטימיזציה של יעד ה-build.פרופיל מדחף חייב להכיל לפחות אחד משני קבצים, פרופיל cc ופרופיל ld. הסימון הזה מאשר תווית בנייה, שחייבת להתייחס לקובצי הקלט של פרופיל המדחף. לדוגמה, קובץ ה-BUILD שמגדיר את התווית, ב-a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) הוראת add to be add to be set to be set it to הוסף את הפרמטר to to הוסף אבל יש לכל הקבצים האלה "הוראות להגשה" של שלהם יש להשתמש באפשרות הזו בתור: --propeller_optimize=//a/b:propeller_profile
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--propeller_optimize_absolute_cc_profile=<a string>
: הצגת תיאור -
שם הנתיב המוחלט של קובץ cc_profile עבור גרסת ה-build של אופטימיזציה של Propleler.
תגים:affects_outputs
- ברירת מחדל של
--propeller_optimize_absolute_ld_profile=<a string>
: הצגת תיאור -
שם הנתיב המוחלט של קובץ ld_profile עבור גרסת ה-build של אופטימיזציה ב-Propleler.
תגים:affects_outputs
- ברירת מחדל של
--run_under=<a prefix in front of command>
: הצגת תיאור -
לפני הסימן צריך להפעיל את הפקודה של 'test' &&339;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
-
אם הערך הוא True, ספריות מקומיות שמכילות פונקציונליות זהה ישותפו בין יעדים שונים
תגים:loading_and_analysis
,affects_outputs
--[no]stamp
כברירת מחדל: "false"-
חותמות בינאריות עם התאריך, שם המשתמש, שם המארח, פרטי סביבת העבודה וכו'
תגים:affects_outputs
- ברירת מחדל של
--strip=<always, sometimes or never>
: "לפעמים" -
ההגדרה קובעת אם להסיר בינאריים וספריות משותפות (באמצעות "-Wl,--strip-debug" ). ערך ברירת המחדל של 'sometimes' פירושו Strap iff --compilation_mode=quickbuild.
תגים: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>
שימושים מרובים -
רשימה אדריכלית של כתובות URL המופרדות בפסיקים, שעליהן יש לבנות קבצים בינאריים של Apple WatchOS.
תגים: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, האפשרויות האלה תמיד יהיו קבועות כאילו לא צוינו Xxary_fdo.
תגים:affects_outputs
- אפשרויות שמשפיעות על התדירות שבה נאכפים ב-Bazel קלט חוקי של Build (הגדרות של כללים, שילובי דגלים וכו'):
--auto_cpu_environment_group=<a build target label>
כברירת מחדל: ""-
הצהרת הסביבה group_to
תגים: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"-
כדי להצפין את קוד ה-בייט בייט Java 8 לפני הסרת הניקוי.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]enforce_constraints
כברירת מחדל: "true"-
בדיקת הסביבות שבהן כל יעד תואם ודיווח על שגיאות אם לכל יעד יש יחסי תלות שלא תומכים באותן סביבות
תגים:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
כברירת מחדל: "false"-
סימון כדי לעזור במעבר מההרשאה 'לא לאפשר הרשאה' לכללים של Android ללא ספריות עם נקודות שפל. יש לנקות את המחסן כדי להשיק את ברירת המחדל הזו.
תגים:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
כברירת מחדל: "true"-
אם צריך לבדוק שוב את ניפוי הבאגים הנכון ברמה בינארית של Android.
תגים:eagerness_to_exit
,loading_and_analysis
,experimental
--[no]experimental_desugar_java8_libs
כברירת מחדל: "false"-
אם רוצים לכלול ספריות Java 8 נתמכות באפליקציות במכשירים מדור קודם.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,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_disable_native_android_rules
כברירת מחדל: "false"-
כשהאפשרות מופעלת, השימוש הישיר בכללים המקוריים של Android מושבת. יש להשתמש בכללים של Android Starkk בכתובת 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_dependenncy_recursives מושבתת.
תגים: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 מצהיר במפורש על כל היעדים שנעשה בהם שימוש ב-'ייבוא ציבורי'.
תגים:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
כברירת מחדל: "false"-
אם המדיניות מוגדרת כ-true, צריך להצהיר על כותרות גם באמצעות נתיבים (-ii).
תגים:loading_and_analysis
,eagerness_to_exit
- נצברו
--target_environment=<a build target label>
שימושים מרובים -
הצהרת סביבת היעד של ה-build הזה. הערך חייב להיות תווית לכלל '&מירכאות'. אם ציינתם זאת, כל היעדים ברמה העליונה חייבים להיות תואמים לסביבה הזו.
תגים: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"-
אם המדיניות מוגדרת ומצב האיסוף לא &&39;opt' אפליקציות objc יכללו הרשאות לניפוי באגים בזמן החתימה.
תגים:changes_inputs
- ברירת מחדל של
--ios_signing_cert_name=<a string>
: הצגת תיאור -
שם שיש להשתמש בו לחתימת iOS. אם המדיניות לא מוגדרת, היא תוחזר לפרופיל ניהול ההקצאות. יכול להיות שהעדפת הזהות של המפתח היא (או מחרוזת משנה) של השם הנפוץ של האישור, בהתאם לדף חותמת הקוד של קוד{2} (SIGNING ID ID).
תגים: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, כשל בניתוח של יעד כלל גורם למופע של יעד מופע של AnalysisFailureInfo המכיל את תיאור השגיאה, במקום לגרום לכשל ב-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 סוגי מכשירים' במחשב שבו הסימולטור יפעל.
תגים: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 מורה ל'בלז' להשתמש בברירות המחדל של הזמן הקצוב לתפוגה עבור קטגוריה זו.
- ברירת מחדל של
--tvos_simulator_device=<a string>
: הצגת תיאור -
המכשיר להדמיה בעת הפעלת אפליקציית tvOS בסימולטור, למשל 'Apple TV 1080p'. כדי לקבל רשימת מכשירים, אפשר להפעיל 'xcrun simctl list סוגי מכשירים' במחשב שבו הסימולטור יפעל.
תגים: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 – 38 מ"מ'. כדי לקבל רשימת מכשירים, אפשר להפעיל 'xcrun simctl list סוגי מכשירים' במחשב שבו הסימולטור יפעל.
תגים: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>
כברירת מחדל: "שמרי"-
איך לפתור בעיות של יחס גובה-רוחב כשפורמט הפלט הוא {xml,proto,record}. 'off' כלומר, לא תלויות יחסי גובה-רוחב, 'שמרני' (ברירת המחדל) פירוש הדבר שכל התלות המוצהרות ביחס להיבטים מתווספות, בין אם הן קיבלו את סיווג הכללים תלויות חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, ולכן הוא איטי יותר מהמצבים האחרים. כמו כן, גם מצב מדויק אינו מדויק לגמרי: ההחלטה אם לחשב היבט מתקבלת על שלב בשלב הניתוח, שאינו פועל במהלך 'שאילתה'
תגים:build_file_semantics
--[no]deduplicate_depsets
כברירת מחדל: "true"-
צריך לבטל כפילויות של ילדים ללא עלים בדף dep_set_of_files בפלט הסופי של proto/textproto/json. הפעולה הזו לא מבטלת כפילויות של דיפסות שלא חולקות הורה מיידי. פעולה זו לא משפיעה על הרשימה הסופית הסופית של פריטי קלט של הפעולות.
תגים:terminal_output
--[no]graph:factored
כברירת מחדל: "true"-
אם הערך הוא True, התרשים יוסר אפשרות זו רלוונטית רק ל- --Output=graph.
תגים:terminal_output
--graph:node_limit=<an integer>
כברירת מחדל: "512"-
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; -1 פירושו חיתוך. אפשרות זו רלוונטית רק ל- --Output=graph.
תגים:terminal_output
--[no]implicit_deps
כברירת מחדל: "true"-
אם אפשרות זו מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלויות שבו השאילתה פועלת. תלות משתמעת היא לא מצוינת במפורש בקובץ BUILD, אבל מתווספת על ידי Bazel. עבור שאילתה, אפשרות זו שולטת בסינון מחזיקי כלים שנפתרו.
תגים:build_file_semantics
--[no]include_artifacts
כברירת מחדל: "true"-
כולל שמות של הקלט והפלט של הפעולות בפלט (אולי בעתיד).
תגים:terminal_output
--[no]include_aspects
כברירת מחדל: "true"-
query, cquery: אם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: לא-תפעול (תמיד מתבצע מעקב אחר היבטים).
תגים:terminal_output
--[no]include_commandline
כברירת מחדל: "true"-
כוללת את התוכן של שורות פקודות הפעולה בפלט (אולי בעתיד).
תגים:terminal_output
--[no]include_param_files
כברירת מחדל: "false"-
יש לכלול את תוכן קובצי הפרמטרים שנעשה בהם שימוש בפקודה (פוטנציאלית). הערה: הפעלה של סימון זה תפעיל את התכונה הניסיונית --include_commandline באופן אוטומטי.
תגים:terminal_output
--[no]incompatible_display_source_file_location
כברירת מחדל: "true"-
ברירת המחדל היא הצגת היעד של קובץ המקור. אם הערך הוא True, מוצג המיקום של שורה 1 של קובצי המקור בפלט המיקום. הסימון הזה קיים רק למטרות מיגרציה.
תגים:terminal_output
,incompatible_change
--[no]infer_universe_scope
כברירת מחדל: "false"-
אם היא מוגדרת ו-unis_scope לא מוגדרת, הערך של לתשומת ליבכם, הערך --universe_scope שמתקבל עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, 'allrdeps')) עשוי להיות לא מה שאתם רוצים, ולכן מומלץ להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים נוספים ודוגמאות זמינים בכתובת https://bazel.build/versions/reference/query#sky-query אם --universe_scope מוגדר, המערכת תתעלם מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'query' (כלומר, לא 'cquery`).
תגים:loading_and_analysis
--[no]line_terminator_null
כברירת מחדל: "false"-
אם כל פורמט יסתיים ב-\0 במקום בשורה חדשה.
תגים:terminal_output
--[no]nodep_deps
כברירת מחדל: "true"-
אם המדיניות מופעלת, נקודות מדדים של "nodep" ייכללו בתרשים התלויות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep" &"ability" אפשר להריץ ולנתח את הפלט של 'info-language' כדי לקבל מידע על כל המאפיינים "nodep" בשפת הבנייה.
תגים:build_file_semantics
--output=<a string>
כברירת מחדל: "text"-
הפורמט שבו יש להדפיס את תוצאות השאילתות. הערכים המותרים לשאילתת החיפוש הם: טקסט, טקסטפרו, פרוטו, jsonproto.
תגים:terminal_output
--[no]proto:default_values
כברירת מחדל: "true"-
אם הערך הוא True, המערכת תכללו מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- -Output=proto
תגים:terminal_output
--[no]proto:definition_stack
כברירת מחדל: "false"-
אכלוס השדה proto-stack של הפרוטוקול, שבו מתועדת כל מופע של כלל ה-Starlark ברגע שהוגדרה המחלקה לכלל.
תגים: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"-
רשימת מאפיינים מופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להפיק פלט אף מאפיין. אפשרות זו רלוונטית ל--Output=proto.
תגים:terminal_output
--[no]proto:rule_inputs_and_outputs
כברירת מחדל: "true"-
האם אפשר לאכלס את השדותכלל_קלט וכלל_פלט.
תגים:terminal_output
--[no]relative_locations
כברירת מחדל: "false"-
אם הערך הוא True, המיקום של קובצי BUILD בפלט XML ו-Proto יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא עקבי במכונות שונות. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במחשבים שונים.
תגים:terminal_output
--[no]skyframe_state
כברירת מחדל: "false"-
בלי לבצע ניתוח נוסף, משחררים את תרשים הפעולות הנוכחי מ-Skyframe. הערה: אין כרגע תמיכה בציון יעד באמצעות --skyframe_state. הסימון הזה זמין רק באמצעות
תגים:terminal_output
--[no]tool_deps
כברירת מחדל: "true"-
שאילתה: אם היא מושבתת, יחסי תלות ב&&39;תצורת מארח' או 'execution' יעדים לא ייכללו בתרשים התלויות שבו השאילתה פועלת. קצה 'הגדרת מארח' תלות, כמו הכלל מכל &&39;proto_library' לרוב, המהדר של הפרוטוקול, מצביע על כלי שנערך במהלך הבנייה ולא על חלק מאותה תוכנית '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
כברירת מחדל: "false"-
אם היא מופעלת, קובצי C++ DD יועברו בזיכרון ישירות מצומתי ה-build המרוחקים, במקום להיכתב בדיסק.
תגים:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
כברירת מחדל: "false"-
אם היא מופעלת, קובצי התלויות (.jdeps) שנוצרו מהאוספים של Java יועברו בזיכרון ישירות מצומתי הבנייה המרוחקים, ולא בכתב בדיסק.
תגים: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_Config יהיה 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, מכיוון שסורק ההכללה לא מטמיע באופן מלא את הסמנטיקה של מעבד ה-C. באופן ספציפי, היא לא מבינה הנחיות #include דינמיות ומתעלמת מלוגיקה מותנית במעבד מראש. השימוש הוא באחריותך בלבד. כל בעיה הקשורה לסימון הזה שהוגשה ייסגרה.
תגים:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
כברירת מחדל: "true"-
רוב העבודה היא של הדבקה בנפרד בכל קובץ צנצנת.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
כברירת מחדל: "true"-
אם מגדירים קבצים מסוג d.
תגים:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
כברירת מחדל: "false"-
כשיוצרים יעד //a:a, העיבוד של כותרות בכל היעדים ש-aa:a תלוי (אם עיבוד הכותרת מופעל ב-toolschain).
תגים: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>
כברירת מחדל: "-.*"-
הדפסה של מידע על תוצאות ניפוי הבאגים במהלך פתרון בעיות בכלי הכלים. התכונה בודקת את הביטוי הרגולרי (regex), שנבדק מול סוגי Toolchain ויעדים ספציפיים כדי לבדוק איזה מהם ניפוי באגים. יש כמה ביטויים רגולריים שאפשר להפריד ביניהם באמצעות פסיקים, ולאחר מכן כל ביטוי רגולרי מסומן בנפרד. הערה: הפלט של הדגל הזה מורכב מאוד, וסביר להניח שהוא יהיה שימושי רק למומחים במציאת פתרון בכלי.
תגים:terminal_output
- אפשרויות המציינות או משנות קלט גנרי לפקודת Bazel שאינה מתאימה לקטגוריות אחרות:
- נצברו
--flag_alias=<a 'name=value' flag alias>
שימושים מרובים -
מגדיר שם מקוצר לסימון Starlark. הוא מקבל צמד מפתח-ערך אחד בצורת ארגומנט;<key>=<value>" כארגומנט.
תגים:changes_inputs
--[no]incompatible_default_to_explicit_init_py
כברירת מחדל: "false"-
הסימון הזה משנה את התנהגות ברירת המחדל כך שקובצי _inin__.py לא נוצרים יותר באופן אוטומטי בקובצי ריצה של יעדים ב-Python. בדיוק, כשיעד py_binary או py_test מוגדר מדור קודם עד: "auto" (ברירת המחדל), המערכת מתייחסת לערך False אם רק הדגל הזה מוגדר. יש לעיין בכתובת https://github.com/bazelbuild/bazel/issues/10076.
תגים:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
כברירת מחדל: "true"-
אם הערך הוא true, יעדים שנוצרו בתצורת Python 2 יופיעו מתחת לשורש הפלט הכולל את הסיומת '-py2' בעוד שיעדים שנוצרו עבור Python 3 יופיעו בשורש ללא סיומת הקשורה ל-Python. המשמעות היא שסימן הנוחות 'bazel-bin' מצביע על טירגוט ב-Python 3 ולא על Python 2. אם האפשרות הזו מופעלת, מומלץ גם להפעיל את `--incompatible_py3_is_default`.
תגים:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
כברירת מחדל: "true"-
אם הערך הוא True, היעדים 'py_binary' ו-'py_test' שלא הגדירו את המאפיין 'python_version' (או 'default_python_version') יעברו כברירת מחדל ל-PY3 במקום ל-PY2. אם הדגל הזה מוגדר, מומלץ גם להגדיר את `--incompliance_py2_Outputs_are_suffixed`.
תגים:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
כברירת מחדל: "true"-
אם המדיניות מוגדרת כ-True, כללים להפעלה אוטומטית של Python יתבססו על זמן הריצה של Python שצוין על ידי Toolchain של ה-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, מערכת Blaze תבטל בו-זמנית את הבדיקות שפועלות בהפעלה הראשונה המוצלחת. זה שימושי רק בשילוב עם --runs_per_test_detects_flake.
תגים: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"-
אם הערך הוא True, יצירת כיסוי מסוג ClangV תיצור דוח 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>
כברירת מחדל: "JavaScriptbuilder"- הפעלה של מסלולי נתיב מופחתים עבור אוספים של Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
כברירת מחדל: "false"-
הגבלה --Experimental_run_android_lint_on_javascript_rules לספריות תואמות ל-Android.
תגים:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
כברירת מחדל: "false"-
אם יש צורך לאמת את מקורות Java_*.
תגים:affects_outputs
--[no]explicit_java_test_deps
כברירת מחדל: "false"- יש לציין באופן תלוי תלות ב-JUNIT או ב-Hunstest ב-JavaScript_test במקום להשיג בטעות את נקודות הטעינה של RunRunner' . מתאים כרגע רק לאפליקציות בנק.
- ברירת מחדל של
--host_java_launcher=<a build target label>
: הצגת תיאור - מרכז האפליקציות של Java המשמש את הכלים שהוצאו משימוש במהלך גרסת build.
- נצברו
--host_javacopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-JavaScript במהלך בניית כלים שמתבצעים במהלך גרסת build.
- נצברו
--host_jvmopt=<a string>
שימושים מרובים - אפשרויות נוספות למעבר ל-VM VM במהלך בניית הכלים שמתבצעים במהלך ה-build. האפשרויות האלה יתווספו לאפשרויות ה-VM להפעלה של כל יעד JavaScript_binary.
--[no]incompatible_exclusive_test_sandboxed
כברירת מחדל: "false"-
אם הערך הוא TRUE, בדיקות בלעדיות יפעלו עם אסטרטגיה מסוג ארגז חול. אפשר להוסיף תג &&39;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_Output=streamed.
הרחבה אל:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
כברירת מחדל: "true"- יצירת מידע על תלות (בשלב זה, נתיב Class time-time) ליעד Java.
--[no]java_header_compilation
כברירת מחדל: "true"- מקבצים את קובצי ה-IE ישירות מהמקור.
--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>
שימושים מרובים - אפשרויות נוספות להעברה ל-JavaScript.
- נצברו
--jvmopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-Java VM. האפשרויות האלה יתווספו לאפשרויות ה-VM להפעלה של כל יעד JavaScript_binary.
- ברירת מחדל של
--legacy_main_dex_list_generator=<a build target label>
: הצגת תיאור - קביעת קובץ בינארי לשימוש ליצירת רשימת הכיתות שחייבות להיות בפקס הראשי בעת הידור כמה מכפילים מדור קודם.
- נצברו
--plugin=<a build target label>
שימושים מרובים - יישומי פלאגין שאפשר להשתמש בהם ב-build. פועל כרגע עם JavaScript_plugins.
- ברירת מחדל של
--proguard_top=<a build target label>
: הצגת תיאור - ההגדרה של גרסת Proguard להסרת קוד בינארי לפי Java.
--proto_compiler=<a build target label>
ברירת מחדל: "@com_google_protobuf//:protracker"-
התווית של המהדר.
תגים:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ברירת מחדל: "@com_google_protobuf//:cc_toolschain"-
תווית של proto_lang_toolschain() שמתארת איך להרכיב C+protos מסוג C+
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_j2objc=<a build target label>
: "@bazel_tools//tools/j2objc:j2objc_proto_toolschain" -
תווית של proto_lang_toolschain() שמתארת איך להדר j2objc protos
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_java=<a build target label>
: "@com_google_protobuf//:JavaScript_toolschain" -
תווית של proto_lang_toolschain() שמתארת את ההידור של Java Protos
תגים:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ברירת מחדל: "@com_google_protobuf//:JavaScriptlite_toolschain"-
תווית של proto_lang_toolschain() שמתארת את ההידור של JavaLite protos
תגים:affects_outputs
,loading_and_analysis
- נצברו
--protocopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה אל המהדר של Protobuf.
תגים:affects_outputs
--[no]runs_per_test_detects_flakes
כברירת מחדל: "false"- אם הערך הוא True, כל שבר שבו ניסיון ריצה/ניסיון אחד לפחות ולפחות ניסיון אחד/ניסיון אחד נכשל נכשל מקבלים סטטוס של תוכן מסוג FLAKY.
- ברירת מחדל של
--shell_executable=<a path>
: הצגת תיאור -
נתיב מוחלט למעטפת המשמשת לשימוש ב-Bazel אם זה לא מוגדר, אבל משתנה הסביבה BAZEL_SH מוגדר בהפעלה הראשונה של Bazel (שמפעילה שרת Bazel), ה-Bazel משתמש בכך. אם אף אחד מהם לא מוגדר, Bazel משתמשת בנתיב ברירת מחדל בתוך קוד פתוח, בהתאם למערכת ההפעלה שבה היא פועלת (Windows: c:/tools/msys64/usr/bin/bash.exe , FreeBSD: /usr/local/bin/bash , כל השאר: /bin/bash). לתשומת ליבכם: שימוש במעטפת שלא תואם ל-bash עלול לגרום לכשלים בבנייה או לכשלים בריצה של נתונים בינאריים שנוצרו.
תגים:loading_and_analysis
- נצברו
--test_arg=<a string>
שימושים מרובים - ההגדרה כוללת אפשרויות וארגומנטים נוספים שצריך להעביר לקובץ ההפעלה של הבדיקה. אפשר להשתמש במספר פעמים כדי לציין כמה ארגומנטים. אם נבצע מספר בדיקות, כל אחת מהן תקבל ארגומנטים זהים. משמש רק את הפקודה 'bazel'
- ברירת מחדל של
--test_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' BUILD. 'disabled' לעולם לא להשתמש בפיצול בדיקות.
--tool_java_language_version=<a string>
כברירת מחדל: "8"- גרסת השפה של Java המשמשת להפעלת הכלים הנחוצים במהלך פיתוח
- ברירת מחדל של
--tool_java_runtime_version=<a string>
: "remotejdk_11" - גרסת זמן הריצה של Java המשמשת להפעלת כלים במהלך יצירת ה-build
--[no]use_ijars
כברירת מחדל: "true"- אם האפשרות הזו מופעלת, הידור Java יכול להשתמש בצנצנות ממשק. פעולה זו תגרום לצבירה מצטברת מהירה יותר, אבל הודעות השגיאה עשויות להיות שונות.
אפשרויות build
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--repository_cache=<a path>
: הצגת תיאור -
קביעת מיקום המטמון של הערכים שהורדו שהתקבלו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט מבקשת השבתה של המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בביצוע גרסאות:
--[no]check_up_to_date
כברירת מחדל: "false"-
אין לבצע את הבנייה, רק צריך לבדוק אם היא מעודכנת. אם כל היעדים מעודכנים, גרסת ה-build הושלמה בהצלחה. אם יש צורך לבצע שלב כלשהו בדיווח, מדווחת שגיאה וה-build נכשל.
תגים:execution
--[no]experimental_delay_virtual_input_materialization
כברירת מחדל: "false"-
אם המדיניות מוגדרת כ-True, המערכת יוצרת קלט וירטואלי (כמו קובצי פרמטרים) רק בתוך ארגז החול, ולא בקובץ ה-EXCroot, שמתקן את תנאי המרוץ באמצעות המתזמן הדינמי. הסימון הזה קיים רק כדי לתמוך בתיקון הבאג הזה.
תגים:execution
--experimental_docker_image=<a string>
כברירת מחדל: ""-
יש לציין שם של תמונת אביזר עגינה (למשל "ubuntu:latest") שישמש לביצוע פעולה מסוג ארגז חול בעת שימוש בשיטת ה-Docker ולפעולה עצמה אין כבר מאפיין של תמונת מאגר במאגר בכתובת Remote_execution_properties בתיאור הפלטפורמה. הערך של הדגל הזה מועבר מילה במילה ל-'docker Run' לכן הוא תומך באותם תחביר ומנגנונים כמו אביזר העגינה עצמו.
תגים:execution
--[no]experimental_docker_privileged
כברירת מחדל: "false"-
אם האפשרות מופעלת, ב-Bazel יעביר את הסימון הנשלח לבעלים של &&39;docker&&39; בעת ביצוע פעולות. זה עשוי להיות חובה על ידי ה-build שלכם, אבל הוא עשוי לגרום גם למידת יורדת.
תגים:execution
--[no]experimental_docker_use_customized_images
כברירת מחדל: "true"-
אם האפשרות מופעלת, מחדיר את המזהה והמזהה של המשתמש הנוכחי לתמונה ב-Docker לפני השימוש. הדרישה הזו נדרשת אם ה-build / הבדיקות שלך תלויים בשם של משתמש ובספריית בית בתוך המאגר. התכונה הזו מופעלת כברירת מחדל, אבל אפשר להשבית אותה אם התכונה 'התאמה אישית של תמונות' לא פועלת במארז. אם אתם יודעים שאינכם צריכים אותה, בדקו אותה.
תגים:execution
--[no]experimental_docker_verbose
כברירת מחדל: "false"-
אם האפשרות מופעלת, ב-Bazel יודפסו הודעות נוספות על אסטרטגיית ארגז החול של Docker.
תגים:execution
--[no]experimental_enable_docker_sandbox
כברירת מחדל: "false"-
הפעלת ארגז חול מבוסס-Docker. לאפשרות זו אין השפעה אם אפליקציית Dock לא מותקנת.
תגים:execution
--[no]experimental_reuse_sandbox_directories
כברירת מחדל: "false"-
אם המדיניות מוגדרת כ-true, ניתן לעשות שימוש חוזר בספריות שבהן נעשה שימוש בפעולות שאינן בארגז חול (sandbox) כדי להימנע מעלויות מיותרות של הגדרה.
תגים:execution
--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 פועל והגודל שלו מודגש בדגל הזה כל עוד השרת לא פעיל.
תגים:execution
--[no]experimental_sandboxfs_map_symlink_targets
כברירת מחדל: "false"- אם הערך הוא true, מתבצע מיפוי של היעדים של קישורים סימבוליים שצוינו כקלט של פעולה בתוך ארגז החול. התכונה הזו קיימת אך ורק כדי לעקוף כללי באגים שלא עושים זאת באופן עצמאי, וצריך להסיר אותם לאחר תיקון כל הכללים.
--experimental_sandboxfs_path=<a string>
כברירת מחדל: "sandboxfs"- הנתיב לבינארי של sandboxfs כדי להשתמש בו -- true_use_sandboxfs הוא הערך TRUE. אם השם הבסיסי נמצא, יש להשתמש בקובץ הבינארי הראשון של השם הזה שנמצא ב-Path.
--[no]experimental_split_xml_generation
כברירת מחדל: "true"-
אם הדגל הזה הוגדר, ופעולת הבדיקה לא תיצור קובץ test.xml, Bazel משתמשת בפעולה נפרדת כדי ליצור קובץ דמה לבדיקה.xml שמכיל את יומן הבדיקה. אחרת, Bazel יוצרת בדיקת test.xml כחלק מפעולת הבדיקה.
תגים:execution
--[no]experimental_use_hermetic_linux_sandbox
כברירת מחדל: "false"-
אם מוגדר כ-true, אין לטעון את הרמה הבסיסית (root), אלא לטעון את מה שסופק עם sandbox_add_Mountain_pair. קובצי קלט יקושרו באופן הדוק לארגז החול במקום להיות מקושרים ל-Sandbox. אם קובצי הקלט של פעולות נמצאים במערכת קבצים שונה מארגז החול, קובצי הקלט יועתקו במקום זאת.
תגים:execution
--[no]experimental_use_sandboxfs
כברירת מחדל: "false"- משתמשים ב-Sandboxf כדי ליצור את הפעולות' ספריות execroot במקום לבנות עץ קישורים סימבוליים. אם "yes", הקובץ הבינארי שסופק על ידי -Experimental_sandboxfs_path חייב להיות חוקי ולהתאים לגרסה נתמכת של sandboxfs. אם "auto", ייתכן שהקובץ הבינארי חסר או לא תואם.
--[no]experimental_use_windows_sandbox
כברירת מחדל: "false"- אפשר להשתמש בארגז החול של Windows כדי להריץ פעולות. אם "yes", הקובץ הבינארי שסופק על ידי -Experimental_windows_sandbox_path חייב להיות חוקי ולהתאים לגרסה נתמכת של sandboxfs. אם "auto", ייתכן שהקובץ הבינארי חסר או לא תואם.
--experimental_windows_sandbox_path=<a string>
כברירת מחדל: "BazelSandbox.exe"- נתיב לבינארי של ארגז החול של Windows לשימוש כאשר --TRUEal_use_windows_sandbox נכון. אם השם הבסיסי נמצא, יש להשתמש בקובץ הבינארי הראשון של השם הזה שנמצא ב-Path.
--genrule_strategy=<comma-separated list of options>
כברירת מחדל: ""-
יש לציין איך מבצעים כללי כלל. הסימון הזה יופסק. במקום זאת, השתמשו ב- -spawn_strategy=<value> כדי לשלוט בכל הפעולות או באפשרות –strategy=Genrule=<value> כדי לשלוט בכללי ז'אנר בלבד.
תגים:execution
--[no]incompatible_legacy_local_fallback
כברירת מחדל: "true"-
אם המדיניות מוגדרת כ-True, ניתן להשתמש בחלופה המשתמעת הקודמת מארגז החול לשיטה המקומית. סימון זה יהיה ברירת המחדל כ-False ולאחר מכן יהפוך ל-no-op. במקום זאת, השתמשו ב--strategy, --spawn_strategy או --dynamic_local_strategy.
תגים:execution
,incompatible_change
--[no]incompatible_remote_symlinks
כברירת מחדל: "true"-
אם היא מוגדרת כ-true, מערכת Bazel תייצג קישורים סימולטניים בפלט של פעולות בפרוטוקול השמירה במטמון/ביצוע מרחוק. ההתנהגות הנוכחית היא שמטמון/מבצעים מרוחקים יעקבו אחר קישורים סימליים ויייצגו אותם כקבצים. פרטים נוספים זמינים בכתובת #6631.
תגים:execution
,incompatible_change
--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", "hosted_CPUS", "Host_RAM" ), ואחריה את הפעולה ([-|*]<float>) למשל. "auto", "Host_CPUS*.5". הערכים צריכים להיות בין 1 ל-5,000. ערך גבוה מ-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", "hosted_CPUS", "Host_RAM" ), ואחריו אופציונלי ([-|*]<float>) למשל. "auto", "Host_CPUS*.5". "auto" מוגדר ברירת מחדל סבירה על סמך המשאבים של המארח. חייב להיות לפחות 1.
תגים:bazel_internal_configuration
--[no]remote_allow_symlink_upload
כברירת מחדל: "true"-
אם הערך הוא True, יש להעלות פלט של קישור סימולציית פעולה למטמון המרוחק. אם אפשרות זו לא מופעלת, פעולות שניתן לשמור במטמון ופלט של קישורים סימולטניים ייכשלו.
תגים:execution
--spawn_strategy=<comma-separated list of options>
כברירת מחדל: ""-
יש לציין איך מתבצעות פעולות שנוצרו כברירת מחדל. ניתן להשתמש ברשימת אסטרטגיות המופרדות בפסיקים, מהגבוהה ביותר לנמוכה ביותר. לכל פעולה, Bazel בוחרת את האסטרטגיה בעלת העדיפות הגבוהה ביותר שיכולה לבצע את הפעולה. ערך ברירת המחדל הוא "remote,work,sandboxed,local". פרטים נוספים זמינים בכתובת https://blog.bazel.build/2019/06/19/list-strategy.html.
תגים:execution
- נצברו
--strategy=<a '[name=]value1[,..,valueN]' assignment>
שימושים מרובים -
יש לציין איך להפיץ אוסף של פעולות אחרות הקשורות להפקה. ניתן להשתמש ברשימת אסטרטגיות המופרדות בפסיקים, מהגבוהה ביותר לנמוכה ביותר. לכל פעולה, Bazel בוחרת את האסטרטגיה בעלת העדיפות הגבוהה ביותר שיכולה לבצע את הפעולה. ערך ברירת המחדל הוא "remote,work,sandboxed,local". הסימון הזה מבטל את הערכים שהוגדרו על ידי --spawn_strategy (וגם --genrule_strategy אם נעשה שימוש ב-Menemonic Genrule). פרטים נוספים זמינים בכתובת https://blog.bazel.build/2019/06/19/list-strategy.html.
תגים:execution
- נצברו
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
שימושים מרובים -
כדאי לשנות את שיטת ההשטיפה שמבצעת פעולות לביצוע עם תיאורים שתואמים ל-regex_filter מסוים. לפרטים על התאמה של מסנן רגולרי (regex) יש לעיין בפרמטר --per_file_copt. נעשה שימוש ב-regex_filter הראשון שתואם לתיאור. אפשרות זו מבטלת את הסימונים האחרים לציון האסטרטגיה. דוגמה: --strategy_regexp=//foo.*\.cc,-//foo/bar=local פירושו להריץ פעולות באמצעות אסטרטגיה מקומית אם התיאורים שלהם תואמים ל-//foo.*.cc אבל לא //foo/bar. דוגמה: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed; יפעל עם 'Compiling //foo/bar/baz' with 'local'
תגים:execution
- אפשרויות שמגדירות את ארגז הכלים המשמש לביצוע הפעולה:
--[no]incompatible_disable_runtimes_filegroups
כברירת מחדל: "false"-
No-op הוצא משימוש.
תגים:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_dont_emit_static_libgcc
כברירת מחדל: "true"-
No-op הוצא משימוש.
תגים:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
--[no]incompatible_linkopts_in_user_link_flags
כברירת מחדל: "true"-
No-op שהוצא משימוש.
תגים:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- אפשרויות שקובעות את הפלט של הפקודה:
--[no]build
כברירת מחדל: "true"-
צריך לבצע את הבנייה. זו ההתנהגות הרגילה. ציון --nobuild גורם לבנייה להפסיק לפני ביצוע פעולות ה-build, ומחזיר אפס אם שלבי הטעינה והניתוח של החבילה הושלמו בהצלחה; מצב זה שימושי לבדיקת השלבים האלה.
תגים:execution
,affects_outputs
--[no]experimental_run_validations
כברירת מחדל: "true"-
במקום זאת, יש להשתמש ב-run_validation.
תגים: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.
תגים:execution
,affects_outputs
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט המיועד, ולהשפיע על הערך שלו, במקום על קיומו:
- נצברו
--aspects=<comma-separated list of options>
שימושים מרובים - רשימת היבטים המופרדים בפסיקים שצריך להחיל על יעדים ברמה העליונה. ברשימה, אם היבט some_aspect מציין ספקי היבט נדרשים באמצעות required_aspect_providers, חלק_מספקים יפעלו לאחר כל היבט שהוזכר לפניו ברשימת ההיבטים שהספקים שמפרסמים שלהם עומדים בספק כלשהו של ספקי היבט. מלבד זאת, Any_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
- ברירת מחדל של
--[no]experimental_convenience_symlinks
: "normal" -
הסימון הזה קובע איך ינוהלו הקישורים הצדדיים (הקישורים הדינמיים שמופיעים בסביבת העבודה לאחר ה-build). ערכים אפשריים:
רגיל (ברירת מחדל): כל סוג של קישור נוחות ייווצר או יימחק, כפי שנקבע על ידי ה-build.
ניקיון: כל הסימולינים יימחקו ללא תנאי.
התעלמות: הקישורים המיידיים לא יימחקו.
log_only: יצירת הודעות יומן כאילו הועברו ל'regular' אבל לא מתבצעת בפועל פעילות של מערכת קבצים (מועילה עבור כלים).
לידיעתכם, ייתכן שתהיה השפעה רק על קישורים סימטריים שהשמות שלהם נוצרים על ידי הערך הנוכחי של --symlink_prefix. אם הקידומת משתנה, כל הקישורים הקיימים הקיימים יישארו ללא שינוי.
תגים:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
כברירת מחדל: "false"-
הסימון הזה קובע אם נפרסם את אירוע BuildConvenienceSymlinksIdentified ב-BuildEventProtocol. אם הערך הוא true, ל-BuildEventProtocol תהיה רשומה עבורנוחות SymlinksIdentified, הכוללת את כל קישורי הנוחות שנוצרו בסביבת העבודה שלכם. אם הערך הוא False, הרשומה ל-נוחותSymlinksIdentified ב-BuildEventProtocol תהיה ריקה.
תגים:affects_outputs
- נצברו
--experimental_multi_cpu=<comma-separated list of options>
שימושים מרובים -
הסימון הזה מאפשר לציין כמה מעבדים מרכזיים. אם תציינו זאת, המערכת תתעלם מהאפשרות -cpu.
תגים:affects_outputs
,experimental
--remote_download_minimal
-
אי אפשר להוריד פלט של מערכת בנייה מרחוק למכשיר המקומי. הדגל הזה הוא קיצור דרך לשלושה סימונים: --Experimental_inmemory_jdeps_files, --ניסיוניal_inmemory_dotd_files ו--remote_download_Outputs=minimal.
הרחבה אל:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=minimal
תגים:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
כברירת מחדל: "all"-
אם היא מוגדרת כ-'מינימלית' לא תוריד פלט של בנייה מרחוק אל המכונה המקומית, חוץ מאלה שנדרשים על-ידי פעולות מקומיות. אם הוא מוגדר ל-'toplevel' מתנהג כמו'minimal' מלבד זאת, הוא מוריד את הפלט של היעדים ברמה העליונה למחשב המקומי. שתי האפשרויות יכולות לקצר משמעותית את זמני הבנייה אם רוחב הפס של הרשת הוא צוואר בקבוק.
תגים:affects_outputs
--remote_download_symlink_template=<a string>
כברירת מחדל: ""-
במקום להוריד פלט של בנייה מרחוק אל המכונה המקומית, יש ליצור קישורים סימבוליים. ניתן לציין את היעד של הקישורים הסימבוליים בצורת מחרוזת תבנית. מחרוזת התבנית הזו עשויה להכיל {hash} ו-{size_bytes} שמתרחבות לגיבוב של האובייקט ולגודל בבייטים, בהתאמה. קישורים סמליים אלה עשויים להפנות, לדוגמה, למערכת קבצים של FUSE שטוענת אובייקטים מ-CAS לפי דרישה.
תגים:affects_outputs
--remote_download_toplevel
-
הורדה של פלטים מרוחקים של יעדים ברמה העליונה בלבד למכונה המקומית. הסימון הזה הוא קיצור דרך לשלושה סימונים: --Experimental_inmemory_jdeps_files, --testal_inmemory_dotd_files ו--remote_download_facts=toplevel.
הרחבה אל:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel
תגים:affects_outputs
- ברירת מחדל של
--symlink_prefix=<a string>
: הצגת תיאור -
הקידומת שמצורפת לכל אחד מהקישורים סימולציית הנוחות שנוצרות אחרי יצירת ה-build. אם לא צוין, ערך ברירת המחדל הוא השם של כלי ה-build ואחריו מקף. אם '/' עבר, לא יווצר קישור סימולטני ולא תיווצר אזהרה. אזהרה: הפונקציונליות המיוחדת עבור '/' תוצא משימוש בקרוב; השתמש ב- --Experimental_convenience_symlinks=ignore
במקום.
תגים:affects_outputs
- אפשרויות שמשפיעות על התדירות שבה נאכפים ב-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
תגים:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
כברירת מחדל: "false"-
אם המדיניות לא תואמת [en_force_config_setting_setting=false], זה לא"נוף". אחרת, אם הסימון הזה הוא false, כל הגדרה של config_ללא מאפיין חשיפה בוטה היא //ability:public אם הסימון הזה נכון, ההנחיה config_setting זהה ללוגיקת חשיפה כמו כל הכללים האחרים. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/12933.
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
כברירת מחדל: "false"-
אם המדיניות הזו מוגדרת כ-True, יש לאכוף את הגבלות החשיפה של ה-config_setting. אם הערך הוא False, כל הגדרה של config_גלויה לכל יעד. פרטים נוספים זמינים בכתובת 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' תחביר חלופי: regex_filter@flky_test_attempts כאשר flky_test_attempts מופיע למעלה ו-regex_filter מייצגת רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (יש לעיין גם --runs_per_test). דוגמה: --flky_test_attempts=//foo/.*,-//foo/bar/.*@3 deflakes כל הבדיקות ב-//foo/ , מלבד אלה שמתחת ל-foo/bar שלוש פעמים. ניתן להעביר את האפשרות הזו מספר פעמים. הארגומנט האחרון שעבר תואם להתאמות שהתקבלו. אם אין התאמה, ההתנהגות היא כמו " 'default' " למעלה.
תגים:execution
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
כברירת מחדל: "auto"-
המספר המקסימלי של משימות בדיקה מקומיות שניתן להריץ בו-זמנית. לוקחת מספר שלם, או מילת מפתח ("auto", "hosted_CPUS", "Host_RAM" ), ואחריה את הפעולה ([-|*]<float>) למשל. "auto", "Host_CPUS*.5". 0 פירושו שמשאבים מקומיים יגביל את מספר משימות הבדיקה המקומיות לפעול במקביל. הגדרת הערך הזה גדול יותר מהערך של --jobs היא ללא השפעה.
תגים:execution
--[no]test_keep_going
כברירת מחדל: "true"-
כשהבדיקה מושבתת, כל הבדיקות שלא יעברו בהצלחה יגרמו להפסקת הפעולה של כל הגרסה. כברירת מחדל, כל הבדיקות פועלות, גם אם חלק מהבדיקות לא עוברות.
תגים:execution
--test_strategy=<a string>
כברירת מחדל: ""-
ציון האסטרטגיה שבה משתמשים כדי להפעיל בדיקות.
תגים:execution
- ברירת מחדל של
--test_tmpdir=<a path>
: הצגת תיאור - ההגדרה מציינת את הספרייה הזמנית הבסיסית עבור 'bazel test' .
- אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום ביומן:
--[no]announce
כברירת מחדל: "false"-
הוצא משימוש. אין פעילות.
תגים:affects_outputs
--[no]experimental_bep_target_summary
כברירת מחדל: "false"- אם רוצים לפרסם אירועי Target סיכום.
--[no]experimental_build_event_expand_filesets
כברירת מחדל: "false"-
אם הקובץ מוגדר כ-True, יש להרחיב את Fileslet ב-BEP כשמציגים קובצי פלט.
תגים:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
כברירת מחדל: "false"-
אם הערך הוא True, יש לסמן באופן מלא את הסמלים היחסיים של Fileset ב-BEP כשמציגים קובצי פלט. יש צורך ב--Experimental_build_event_expand_filesets.
תגים:affects_outputs
- ברירת מחדל של
--experimental_build_event_upload_strategy=<a string>
: הצגת תיאור -
ההגדרה קובעת איך להעלות פריטי מידע שנוצרו בתהליך פיתוח (Artifact) שמוזכרים בפרוטוקול של אירוע build.
תגים:affects_outputs
--[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 להסביר את כל השלבים שבוצעו של ה-build. ההסבר נכתב לקובץ היומן שצוין.
תגים:affects_outputs
--[no]legacy_important_outputs
כברירת מחדל: "true"-
אפשר להשתמש באפשרות זו כדי למנוע יצירה של שדה חשוב_פלטים קודם באירוע Targetcomplete. נדרשים שילובs
תגים:affects_outputs
--[no]materialize_param_files
כברירת מחדל: "false"-
כתיבה של קובצי פרמטרים מסוג ביניים לעץ הפלט גם כשמשתמשים בביצוע פעולות מרחוק. שימושי במקרים של ניפוי באגים. דבר זה משתמע מ--subcommands ו- --verbose_failures.
תגים:execution
--max_config_changes_to_show=<an integer>
כברירת מחדל: "3"-
כשמוחקים את מטמון הניתוח עקב שינוי באפשרויות ה-build, מוצג עד המספר הנתון של שמות האפשרויות ששונו. אם המספר הנתון הוא -1, כל האפשרויות ששונו יוצגו.
תגים:terminal_output
--max_test_output_bytes=<an integer>
כברירת מחדל: "-1"-
ההגדרה קובעת את הגודל המקסימלי של כל יומן בדיקה לכל משתמש שניתן לבדוק כאשר --test_פלט הוא 'שגיאות' או 'הכול'. השימוש הזה עוזר להימנע מהצפה של פלט עקב שימוש בפלט רועש מדי. כותרת הבדיקה כלולה בגודל היומן. ערכים שליליים מרמזים על מגבלה. הפלט תקין או אפס.
תגים: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'
תגים:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
כברירת מחדל: "short"-
ההגדרה קובעת את הפורמט הרצוי של סיכום הבדיקה. כדי להדפיס מידע מפורט על בדיקות שנכשלו, 'detail'&&39;noneed'
תגים: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` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
--[no]experimental_guard_against_concurrent_changes
כברירת מחדל: "false"- השבתת האפשרות הזו תשבית את זמן האחזור של קובצי הקלט של פעולה לפני העלאתה למטמון מרוחק. ייתכנו מקרים שבהם הליבה של Linux תעכב את כתיבת הקבצים, וכתוצאה מכך עלולות להיות תוצאות שגויות.
--[no]experimental_remote_cache_async
כברירת מחדל: "false"- אם הערך הוא True, מטמון I/O מרוחק יתרחש ברקע במקום להיערך כחלק מה-1.
--[no]experimental_remote_cache_compression
כברירת מחדל: "false"- אם האפשרות מופעלת, אפשר לדחוס או לבטל את הדחיסה של blobs במטמון באמצעות zstd.
- ברירת מחדל של
--experimental_remote_capture_corrupted_outputs=<a path>
: הצגת תיאור - נתיב אל ספרייה שבה יתועדו הפלט הפגום.
- ברירת מחדל של
--experimental_remote_downloader=<a string>
: הצגת תיאור - URI של נקודת קצה ב-API של נכסים מרוחקים, המשמש כשרת proxy להורדה מרחוק. הסכימות הנתמכות הן grpc, GRpcs (grpc (עם TLS מופעל) ו-Unix (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תשתמש כברירת מחדל ב-GRp. למידע נוסף: https://github.com/bazelbuild/remote-apis/blob/Master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_execution_keepalive
כברירת מחדל: "false"- האם להשתמש ב-realive לשיחות מרחוק?
- ברירת מחדל של
--experimental_remote_grpc_log=<a path>
: הצגת תיאור - אם צוין, נתיב לקובץ ירשום פרטים הקשורים לשיחה עם gRPC. היומן הזה מורכב מרצף של com.google.devtools.build.lib.remote.logging.remoteE.remoteExecutionLog.LogEntry protobufs עם כל הודעה שהקידומת שלה מציינת קידומת שמציינת את הגודל של ההודעה הטורית הטורית הבאה, כפי שמבוצעת בשיטה LogEntry.writeDelimitedTo(OutputStream).
--[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' קובצי עזר רכים לא נשמרים, ייתכן ששגיאות "חסרות זיכרון" יהיו גבוהות מדי. אם הערך הוא 0, גודל המטמון לא מוגבל. הערך האופטימלי משתנה בהתאם לגודל הפרויקט. ערך ברירת המחדל הוא 1,000.
--[no]incompatible_remote_build_event_upload_respect_no_cache
כברירת מחדל: "false"- אם המדיניות מוגדרת כ-True, פלט ש-BEP מפנה אליו אינו מועלה למטמון מרוחק אם לא ניתן לשמור את פעולת היצירה במטמון מרחוק.
--[no]incompatible_remote_output_paths_relative_to_input_root
כברירת מחדל: "false"-
אם המדיניות מוגדרת כ-True, נתיבי הפלט יהיו יחסיים לשורש הקלט במקום לספרייה הפעילה.
תגים:incompatible_change
--[no]incompatible_remote_results_ignore_disk
כברירת מחדל: "false"-
אם המדיניות מוגדרת כ-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 של bytestream:// שכתובים במקורות נתונים של אירועים של build. ניתן להגדיר את האפשרות הזו כשמבצעים גרסאות build באמצעות שרת proxy, שגורם לכך שהערכים של --remote_executor ו--remote_instance_name כבר לא תואמים לשם הקנוני של שירות ההפעלה מרחוק. כשהמדיניות הזו לא מוגדרת, ברירת המחדל היא "${hostname}/${instance_name}".
- ברירת מחדל של
--remote_cache=<a string>
: הצגת תיאור - URI של נקודת קצה שנשמרת במטמון. הסכימות הנתמכות הן http, https, grpc, grpcs (grpc עם TLS מופעל) ו-Unix (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תשתמש כברירת מחדל ב-GRp. צריך לציין grpc://, http:// או Unix: כדי להשבית TLS. https://dbaze.build/docs/remote-caching
- נצברו
--remote_cache_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות לשמירה במטמון: --remote_cache_header=Name=Value. ניתן להעביר מספר כותרות על ידי ציון הסימון מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת באמצעות פסיקים.
- נצברו
--remote_default_exec_properties=<a 'name=value' assignment>
שימושים מרובים -
אם נכסי exec מוגדרים כפלטפורמת ביצוע מרחוק, ברירת המחדל תהיה שימוש כפלטפורמה לביצוע מרחוק.
תגים:affects_outputs
--remote_default_platform_properties=<a string>
כברירת מחדל: ""- ניתן להגדיר את מאפייני ברירת המחדל של הפלטפורמה כ-API של ביצוע מרחוק, אם פלטפורמת ההפעלה לא הגדירה עדיין Remote_execution_properties. המערכת תשתמש בערך הזה גם אם פלטפורמת המארח נבחרה כפלטפורמת ביצוע לביצוע מרחוק.
- נצברו
--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>
: הצגת תיאור - מארח או מתארח:PORT של נקודת קצה להפעלה מרחוק. הסכימות הנתמכות הן grpc, GRpcs (grpc (עם TLS מופעל) ו-Unix (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תשתמש כברירת מחדל ב-GRp. צריך לציין 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"- No-op, מיושן. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/7480.
--remote_max_connections=<an integer>
כברירת מחדל: "100"-
הגבלת המספר המקסימלי של חיבורים בו-זמניים למטמון/ביצוע מרחוק. כברירת מחדל, הערך הוא 100. אם מגדירים את הערך כ-0, אין הגבלה.
למטמון של HTTP מרחוק, חיבור אחד של TCP יכול לטפל בבקשה אחת בכל פעם, כך ש-Bazel יכולה לבצע עד בו-זמנית בקשות בו-זמנית.
עבור מטמון/ביצוע מרוחק של gRPC, ערוץ gRPC אחד בדרך כלל יכול לטפל ביותר מ-100 בקשות בו-זמנית, כך ש-Bazel יכולה לבצע כ-100 בקשות בו-זמנית * 1
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--remote_proxy=<a string>
: הצגת תיאור - מתחברים למטמון המרוחק דרך שרת proxy. בשלב זה, ניתן להשתמש בסימון הזה רק כדי להגדיר שקע דומיין Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
כברירת מחדל: "0"- העדיפות היחסית של פעולות מרוחקות שנשמרו במטמון מרוחק. הסמנטיקה של ערכי העדיפות הספציפיים תלוית שרת.
--remote_retries=<an integer>
כברירת מחדל: "5"- מספר הניסיונות המקסימלי לניסיון חוזר של שגיאה זמנית. אם המדיניות מוגדרת כ-0, הניסיונות החוזרים מושבתים.
--remote_timeout=<An immutable length of time.>
כברירת מחדל: "60s"- משך הזמן המקסימלי להמתנה לביצוע מרחוק של שיחות ולשמירת מטמון. במטמון REST, מדובר גם בחיבור וגם בזמן קצוב לתפוגה של קריאה. אפשר להשתמש ביחידות הבאות: ימים (d), שעות (h), דקות (m), שניות (s) ואלפיות שנייה (ms). אם תשמיט את היחידה, הערך יפורש בשניות.
--[no]remote_upload_local_results
כברירת מחדל: "true"- אם מעלים למטמון המרוחק תוצאות של פעולות שבוצעו באופן מקומי.
--[no]remote_verify_downloads
כברירת מחדל: "true"- אם היא מוגדרת כ-true, מערכת Bazel תחשב את סכום הגיבוב של כל ההורדות מרחוק ותמחק את הערכים שנשמרו במטמון מרחוק, אם הם לא תואמים לערך הצפוי.
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות:
--auto_output_filter=<none, all, packages or subpackages>
כברירת מחדל: "none"- אם לא מזינים את הפרמטר ‘Output_filter, המערכת תשתמש בערך הזה כדי ליצור מסנן באופן אוטומטי. הערכים המותרים הם 'none' (מסנן שום דבר / הצגת הכול), 'all' (מסננים הכול / לא מציגים שום דבר) 'packages' (כולל פלט מכללים בחבילות שהוזכרו בשורת ה-Blaze), וגם 'חבילות'חבילות 'חבילות'חבילות עבור 'packages' and 'subpackages'; //javascript/foo and //JavaScripttests/foo נחשב כחבילה אחת)'.
--[no]build_manual_tests
כברירת מחדל: "false"- מתבצעת התקנה של יעדי בדיקה שתויגו 'ידני'. 'ידני' בדיקות לא נכללות בעיבוד. האפשרות הזו מאלצת את בנייתם (אבל לא את השימוש בהם).
--build_tag_filters=<comma-separated list of options>
כברירת מחדל: ""- ההגדרה מציינת רשימת תגים המופרדים בפסיקים. לפני כל תג אפשר להוסיף '-' כדי לציין את התגים שהחרגת. רק היעדים האלה יווצרו הכוללים לפחות תג כלול אחד שאינו מכיל תגים שלא נכללים. אפשרות זו לא משפיעה על קבוצת הבדיקות שבוצעו באמצעות הפקודה 'test'
--[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_packages 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>
: הצגת תיאור - אפשר לתעד את ההרצה של הקובץ שנשלח כפרוטוקול ל-Propen, תחילה רושמים את היומן ללא סדר, ואז בסוף ההפעלה, הוא ממוין בסדר קבוע (ייתכן שכדי להפעיל אותו יש צורך במעבד ובזיכרון). סימונים קשורים: --execution_log_json_file (בפורמט json של טקסט שהוזמן), --Experimental_execution_log_file (פורמט לא בינארי של קובץ protobuf) ללא סדר משנה (להצגה של פקודות משנה בפלט מסוף).
- ברירת מחדל של
--execution_log_json_file=<a path>
: הצגת תיאור - אפשר לתעד את ההצטברות המבוצעת בקובץ הזה כייצוג json של פרוטוסים מופרדים בפסיקים, בהתאם ל- src/main/protobuf/spawn.proto. תחילה רושמים את היומן ללא סדר, ואז בסוף ההפעלה, הוא ממוין בסדר קבוע (ייתכן שכדי להפעיל אותו יש צורך במעבד ובזיכרון). סימונים קשורים: סימונים קשורים: --execution_log_binary_file (בפורמט בינארי מסוג protobuf) –
--[no]expand_test_suites
כברירת מחדל: "true"-
מומלץ להרחיב את היעדים test_Suite לבדיקות העיקריות שלהם לפני הניתוח. כשהסימון הזה מופעל (ברירת המחדל), דפוסי היעד השליליים יחולו על הבדיקות השייכות לחבילת הבדיקה, אחרת הן לא יפעלו. כיבוי הדגל הזה שימושי כשמחילים היבטים ברמה העליונה בשורת הפקודה: לאחר מכן הם יכולים לנתח מטרות מסוג test_Suite.
תגים:loading_and_analysis
- ברירת מחדל של
--experimental_execution_log_file=<a path>
: הצגת תיאור - אפשר לתעד את ההרצה של הקובץ שנשלח כפרוטוקול ל-Propen, הקובץ הזה נכתב לפי סדר הפעלת ה-Spwns. סימונים קשורים: --execution_log_binary_file (פורמט בינארי Protobuf מסודר), --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"- הוצא משימוש בשל היבטים. תזמון רק פעולות additional_action עבור יעדים ברמה העליונה.
--experimental_local_execution_delay=<an integer>
כברירת מחדל: "1000"- כמה אלפיות שנייה לדחות את הביצוע המקומי, אם ההפעלה מרחוק הייתה מהירה יותר במהלך גרסת build?
--[no]experimental_local_memory_estimate
כברירת מחדל: "false"- כדי להעריך את הזיכרון הזמין בפועל באינטרנט. כברירת מחדל, Blaze מניח שרוב הפעולות משתמשות בכמות זיכרון קבועה, וסופרת את הזיכרון הכולל הכולל של המערכת, ללא קשר לזיכרון הזמין בפועל. אפשרות זו מאפשרת לבצע הערכה מקוונת של כמות הזיכרון הזמינה בכל רגע נתון, ולכן לא דורשת הערכה מדויקת של נפח הזיכרון שפעולה נתונה תבצע.
--experimental_persistent_javac
-
הפעלת המהדר הניסיוני המתמשך של Java.
הרחבה אל:
--strategy=Javac=worker
--strategy=JavaIjar=local
--strategy=JavaDeployJar=local
--strategy=JavaSourceJar=local
--strategy=Turbine=local
--[no]experimental_prioritize_local_actions
כברירת מחדל: "true"-
אם המדיניות מוגדרת, פעולות שניתן להריץ באופן מקומי בלבד יקבלו הזדמנות ראשונה לרכוש משאבים, עובדים שירוצים באופן דינמי יקבלו הזדמנות שנייה, ופעולות עצמאיות שמופעלות באופן דינמי יהיו עדכניות.
תגים:execution
--experimental_spawn_scheduler
-
הפעלה דינמית מאפשרת לך לבצע פעולות באופן מקומי ומרוחק במקביל. Bazel מבצעת כל פעולה באופן מקומי ומרוחק, ובוחרת את הפעולה המסתיימת ראשונה. אם פעולה תומכת ב-worker, הפעולה המקומית תרוץ במצב 'קבוע'. כדי להפעיל ביצוע דינמי בפעולה אחת
הרחבה אל:
--internal_spawn_scheduler
--spawn_strategy=dynamic
--[no]experimental_worker_as_resource
כברירת מחדל: "false"-
אם עובדים, הם מקבלים משאבים כמשאבים מ-ResourceManager.
תגים:execution
--[no]experimental_worker_cancellation
כברירת מחדל: "false"-
אם האפשרות מופעלת, Bazel עשויה לשלוח בקשות ביטול לעובדים שתומכים בהן.
תגים:execution
- נצברו
--experimental_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">
שימושים מרובים -
כמה בקשות עבודה ב-WorkRequests יכולות להתבצע במקביל, אם תשתמשו בשיטה 'worker' עם יכול להיות מצוין כ-[name=value] כדי לתת ערך שונה לכל אופרטור. לוקחת מספר שלם, או מילת מפתח ("auto", "hosted_CPUS", "Host_RAM" ), ואחריה את הפעולה ([-|*]<float>) למשל. "auto", "Host_CPUS*.5". 'auto' מחושב כברירת מחדל סבירה, על סמך קיבולת המכונה. "=value" מגדיר ברירת מחדל לפונקציות לא ידועות.
תגים:host_machine_resource_optimizations
--[no]experimental_worker_multiplex
כברירת מחדל: "true"- כשהאפשרות מופעלת, עובדים שתומכים בתכונה הניסיונית ' Multiplex' משתמשים בתכונה הזו.
--[no]experimental_worker_multiplex_sandboxing
כברירת מחדל: "false"-
אם המדיניות מופעלת, מספר ארגזי חול (Sandbox) יועברו לארגז חול, באמצעות ספריית Sandbox נפרדת לכל בקשת עבודה. רק עובדים שיש להם 'supports-multix-sandboxed' ארגז חול של ארגז חול
תגים:execution
- ברירת מחדל של
--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 אחת בהמתנה. זמנים מתייחסים לרמת פירוט של שנייה. שגיאה בהגדרה של ערך שאינו שנייה. כברירת מחדל, פינגים פעילים. לפני שמפעילים את ההגדרה הזו, צריך לתאם עם הבעלים של השירות.
--grpc_keepalive_timeout=<An immutable length of time.>
כברירת מחדל: "20s"- הגדרת זמן קצוב לתפוגה של חיבורים פעילים של gRPC. אם פינגים מסוג keep-alive מופעלים באמצעות --grpc_keepalive_time, סימן ש-Bazel תם הזמן הקצוב לחיבור אם הוא לא מקבל תשובה בפינגים אחרי פרק הזמן הזה. זמנים מתייחסים לרמת פירוט של שנייה. שגיאה בהגדרה של ערך שאינו שנייה. אם פינגים פעילים נשמרים, המערכת תתעלם מההגדרה הזו.
- נצברו
--high_priority_workers=<a string>
שימושים מרובים - הנצחה של העובדים לפעול בעדיפות גבוהה. כאשר עובדים בעדיפות גבוהה רצים לכל שאר העובדים, המשתמשים מווסתים.
--[no]ignore_unsupported_sandboxing
כברירת מחדל: "false"- אין להדפיס אזהרה כשההפעלה בארגז החול לא נתמכת במערכת הזו.
--[no]incompatible_dont_use_javasourceinfoprovider
כברירת מחדל: "false"-
No-op
תגים:incompatible_change
- ברירת מחדל של
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "Host_CPUS" - יש להגדיר במפורש את המספר הכולל של ליבות המעבד (CPU) המקומיות שזמינות ל-Bazel לצורך הוצאה בפעולות בנייה שבוצעו באופן מקומי. לוקח מספר שלם, או "Host_CPUS" ואופציונלי, אחריו [-|*]<float> (למשל מארחים_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'
- נצברו
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
שימושים מרובים - הוספה של זוג מסלולים נוסף לטעינה בארגז החול.
--sandbox_base=<a string>
כברירת מחדל: ""- מתן הרשאה לארגז החול ליצור את ספריות ארגז החול שלו מתחת לנתיב הזה. יש לציין נתיב בפורמט tmpf (כגון /run/shm) כדי לשפר את הביצועים לעיתים קרובות, כאשר גרסת build / הבדיקות כוללת קובצי קלט רבים. הערה: יש צורך בשטח RAM מספיק ובשטח אחסון פנוי ב-tmpf כדי לשמור קובצי פלט וקובצי ביניים שנוצרו על ידי פעולות פעילות.
- נצברו
--sandbox_block_path=<a string>
שימושים מרובים - בפעולות בארגז חול, אין לאפשר גישה לנתיב הזה.
--[no]sandbox_debug
כברירת מחדל: "false"- הפעלת תכונות ניפוי באגים באמצעות התכונה 'ארגז חול'. הדבר כולל שני דברים: תחילה, תוכן הבסיס של ארגז החול נשאר ללא שינוי לאחר יצירת build (ואם נעשה שימוש בארגזי חול (Sandboxfs), מערכת הקבצים נשארת מותקנת, והשנייה היא הדפסה של מידע נוסף על ניפוי באגים בזמן הביצוע. זה יכול לעזור למפתחים של כללי Bazel או Starlark לבצע כשלי ניפוי באגים עקב קובצי קלט חסרים וכו'.
--[no]sandbox_default_allow_network
כברירת מחדל: "true"- אישור גישה לרשת כברירת מחדל עבור פעולות. ייתכן שהשיטה הזו לא תפעל בכל הטמעות ה-Sandbox.
--[no]sandbox_fake_hostname
כברירת מחדל: "false"- שינוי שם המארח הנוכחי ל&&39;localhost' עבור פעולות בארגז חול.
--[no]sandbox_fake_username
כברירת מחדל: "false"- יש לשנות את שם המשתמש הנוכחי ל-'nobody' לפעולות בארגז חול.
- נצברו
--sandbox_tmpfs_path=<an absolute path>
שימושים מרובים - לפעולות בארגז חול, יש להציב ספרייה ריקה וניתנת לכתיבה בנתיב המוחלט הזה (אם המערכת מיישמת את ההטמעה בארגז החול, המערכת מתעלמת ממנה).
- נצברו
--sandbox_writable_path=<a string>
שימושים מרובים - לפעולות בארגז חול, יש ליצור ספרייה קיימת בתוך ארגז החול (אם היא נתמכת על ידי הטמעת ארגז חול, המערכת תתעלם ממנה).
--[no]show_loading_progress
כברירת מחדל: "true"- אם מופעל, גורם ל-Bazel להדפיס {0} "חבילה
--test_lang_filters=<comma-separated list of options>
כברירת מחדל: ""- ההגדרה קובעת רשימה של שפות בדיקה מופרדות בפסיקים. ניתן להוסיף לפני כל שפה את &&39;-' כדי לציין שפות שלא נכללו. רק יעדי הבדיקה האלה יימצאו בשפות שצוינו. השם המשמש לכל שפה צריך להיות זהה לתחילית השפה בכלל *_test, למשל 'cc', 'javascript', &'py' וכו'. האפשרות הזו משפיעה על --build_tests_only behavior ועל הפקודה test.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
כברירת מחדל: ""- קביעת רשימה של גודלי בדיקה המופרדים בפסיקים. לפני כל גודל אפשר להוסיף '-' כדי לציין את אי-הגדלים. רק יעד הבדיקה הזה יוצג אם הוא מכיל לפחות מידה אחת שנכללה, ושאין בו גדלים שהוחרגו. אפשרות זו משפיעה על התנהגות --build_tests_only ועל הפקודה לבדיקה.
--test_tag_filters=<comma-separated list of options>
כברירת מחדל: ""- קביעת רשימה של תגי בדיקה מופרדים בפסיקים. לפני כל תג אפשר להוסיף '-' כדי לציין את התגים שהחרגת. רק יעדי הבדיקה האלה יימצאו מכילים לפחות תג כלול אחד ואינם מכילים תגים שלא נכללים. אפשרות זו משפיעה על התנהגות --build_tests_only ועל הפקודה לבדיקה.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
כברירת מחדל: ""- קביעת רשימה של זמני קצוב לתפוגה המופרדים בפסיקים. אחרי כל זמן קצוב לתפוגה, אפשר להוסיף לפני '-' כדי לציין החרגות של זמן קצוב לתפוגה. רק יעדי הבדיקה האלה יימצאו ושמכילים לפחות זמן קצוב לתפוגה אחד, ושאין בהם זמן קצוב לתפוגה. אפשרות זו משפיעה על התנהגות --build_tests_only ועל הפקודה לבדיקה.
- ברירת מחדל של
--tls_certificate=<a string>
: הצגת תיאור - יש לציין נתיב לאישור TLS מהימן לחתימה על אישורי שרת.
- ברירת מחדל של
--tls_client_certificate=<a string>
: הצגת תיאור - יש לציין את אישור הלקוח ל-TLS שבו רוצים להשתמש. צריך גם לספק מפתח לקוח כדי להפעיל אימות לקוח.
- ברירת מחדל של
--tls_client_key=<a string>
: הצגת תיאור - יש לציין את מפתח הלקוח ב-TLS שבו יש להשתמש. כמו כן, צריך לספק אישור לקוח כדי להפעיל את אימות הלקוח.
- נצברו
--worker_extra_flag=<a 'name=value' assignment>
שימושים מרובים - סימון נוסף של פקודות שיועבר לתהליכי עובדים, בנוסף ל--persistent_worker, שנוצר על ידי המשמעה (למשל --worker_extra_flag=Javac=--debug.
- נצברו
--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", "hosted_CPUS", "Host_RAM" ), ואחריה את הפעולה ([-|*]<float>) למשל. "auto", "Host_CPUS*.5". 'auto' מחושב כברירת מחדל סבירה, על סמך קיבולת המכונה. "=value" מגדיר ברירת מחדל לפונקציות לא ידועות.
תגים:host_machine_resource_optimizations
--[no]worker_quit_after_build
כברירת מחדל: "false"- אם המדיניות מופעלת, כל העובדים מפסיקים לאחר סיום ה-build.
--[no]worker_sandboxing
כברירת מחדל: "false"- אם אפשרות זו מופעלת, העובדים יבוצעו בסביבת ארגז חול.
--[no]worker_verbose
כברירת מחדל: "false"- אם האפשרות מופעלת, מדפיסים הודעות עם הסברים על כך שהעובדים עובדים, יוצאים לדרך, ...
--workspace_status_command=<path>
כברירת מחדל: ""- פקודה מופעלת בתחילת ה-build כדי לספק מידע על סטטוס סביבת העבודה בצורת זוגות מפתח/ערך. המדריך המלא כולל את המדריך למשתמש. כדי לראות דוגמה, אפשר לעיין גם בכלים/buildstamp/get_workspace_status.
- אפשרויות ששולטות בביצוע גרסאות:
--[no]check_up_to_date
כברירת מחדל: "false"-
אין לבצע את הבנייה, רק צריך לבדוק אם היא מעודכנת. אם כל היעדים מעודכנים, גרסת ה-build הושלמה בהצלחה. אם יש צורך לבצע שלב כלשהו בדיווח, מדווחת שגיאה וה-build נכשל.
תגים:execution
--[no]experimental_inprocess_symlink_creation
כברירת מחדל: "false"-
האם אפשר להתקשר ישירות למערכת קבצים כדי ליצור עצים סימליים
תגים: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 שמכיל את יומן הבדיקה. אחרת, Bazel יוצרת בדיקת test.xml כחלק מפעולת הבדיקה.
תגים:execution
--[no]experimental_strict_fileset_output
כברירת מחדל: "false"-
אם האפשרות הזו מופעלת, Files יתייחסו לכל פריטי הפלט כקבצים רגילים. הם לא יעבירו ספריות ורגישים לקישורים.
תגים:execution
--genrule_strategy=<comma-separated list of options>
כברירת מחדל: ""-
יש לציין איך מבצעים כללי כלל. הסימון הזה יופסק. במקום זאת, השתמשו ב- -spawn_strategy=<value> כדי לשלוט בכל הפעולות או באפשרות –strategy=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", "hosted_CPUS", "Host_RAM" ), ואחריה את הפעולה ([-|*]<float>) למשל. "auto", "Host_CPUS*.5". הערכים צריכים להיות בין 1 ל-5,000. ערך גבוה מ-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", "hosted_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' מוסיף 'x' &'z ' אל ומסירים את פרטי הביצוע של ##99;y'
'Genrule=+requires-x'add 'requires-x' לפרטי הביצוע של כל פעולות הז'אנר.
'(?!Genrule).*=-requires-x' removed 'requires-x' מנתוני הביצוע של כל הפעולות שאינן כלליות.
תגים:execution
,affects_outputs
,loading_and_analysis
--persistent_android_resource_processor
-
ניתן להשתמש במעבד המידע כדי לעבד באופן קבוע את מעבד המשאבים של Android.
מתרחב אל:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
1--strategy=AaptPackage=worker
--spawn_strategy=<comma-separated list of options>
כברירת מחדל: ""-
יש לציין איך מתבצעות פעולות שנוצרו כברירת מחדל. ניתן להשתמש ברשימת אסטרטגיות המופרדות בפסיקים, מהגבוהה ביותר לנמוכה ביותר. לכל פעולה, Bazel בוחרת את האסטרטגיה בעלת העדיפות הגבוהה ביותר שיכולה לבצע את הפעולה. ערך ברירת המחדל הוא "remote,work,sandboxed,local". פרטים נוספים זמינים בכתובת https://blog.bazel.build/2019/06/19/list-strategy.html.
תגים:execution
- נצברו
--strategy=<a '[name=]value1[,..,valueN]' assignment>
שימושים מרובים -
יש לציין איך להפיץ אוסף של פעולות אחרות הקשורות להפקה. ניתן להשתמש ברשימת אסטרטגיות המופרדות בפסיקים, מהגבוהה ביותר לנמוכה ביותר. לכל פעולה, Bazel בוחרת את האסטרטגיה בעלת העדיפות הגבוהה ביותר שיכולה לבצע את הפעולה. ערך ברירת המחדל הוא "remote,work,sandboxed,local". הסימון הזה מבטל את הערכים שהוגדרו על ידי --spawn_strategy (וגם --genrule_strategy אם נעשה שימוש ב-Menemonic Genrule). פרטים נוספים זמינים בכתובת https://blog.bazel.build/2019/06/19/list-strategy.html.
תגים:execution
- נצברו
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
שימושים מרובים -
כדאי לשנות את שיטת ההשטיפה שמבצעת פעולות לביצוע עם תיאורים שתואמים ל-regex_filter מסוים. לפרטים על התאמה של מסנן רגולרי (regex) יש לעיין בפרמטר --per_file_copt. נעשה שימוש ב-regex_filter הראשון שתואם לתיאור. אפשרות זו מבטלת את הסימונים האחרים לציון האסטרטגיה. דוגמה: --strategy_regexp=//foo.*\.cc,-//foo/bar=local פירושו להריץ פעולות באמצעות אסטרטגיה מקומית אם התיאורים שלהם תואמים ל-//foo.*.cc אבל לא //foo/bar. דוגמה: --strategy_regexp='Compiling.*/bar=local --strategy_regexp=Compiling=sandboxed; יפעל עם 'Compiling //foo/bar/baz' with 'local'
תגים:execution
- אפשרויות שמגדירות את ארגז הכלים המשמש לביצוע הפעולה:
- ברירת מחדל של
--android_compiler=<a string>
: הצגת תיאור -
מהדר היעד של Android.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_crosstool_top=<a build target label>
: "//external:android/crosstools" -
המיקום של מהדר 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"-
קביעת SDK/פלטפורמה של Android שמשמשת לבניית אפליקציות ל-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:toolschain" -
התווית של חבילת הכלים השונים לשימוש בכללי 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_variable"-
המיקום של הקובץ הבינארי המשמש ליצירת דוחות כיסוי. נכון לעכשיו זו חייבת להיות קבוצת קבצים שמכילה קובץ אחד, הקובץ הבינארי. ברירת המחדל היא '//tools/test:coverage_report_variable'.
תגים: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:toolschain" -
התווית של חבילת הכלי המוצלב שבה יש להשתמש כדי להרכיב קוד C++.
תגים:loading_and_analysis
,changes_inputs
,affects_outputs
- ברירת מחדל של
--custom_malloc=<a build target label>
: הצגת תיאור -
ציון של הטמעה מותאמת אישית של Malloc. ההגדרה הזו מבטלת את המאפיינים של Malloc בכללי Build.
תגים:changes_inputs
,affects_outputs
- נצברו
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
שימושים מרובים -
רשימה של ביטויים רגולריים המופרדים בפסיקים, שאפשר להוסיף להם את הסימן - (ביטוי שלילי) כדי להקצות אותם (=) לרשימה של יעדי ערך אילוץ שמופרדים בפסיקים. אם יעד מסוים לא תואם לאף ביטוי שלילי ולפחות ביטוי חיובי אחד, רזולוציית הכלי תבוצע כאילו הוא הצהיר שערכי האילוץ הם אילוצי הביצוע. דוגמה: //demo,-test=@platforms//cpus:x86_64 יתווסף אל 'x86_64' לכל יעד השייך ל-//demo מלבד אלה שהשם שלהם מכיל 'test'.
תגים:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
כברירת מחדל: "true"-
מתן אפשרות לכללים 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 על ידיenroll_execution_platforms().
תגים:execution
- נצברו
--extra_toolchains=<comma-separated list of options>
שימושים מרובים -
הכללים של כלי הכלים שיש להתייחס אליהם במהלך פתרון הבעיות בכלי. ניתן לציין מחזיקי כלים לפי יעד מדויק, או כתבנית יעד. שרשראות הכלים האלה יילקחו בחשבון לפני הרשומות של קובץ ה-WORKSPACE על ידיenroll_toolschains().
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--grte_top=<a label>
: הצגת תיאור -
תווית לספריית Libc בצ'ק-אין. ערך ברירת המחדל נבחר על ידי ארגז הכלים של הכלי המוצלב, וכמעט לא תצטרכו לעקוף אותו.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_compiler=<a string>
: הצגת תיאור -
מהדר C++ המשמש לאיסוף הידור. המערכת מתעלמת מהפרמטר הזה אם --host_crosstools_top לא מוגדר.
תגים:loading_and_analysis
,execution
- ברירת מחדל של
--host_crosstool_top=<a build target label>
: הצגת תיאור -
כברירת מחדל, גם אפשרויות ה- --פיינק מהלך --ורכיב המהדר -- משמשות גם להגדרת המארח. אם סימון זה מופיע, ה-Bazel משתמש ב-libc ובמהדר המוגדר כברירת מחדל עבור ה-crosstools_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 לא תפעיל את &&39;host' 'nonhost' את C++ Toolchain (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/7407).
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
כברירת מחדל: "false"-
שימוש ברזולוציה של Toolchain כדי לבחור את ה-SDK ל-Android לכללי Android (Starlark ו-Native)
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
כברירת מחדל: "false"-
שימוש ברזולוציית כלים כדי לבחור את ה-SDK של Apple לכללי תפוחים (Starlark ומותאמות)
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
כברירת מחדל: "true"-
אם הערך הוא true, Bazel תשתמש שוב בשורות של פעולת הקישור ל-C++ כדי להוסיף לשורות הפקודה של Lto באינדקס (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/6791).
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
כברירת מחדל: "true"-
אם הערך הוא true, Bazel מתלונן כאשר מוגדרים המאפיינים cc_toolschain.cpu ו-cc_toolschain.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"-
אם הדבר נכון, מערכת Bazel תדרוש 'ctx'
תגים:loading_and_analysis
,incompatible_change
-
שימוש באובייקטים משותפים בממשק, אם הם נתמכים על ידי הכלי הזה. כל מחזיקי הכלים של ELF תומכים בשלב זה בהגדרה הזו.
תגים:loading_and_analysis
,affects_outputs
,affects_outputs
- ברירת מחדל של
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: הצגת תיאור -
ההגדרה קובעת את גרסת ה-SDK של iOS שבה משתמשים כדי ליצור אפליקציות ל-iOS. אם לא צוין, נעשה שימוש בגרסת ה-SDK ל-iOS המוגדרת כברירת מחדל מ-'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: הצגת תיאור -
הגדרה של גרסת ה-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' (קובץ שנמצא מתחת לבסיס של סביבת העבודה).
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
כברירת מחדל: ""-
התוויות של כללי הפלטפורמה שמתארות את פלטפורמות היעד של הפקודה הנוכחית.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--python2_path=<a string>
: הצגת תיאור -
הוצא משימוש, no-op. הושבת על ידי `--incompliance_use_python_toolschains`.
תגים:no_op
,deprecated
- ברירת מחדל של
--python3_path=<a string>
: הצגת תיאור -
הוצא משימוש, no-op. הושבת על ידי `--incompliance_use_python_toolschains`.
תגים:no_op
,deprecated
- ברירת מחדל של
--python_path=<a string>
: הצגת תיאור -
הנתיב המוחלט של כלי התרגום של Python הופעל להפעלת יעדים ב-Python בפלטפורמת היעד. הוצא משימוש; הושבת על ידי --incompliance_use_python_toolschains.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--python_top=<a build target label>
: הצגת תיאור -
התווית של py_runtime שמייצגת את תרגום ה-Python שהופעל כדי להפעיל יעדי Python בפלטפורמת היעד. הוצא משימוש; הושבת על ידי --incompliance_use_python_toolschains.
תגים: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 שבה רוצים להשתמש כדי ליצור אפליקציות טלוויזיה. אם לא צוין אחרת, המערכת משתמשת בגרסת ברירת המחדל של ה-SDK של tvOS מאת 'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: הצגת תיאור -
קביעת הגרסה של ה-SDK של WatchOS שבה רוצים להשתמש כדי ליצור אפליקציות WatchOS. אם לא צוין אחרת, המערכת תשתמש בגרסת ה-SDK שהוגדרה ל-watchOS כברירת מחדל מהכתובת 'xcode_version'
תגים:loses_incremental_state
- ברירת מחדל של
--xcode_version=<a string>
: הצגת תיאור -
אם צוין, נעשה שימוש ב-Xcode של הגרסה הנתונה לפעולות build רלוונטיות. אם לא צוין אחרת, נעשה שימוש בגרסת ברירת המחדל של ה-Xcoder.
תגים: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, ומחזיר אפס אם שלבי הטעינה והניתוח של החבילה הושלמו בהצלחה; מצב זה שימושי לבדיקת השלבים האלה.
תגים:execution
,affects_outputs
--[no]build_runfile_links
כברירת מחדל: "true"-
אם זה מוגדר, יש לבנות יערות קישורים של קובצי ריצה עבור כל היעדים. אם הערך הוא False, יש לכתוב מניפסטים רק כאשר הדבר אפשרי.
תגים:affects_outputs
--[no]build_runfile_manifests
כברירת מחדל: "true"-
אם הערך הוא true, יש לכתוב מניפסטים של Runruns בכל היעדים. אם הם שגויים, יש להשמיט אותם. בדיקות מקומיות ייכשלו כשהן הוגדרו כ-False.
תגים:affects_outputs
--[no]build_test_dwp
כברירת מחדל: "false"-
אם המדיניות מופעלת, כשיוצרים בדיקות C++ באופן סטטי ובהשהיה, קובץ ה-dvp של הקובץ הבינארי של הבדיקה יהיה גם הוא נבנה באופן אוטומטי.
תגים: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_validation.
תגים: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++ וקישורים. אפשר לשלב כל שילוב של {'quickbuild', 'dbg', 'opt'} או את הערכים המיוחדים 'yes' כדי להשבית את כל המצבים &&339;no' כדי להשבית את כל המצבים.
תגים:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]legacy_external_runfiles
כברירת מחדל: "true"-
אם פעולה זו מוגדרת כ-TRUE, יש לבנות יערות סימבול של Run Runlinks עבור מאגרים חיצוניים בסיומת .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.
תגים: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>
שימושים מרובים -
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם הגדרת יעד. אפשר לציין משתנים לפי שם, ובמקרה כזה הערך יילקח מסביבת ההפעלה, או מצמד של שם=ערך שמגדיר את הערך ללא קשר לסביבת ההפעלה. ניתן להשתמש באפשרות הזו מספר פעמים. אם מגדירים את אותו משתנה, נצברות הווריאציות האחרונות וגם צוברים את האפשרויות השונות.
תגים: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 Databind 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' פירושו ש-Bazel תבחר אם לקשר באופן דינמי. 'LY' פירושו שכל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי בעיקר.
תגים:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
כברירת מחדל: "alphabetical"-
הגדרת הסדר של המניפסטים שהועברו למיזוג של המניפסט עבור קבצים בינאריים של Android. ALPHABETICAL כלומר מניפסטים ממוינים לפי נתיב ביחס ל-executroot. 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>
שימושים מרובים -
יש לציין את מצב הסיביות של Apple לשלבי ההידור שמטרגטים את ארכיטקטורות המכשירים. הערכים צריכים להיות בפורמט '[platform=]mode' כאשר הפלטפורמה (חייבת להיות 'ios', 'macos', 'tvos' או 'watchos' ) היא אופציונלית. אם ציינתם קוד כזה, הוא מיושם באופן ספציפי עבור הפלטפורמה הזו. אם הוא חסר, הוא חל על כל הפלטפורמות. המצב חייב להיות &&39;none', 'embedded_טושים' או 'embedded' ייתכן שהאפשרות הזו תוצג כמה פעמים.
תגים:loses_incremental_state
- נצברו
--aspects=<comma-separated list of options>
שימושים מרובים - רשימת היבטים המופרדים בפסיקים שצריך להחיל על יעדים ברמה העליונה. ברשימה, אם היבט some_aspect מציין ספקי היבט נדרשים באמצעות required_aspect_providers, חלק_מספקים יפעלו לאחר כל היבט שהוזכר לפניו ברשימת ההיבטים שהספקים שמפרסמים שלהם עומדים בספק כלשהו של ספקי היבט. מלבד זאת, Any_aspect יפעל אחרי כל ההיבטים הנדרשים שמצוינים באמצעות מאפיין. ל-some_aspect תהיה גישה לערכים של ההיבטים האלה'. <bzl-file-label>%<aspect_name>, לדוגמה '//tools:my_def.bzl%my_aspect' כאשר 'my_aspect' הוא ערך ברמה העליונה מכלי קובץ/my_def.bzl
--[no]build_python_zip
כברירת מחדל: "auto"-
בניית מיקוד לקובץ python שניתן להפעלה; ב-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. בדרך כלל אין לציין אפשרות זו ישירות – 'כיסוי פנים' יש להשתמש בפקודה במקום זאת.
תגים:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ברירת מחדל: "quickbuild"-
ציון המצב שבו הקובץ הבינארי יהיה מובנה. Value: 'quickbuild', 'dbg', 'opt'.
תגים:affects_outputs
,action_command_lines
,explicit_in_output_path
- נצברו
--conlyopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc בעת הידור קובצי מקור ב-C.
תגים:action_command_lines
,affects_outputs
- נצברו
--copt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-GCC.
תגים: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>
: הצגת תיאור -
cscsff_profile שמייצג את הפרופיל הרגיש של ההקשר שישמש לאופטימיזציה.
תגים:affects_outputs
- נצברו
--cxxopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-GCC במהלך הידור קובצי מקור ב-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"-
הפעלה של עץ סימולט של קובצי הפעלה; כברירת מחדל, האפשרות מושבתת ב-Windows, בפלטפורמות אחרות.
תגים:affects_outputs
- נצברו
--experimental_action_listener=<a build target label>
שימושים מרובים -
הוצא משימוש בשל היבטים. אפשר להשתמש ב-action_listener כדי לצרף additional_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"-
להשתמש בגרסה ל-Android של קישור נתונים גרסה 2
תגים: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
- ברירת מחדל של
--[no]experimental_convenience_symlinks
: "normal" -
הסימון הזה קובע איך ינוהלו הקישורים הצדדיים (הקישורים הדינמיים שמופיעים בסביבת העבודה לאחר ה-build). ערכים אפשריים:
רגיל (ברירת מחדל): כל סוג של קישור נוחות ייווצר או יימחק, כפי שנקבע על ידי ה-build.
ניקיון: כל הסימולינים יימחקו ללא תנאי.
התעלמות: הקישורים המיידיים לא יימחקו.
log_only: יצירת הודעות יומן כאילו הועברו ל'regular' אבל לא מתבצעת בפועל פעילות של מערכת קבצים (מועילה עבור כלים).
לידיעתכם, ייתכן שתהיה השפעה רק על קישורים סימטריים שהשמות שלהם נוצרים על ידי הערך הנוכחי של --symlink_prefix. אם הקידומת משתנה, כל הקישורים הקיימים הקיימים יישארו ללא שינוי.
תגים:affects_outputs
--[no]experimental_convenience_symlinks_bep_event
כברירת מחדל: "false"-
הסימון הזה קובע אם נפרסם את אירוע BuildConvenienceSymlinksIdentified ב-BuildEventProtocol. אם הערך הוא true, ל-BuildEventProtocol תהיה רשומה עבורנוחות SymlinksIdentified, הכוללת את כל קישורי הנוחות שנוצרו בסביבת העבודה שלכם. אם הערך הוא False, הרשומה ל-נוחותSymlinksIdentified ב-BuildEventProtocol תהיה ריקה.
תגים:affects_outputs
- נצברו
--experimental_multi_cpu=<comma-separated list of options>
שימושים מרובים -
הסימון הזה מאפשר לציין כמה מעבדים מרכזיים. אם תציינו זאת, המערכת תתעלם מהאפשרות -cpu.
תגים:affects_outputs
,experimental
- ברירת מחדל של
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
המערכת משתמשת במחרוזות האלה כאפשרויות מהדר OBJC לבנייה מהירה.
תגים:action_command_lines
--[no]experimental_omitfp
כברירת מחדל: "false"-
True
תגים: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 כשמפעילים את collections_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 המכיל פרופיל אוטומטי. הדגל הזה מקבל גם קבצים שצוינו כתוויות, לדוגמה //foo/bar:file.afdo. תוויות כאלה חייבות להפנות לקובצי קלט. ייתכן שתצטרכו להוסיף הוראת Export_files לחבילה המתאימה כדי שהקובץ יהיה גלוי ל-Bazel. אפשר גם לקבל קובץ פרופיל LLVM גולמי או שנוסף לאינדקס. הסימון הזה יוחלף על ידי כלל 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>
שימושים מרובים -
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם הגדרות מארח או הפעלה. אפשר לציין משתנים לפי שם, ובמקרה כזה הערך יילקח מסביבת ההפעלה, או מצמד של שם=ערך שמגדיר את הערך ללא קשר לסביבת ההפעלה. ניתן להשתמש באפשרות הזו מספר פעמים. אם מגדירים את אותו משתנה, נצברות הווריאציות האחרונות וגם צוברים את האפשרויות השונות.
תגים:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
כברירת מחדל: "opt"-
יש לציין את המצב שבו ייעשה שימוש בכלים שנוצרו במהלך ה-build. Value: 'quickbuild', 'dbg', 'opt'.
תגים:affects_outputs
,action_command_lines
- נצברו
--host_conlyopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-gcc במהלך הידור קובצי מקור ל-C עבור כלי מארח.
תגים:action_command_lines
,affects_outputs
- נצברו
--host_copt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה אל GCC עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
--host_cpu=<a string>
כברירת מחדל: ""-
יחידת העיבוד המרכזית (CPU) של המארח.
תגים:changes_inputs
,affects_outputs
- נצברו
--host_cxxopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה אל GCC עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_force_python=<PY2 or PY3>
: הצגת תיאור -
ההגדרה הזו מבטלת את גרסת Python של תצורת המארח. יכול להיות "PY2" או "PY3".
תגים:loading_and_analysis
,affects_outputs
- נצברו
--host_linkopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-ccC כשמקשרים כלים למארחים.
תגים: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>
שימושים מרובים -
אפשרויות נוספות להעברה ל-wifc עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
כברירת מחדל: "true"-
אם האפשרות מופעלת, כל הספריות המקושרות (DLL) של C++ שנוצרו על ידי cc_library ב-Windows ישתנו ל-name_{hash}.dll, והחישוב שלהן מבוסס על ה-RepositoryName ונתיב החבילה DLL'. האפשרות הזו שימושית כשיש חבילה אחת שתלויה במספר יחידות, cc_library בשם זהה (למשל //foo/bar1:utils ו-//foo/bar2:utils).
תגים:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
כברירת מחדל: "true"-
אם הערך הוא True, ספריית קובצי הקיפול מורכבת ממאגר הספרייה.
תגים:affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
כברירת מחדל: "false"-
אם הערך הוא 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>
default: "-/JavaScripttests[/:],-/test/javascript[/:]"-
כשהכיסוי מופעל, המערכת תשלב רק כללים עם שמות שכלולים במסנן המבוסס על ביטויים רגולריים (regex). כללים עם קידומת '-' אינם נכללים במקום זאת. לידיעתכם, ניתן להשתמש רק בכללים שאינם בדיקות, אלא אם התכונה ininument_test_targets מופעלת.
תגים:affects_outputs
--ios_cpu=<a string>
כברירת מחדל: "x86_64"-
ההגדרה כוללת טירגוט של יחידת העיבוד המרכזית (CPU) ב-iOS.
תגים:no_op
,deprecated
- ברירת מחדל של
--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"-
הוצא משימוש, הוחלף על ידי --incompliance_remove_Legacy_whole_archive (לפרטים: https://github.com/bazelbuild/bazel/issues/7362). כאשר הוא פועל, יש להשתמש ב- --all-archive עבור כללים cc_binary שיש להם linkshared=1 וכן linkstatic=1 או '-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>
שימושים מרובים -
אפשרויות נוספות להעברה לאוסף של יעד C.
תגים:action_command_lines
- נצברו
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
שימושים מרובים -
אפשרויות נוספות להעברה סלקטיבית ל-GCC במהלך הידור קבצים מסוימים. ניתן להעביר את האפשרות הזו מספר פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. כאשר regex_filter מייצג רשימה של הכללת והחרגה של דפוסי ביטויים רגולריים (ראו גם -instrumentation_filter). option_1 to option_n מייצגת אפשרויות של שורת פקודה שרירותית. אם אפשרות מכילה פסיק, יש לצטט אותו לוכסן הפוך. אפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 מוסיפה את אפשרות שורת הפקודה -O0 לשורת הפקודה של gcc בכל קובצי ה-עותקים ב-//foo/ פרט ל-bar.cc.
תגים:action_command_lines
,affects_outputs
- נצברו
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
שימושים מרובים -
אפשרויות נוספות להעברה סלקטיבית אל קצה עורפי LTO (בקטע --features=thin_lto) במהלך הידור אובייקטים עורפים. ניתן להעביר את האפשרות הזו מספר פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. כאשר regex_filter מייצג רשימה של הכללה והחרגה של דפוסים רגולריים של ביטויים רגולריים (Option_1) אל option_n, לציון אפשרויות של שורת פקודה שרירותית. אם אפשרות מכילה פסיק, יש לצטט אותו לוכסן הפוך. אפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 מוסיף את אפשרות שורת הפקודה -O0 לשורת הפקודה LTO בקצה העורפי של כל קובצי o ב-//foo/ מלבד Bar.o.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--platform_suffix=<a string>
: הצגת תיאור -
קביעת סיומת להוספה לספריית התצורה.
תגים:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ברירת מחדל של
--propeller_optimize=<a build target label>
: הצגת תיאור -
יש להשתמש בפרטי פרופיל המדחף כדי לבצע אופטימיזציה של יעד ה-build.פרופיל מדחף חייב להכיל לפחות אחד משני קבצים, פרופיל cc ופרופיל ld. הסימון הזה מאשר תווית בנייה, שחייבת להתייחס לקובצי הקלט של פרופיל המדחף. לדוגמה, קובץ ה-BUILD שמגדיר את התווית, ב-a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) הוראת add to be add to be set to be set it to הוסף את הפרמטר to to הוסף אבל יש לכל הקבצים האלה "הוראות להגשה" של שלהם יש להשתמש באפשרות הזו בתור: --propeller_optimize=//a/b:propeller_profile
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--propeller_optimize_absolute_cc_profile=<a string>
: הצגת תיאור -
שם הנתיב המוחלט של קובץ cc_profile עבור גרסת ה-build של אופטימיזציה של Propleler.
תגים:affects_outputs
- ברירת מחדל של
--propeller_optimize_absolute_ld_profile=<a string>
: הצגת תיאור -
שם הנתיב המוחלט של קובץ ld_profile עבור גרסת ה-build של אופטימיזציה ב-Propleler.
תגים:affects_outputs
- ברירת מחדל של
--run_under=<a prefix in front of command>
: הצגת תיאור -
לפני הסימן צריך להפעיל את הפקודה של 'test' &&339;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
-
אם הערך הוא True, ספריות מקומיות שמכילות פונקציונליות זהה ישותפו בין יעדים שונים
תגים:loading_and_analysis
,affects_outputs
--[no]stamp
כברירת מחדל: "false"-
חותמות בינאריות עם התאריך, שם המשתמש, שם המארח, פרטי סביבת העבודה וכו'
תגים:affects_outputs
- ברירת מחדל של
--strip=<always, sometimes or never>
: "לפעמים" -
ההגדרה קובעת אם להסיר בינאריים וספריות משותפות (באמצעות "-Wl,--strip-debug" ). ערך ברירת המחדל של 'sometimes' פירושו Strap iff --compilation_mode=quickbuild.
תגים:affects_outputs
- נצברו
--stripopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה לרצועה בעת יצירת קובץ בינארי של '<name>.stripped' .
תגים:action_command_lines
,affects_outputs
- נצברו
--swiftcopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה לאוסף של Swift.
תגים:action_command_lines
- ברירת מחדל של
--symlink_prefix=<a string>
: הצגת תיאור -
הקידומת שמצורפת לכל אחד מהקישורים סימולציית הנוחות שנוצרות אחרי יצירת ה-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>
שימושים מרובים -
רשימה אדריכלית של כתובות URL המופרדות בפסיקים, שעליהן יש לבנות קבצים בינאריים של Apple WatchOS.
תגים: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, האפשרויות האלה תמיד יהיו קבועות כאילו לא צוינו Xxary_fdo.
תגים:affects_outputs
- אפשרויות שמשפיעות על התדירות שבה נאכפים ב-Bazel קלט חוקי של Build (הגדרות של כללים, שילובי דגלים וכו'):
--auto_cpu_environment_group=<a build target label>
כברירת מחדל: ""-
הצהרת הסביבה group_to
תגים: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"-
כדי להצפין את קוד ה-בייט בייט Java 8 לפני הסרת הניקוי.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]enforce_constraints
כברירת מחדל: "true"-
בדיקת הסביבות שבהן כל יעד תואם ודיווח על שגיאות אם לכל יעד יש יחסי תלות שלא תומכים באותן סביבות
תגים:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
כברירת מחדל: "false"-
סימון כדי לעזור במעבר מההרשאה 'לא לאפשר הרשאה' לכללים של Android ללא ספריות עם נקודות שפל. יש לנקות את המחסן כדי להשיק את ברירת המחדל הזו.
תגים:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
כברירת מחדל: "true"-
אם צריך לבדוק שוב את ניפוי הבאגים הנכון ברמה בינארית של Android.
תגים:eagerness_to_exit
,loading_and_analysis
,experimental
--[no]experimental_desugar_java8_libs
כברירת מחדל: "false"-
אם רוצים לכלול ספריות Java 8 נתמכות באפליקציות במכשירים מדור קודם.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,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_disable_native_android_rules
כברירת מחדל: "false"-
כשהאפשרות מופעלת, השימוש הישיר בכללים המקוריים של Android מושבת. יש להשתמש בכללים של Android Starkk בכתובת 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_dependenncy_recursives מושבתת.
תגים: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 מצהיר במפורש על כל היעדים שנעשה בהם שימוש ב-'ייבוא ציבורי'.
תגים:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
כברירת מחדל: "false"-
אם המדיניות מוגדרת כ-true, צריך להצהיר על כותרות גם באמצעות נתיבים (-ii).
תגים:loading_and_analysis
,eagerness_to_exit
- נצברו
--target_environment=<a build target label>
שימושים מרובים -
הצהרת סביבת היעד של ה-build הזה. הערך חייב להיות תווית לכלל '&מירכאות'. אם ציינתם זאת, כל היעדים ברמה העליונה חייבים להיות תואמים לסביבה הזו.
תגים: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"-
אם המדיניות מוגדרת ומצב האיסוף לא &&39;opt' אפליקציות objc יכללו הרשאות לניפוי באגים בזמן החתימה.
תגים:changes_inputs
- ברירת מחדל של
--ios_signing_cert_name=<a string>
: הצגת תיאור -
שם שיש להשתמש בו לחתימת iOS. אם המדיניות לא מוגדרת, היא תוחזר לפרופיל ניהול ההקצאות. יכול להיות שהעדפת הזהות של המפתח היא (או מחרוזת משנה) של השם הנפוץ של האישור, בהתאם לדף חותמת הקוד של קוד{2} (SIGNING ID ID).
תגים:action_command_lines
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build, שאליו ניתן לגשת לקובצי BUILD, קובצי .bzl או WORKSPACE.
--[no]incompatible_config_setting_private_default_visibility
כברירת מחדל: "false"-
אם המדיניות לא תואמת [en_force_config_setting_setting=false], זה לא "נוף". אחרת, אם הסימון הזה הוא false, כל הגדרה של config_ללא מאפיין חשיפה בוטה היא //ability: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
כברירת מחדל: "false"-
אם המדיניות הזו מוגדרת כ-True, יש לאכוף את הגבלות החשיפה של ה-config_setting. אם הערך הוא False, כל הגדרה של config_גלויה לכל יעד. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים:loading_and_analysis
,incompatible_change
- אפשרויות שקובעות את התנהגות סביבת הבדיקה או מריצים את הבדיקה:
--[no]allow_analysis_failures
כברירת מחדל: "false"-
אם הערך הוא TRUE, כשל בניתוח של יעד כלל גורם למופע של יעד מופע של AnalysisFailureInfo המכיל את תיאור השגיאה, במקום לגרום לכשל ב-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' תחביר חלופי: regex_filter@flky_test_attempts כאשר flky_test_attempts מופיע למעלה ו-regex_filter מייצגת רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (יש לעיין גם --runs_per_test). דוגמה: --flky_test_attempts=//foo/.*,-//foo/bar/.*@3 deflakes כל הבדיקות ב-//foo/ , מלבד אלה שמתחת ל-foo/bar שלוש פעמים. ניתן להעביר את האפשרות הזו מספר פעמים. הארגומנט האחרון שעבר תואם להתאמות שהתקבלו. אם אין התאמה, ההתנהגות היא כמו " 'default' " למעלה.
תגים:execution
--[no]ios_memleaks
כברירת מחדל: "false"-
יש להפעיל בדיקה של דליפות זיכרון ביעדים מסוג ios_test.
תגים:action_command_lines
- ברירת מחדל של
--ios_simulator_device=<a string>
: הצגת תיאור -
המכשיר להדמיה בעת הפעלת אפליקציה ל-iOS בסימולטור, למשל 'iPhone 6'. כדי לקבל רשימת מכשירים, אפשר להפעיל 'xcrun simctl list סוגי מכשירים' במחשב שבו הסימולטור יפעל.
תגים: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", "hosted_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"-
כשהבדיקה מושבתת, כל הבדיקות שלא יעברו בהצלחה יגרמו להפסקת הפעולה של כל הגרסה. כברירת מחדל, כל הבדיקות פועלות, גם אם חלק מהבדיקות לא עוברות.
תגים:execution
--test_strategy=<a string>
כברירת מחדל: ""-
ציון האסטרטגיה שבה משתמשים כדי להפעיל בדיקות.
תגים:execution
--test_timeout=<a single integer or comma-separated list of 4 integers>
כברירת מחדל: "-1"- ביטול ערכי ברירת המחדל של זמן קצוב לתפוגה של בדיקות (באלפיות שנייה). אם יצוין ערך חיובי אחד של מספר שלם, הוא יבטל את כל הקטגוריות. אם מציינים 4 מספרים שלמים המופרדים בפסיקים, הם מבטלים את משכי הזמן של הקטעים הקצרים, הבינוניים, הארוכים והקבועים (בסדר הזה). בכל אחד מהפורמטים, הערך -1 מורה ל'בלז' להשתמש בברירות המחדל של הזמן הקצוב לתפוגה עבור קטגוריה זו.
- ברירת מחדל של
--test_tmpdir=<a path>
: הצגת תיאור - ההגדרה מציינת את הספרייה הזמנית הבסיסית עבור 'bazel test' .
- ברירת מחדל של
--tvos_simulator_device=<a string>
: הצגת תיאור -
המכשיר להדמיה בעת הפעלת אפליקציית tvOS בסימולטור, למשל 'Apple TV 1080p'. כדי לקבל רשימת מכשירים, אפשר להפעיל 'xcrun simctl list סוגי מכשירים' במחשב שבו הסימולטור יפעל.
תגים: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 – 38 מ"מ'. כדי לקבל רשימת מכשירים, אפשר להפעיל 'xcrun simctl list סוגי מכשירים' במחשב שבו הסימולטור יפעל.
תגים: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
כברירת מחדל: "false"-
אם היא מופעלת, קובצי C++ DD יועברו בזיכרון ישירות מצומתי ה-build המרוחקים, במקום להיכתב בדיסק.
תגים:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
כברירת מחדל: "false"-
אם היא מופעלת, קובצי התלויות (.jdeps) שנוצרו מהאוספים של Java יועברו בזיכרון ישירות מצומתי הבנייה המרוחקים, ולא בכתב בדיסק.
תגים: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_Config יהיה 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, מכיוון שסורק ההכללה לא מטמיע באופן מלא את הסמנטיקה של מעבד ה-C. באופן ספציפי, היא לא מבינה הנחיות #include דינמיות ומתעלמת מלוגיקה מותנית במעבד מראש. השימוש הוא באחריותך בלבד. כל בעיה הקשורה לסימון הזה שהוגשה ייסגרה.
תגים:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
כברירת מחדל: "true"-
רוב העבודה היא של הדבקה בנפרד בכל קובץ צנצנת.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
כברירת מחדל: "true"-
אם מגדירים קבצים מסוג d.
תגים:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
כברירת מחדל: "false"-
כשיוצרים יעד //a:a, העיבוד של כותרות בכל היעדים ש-aa:a תלוי (אם עיבוד הכותרת מופעל ב-toolschain).
תגים: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"- אם רוצים לפרסם אירועי Target סיכום.
--[no]experimental_build_event_expand_filesets
כברירת מחדל: "false"-
אם הקובץ מוגדר כ-True, יש להרחיב את Fileslet ב-BEP כשמציגים קובצי פלט.
תגים:affects_outputs
--[no]experimental_build_event_fully_resolve_fileset_symlinks
כברירת מחדל: "false"-
אם הערך הוא True, יש לסמן באופן מלא את הסמלים היחסיים של Fileset ב-BEP כשמציגים קובצי פלט. יש צורך ב--Experimental_build_event_expand_filesets.
תגים:affects_outputs
- ברירת מחדל של
--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 להסביר את כל השלבים שבוצעו של ה-build. ההסבר נכתב לקובץ היומן שצוין.
תגים:affects_outputs
--[no]legacy_important_outputs
כברירת מחדל: "true"-
אפשר להשתמש באפשרות זו כדי למנוע יצירה של שדה חשוב_פלטים קודם באירוע Targetcomplete. נדרשים שילובs
תגים:affects_outputs
--[no]materialize_param_files
כברירת מחדל: "false"-
כתיבה של קובצי פרמטרים מסוג ביניים לעץ הפלט גם כשמשתמשים בביצוע פעולות מרחוק. שימושי במקרים של ניפוי באגים. דבר זה משתמע מ--subcommands ו- --verbose_failures.
תגים:execution
--max_config_changes_to_show=<an integer>
כברירת מחדל: "3"-
כשמוחקים את מטמון הניתוח עקב שינוי באפשרויות ה-build, מוצג עד המספר הנתון של שמות האפשרויות ששונו. אם המספר הנתון הוא -1, כל האפשרויות ששונו יוצגו.
תגים:terminal_output
--max_test_output_bytes=<an integer>
כברירת מחדל: "-1"-
ההגדרה קובעת את הגודל המקסימלי של כל יומן בדיקה לכל משתמש שניתן לבדוק כאשר --test_פלט הוא 'שגיאות' או 'הכול'. השימוש הזה עוזר להימנע מהצפה של פלט עקב שימוש בפלט רועש מדי. כותרת הבדיקה כלולה בגודל היומן. ערכים שליליים מרמזים על מגבלה. הפלט תקין או אפס.
תגים: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'
תגים:test_runner
,terminal_output
,execution
--test_summary=<short, terse, detailed, none or testcase>
כברירת מחדל: "short"-
ההגדרה קובעת את הפורמט הרצוי של סיכום הבדיקה. כדי להדפיס מידע מפורט על בדיקות שנכשלו, 'detail'&&39;noneed'
תגים:terminal_output
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
כברירת מחדל: "-.*"-
הדפסה של מידע על תוצאות ניפוי הבאגים במהלך פתרון בעיות בכלי הכלים. התכונה בודקת את הביטוי הרגולרי (regex), שנבדק מול סוגי Toolchain ויעדים ספציפיים כדי לבדוק איזה מהם ניפוי באגים. יש כמה ביטויים רגולריים שאפשר להפריד ביניהם באמצעות פסיקים, ולאחר מכן כל ביטוי רגולרי מסומן בנפרד. הערה: הפלט של הדגל הזה מורכב מאוד, וסביר להניח שהוא יהיה שימושי רק למומחים במציאת פתרון בכלי.
תגים: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"-
הסימון הזה משנה את התנהגות ברירת המחדל כך שקובצי _inin__.py לא נוצרים יותר באופן אוטומטי בקובצי ריצה של יעדים ב-Python. בדיוק, כשיעד py_binary או py_test מוגדר מדור קודם עד: "auto" (ברירת המחדל), המערכת מתייחסת לערך False אם רק הדגל הזה מוגדר. יש לעיין בכתובת https://github.com/bazelbuild/bazel/issues/10076.
תגים:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
כברירת מחדל: "true"-
אם הערך הוא true, יעדים שנוצרו בתצורת Python 2 יופיעו מתחת לשורש הפלט הכולל את הסיומת '-py2' בעוד שיעדים שנוצרו עבור Python 3 יופיעו בשורש ללא סיומת הקשורה ל-Python. המשמעות היא שסימן הנוחות 'bazel-bin' מצביע על טירגוט ב-Python 3 ולא על Python 2. אם האפשרות הזו מופעלת, מומלץ גם להפעיל את `--incompatible_py3_is_default`.
תגים:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
כברירת מחדל: "true"-
אם הערך הוא True, היעדים 'py_binary' ו-'py_test' שלא הגדירו את המאפיין 'python_version' (או 'default_python_version') יעברו כברירת מחדל ל-PY3 במקום ל-PY2. אם הדגל הזה מוגדר, מומלץ גם להגדיר את `--incompliance_py2_Outputs_are_suffixed`.
תגים:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
כברירת מחדל: "true"-
אם המדיניות מוגדרת כ-True, כללים להפעלה אוטומטית של Python יתבססו על זמן הריצה של Python שצוין על ידי Toolchain של ה-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'
--[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_packages x/y מונע את הבעיה הזו.
--[no]discard_analysis_cache
כברירת מחדל: "false"- אפשר למחוק את מטמון הניתוח מיד אחרי ששלב הניתוח מסתיים. מפחית את השימוש בזיכרון בכ-10%, אך הופך את גרסאות build נוספות לאט יותר.
- ברירת מחדל של
--execution_log_binary_file=<a path>
: הצגת תיאור - אפשר לתעד את ההרצה של הקובץ שנשלח כפרוטוקול ל-Propen, תחילה רושמים את היומן ללא סדר, ואז בסוף ההפעלה, הוא ממוין בסדר קבוע (ייתכן שכדי להפעיל אותו יש צורך במעבד ובזיכרון). סימונים קשורים: --execution_log_json_file (בפורמט json של טקסט שהוזמן), --Experimental_execution_log_file (פורמט לא בינארי של קובץ protobuf) ללא סדר משנה (להצגה של פקודות משנה בפלט מסוף).
- ברירת מחדל של
--execution_log_json_file=<a path>
: הצגת תיאור - אפשר לתעד את ההצטברות המבוצעת בקובץ הזה כייצוג json של פרוטוסים מופרדים בפסיקים, בהתאם ל- src/main/protobuf/spawn.proto. תחילה רושמים את היומן ללא סדר, ואז בסוף ההפעלה, הוא ממוין בסדר קבוע (ייתכן שכדי להפעיל אותו יש צורך במעבד ובזיכרון). סימונים קשורים: סימונים קשורים: --execution_log_binary_file (בפורמט בינארי מסוג protobuf) –
--[no]expand_test_suites
כברירת מחדל: "true"-
מומלץ להרחיב את היעדים test_Suite לבדיקות העיקריות שלהם לפני הניתוח. כשהסימון הזה מופעל (ברירת המחדל), דפוסי היעד השליליים יחולו על הבדיקות השייכות לחבילת הבדיקה, אחרת הן לא יפעלו. כיבוי הדגל הזה שימושי כשמחילים היבטים ברמה העליונה בשורת הפקודה: לאחר מכן הם יכולים לנתח מטרות מסוג test_Suite.
תגים:loading_and_analysis
--[no]experimental_cancel_concurrent_tests
כברירת מחדל: "false"-
אם הערך הוא True, מערכת Blaze תבטל בו-זמנית את הבדיקות שפועלות בהפעלה הראשונה המוצלחת. זה שימושי רק בשילוב עם --runs_per_test_detects_flake.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--experimental_execution_log_file=<a path>
: הצגת תיאור - אפשר לתעד את ההרצה של הקובץ שנשלח כפרוטוקול ל-Propen, הקובץ הזה נכתב לפי סדר הפעלת ה-Spwns. סימונים קשורים: --execution_log_binary_file (פורמט בינארי Protobuf מסודר), --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"- הוצא משימוש בשל היבטים. תזמון רק פעולות additional_action עבור יעדים ברמה העליונה.
--[no]experimental_fetch_all_coverage_outputs
כברירת מחדל: "false"-
אם הערך הוא True, מערכת Bazel מאחזרת את כל ספריית נתוני הכיסוי עבור כל בדיקה במהלך הפעלת כיסוי.
תגים:affects_outputs
,loading_and_analysis
--[no]experimental_generate_llvm_lcov
כברירת מחדל: "false"-
אם הערך הוא True, יצירת כיסוי מסוג ClangV תיצור דוח 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>
כברירת מחדל: "JavaScriptbuilder"- הפעלה של מסלולי נתיב מופחתים עבור אוספים של Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
כברירת מחדל: "false"-
הגבלה --Experimental_run_android_lint_on_javascript_rules לספריות תואמות ל-Android.
תגים:affects_outputs
--[no]experimental_local_memory_estimate
כברירת מחדל: "false"- כדי להעריך את הזיכרון הזמין בפועל באינטרנט. כברירת מחדל, Blaze מניח שרוב הפעולות משתמשות בכמות זיכרון קבועה, וסופרת את הזיכרון הכולל הכולל של המערכת, ללא קשר לזיכרון הזמין בפועל. אפשרות זו מאפשרת לבצע הערכה מקוונת של כמות הזיכרון הזמינה בכל רגע נתון, ולכן לא דורשת הערכה מדויקת של נפח הזיכרון שפעולה נתונה תבצע.
--[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 או ב-Hunstest ב-JavaScript_test במקום להשיג בטעות את נקודות הטעינה של RunRunner' . מתאים כרגע רק לאפליקציות בנק.
- ברירת מחדל של
--host_java_launcher=<a build target label>
: הצגת תיאור - מרכז האפליקציות של Java המשמש את הכלים שהוצאו משימוש במהלך גרסת build.
- נצברו
--host_javacopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-JavaScript במהלך בניית כלים שמתבצעים במהלך גרסת build.
- נצברו
--host_jvmopt=<a string>
שימושים מרובים - אפשרויות נוספות למעבר ל-VM VM במהלך בניית הכלים שמתבצעים במהלך ה-build. האפשרויות האלה יתווספו לאפשרויות ה-VM להפעלה של כל יעד JavaScript_binary.
--[no]incompatible_exclusive_test_sandboxed
כברירת מחדל: "false"-
אם הערך הוא TRUE, בדיקות בלעדיות יפעלו עם אסטרטגיה מסוג ארגז חול. אפשר להוסיף תג &&39;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_Output=streamed.
הרחבה אל:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
כברירת מחדל: "true"- יצירת מידע על תלות (בשלב זה, נתיב Class time-time) ליעד Java.
--[no]java_header_compilation
כברירת מחדל: "true"- מקבצים את קובצי ה-IE ישירות מהמקור.
--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>
שימושים מרובים - אפשרויות נוספות להעברה ל-JavaScript.
- נצברו
--jvmopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-Java VM. האפשרויות האלה יתווספו לאפשרויות ה-VM להפעלה של כל יעד JavaScript_binary.
- ברירת מחדל של
--legacy_main_dex_list_generator=<a build target label>
: הצגת תיאור - קביעת קובץ בינארי לשימוש ליצירת רשימת הכיתות שחייבות להיות בפקס הראשי בעת הידור כמה מכפילים מדור קודם.
- ברירת מחדל של
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "Host_CPUS" - יש להגדיר במפורש את המספר הכולל של ליבות המעבד (CPU) המקומיות שזמינות ל-Bazel לצורך הוצאה בפעולות בנייה שבוצעו באופן מקומי. לוקח מספר שלם, או "Host_CPUS" ואופציונלי, אחריו [-|*]<float> (למשל מארחים_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. פועל כרגע עם JavaScript_plugins.
- ברירת מחדל של
--proguard_top=<a build target label>
: הצגת תיאור - ההגדרה של גרסת Proguard להסרת קוד בינארי לפי Java.
--proto_compiler=<a build target label>
ברירת מחדל: "@com_google_protobuf//:protracker"-
התווית של המהדר.
תגים:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ברירת מחדל: "@com_google_protobuf//:cc_toolschain"-
תווית של proto_lang_toolschain() שמתארת איך להרכיב C+protos מסוג C+
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_j2objc=<a build target label>
: "@bazel_tools//tools/j2objc:j2objc_proto_toolschain" -
תווית של proto_lang_toolschain() שמתארת איך להדר j2objc protos
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_java=<a build target label>
: "@com_google_protobuf//:JavaScript_toolschain" -
תווית של proto_lang_toolschain() שמתארת את ההידור של Java Protos
תגים:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ברירת מחדל: "@com_google_protobuf//:JavaScriptlite_toolschain"-
תווית של proto_lang_toolschain() שמתארת את ההידור של JavaLite protos
תגים:affects_outputs
,loading_and_analysis
- נצברו
--protocopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה אל המהדר של Protobuf.
תגים:affects_outputs
--[no]runs_per_test_detects_flakes
כברירת מחדל: "false"- אם הערך הוא True, כל שבר שבו ניסיון ריצה/ניסיון אחד לפחות ולפחות ניסיון אחד/ניסיון אחד נכשל נכשל מקבלים סטטוס של תוכן מסוג FLAKY.
- ברירת מחדל של
--shell_executable=<a path>
: הצגת תיאור -
נתיב מוחלט למעטפת המשמשת לשימוש ב-Bazel אם זה לא מוגדר, אבל משתנה הסביבה BAZEL_SH מוגדר בהפעלה הראשונה של Bazel (שמפעילה שרת Bazel), ה-Bazel משתמש בכך. אם אף אחד מהם לא מוגדר, Bazel משתמשת בנתיב ברירת מחדל בתוך קוד פתוח, בהתאם למערכת ההפעלה שבה היא פועלת (Windows: c:/tools/msys64/usr/bin/bash.exe , FreeBSD: /usr/local/bin/bash , כל השאר: /bin/bash). לתשומת ליבכם: שימוש במעטפת שלא תואם ל-bash עלול לגרום לכשלים בבנייה או לכשלים בריצה של נתונים בינאריים שנוצרו.
תגים:loading_and_analysis
--[no]show_loading_progress
כברירת מחדל: "true"- אם מופעל, גורם ל-Bazel להדפיס {0} "חבילה
- נצברו
--test_arg=<a string>
שימושים מרובים - ההגדרה כוללת אפשרויות וארגומנטים נוספים שצריך להעביר לקובץ ההפעלה של הבדיקה. אפשר להשתמש במספר פעמים כדי לציין כמה ארגומנטים. אם נבצע מספר בדיקות, כל אחת מהן תקבל ארגומנטים זהים. משמש רק את הפקודה 'bazel'
- ברירת מחדל של
--test_filter=<a string>
: הצגת תיאור - קביעת מסנן להעברה למסגרת הבדיקה. משמשים להגבלת הבדיקות. שימו לב: ההגדרה הזו לא משפיעה על יעדי הטירגוט.
--test_lang_filters=<comma-separated list of options>
כברירת מחדל: ""- ההגדרה קובעת רשימה של שפות בדיקה מופרדות בפסיקים. ניתן להוסיף לפני כל שפה את &&39;-' כדי לציין שפות שלא נכללו. רק יעדי הבדיקה האלה יימצאו בשפות שצוינו. השם המשמש לכל שפה צריך להיות זהה לתחילית השפה בכלל *_test, למשל 'cc', 'javascript', &'py' וכו'. האפשרות הזו משפיעה על --build_tests_only behavior ועל הפקודה test.
--test_result_expiration=<an integer>
כברירת מחדל: "-1"- האפשרות הזו הוצאה משימוש ואין לה השפעה.
--[no]test_runner_fail_fast
כברירת מחדל: "false"- הרצה קדימה תיכשל במהירות על הרצת הבדיקה. הרצת הבדיקה צריכה להפסיק את ההפעלה לאחר הכשל הראשון.
--test_sharding_strategy=<explicit or disabled>
כברירת מחדל: "explicit"- יש לציין את השיטה לפיצול הבדיקה: 'explicit' כדי להשתמש בפיצול רק אם המאפיין 'shard_count' BUILD. 'disabled' לעולם לא להשתמש בפיצול בדיקות.
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
כברירת מחדל: ""- קביעת רשימה של גודלי בדיקה המופרדים בפסיקים. לפני כל גודל אפשר להוסיף '-' כדי לציין את אי-הגדלים. רק יעד הבדיקה הזה יוצג אם הוא מכיל לפחות מידה אחת שנכללה, ושאין בו גדלים שהוחרגו. אפשרות זו משפיעה על התנהגות --build_tests_only ועל הפקודה לבדיקה.
--test_tag_filters=<comma-separated list of options>
כברירת מחדל: ""- קביעת רשימה של תגי בדיקה מופרדים בפסיקים. לפני כל תג אפשר להוסיף '-' כדי לציין את התגים שהחרגת. רק יעדי הבדיקה האלה יימצאו מכילים לפחות תג כלול אחד ואינם מכילים תגים שלא נכללים. אפשרות זו משפיעה על התנהגות --build_tests_only ועל הפקודה לבדיקה.
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
כברירת מחדל: ""- קביעת רשימה של זמני קצוב לתפוגה המופרדים בפסיקים. אחרי כל זמן קצוב לתפוגה, אפשר להוסיף לפני '-' כדי לציין החרגות של זמן קצוב לתפוגה. רק יעדי הבדיקה האלה יימצאו ושמכילים לפחות זמן קצוב לתפוגה אחד, ושאין בהם זמן קצוב לתפוגה. אפשרות זו משפיעה על התנהגות --build_tests_only ועל הפקודה לבדיקה.
--tool_java_language_version=<a string>
כברירת מחדל: "8"- גרסת השפה של Java המשמשת להפעלת הכלים הנחוצים במהלך פיתוח
- ברירת מחדל של
--tool_java_runtime_version=<a string>
: "remotejdk_11" - גרסת זמן הריצה של Java המשמשת להפעלת כלים במהלך יצירת ה-build
--[no]use_ijars
כברירת מחדל: "true"- אם האפשרות הזו מופעלת, הידור Java יכול להשתמש בצנצנות ממשק. פעולה זו תגרום לצבירה מצטברת מהירה יותר, אבל הודעות השגיאה עשויות להיות שונות.
אפשרויות סימון כקנוניות
היא מקבלת בירושה את כל האפשרויות מ-build.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--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 אוכפת קלט חוקי של 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
תגים:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
כברירת מחדל: "false"-
אם המדיניות לא תואמת [en_force_config_setting_setting=false], זה לא "נוף". אחרת, אם הסימון הזה הוא false, כל הגדרה של config_ללא מאפיין חשיפה בוטה היא //ability:public אם הסימון הזה נכון, ההנחיה config_setting זהה ללוגיקת חשיפה כמו כל הכללים האחרים. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/12933.
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
כברירת מחדל: "false"-
אם המדיניות הזו מוגדרת כ-True, יש לאכוף את הגבלות החשיפה של ה-config_setting. אם הערך הוא False, כל הגדרה של config_גלויה לכל יעד. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים:loading_and_analysis
,incompatible_change
- אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום ביומן:
--[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` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות:
--deleted_packages=<comma-separated list of package names>
כברירת מחדל: ""- רשימה של שמות של חבילות המופרדות בפסיקים, שמערכת ה-build תתייחס אליהן כלא קיימות, גם אם הן גלויות במקום כלשהו בנתיב החבילה. צריך להשתמש באפשרות הזו כשמוחקים חבילת משנה 'x/y' של חבילה קיימת 'x'. לדוגמה, אחרי מחיקת x/y/BUILD בלקוח, מערכת ה-build עשויה להתלונן אם היא תיתקל בתווית '//x:y/z' אם היא עדיין מסופקת על ידי רשומה אחרים של package_path. ציון --delete_packages x/y מונע את הבעיה הזו.
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
--package_path=<colon-separated list of options>
כברירת מחדל: "%workspace%"- רשימה של המקומות שבהם מחפשים חבילות המופרדות בנקודתיים. רכיבים שמתחילים ב-'%workspace%' הם יחסי לסביבת העבודה הכוללת. אם לא מופיעה או ריקה, ברירת המחדל היא הפלט של 'bazel information default-package-path'
--[no]show_loading_progress
כברירת מחדל: "true"- אם מופעל, גורם ל-Bazel להדפיס {0} "חבילה
אפשרויות ניקוי
היא מקבלת בירושה את כל האפשרויות מ-build.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--repository_cache=<a path>
: הצגת תיאור -
קביעת מיקום המטמון של הערכים שהורדו שהתקבלו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט מבקשת השבתה של המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בפלט של הפקודה:
--[no]async
כברירת מחדל: "false"-
אם הערך הוא True, ניקוי הפלט האסינכרוני. כשהפקודה תסתיים, יהיה אפשר לבצע פקודות חדשות באותו לקוח, גם אם המחיקה עשויה להתבצע ברקע.
תגים:host_machine_resource_optimizations
--[no]expunge
כברירת מחדל: "false"-
אם הערך הוא True, ניקוי כל עץ העבודה במופע ה-Bazel הזה כולל את כל קובצי ה-Bazel הזמניים שנוצרו ובניית פלט, ומפסיק את שרת ה-Bazel אם הוא פועל.
תגים:host_machine_resource_optimizations
--expunge_async
-
אם צוין, ניקוי באופן אסינכרוני של עץ העבודה המלא של מופע ה-bazel הזה, שכולל את כל קובצי הזמניים שנוצרו ב-bazel ויוצרים פלט של עץ, ומפסיק את שרת ה-Bazel אם הוא פועל. כשהפקודה תסתיים, יהיה אפשר לבצע פקודות חדשות באותו לקוח, גם אם המחיקה עשויה להתבצע ברקע.
הרחבה אל:
--expunge
--async
תגים:host_machine_resource_optimizations
--[no]remove_all_convenience_symlinks
כברירת מחדל: "false"-
אם הערך הוא 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
תגים:no_op
,deprecated
,experimental
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
--[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` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות תצורה
אפשרויות כיסוי
עוברת בירושה את כל האפשרויות מבדיקה.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--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
תגים:no_op
,deprecated
,experimental
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
--[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` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות שאילתה
עוברת בירושה את כל האפשרויות מבדיקה.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--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
תגים:no_op
,deprecated
,experimental
- אפשרויות הקשורות לפלט שאילתה ולסמנטיקה:
--aspect_deps=<off, conservative or precise>
כברירת מחדל: "שמרי"-
איך לפתור בעיות של יחס גובה-רוחב כשפורמט הפלט הוא {xml,proto,record}. 'off' כלומר, לא תלויות יחסי גובה-רוחב, 'שמרני' (ברירת המחדל) פירוש הדבר שכל התלות המוצהרות ביחס להיבטים מתווספות, בין אם הן קיבלו את סיווג הכללים תלויות חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, ולכן הוא איטי יותר מהמצבים האחרים. כמו כן, גם מצב מדויק אינו מדויק לגמרי: ההחלטה אם לחשב היבט מתקבלת על שלב בשלב הניתוח, שאינו פועל במהלך 'שאילתה'
תגים:build_file_semantics
--[no]graph:factored
כברירת מחדל: "true"-
אם הערך הוא True, התרשים יוסר אפשרות זו רלוונטית רק ל- --Output=graph.
תגים:terminal_output
--graph:node_limit=<an integer>
כברירת מחדל: "512"-
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; -1 פירושו חיתוך. אפשרות זו רלוונטית רק ל- --Output=graph.
תגים:terminal_output
--[no]implicit_deps
כברירת מחדל: "true"-
אם אפשרות זו מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלויות שבו השאילתה פועלת. תלות משתמעת היא לא מצוינת במפורש בקובץ BUILD, אבל מתווספת על ידי Bazel. עבור שאילתה, אפשרות זו שולטת בסינון מחזיקי כלים שנפתרו.
תגים:build_file_semantics
--[no]include_aspects
כברירת מחדל: "true"-
query, cquery: אם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: לא-תפעול (תמיד מתבצע מעקב אחר היבטים).
תגים:terminal_output
--[no]incompatible_display_source_file_location
כברירת מחדל: "true"-
ברירת המחדל היא הצגת היעד של קובץ המקור. אם הערך הוא True, מוצג המיקום של שורה 1 של קובצי המקור בפלט המיקום. הסימון הזה קיים רק למטרות מיגרציה.
תגים:terminal_output
,incompatible_change
--[no]infer_universe_scope
כברירת מחדל: "false"-
אם היא מוגדרת ו-unis_scope לא מוגדרת, הערך של לתשומת ליבכם, הערך --universe_scope שמתקבל עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, 'allrdeps')) עשוי להיות לא מה שאתם רוצים, ולכן מומלץ להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים נוספים ודוגמאות זמינים בכתובת https://bazel.build/versions/reference/query#sky-query אם --universe_scope מוגדר, המערכת תתעלם מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'query' (כלומר, לא 'cquery`).
תגים:loading_and_analysis
--[no]line_terminator_null
כברירת מחדל: "false"-
אם כל פורמט יסתיים ב-\0 במקום בשורה חדשה.
תגים:terminal_output
--[no]nodep_deps
כברירת מחדל: "true"-
אם המדיניות מופעלת, נקודות מדדים של "nodep" ייכללו בתרשים התלויות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep" &"ability" אפשר להריץ ולנתח את הפלט של 'info-language' כדי לקבל מידע על כל המאפיינים "nodep" בשפת הבנייה.
תגים:build_file_semantics
--output=<a string>
כברירת מחדל: "label"-
הפורמט שבו יש להדפיס את תוצאות השאילתות. הערכים המותרים ל-cquery הם: label, label_kind, textproto, Transits, proto, jsonproto. אם בוחרים 'transitions' צריך גם לציין את האפשרות --transitions=(lite|full).
תגים:terminal_output
--[no]proto:default_values
כברירת מחדל: "true"-
אם הערך הוא True, המערכת תכללו מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- -Output=proto
תגים:terminal_output
--[no]proto:definition_stack
כברירת מחדל: "false"-
אכלוס השדה proto-stack של הפרוטוקול, שבו מתועדת כל מופע של כלל ה-Starlark ברגע שהוגדרה המחלקה לכלל.
תגים: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"-
רשימת מאפיינים מופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להפיק פלט אף מאפיין. אפשרות זו רלוונטית ל--Output=proto.
תגים:terminal_output
--[no]proto:rule_inputs_and_outputs
כברירת מחדל: "true"-
האם אפשר לאכלס את השדותכלל_קלט וכלל_פלט.
תגים:terminal_output
--[no]relative_locations
כברירת מחדל: "false"-
אם הערך הוא True, המיקום של קובצי BUILD בפלט XML ו-Proto יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא עקבי במכונות שונות. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במחשבים שונים.
תגים:terminal_output
--show_config_fragments=<off, direct or transitive>
כברירת מחדל: "off"-
הצגת קטעי הקוד הנדרשים על ידי כלל והתלויות העקיפות שלו. אפשרות זו יכולה לעזור להעריך עד כמה ניתן לחתוך תרשים יעד מוגדר.
תגים:affects_outputs
--starlark:expr=<a string>
כברירת מחדל: ""-
ביטוי Starlark לפורמט של כל יעד שמוגדר במצב cquery's --fact=starlark. היעד המוגדר כפוף ל-'target'. אם לא מציינים --starlark:expr and --starlark:file, האפשרות הזו תוגדר כברירת מחדל ל- 'str(target.label)'. אירעה שגיאה בציון --starlark:expr ו- --starlark:file.
תגים:terminal_output
--starlark:file=<a string>
כברירת מחדל: ""-
שם של קובץ שמגדיר פונקציית Starlark בשם 'format' מתוך ארגומנט אחד, שחל על כל יעד מוגדר כדי לעצב אותו כמחרוזת. אירעה שגיאה בציון --starlark:expr ו- --starlark:file. לפרטים נוספים, --
תגים:terminal_output
--[no]tool_deps
כברירת מחדל: "true"-
שאילתה: אם היא מושבתת, יחסי תלות ב&&39;תצורת מארח' או 'execution' יעדים לא ייכללו בתרשים התלויות שבו השאילתה פועלת. קצה 'הגדרת מארח' תלות, כמו הכלל מכל &&39;proto_library' לרוב, המהדר של הפרוטוקול, מצביע על כלי שנערך במהלך הבנייה ולא על חלק מאותה תוכנית 'target'
שאילתה: אם אפשרות זו מושבתת, מסננים את כל היעדים שהוגדרו שעוברים את המארח או את ההעברה מהיעד ברמה העליונה שגילו את היעד המוגדר. כלומר, אם היעד ברמה העליונה נכלל בהגדרת הטירגוט, יוחזרו רק יעדים שהוגדרו. אם היעד ברמה העליונה נמצא בתצורת המארח, יוחזרו רק יעדים שהוגדרו על ידי המארח. אפשרות זו לא תחריג מחזיקי כלים שנפתרו.
תגים:build_file_semantics
--transitions=<full, lite or none>
כברירת מחדל: "none"-
הפורמט שבו השאילתה תדפיס את פרטי המעבר.
תגים:affects_outputs
--universe_scope=<comma-separated list of options>
כברירת מחדל: ""-
קבוצה של דפוסי יעד מופרדים בפסיקים (תוספתיים וירידה). השאילתה יכולה להתבצע ביקום המוגדר על ידי הסגירה העקיפה של היעדים שצוינו. האפשרות הזו משמשת לפקודות השאילתה ולשאילתות השאילתה.
בשאילתה מסוג 'שאילתה', הקלט באפשרות זו הוא היעדים המובנים בכל התשובות, לכן האפשרות הזו עשויה להשפיע על ההגדרות ועל המעברים. אם אפשרות זו לא צוינה, היעדים ברמה העליונה נחשבים כיעדים ולנתח אותם מתוך ביטוי השאילתה. הערה: לגבי שאילתה, אם לא מציינים את האפשרות הזו, ייתכן שה-build של התוכנה ייפגע אם לא ניתן יהיה לבנות יעדים מתוך ביטוי השאילתה עם אפשרויות ברמה עליונה.
תגים:loading_and_analysis
- אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום ביומן:
--[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` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
- אפשרויות ששולטות בביצוע גרסאות:
--[no]experimental_inprocess_symlink_creation
כברירת מחדל: "false"-
האם אפשר להתקשר ישירות למערכת קבצים כדי ליצור עצים סימליים
תגים: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"-
אם האפשרות הזו מופעלת, Files יתייחסו לכל פריטי הפלט כקבצים רגילים. הם לא יעבירו ספריות ורגישים לקישורים.
תגים:execution
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
כברירת מחדל: ""-
הוספה או הסרה של מפתחות מתוך פרטי הביצוע של הפעולה, על סמך פעולת הפעולה. חל רק על פעולות שתומכות בפרטי הביצוע. פעולות נפוצות רבות תומכות בפרטי ביצוע, כמו Genrule, CppCompile, Javac, StarlarkAction, TestRunner. כשמציינים ערכים מרובים, הסדר חשוב כי ביטויים רגולריים רבים עשויים לחול על אותו אמצעי.
תחביר: "regex=[ +-]key,regex=[+-]key,...".
לדוגמה:
'.*=+x,.*=-y,.*=+z' מוסיף 'x' &'z ' אל ומסירים את פרטי הביצוע של ##99;y'
'Genrule=+requires-x'add 'requires-x' לפרטי הביצוע של כל פעולות הז'אנר.
'(?!Genrule).*=-requires-x' removed 'requires-x' מנתוני הביצוע של כל הפעולות שאינן כלליות.
תגים:execution
,affects_outputs
,loading_and_analysis
--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=ManifestMerger=worker
- ברירת מחדל של
--android_compiler=<a string>
: הצגת תיאור -
מהדר היעד של Android.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_crosstool_top=<a build target label>
: "//external:android/crosstools" -
המיקום של מהדר 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"-
קביעת SDK/פלטפורמה של Android שמשמשת לבניית אפליקציות ל-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:toolschain" -
התווית של חבילת הכלים השונים לשימוש בכללי 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_variable"-
המיקום של הקובץ הבינארי המשמש ליצירת דוחות כיסוי. נכון לעכשיו זו חייבת להיות קבוצת קבצים שמכילה קובץ אחד, הקובץ הבינארי. ברירת המחדל היא '//tools/test:coverage_report_variable'.
תגים: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:toolschain" -
התווית של חבילת הכלי המוצלב שבה יש להשתמש כדי להרכיב קוד C++.
תגים:loading_and_analysis
,changes_inputs
,affects_outputs
- ברירת מחדל של
--custom_malloc=<a build target label>
: הצגת תיאור -
ציון של הטמעה מותאמת אישית של Malloc. ההגדרה הזו מבטלת את המאפיינים של Malloc בכללי Build.
תגים:changes_inputs
,affects_outputs
- נצברו
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
שימושים מרובים -
רשימה של ביטויים רגולריים המופרדים בפסיקים, שאפשר להוסיף להם את הסימן - (ביטוי שלילי) כדי להקצות אותם (=) לרשימה של יעדי ערך אילוץ שמופרדים בפסיקים. אם יעד מסוים לא תואם לאף ביטוי שלילי ולפחות ביטוי חיובי אחד, רזולוציית הכלי תבוצע כאילו הוא הצהיר שערכי האילוץ הם אילוצי הביצוע. דוגמה: //demo,-test=@platforms//cpus:x86_64 יתווסף אל 'x86_64' לכל יעד השייך ל-//demo מלבד אלה שהשם שלהם מכיל 'test'.
תגים:loading_and_analysis
--[no]experimental_enable_objc_cc_deps
כברירת מחדל: "true"-
מתן אפשרות לכללים 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 על ידיenroll_execution_platforms().
תגים:execution
- נצברו
--extra_toolchains=<comma-separated list of options>
שימושים מרובים -
הכללים של כלי הכלים שיש להתייחס אליהם במהלך פתרון הבעיות בכלי. ניתן לציין מחזיקי כלים לפי יעד מדויק, או כתבנית יעד. שרשראות הכלים האלה יילקחו בחשבון לפני הרשומות של קובץ ה-WORKSPACE על ידיenroll_toolschains().
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--grte_top=<a label>
: הצגת תיאור -
תווית לספריית Libc בצ'ק-אין. ערך ברירת המחדל נבחר על ידי ארגז הכלים של הכלי המוצלב, וכמעט לא תצטרכו לעקוף אותו.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_compiler=<a string>
: הצגת תיאור -
מהדר C++ המשמש לאיסוף הידור. המערכת מתעלמת מהפרמטר הזה אם --host_crosstools_top לא מוגדר.
תגים:loading_and_analysis
,execution
- ברירת מחדל של
--host_crosstool_top=<a build target label>
: הצגת תיאור -
כברירת מחדל, גם אפשרויות ה- --פיינק מהלך --ורכיב המהדר -- משמשות גם להגדרת המארח. אם סימון זה מופיע, ה-Bazel משתמש ב-libc ובמהדר המוגדר כברירת מחדל עבור ה-crosstools_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 לא תפעיל את &&39;host' 'nonhost' את C++ Toolchain (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/7407).
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_android_toolchain_resolution
כברירת מחדל: "false"-
שימוש ברזולוציה של Toolchain כדי לבחור את ה-SDK ל-Android לכללי Android (Starlark ו-Native)
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_enable_apple_toolchain_resolution
כברירת מחדל: "false"-
שימוש ברזולוציית כלים כדי לבחור את ה-SDK של Apple לכללי תפוחים (Starlark ומותאמות)
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_make_thinlto_command_lines_standalone
כברירת מחדל: "true"-
אם הערך הוא true, Bazel תשתמש שוב בשורות של פעולת הקישור ל-C++ כדי להוסיף לשורות הפקודה של Lto באינדקס (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/6791).
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
כברירת מחדל: "true"-
אם הערך הוא true, Bazel מתלונן כאשר מוגדרים המאפיינים cc_toolschain.cpu ו-cc_toolschain.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"-
אם הדבר נכון, מערכת Bazel תדרוש 'ctx'
תגים:loading_and_analysis
,incompatible_change
-
שימוש באובייקטים משותפים בממשק, אם הם נתמכים על ידי הכלי הזה. כל מחזיקי הכלים של ELF תומכים בשלב זה בהגדרה הזו.
תגים:loading_and_analysis
,affects_outputs
,affects_outputs
- ברירת מחדל של
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: הצגת תיאור -
ההגדרה קובעת את גרסת ה-SDK של iOS שבה משתמשים כדי ליצור אפליקציות ל-iOS. אם לא צוין, נעשה שימוש בגרסת ה-SDK ל-iOS המוגדרת כברירת מחדל מ-'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: הצגת תיאור -
הגדרה של גרסת ה-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' (קובץ שנמצא מתחת לבסיס של סביבת העבודה).
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
--platforms=<a build target label>
כברירת מחדל: ""-
התוויות של כללי הפלטפורמה שמתארות את פלטפורמות היעד של הפקודה הנוכחית.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--python2_path=<a string>
: הצגת תיאור -
הוצא משימוש, no-op. הושבת על ידי `--incompliance_use_python_toolschains`.
תגים:no_op
,deprecated
- ברירת מחדל של
--python3_path=<a string>
: הצגת תיאור -
הוצא משימוש, no-op. הושבת על ידי `--incompliance_use_python_toolschains`.
תגים:no_op
,deprecated
- ברירת מחדל של
--python_path=<a string>
: הצגת תיאור -
הנתיב המוחלט של כלי התרגום של Python הופעל להפעלת יעדים ב-Python בפלטפורמת היעד. הוצא משימוש; הושבת על ידי --incompliance_use_python_toolschains.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--python_top=<a build target label>
: הצגת תיאור -
התווית של py_runtime שמייצגת את תרגום ה-Python שהופעל כדי להפעיל יעדי Python בפלטפורמת היעד. הוצא משימוש; הושבת על ידי --incompliance_use_python_toolschains.
תגים: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 שבה רוצים להשתמש כדי ליצור אפליקציות טלוויזיה. אם לא צוין אחרת, המערכת משתמשת בגרסת ברירת המחדל של ה-SDK של tvOS מאת 'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: הצגת תיאור -
קביעת הגרסה של ה-SDK של WatchOS שבה רוצים להשתמש כדי ליצור אפליקציות WatchOS. אם לא צוין אחרת, המערכת תשתמש בגרסת ה-SDK שהוגדרה ל-watchOS כברירת מחדל מהכתובת 'xcode_version'
תגים:loses_incremental_state
- ברירת מחדל של
--xcode_version=<a string>
: הצגת תיאור -
אם צוין, נעשה שימוש ב-Xcode של הגרסה הנתונה לפעולות build רלוונטיות. אם לא צוין אחרת, נעשה שימוש בגרסת ברירת המחדל של ה-Xcoder.
תגים: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_runfile_links
כברירת מחדל: "true"-
אם זה מוגדר, יש לבנות יערות קישורים של קובצי ריצה עבור כל היעדים. אם הערך הוא False, יש לכתוב מניפסטים רק כאשר הדבר אפשרי.
תגים:affects_outputs
--[no]build_runfile_manifests
כברירת מחדל: "true"-
אם הערך הוא true, יש לכתוב מניפסטים של Runruns בכל היעדים. אם הם שגויים, יש להשמיט אותם. בדיקות מקומיות ייכשלו כשהן הוגדרו כ-False.
תגים:affects_outputs
--[no]build_test_dwp
כברירת מחדל: "false"-
אם המדיניות מופעלת, כשיוצרים בדיקות C++ באופן סטטי ובהשהיה, קובץ ה-dvp של הקובץ הבינארי של הבדיקה יהיה גם הוא נבנה באופן אוטומטי.
תגים: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++ וקישורים. אפשר לשלב כל שילוב של {'quickbuild', 'dbg', 'opt'} או את הערכים המיוחדים 'yes' כדי להשבית את כל המצבים &&339;no' כדי להשבית את כל המצבים.
תגים:loading_and_analysis
,action_command_lines
,affects_outputs
--[no]legacy_external_runfiles
כברירת מחדל: "true"-
אם פעולה זו מוגדרת כ-TRUE, יש לבנות יערות סימבול של Run Runlinks עבור מאגרים חיצוניים בסיומת .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>
שימושים מרובים -
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם הגדרת יעד. אפשר לציין משתנים לפי שם, ובמקרה כזה הערך יילקח מסביבת ההפעלה, או מצמד של שם=ערך שמגדיר את הערך ללא קשר לסביבת ההפעלה. ניתן להשתמש באפשרות הזו מספר פעמים. אם מגדירים את אותו משתנה, נצברות הווריאציות האחרונות וגם צוברים את האפשרויות השונות.
תגים: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 Databind 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' פירושו ש-Bazel תבחר אם לקשר באופן דינמי. 'LY' פירושו שכל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי בעיקר.
תגים:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
כברירת מחדל: "alphabetical"-
הגדרת הסדר של המניפסטים שהועברו למיזוג של המניפסט עבור קבצים בינאריים של Android. ALPHABETICAL כלומר מניפסטים ממוינים לפי נתיב ביחס ל-executroot. 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>
שימושים מרובים -
יש לציין את מצב הסיביות של Apple לשלבי ההידור שמטרגטים את ארכיטקטורות המכשירים. הערכים צריכים להיות בפורמט '[platform=]mode' כאשר הפלטפורמה (חייבת להיות 'ios', 'macos', 'tvos' או 'watchos' ) היא אופציונלית. אם ציינתם קוד כזה, הוא מיושם באופן ספציפי עבור הפלטפורמה הזו. אם הוא חסר, הוא חל על כל הפלטפורמות. המצב חייב להיות &&39;none', 'embedded_טושים' או 'embedded' ייתכן שהאפשרות הזו תוצג כמה פעמים.
תגים:loses_incremental_state
--[no]build_python_zip
כברירת מחדל: "auto"-
בניית מיקוד לקובץ python שניתן להפעלה; ב-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. בדרך כלל אין לציין אפשרות זו ישירות – 'כיסוי פנים' יש להשתמש בפקודה במקום זאת.
תגים:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ברירת מחדל: "quickbuild"-
ציון המצב שבו הקובץ הבינארי יהיה מובנה. Value: 'quickbuild', 'dbg', 'opt'.
תגים:affects_outputs
,action_command_lines
,explicit_in_output_path
- נצברו
--conlyopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc בעת הידור קובצי מקור ב-C.
תגים:action_command_lines
,affects_outputs
- נצברו
--copt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-GCC.
תגים: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>
: הצגת תיאור -
cscsff_profile שמייצג את הפרופיל הרגיש של ההקשר שישמש לאופטימיזציה.
תגים:affects_outputs
- נצברו
--cxxopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-GCC במהלך הידור קובצי מקור ב-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"-
הפעלה של עץ סימולט של קובצי הפעלה; כברירת מחדל, האפשרות מושבתת ב-Windows, בפלטפורמות אחרות.
תגים:affects_outputs
- נצברו
--experimental_action_listener=<a build target label>
שימושים מרובים -
הוצא משימוש בשל היבטים. אפשר להשתמש ב-action_listener כדי לצרף additional_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"-
להשתמש בגרסה ל-Android של קישור נתונים גרסה 2
תגים: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" -
המערכת משתמשת במחרוזות האלה כאפשרויות מהדר OBJC לבנייה מהירה.
תגים:action_command_lines
--[no]experimental_omitfp
כברירת מחדל: "false"-
True
תגים: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 כשמפעילים את collections_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 המכיל פרופיל אוטומטי. הדגל הזה מקבל גם קבצים שצוינו כתוויות, לדוגמה //foo/bar:file.afdo. תוויות כאלה חייבות להפנות לקובצי קלט. ייתכן שתצטרכו להוסיף הוראת Export_files לחבילה המתאימה כדי שהקובץ יהיה גלוי ל-Bazel. אפשר גם לקבל קובץ פרופיל LLVM גולמי או שנוסף לאינדקס. הסימון הזה יוחלף על ידי כלל 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>
שימושים מרובים -
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם הגדרות מארח או הפעלה. אפשר לציין משתנים לפי שם, ובמקרה כזה הערך יילקח מסביבת ההפעלה, או מצמד של שם=ערך שמגדיר את הערך ללא קשר לסביבת ההפעלה. ניתן להשתמש באפשרות הזו מספר פעמים. אם מגדירים את אותו משתנה, נצברות הווריאציות האחרונות וגם צוברים את האפשרויות השונות.
תגים:action_command_lines
--host_compilation_mode=<fastbuild, dbg or opt>
כברירת מחדל: "opt"-
יש לציין את המצב שבו ייעשה שימוש בכלים שנוצרו במהלך ה-build. Value: 'quickbuild', 'dbg', 'opt'.
תגים:affects_outputs
,action_command_lines
- נצברו
--host_conlyopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-gcc במהלך הידור קובצי מקור ל-C עבור כלי מארח.
תגים:action_command_lines
,affects_outputs
- נצברו
--host_copt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה אל GCC עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
--host_cpu=<a string>
כברירת מחדל: ""-
יחידת העיבוד המרכזית (CPU) של המארח.
תגים:changes_inputs
,affects_outputs
- נצברו
--host_cxxopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה אל GCC עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_force_python=<PY2 or PY3>
: הצגת תיאור -
ההגדרה הזו מבטלת את גרסת Python של תצורת המארח. יכול להיות "PY2" או "PY3".
תגים:loading_and_analysis
,affects_outputs
- נצברו
--host_linkopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-ccC כשמקשרים כלים למארחים.
תגים: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>
שימושים מרובים -
אפשרויות נוספות להעברה ל-wifc עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
--[no]incompatible_avoid_conflict_dlls
כברירת מחדל: "true"-
אם האפשרות מופעלת, כל הספריות המקושרות (DLL) של C++ שנוצרו על ידי cc_library ב-Windows ישתנו ל-name_{hash}.dll, והחישוב שלהן מבוסס על ה-RepositoryName ונתיב החבילה DLL'. האפשרות הזו שימושית כשיש חבילה אחת שתלויה במספר יחידות, cc_library בשם זהה (למשל //foo/bar1:utils ו-//foo/bar2:utils).
תגים:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_merge_genfiles_directory
כברירת מחדל: "true"-
אם הערך הוא True, ספריית קובצי הקיפול מורכבת ממאגר הספרייה.
תגים:affects_outputs
,incompatible_change
--[no]incompatible_use_platforms_repo_for_constraints
כברירת מחדל: "false"-
אם הערך הוא 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>
default: "-/JavaScripttests[/:],-/test/javascript[/:]"-
כשהכיסוי מופעל, המערכת תשלב רק כללים עם שמות שכלולים במסנן המבוסס על ביטויים רגולריים (regex). כללים עם קידומת '-' אינם נכללים במקום זאת. לידיעתכם, ניתן להשתמש רק בכללים שאינם בדיקות, אלא אם התכונה ininument_test_targets מופעלת.
תגים:affects_outputs
--ios_cpu=<a string>
כברירת מחדל: "x86_64"-
ההגדרה כוללת טירגוט של יחידת העיבוד המרכזית (CPU) ב-iOS.
תגים:no_op
,deprecated
- ברירת מחדל של
--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"-
הוצא משימוש, הוחלף על ידי --incompliance_remove_Legacy_whole_archive (לפרטים: https://github.com/bazelbuild/bazel/issues/7362). כאשר הוא פועל, יש להשתמש ב- --all-archive עבור כללים cc_binary שיש להם linkshared=1 וכן linkstatic=1 או '-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>
שימושים מרובים -
אפשרויות נוספות להעברה לאוסף של יעד C.
תגים:action_command_lines
- נצברו
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
שימושים מרובים -
אפשרויות נוספות להעברה סלקטיבית ל-GCC במהלך הידור קבצים מסוימים. ניתן להעביר את האפשרות הזו מספר פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. כאשר regex_filter מייצג רשימה של הכללת והחרגה של דפוסי ביטויים רגולריים (ראו גם -instrumentation_filter). option_1 to option_n מייצגת אפשרויות של שורת פקודה שרירותית. אם אפשרות מכילה פסיק, יש לצטט אותו לוכסן הפוך. אפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --per_file_copt=//foo/.*\.cc,-//foo/bar\.cc@-O0 מוסיפה את אפשרות שורת הפקודה -O0 לשורת הפקודה של gcc בכל קובצי ה-עותקים ב-//foo/ פרט ל-bar.cc.
תגים:action_command_lines
,affects_outputs
- נצברו
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
שימושים מרובים -
אפשרויות נוספות להעברה סלקטיבית אל קצה עורפי LTO (בקטע --features=thin_lto) במהלך הידור אובייקטים עורפים. ניתן להעביר את האפשרות הזו מספר פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. כאשר regex_filter מייצג רשימה של הכללה והחרגה של דפוסים רגולריים של ביטויים רגולריים (Option_1) אל option_n, לציון אפשרויות של שורת פקודה שרירותית. אם אפשרות מכילה פסיק, יש לצטט אותו לוכסן הפוך. אפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --per_file_ltobackendopt=//foo/.*\.o,-//foo/bar\.o@-O0 מוסיף את אפשרות שורת הפקודה -O0 לשורת הפקודה LTO בקצה העורפי של כל קובצי o ב-//foo/ מלבד Bar.o.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--platform_suffix=<a string>
: הצגת תיאור -
קביעת סיומת להוספה לספריית התצורה.
תגים:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ברירת מחדל של
--propeller_optimize=<a build target label>
: הצגת תיאור -
יש להשתמש בפרטי פרופיל המדחף כדי לבצע אופטימיזציה של יעד ה-build.פרופיל מדחף חייב להכיל לפחות אחד משני קבצים, פרופיל cc ופרופיל ld. הסימון הזה מאשר תווית בנייה, שחייבת להתייחס לקובצי הקלט של פרופיל המדחף. לדוגמה, קובץ ה-BUILD שמגדיר את התווית, ב-a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) הוראת add to be add to be set to be set it to הוסף את הפרמטר to to הוסף אבל יש לכל הקבצים האלה "הוראות להגשה" של שלהם יש להשתמש באפשרות הזו בתור: --propeller_optimize=//a/b:propeller_profile
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--propeller_optimize_absolute_cc_profile=<a string>
: הצגת תיאור -
שם הנתיב המוחלט של קובץ cc_profile עבור גרסת ה-build של אופטימיזציה של Propleler.
תגים:affects_outputs
- ברירת מחדל של
--propeller_optimize_absolute_ld_profile=<a string>
: הצגת תיאור -
שם הנתיב המוחלט של קובץ ld_profile עבור גרסת ה-build של אופטימיזציה ב-Propleler.
תגים:affects_outputs
- ברירת מחדל של
--run_under=<a prefix in front of command>
: הצגת תיאור -
לפני הסימן צריך להפעיל את הפקודה של 'test' &&339;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
-
אם הערך הוא True, ספריות מקומיות שמכילות פונקציונליות זהה ישותפו בין יעדים שונים
תגים:loading_and_analysis
,affects_outputs
--[no]stamp
כברירת מחדל: "false"-
חותמות בינאריות עם התאריך, שם המשתמש, שם המארח, פרטי סביבת העבודה וכו'
תגים:affects_outputs
- ברירת מחדל של
--strip=<always, sometimes or never>
: "לפעמים" -
ההגדרה קובעת אם להסיר בינאריים וספריות משותפות (באמצעות "-Wl,--strip-debug" ). ערך ברירת המחדל של 'sometimes' פירושו Strap iff --compilation_mode=quickbuild.
תגים: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>
שימושים מרובים -
רשימה אדריכלית של כתובות URL המופרדות בפסיקים, שעליהן יש לבנות קבצים בינאריים של Apple WatchOS.
תגים: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, האפשרויות האלה תמיד יהיו קבועות כאילו לא צוינו Xxary_fdo.
תגים:affects_outputs
- אפשרויות שמשפיעות על התדירות שבה נאכפים ב-Bazel קלט חוקי של Build (הגדרות של כללים, שילובי דגלים וכו'):
--auto_cpu_environment_group=<a build target label>
כברירת מחדל: ""-
הצהרת הסביבה group_to
תגים: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"-
כדי להצפין את קוד ה-בייט בייט Java 8 לפני הסרת הניקוי.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]enforce_constraints
כברירת מחדל: "true"-
בדיקת הסביבות שבהן כל יעד תואם ודיווח על שגיאות אם לכל יעד יש יחסי תלות שלא תומכים באותן סביבות
תגים:build_file_semantics
--[no]experimental_allow_android_library_deps_without_srcs
כברירת מחדל: "false"-
סימון כדי לעזור במעבר מההרשאה 'לא לאפשר הרשאה' לכללים של Android ללא ספריות עם נקודות שפל. יש לנקות את המחסן כדי להשיק את ברירת המחדל הזו.
תגים:eagerness_to_exit
,loading_and_analysis
--[no]experimental_check_desugar_deps
כברירת מחדל: "true"-
אם צריך לבדוק שוב את ניפוי הבאגים הנכון ברמה בינארית של Android.
תגים:eagerness_to_exit
,loading_and_analysis
,experimental
--[no]experimental_desugar_java8_libs
כברירת מחדל: "false"-
אם רוצים לכלול ספריות Java 8 נתמכות באפליקציות במכשירים מדור קודם.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,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_disable_native_android_rules
כברירת מחדל: "false"-
כשהאפשרות מופעלת, השימוש הישיר בכללים המקוריים של Android מושבת. יש להשתמש בכללים של Android Starkk בכתובת 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_dependenncy_recursives מושבתת.
תגים: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 מצהיר במפורש על כל היעדים שנעשה בהם שימוש ב-'ייבוא ציבורי'.
תגים:build_file_semantics
,eagerness_to_exit
,incompatible_change
--[no]strict_system_includes
כברירת מחדל: "false"-
אם המדיניות מוגדרת כ-true, צריך להצהיר על כותרות גם באמצעות נתיבים (-ii).
תגים:loading_and_analysis
,eagerness_to_exit
- נצברו
--target_environment=<a build target label>
שימושים מרובים -
הצהרת סביבת היעד של ה-build הזה. הערך חייב להיות תווית לכלל '&מירכאות'. אם ציינתם זאת, כל היעדים ברמה העליונה חייבים להיות תואמים לסביבה הזו.
תגים: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"-
אם המדיניות מוגדרת ומצב האיסוף לא &&39;opt' אפליקציות objc יכללו הרשאות לניפוי באגים בזמן החתימה.
תגים:changes_inputs
- ברירת מחדל של
--ios_signing_cert_name=<a string>
: הצגת תיאור -
שם שיש להשתמש בו לחתימת iOS. אם המדיניות לא מוגדרת, היא תוחזר לפרופיל ניהול ההקצאות. יכול להיות שהעדפת הזהות של המפתח היא (או מחרוזת משנה) של השם הנפוץ של האישור, בהתאם לדף חותמת הקוד של קוד{2} (SIGNING ID ID).
תגים: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, כשל בניתוח של יעד כלל גורם למופע של יעד מופע של AnalysisFailureInfo המכיל את תיאור השגיאה, במקום לגרום לכשל ב-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 סוגי מכשירים' במחשב שבו הסימולטור יפעל.
תגים: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 מורה ל'בלז' להשתמש בברירות המחדל של הזמן הקצוב לתפוגה עבור קטגוריה זו.
- ברירת מחדל של
--tvos_simulator_device=<a string>
: הצגת תיאור -
המכשיר להדמיה בעת הפעלת אפליקציית tvOS בסימולטור, למשל 'Apple TV 1080p'. כדי לקבל רשימת מכשירים, אפשר להפעיל 'xcrun simctl list סוגי מכשירים' במחשב שבו הסימולטור יפעל.
תגים: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 – 38 מ"מ'. כדי לקבל רשימת מכשירים, אפשר להפעיל 'xcrun simctl list סוגי מכשירים' במחשב שבו הסימולטור יפעל.
תגים: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>
כברירת מחדל: "שמרי"-
איך לפתור בעיות של יחס גובה-רוחב כשפורמט הפלט הוא {xml,proto,record}. 'off' כלומר, לא תלויות יחסי גובה-רוחב, 'שמרני' (ברירת המחדל) פירוש הדבר שכל התלות המוצהרות ביחס להיבטים מתווספות, בין אם הן קיבלו את סיווג הכללים תלויות חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, ולכן הוא איטי יותר מהמצבים האחרים. כמו כן, גם מצב מדויק אינו מדויק לגמרי: ההחלטה אם לחשב היבט מתקבלת על שלב בשלב הניתוח, שאינו פועל במהלך 'שאילתה'
תגים:build_file_semantics
--[no]graph:factored
כברירת מחדל: "true"-
אם הערך הוא True, התרשים יוסר אפשרות זו רלוונטית רק ל- --Output=graph.
תגים:terminal_output
--graph:node_limit=<an integer>
כברירת מחדל: "512"-
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; -1 פירושו חיתוך. אפשרות זו רלוונטית רק ל- --Output=graph.
תגים:terminal_output
--[no]implicit_deps
כברירת מחדל: "true"-
אם אפשרות זו מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלויות שבו השאילתה פועלת. תלות משתמעת היא לא מצוינת במפורש בקובץ BUILD, אבל מתווספת על ידי Bazel. עבור שאילתה, אפשרות זו שולטת בסינון מחזיקי כלים שנפתרו.
תגים:build_file_semantics
--[no]include_aspects
כברירת מחדל: "true"-
query, cquery: אם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: לא-תפעול (תמיד מתבצע מעקב אחר היבטים).
תגים:terminal_output
--[no]incompatible_display_source_file_location
כברירת מחדל: "true"-
ברירת המחדל היא הצגת היעד של קובץ המקור. אם הערך הוא True, מוצג המיקום של שורה 1 של קובצי המקור בפלט המיקום. הסימון הזה קיים רק למטרות מיגרציה.
תגים:terminal_output
,incompatible_change
--[no]infer_universe_scope
כברירת מחדל: "false"-
אם היא מוגדרת ו-unis_scope לא מוגדרת, הערך של לתשומת ליבכם, הערך --universe_scope שמתקבל עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, 'allrdeps')) עשוי להיות לא מה שאתם רוצים, ולכן מומלץ להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים נוספים ודוגמאות זמינים בכתובת https://bazel.build/versions/reference/query#sky-query אם --universe_scope מוגדר, המערכת תתעלם מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'query' (כלומר, לא 'cquery`).
תגים:loading_and_analysis
--[no]line_terminator_null
כברירת מחדל: "false"-
אם כל פורמט יסתיים ב-\0 במקום בשורה חדשה.
תגים:terminal_output
--[no]nodep_deps
כברירת מחדל: "true"-
אם המדיניות מופעלת, נקודות מדדים של "nodep" ייכללו בתרשים התלויות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep" &"ability" אפשר להריץ ולנתח את הפלט של 'info-language' כדי לקבל מידע על כל המאפיינים "nodep" בשפת הבנייה.
תגים:build_file_semantics
--output=<a string>
כברירת מחדל: "label"-
הפורמט שבו יש להדפיס את תוצאות השאילתות. הערכים המותרים ל-cquery הם: label, label_kind, textproto, Transits, proto, jsonproto. אם בוחרים 'transitions' צריך גם לציין את האפשרות --transitions=(lite|full).
תגים:terminal_output
--[no]proto:default_values
כברירת מחדל: "true"-
אם הערך הוא True, המערכת תכללו מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- -Output=proto
תגים:terminal_output
--[no]proto:definition_stack
כברירת מחדל: "false"-
אכלוס השדה proto-stack של הפרוטוקול, שבו מתועדת כל מופע של כלל ה-Starlark ברגע שהוגדרה המחלקה לכלל.
תגים: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"-
רשימת מאפיינים מופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להפיק פלט אף מאפיין. אפשרות זו רלוונטית ל--Output=proto.
תגים:terminal_output
--[no]proto:rule_inputs_and_outputs
כברירת מחדל: "true"-
האם אפשר לאכלס את השדותכלל_קלט וכלל_פלט.
תגים:terminal_output
--[no]relative_locations
כברירת מחדל: "false"-
אם הערך הוא True, המיקום של קובצי BUILD בפלט XML ו-Proto יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא עקבי במכונות שונות. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במחשבים שונים.
תגים:terminal_output
--show_config_fragments=<off, direct or transitive>
כברירת מחדל: "off"-
הצגת קטעי הקוד הנדרשים על ידי כלל והתלויות העקיפות שלו. אפשרות זו יכולה לעזור להעריך עד כמה ניתן לחתוך תרשים יעד מוגדר.
תגים:affects_outputs
--starlark:expr=<a string>
כברירת מחדל: ""-
ביטוי Starlark לפורמט של כל יעד שמוגדר במצב cquery's --fact=starlark. היעד המוגדר כפוף ל-'target'. אם לא מציינים --starlark:expr and --starlark:file, האפשרות הזו תוגדר כברירת מחדל ל- 'str(target.label)'. אירעה שגיאה בציון --starlark:expr ו- --starlark:file.
תגים:terminal_output
--starlark:file=<a string>
כברירת מחדל: ""-
שם של קובץ שמגדיר פונקציית Starlark בשם 'format' מתוך ארגומנט אחד, שחל על כל יעד מוגדר כדי לעצב אותו כמחרוזת. אירעה שגיאה בציון --starlark:expr ו- --starlark:file. לפרטים נוספים, --
תגים:terminal_output
--[no]tool_deps
כברירת מחדל: "true"-
שאילתה: אם היא מושבתת, יחסי תלות ב&&39;תצורת מארח' או 'execution' יעדים לא ייכללו בתרשים התלויות שבו השאילתה פועלת. קצה 'הגדרת מארח' תלות, כמו הכלל מכל &&39;proto_library' לרוב, המהדר של הפרוטוקול, מצביע על כלי שנערך במהלך הבנייה ולא על חלק מאותה תוכנית '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
כברירת מחדל: "false"-
אם היא מופעלת, קובצי C++ DD יועברו בזיכרון ישירות מצומתי ה-build המרוחקים, במקום להיכתב בדיסק.
תגים:loading_and_analysis
,execution
,affects_outputs
,experimental
--[no]experimental_inmemory_jdeps_files
כברירת מחדל: "false"-
אם היא מופעלת, קובצי התלויות (.jdeps) שנוצרו מהאוספים של Java יועברו בזיכרון ישירות מצומתי הבנייה המרוחקים, ולא בכתב בדיסק.
תגים: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_Config יהיה 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, מכיוון שסורק ההכללה לא מטמיע באופן מלא את הסמנטיקה של מעבד ה-C. באופן ספציפי, היא לא מבינה הנחיות #include דינמיות ומתעלמת מלוגיקה מותנית במעבד מראש. השימוש הוא באחריותך בלבד. כל בעיה הקשורה לסימון הזה שהוגשה ייסגרה.
תגים:loading_and_analysis
,execution
,changes_inputs
--[no]incremental_dexing
כברירת מחדל: "true"-
רוב העבודה היא של הדבקה בנפרד בכל קובץ צנצנת.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
--[no]objc_use_dotd_pruning
כברירת מחדל: "true"-
אם מגדירים קבצים מסוג d.
תגים:changes_inputs
,loading_and_analysis
--[no]process_headers_in_dependencies
כברירת מחדל: "false"-
כשיוצרים יעד //a:a, העיבוד של כותרות בכל היעדים ש-aa:a תלוי (אם עיבוד הכותרת מופעל ב-toolschain).
תגים: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>
כברירת מחדל: "-.*"-
הדפסה של מידע על תוצאות ניפוי הבאגים במהלך פתרון בעיות בכלי הכלים. התכונה בודקת את הביטוי הרגולרי (regex), שנבדק מול סוגי Toolchain ויעדים ספציפיים כדי לבדוק איזה מהם ניפוי באגים. יש כמה ביטויים רגולריים שאפשר להפריד ביניהם באמצעות פסיקים, ולאחר מכן כל ביטוי רגולרי מסומן בנפרד. הערה: הפלט של הדגל הזה מורכב מאוד, וסביר להניח שהוא יהיה שימושי רק למומחים במציאת פתרון בכלי.
תגים:terminal_output
- אפשרויות המציינות או משנות קלט גנרי לפקודת Bazel שאינה מתאימה לקטגוריות אחרות:
- נצברו
--flag_alias=<a 'name=value' flag alias>
שימושים מרובים -
מגדיר שם מקוצר לסימון Starlark. הוא מקבל צמד מפתח-ערך אחד בצורת ארגומנט;<key>=<value>" כארגומנט.
תגים:changes_inputs
--[no]incompatible_default_to_explicit_init_py
כברירת מחדל: "false"-
הסימון הזה משנה את התנהגות ברירת המחדל כך שקובצי _inin__.py לא נוצרים יותר באופן אוטומטי בקובצי ריצה של יעדים ב-Python. בדיוק, כשיעד py_binary או py_test מוגדר מדור קודם עד: "auto" (ברירת המחדל), המערכת מתייחסת לערך False אם רק הדגל הזה מוגדר. יש לעיין בכתובת https://github.com/bazelbuild/bazel/issues/10076.
תגים:affects_outputs
,incompatible_change
--[no]incompatible_py2_outputs_are_suffixed
כברירת מחדל: "true"-
אם הערך הוא true, יעדים שנוצרו בתצורת Python 2 יופיעו מתחת לשורש הפלט הכולל את הסיומת '-py2' בעוד שיעדים שנוצרו עבור Python 3 יופיעו בשורש ללא סיומת הקשורה ל-Python. המשמעות היא שסימן הנוחות 'bazel-bin' מצביע על טירגוט ב-Python 3 ולא על Python 2. אם האפשרות הזו מופעלת, מומלץ גם להפעיל את `--incompatible_py3_is_default`.
תגים:affects_outputs
,incompatible_change
--[no]incompatible_py3_is_default
כברירת מחדל: "true"-
אם הערך הוא True, היעדים 'py_binary' ו-'py_test' שלא הגדירו את המאפיין 'python_version' (או 'default_python_version') יעברו כברירת מחדל ל-PY3 במקום ל-PY2. אם הדגל הזה מוגדר, מומלץ גם להגדיר את `--incompliance_py2_Outputs_are_suffixed`.
תגים:loading_and_analysis
,affects_outputs
,incompatible_change
--[no]incompatible_use_python_toolchains
כברירת מחדל: "true"-
אם המדיניות מוגדרת כ-True, כללים להפעלה אוטומטית של Python יתבססו על זמן הריצה של Python שצוין על ידי Toolchain של ה-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, מערכת Blaze תבטל בו-זמנית את הבדיקות שפועלות בהפעלה הראשונה המוצלחת. זה שימושי רק בשילוב עם --runs_per_test_detects_flake.
תגים: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"-
אם הערך הוא True, יצירת כיסוי מסוג ClangV תיצור דוח 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>
כברירת מחדל: "JavaScriptbuilder"- הפעלה של מסלולי נתיב מופחתים עבור אוספים של Java.
--[no]experimental_limit_android_lint_to_android_constrained_java
כברירת מחדל: "false"-
הגבלה --Experimental_run_android_lint_on_javascript_rules לספריות תואמות ל-Android.
תגים:affects_outputs
--[no]experimental_run_android_lint_on_java_rules
כברירת מחדל: "false"-
אם יש צורך לאמת את מקורות Java_*.
תגים:affects_outputs
--[no]explicit_java_test_deps
כברירת מחדל: "false"- יש לציין באופן תלוי תלות ב-JUNIT או ב-Hunstest ב-JavaScript_test במקום להשיג בטעות את נקודות הטעינה של RunRunner' . מתאים כרגע רק לאפליקציות בנק.
- ברירת מחדל של
--host_java_launcher=<a build target label>
: הצגת תיאור - מרכז האפליקציות של Java המשמש את הכלים שהוצאו משימוש במהלך גרסת build.
- נצברו
--host_javacopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-JavaScript במהלך בניית כלים שמתבצעים במהלך גרסת build.
- נצברו
--host_jvmopt=<a string>
שימושים מרובים - אפשרויות נוספות למעבר ל-VM VM במהלך בניית הכלים שמתבצעים במהלך ה-build. האפשרויות האלה יתווספו לאפשרויות ה-VM להפעלה של כל יעד JavaScript_binary.
--[no]incompatible_exclusive_test_sandboxed
כברירת מחדל: "false"-
אם הערך הוא TRUE, בדיקות בלעדיות יפעלו עם אסטרטגיה מסוג ארגז חול. אפשר להוסיף תג &&39;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_Output=streamed.
הרחבה אל:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
--[no]java_deps
כברירת מחדל: "true"- יצירת מידע על תלות (בשלב זה, נתיב Class time-time) ליעד Java.
--[no]java_header_compilation
כברירת מחדל: "true"- מקבצים את קובצי ה-IE ישירות מהמקור.
--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>
שימושים מרובים - אפשרויות נוספות להעברה ל-JavaScript.
- נצברו
--jvmopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-Java VM. האפשרויות האלה יתווספו לאפשרויות ה-VM להפעלה של כל יעד JavaScript_binary.
- ברירת מחדל של
--legacy_main_dex_list_generator=<a build target label>
: הצגת תיאור - קביעת קובץ בינארי לשימוש ליצירת רשימת הכיתות שחייבות להיות בפקס הראשי בעת הידור כמה מכפילים מדור קודם.
- נצברו
--plugin=<a build target label>
שימושים מרובים - יישומי פלאגין שאפשר להשתמש בהם ב-build. פועל כרגע עם JavaScript_plugins.
- ברירת מחדל של
--proguard_top=<a build target label>
: הצגת תיאור - ההגדרה של גרסת Proguard להסרת קוד בינארי לפי Java.
--proto_compiler=<a build target label>
ברירת מחדל: "@com_google_protobuf//:protracker"-
התווית של המהדר.
תגים:affects_outputs
,loading_and_analysis
--proto_toolchain_for_cc=<a build target label>
ברירת מחדל: "@com_google_protobuf//:cc_toolschain"-
תווית של proto_lang_toolschain() שמתארת איך להרכיב C+protos מסוג C+
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_j2objc=<a build target label>
: "@bazel_tools//tools/j2objc:j2objc_proto_toolschain" -
תווית של proto_lang_toolschain() שמתארת איך להדר j2objc protos
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_java=<a build target label>
: "@com_google_protobuf//:JavaScript_toolschain" -
תווית של proto_lang_toolschain() שמתארת את ההידור של Java Protos
תגים:affects_outputs
,loading_and_analysis
--proto_toolchain_for_javalite=<a build target label>
ברירת מחדל: "@com_google_protobuf//:JavaScriptlite_toolschain"-
תווית של proto_lang_toolschain() שמתארת את ההידור של JavaLite protos
תגים:affects_outputs
,loading_and_analysis
- נצברו
--protocopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה אל המהדר של Protobuf.
תגים:affects_outputs
--[no]runs_per_test_detects_flakes
כברירת מחדל: "false"- אם הערך הוא True, כל שבר שבו ניסיון ריצה/ניסיון אחד לפחות ולפחות ניסיון אחד/ניסיון אחד נכשל נכשל מקבלים סטטוס של תוכן מסוג FLAKY.
- ברירת מחדל של
--shell_executable=<a path>
: הצגת תיאור -
נתיב מוחלט למעטפת המשמשת לשימוש ב-Bazel אם זה לא מוגדר, אבל משתנה הסביבה BAZEL_SH מוגדר בהפעלה הראשונה של Bazel (שמפעילה שרת Bazel), ה-Bazel משתמש בכך. אם אף אחד מהם לא מוגדר, Bazel משתמשת בנתיב ברירת מחדל בתוך קוד פתוח, בהתאם למערכת ההפעלה שבה היא פועלת (Windows: c:/tools/msys64/usr/bin/bash.exe , FreeBSD: /usr/local/bin/bash , כל השאר: /bin/bash). לתשומת ליבכם: שימוש במעטפת שלא תואם ל-bash עלול לגרום לכשלים בבנייה או לכשלים בריצה של נתונים בינאריים שנוצרו.
תגים:loading_and_analysis
- נצברו
--test_arg=<a string>
שימושים מרובים - ההגדרה כוללת אפשרויות וארגומנטים נוספים שצריך להעביר לקובץ ההפעלה של הבדיקה. אפשר להשתמש במספר פעמים כדי לציין כמה ארגומנטים. אם נבצע מספר בדיקות, כל אחת מהן תקבל ארגומנטים זהים. משמש רק את הפקודה 'bazel'
- ברירת מחדל של
--test_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' BUILD. 'disabled' לעולם לא להשתמש בפיצול בדיקות.
--tool_java_language_version=<a string>
כברירת מחדל: "8"- גרסת השפה של Java המשמשת להפעלת הכלים הנחוצים במהלך פיתוח
- ברירת מחדל של
--tool_java_runtime_version=<a string>
: "remotejdk_11" - גרסת זמן הריצה של Java המשמשת להפעלת כלים במהלך יצירת ה-build
--[no]use_ijars
כברירת מחדל: "true"- אם האפשרות הזו מופעלת, הידור Java יכול להשתמש בצנצנות ממשק. פעולה זו תגרום לצבירה מצטברת מהירה יותר, אבל הודעות השגיאה עשויות להיות שונות.
אפשרויות Dump
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--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 or detailed>
כברירת מחדל: "off"-
Dump של תרשים ה-Skyframe: 'off', 'summary', 'count' או 'detailed'.
תגים:bazel_monitoring
--skyfunction_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
כברירת מחדל: ".*"-
מסנן Regex של שמות SkyFunction לפלט. בשימוש רק עם --skyframe=detail.
תגים:bazel_monitoring
- ברירת מחדל של
--skylark_memory=<a string>
: הצגת תיאור -
מעבירה פרופיל זיכרון התואם ל-pff אל הנתיב שצוין. מידע נוסף זמין בכתובת 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
תגים:no_op
,deprecated
,experimental
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
--[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` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות אחזור
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--repository_cache=<a path>
: הצגת תיאור -
קביעת מיקום המטמון של הערכים שהורדו שהתקבלו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט מבקשת השבתה של המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בביצוע גרסאות:
--[no]incompatible_remote_symlinks
כברירת מחדל: "true"-
אם היא מוגדרת כ-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", "hosted_CPUS", "Host_RAM" ), ואחריו אופציונלי ([-|*]<float>) למשל. "auto", "Host_CPUS*.5". "auto" מוגדר ברירת מחדל סבירה על סמך המשאבים של המארח. חייב להיות לפחות 1.
תגים:bazel_internal_configuration
--[no]remote_allow_symlink_upload
כברירת מחדל: "true"-
אם הערך הוא True, יש להעלות פלט של קישור סימולציית פעולה למטמון המרוחק. אם אפשרות זו לא מופעלת, פעולות שניתן לשמור במטמון ופלט של קישורים סימולטניים ייכשלו.
תגים:execution
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, ולהשפיע על הערך שלו, במקום הקיום שלו:
--bep_maximum_open_remote_upload_files=<an integer>
כברירת מחדל: "-1"-
המספר המקסימלי של קבצים פתוחים המותרים במהלך העלאה של פריט מידע שנוצר על ידי משתמש (BEP).
תגים:affects_outputs
--remote_download_minimal
-
אי אפשר להוריד פלט של מערכת בנייה מרחוק למכשיר המקומי. הדגל הזה הוא קיצור דרך לשלושה סימונים: --Experimental_inmemory_jdeps_files, --ניסיוניal_inmemory_dotd_files ו--remote_download_Outputs=minimal.
הרחבה אל:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=minimal
תגים:affects_outputs
--remote_download_outputs=<all, minimal or toplevel>
כברירת מחדל: "all"-
אם היא מוגדרת כ-'מינימלית' לא תוריד פלט של בנייה מרחוק אל המכונה המקומית, חוץ מאלה שנדרשים על-ידי פעולות מקומיות. אם הוא מוגדר ל-'toplevel' מתנהג כמו'minimal' מלבד זאת, הוא מוריד את הפלט של היעדים ברמה העליונה למחשב המקומי. שתי האפשרויות יכולות לקצר משמעותית את זמני הבנייה אם רוחב הפס של הרשת הוא צוואר בקבוק.
תגים:affects_outputs
--remote_download_symlink_template=<a string>
כברירת מחדל: ""-
במקום להוריד פלט של בנייה מרחוק אל המכונה המקומית, יש ליצור קישורים סימבוליים. ניתן לציין את היעד של הקישורים הסימבוליים בצורת מחרוזת תבנית. מחרוזת התבנית הזו עשויה להכיל {hash} ו-{size_bytes} שמתרחבות לגיבוב של האובייקט ולגודל בבייטים, בהתאמה. קישורים סמליים אלה עשויים להפנות, לדוגמה, למערכת קבצים של FUSE שטוענת אובייקטים מ-CAS לפי דרישה.
תגים:affects_outputs
--remote_download_toplevel
-
הורדה של פלטים מרוחקים של יעדים ברמה העליונה בלבד למכונה המקומית. הסימון הזה הוא קיצור דרך לשלושה סימונים: --Experimental_inmemory_jdeps_files, --testal_inmemory_dotd_files ו--remote_download_facts=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
תגים:no_op
,deprecated
,experimental
--[no]incompatible_config_setting_private_default_visibility
כברירת מחדל: "false"-
אם המדיניות לא תואמת [en_force_config_setting_setting=false], זה לא "נוף". אחרת, אם הסימון הזה הוא false, כל הגדרה של config_ללא מאפיין חשיפה בוטה היא //ability:public אם הסימון הזה נכון, ההנחיה config_setting זהה ללוגיקת חשיפה כמו כל הכללים האחרים. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/12933.
תגים:loading_and_analysis
,incompatible_change
--[no]incompatible_enforce_config_setting_visibility
כברירת מחדל: "false"-
אם המדיניות הזו מוגדרת כ-True, יש לאכוף את הגבלות החשיפה של ה-config_setting. אם הערך הוא False, כל הגדרה של config_גלויה לכל יעד. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים:loading_and_analysis
,incompatible_change
- אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום ביומן:
--[no]experimental_record_metrics_for_all_mnemonics
כברירת מחדל: "false"- כברירת מחדל, מספר פעולות הפעולה מוגבל ל-20 הרכיבים המסחריים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים לכל הכלים.
--experimental_repository_resolved_file=<a string>
כברירת מחדל: ""-
אם לא ריק, צריך לכתוב ערך ב-Starlark עם המידע שנפתר בכל כללי מאגר הנתונים של Starlark שהופעלו.
תגים:affects_outputs
- אפשרויות המציינות או משנות קלט גנרי לפקודת Bazel שאינה מתאימה לקטגוריות אחרות:
--experimental_resolved_file_instead_of_workspace=<a string>
כברירת מחדל: ""-
אם הקובץ לא ריק, צריך לקרוא את הקובץ שנפתר במקום את הקובץ WORKSPACE
תגים:changes_inputs
- אפשרויות לשמירה במטמון ולהפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: הצגת תיאור - יש לציין קובץ שיוגדר בו את כלי ההורדה מרחוק. הקובץ מורכב משורות, וכל אחת מהן מתחילה בהוראה (`allow` , `block` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
--[no]experimental_guard_against_concurrent_changes
כברירת מחדל: "false"- השבתת האפשרות הזו תשבית את זמן האחזור של קובצי הקלט של פעולה לפני העלאתה למטמון מרוחק. ייתכנו מקרים שבהם הליבה של Linux תעכב את כתיבת הקבצים, וכתוצאה מכך עלולות להיות תוצאות שגויות.
--[no]experimental_remote_cache_async
כברירת מחדל: "false"- אם הערך הוא True, מטמון I/O מרוחק יתרחש ברקע במקום להיערך כחלק מה-1.
--[no]experimental_remote_cache_compression
כברירת מחדל: "false"- אם האפשרות מופעלת, אפשר לדחוס או לבטל את הדחיסה של blobs במטמון באמצעות zstd.
- ברירת מחדל של
--experimental_remote_capture_corrupted_outputs=<a path>
: הצגת תיאור - נתיב אל ספרייה שבה יתועדו הפלט הפגום.
- ברירת מחדל של
--experimental_remote_downloader=<a string>
: הצגת תיאור - URI של נקודת קצה ב-API של נכסים מרוחקים, המשמש כשרת proxy להורדה מרחוק. הסכימות הנתמכות הן grpc, GRpcs (grpc (עם TLS מופעל) ו-Unix (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תשתמש כברירת מחדל ב-GRp. למידע נוסף: https://github.com/bazelbuild/remote-apis/blob/Master/build/bazel/remote/asset/v1/remote_asset.proto
--[no]experimental_remote_execution_keepalive
כברירת מחדל: "false"- האם להשתמש ב-realive לשיחות מרחוק?
- ברירת מחדל של
--experimental_remote_grpc_log=<a path>
: הצגת תיאור - אם צוין, נתיב לקובץ ירשום פרטים הקשורים לשיחה עם gRPC. היומן הזה מורכב מרצף של com.google.devtools.build.lib.remote.logging.remoteE.remoteExecutionLog.LogEntry protobufs עם כל הודעה שהקידומת שלה מציינת קידומת שמציינת את הגודל של ההודעה הטורית הטורית הבאה, כפי שמבוצעת בשיטה LogEntry.writeDelimitedTo(OutputStream).
--[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' קובצי עזר רכים לא נשמרים, ייתכן ששגיאות "חסרות זיכרון" יהיו גבוהות מדי. אם הערך הוא 0, גודל המטמון לא מוגבל. הערך האופטימלי משתנה בהתאם לגודל הפרויקט. ערך ברירת המחדל הוא 1,000.
--[no]incompatible_remote_build_event_upload_respect_no_cache
כברירת מחדל: "false"- אם המדיניות מוגדרת כ-True, פלט ש-BEP מפנה אליו אינו מועלה למטמון מרוחק אם לא ניתן לשמור את פעולת היצירה במטמון מרחוק.
--[no]incompatible_remote_output_paths_relative_to_input_root
כברירת מחדל: "false"-
אם המדיניות מוגדרת כ-True, נתיבי הפלט יהיו יחסיים לשורש הקלט במקום לספרייה הפעילה.
תגים:incompatible_change
--[no]incompatible_remote_results_ignore_disk
כברירת מחדל: "false"-
אם המדיניות מוגדרת כ-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 של bytestream:// שכתובים במקורות נתונים של אירועים של build. ניתן להגדיר את האפשרות הזו כשמבצעים גרסאות build באמצעות שרת proxy, שגורם לכך שהערכים של --remote_executor ו--remote_instance_name כבר לא תואמים לשם הקנוני של שירות ההפעלה מרחוק. כשהמדיניות הזו לא מוגדרת, ברירת המחדל היא "${hostname}/${instance_name}".
- ברירת מחדל של
--remote_cache=<a string>
: הצגת תיאור - URI של נקודת קצה שנשמרת במטמון. הסכימות הנתמכות הן http, https, grpc, grpcs (grpc עם TLS מופעל) ו-Unix (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תשתמש כברירת מחדל ב-GRp. צריך לציין grpc://, http:// או Unix: כדי להשבית TLS. https://dbaze.build/docs/remote-caching
- נצברו
--remote_cache_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות לשמירה במטמון: --remote_cache_header=Name=Value. ניתן להעביר מספר כותרות על ידי ציון הסימון מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת באמצעות פסיקים.
- נצברו
--remote_default_exec_properties=<a 'name=value' assignment>
שימושים מרובים -
אם נכסי exec מוגדרים כפלטפורמת ביצוע מרחוק, ברירת המחדל תהיה שימוש כפלטפורמה לביצוע מרחוק.
תגים:affects_outputs
--remote_default_platform_properties=<a string>
כברירת מחדל: ""- ניתן להגדיר את מאפייני ברירת המחדל של הפלטפורמה כ-API של ביצוע מרחוק, אם פלטפורמת ההפעלה לא הגדירה עדיין Remote_execution_properties. המערכת תשתמש בערך הזה גם אם פלטפורמת המארח נבחרה כפלטפורמת ביצוע לביצוע מרחוק.
- נצברו
--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>
: הצגת תיאור - מארח או מתארח:PORT של נקודת קצה להפעלה מרחוק. הסכימות הנתמכות הן grpc, GRpcs (grpc (עם TLS מופעל) ו-Unix (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תשתמש כברירת מחדל ב-GRp. צריך לציין 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"- No-op, מיושן. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/7480.
--remote_max_connections=<an integer>
כברירת מחדל: "100"-
הגבלת המספר המקסימלי של חיבורים בו-זמניים למטמון/ביצוע מרחוק. כברירת מחדל, הערך הוא 100. אם מגדירים את הערך כ-0, אין הגבלה.
למטמון של HTTP מרחוק, חיבור אחד של TCP יכול לטפל בבקשה אחת בכל פעם, כך ש-Bazel יכולה לבצע עד בו-זמנית בקשות בו-זמנית.
עבור מטמון/ביצוע מרוחק של gRPC, ערוץ gRPC אחד בדרך כלל יכול לטפל ביותר מ-100 בקשות בו-זמנית, כך ש-Bazel יכולה לבצע כ-100 בקשות בו-זמנית * 1
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--remote_proxy=<a string>
: הצגת תיאור - מתחברים למטמון המרוחק דרך שרת proxy. בשלב זה, ניתן להשתמש בסימון הזה רק כדי להגדיר שקע דומיין Unix (unix:/path/to/socket).
--remote_result_cache_priority=<an integer>
כברירת מחדל: "0"- העדיפות היחסית של פעולות מרוחקות שנשמרו במטמון מרוחק. הסמנטיקה של ערכי העדיפות הספציפיים תלוית שרת.
--remote_retries=<an integer>
כברירת מחדל: "5"- מספר הניסיונות המקסימלי לניסיון חוזר של שגיאה זמנית. אם המדיניות מוגדרת כ-0, הניסיונות החוזרים מושבתים.
--remote_timeout=<An immutable length of time.>
כברירת מחדל: "60s"- משך הזמן המקסימלי להמתנה לביצוע מרחוק של שיחות ולשמירת מטמון. במטמון REST, מדובר גם בחיבור וגם בזמן קצוב לתפוגה של קריאה. אפשר להשתמש ביחידות הבאות: ימים (d), שעות (h), דקות (m), שניות (s) ואלפיות שנייה (ms). אם תשמיט את היחידה, הערך יפורש בשניות.
--[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_packages x/y מונע את הבעיה הזו.
- ברירת מחדל של
--disk_cache=<a path>
: הצגת תיאור - נתיב לספרייה שבו Bazel יכולה לקרוא ולכתוב פעולות ופלטי פעולות. אם הספרייה לא קיימת, היא תיווצר.
- ברירת מחדל של
--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 אחת בהמתנה. זמנים מתייחסים לרמת פירוט של שנייה. שגיאה בהגדרה של ערך שאינו שנייה. כברירת מחדל, פינגים פעילים. לפני שמפעילים את ההגדרה הזו, צריך לתאם עם הבעלים של השירות.
--grpc_keepalive_timeout=<An immutable length of time.>
כברירת מחדל: "20s"- הגדרת זמן קצוב לתפוגה של חיבורים פעילים של gRPC. אם פינגים מסוג keep-alive מופעלים באמצעות --grpc_keepalive_time, סימן ש-Bazel תם הזמן הקצוב לחיבור אם הוא לא מקבל תשובה בפינגים אחרי פרק הזמן הזה. זמנים מתייחסים לרמת פירוט של שנייה. שגיאה בהגדרה של ערך שאינו שנייה. אם פינגים פעילים נשמרים, המערכת תתעלם מההגדרה הזו.
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
--package_path=<colon-separated list of options>
כברירת מחדל: "%workspace%"- רשימה של המקומות שבהם מחפשים חבילות המופרדות בנקודתיים. רכיבים שמתחילים ב-'%workspace%' הם יחסי לסביבת העבודה הכוללת. אם לא מופיעה או ריקה, ברירת המחדל היא הפלט של 'bazel information default-package-path'
--[no]show_loading_progress
כברירת מחדל: "true"- אם מופעל, גורם ל-Bazel להדפיס {0} "חבילה
- ברירת מחדל של
--tls_certificate=<a string>
: הצגת תיאור - יש לציין נתיב לאישור TLS מהימן לחתימה על אישורי שרת.
- ברירת מחדל של
--tls_client_certificate=<a string>
: הצגת תיאור - יש לציין את אישור הלקוח ל-TLS שבו רוצים להשתמש. צריך גם לספק מפתח לקוח כדי להפעיל אימות לקוח.
- ברירת מחדל של
--tls_client_key=<a string>
: הצגת תיאור - יש לציין את מפתח הלקוח ב-TLS שבו יש להשתמש. כמו כן, צריך לספק אישור לקוח כדי להפעיל את אימות הלקוח.
אפשרויות עזרה
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--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
תגים:no_op
,deprecated
,experimental
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
--[no]experimental_record_metrics_for_all_mnemonics
כברירת מחדל: "false"- כברירת מחדל, מספר פעולות הפעולה מוגבל ל-20 הרכיבים המסחריים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים לכל הכלים.
--help_verbosity=<long, medium or short>
כברירת מחדל: "medium"-
בוחרים את המשמעויות של פקודת העזרה.
תגים:affects_outputs
,terminal_output
--long
[-l
]-
הצגת תיאור מלא של כל אפשרות במקום רק את השם שלה.
הרחבה אל:
--help_verbosity=long
תגים:affects_outputs
,terminal_output
--short
-
להציג רק את שמות האפשרויות, ולא את הסוגים או המשמעויות שלהן.
הרחבה אל:
--help_verbosity=short
תגים:affects_outputs
,terminal_output
- אפשרויות שמפרטות או משנות קלט גנרי לפקודת Bazel שאינה מתאימה לקטגוריות אחרות:
--experimental_resolved_file_instead_of_workspace=<a string>
כברירת מחדל: ""-
אם הקובץ לא ריק, צריך לקרוא את הקובץ שנפתר במקום את הקובץ WORKSPACE
תגים:changes_inputs
- אפשרויות לשמירה במטמון ולהפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: הצגת תיאור - יש לציין קובץ שיוגדר בו את כלי ההורדה מרחוק. הקובץ מורכב משורות, וכל אחת מהן מתחילה בהוראה (`allow` , `block` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות מידע
היא מקבלת בירושה את כל האפשרויות מ-build.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--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
תגים:no_op
,deprecated
,experimental
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
--[no]experimental_record_metrics_for_all_mnemonics
כברירת מחדל: "false"- כברירת מחדל, מספר פעולות הפעולה מוגבל ל-20 הרכיבים המסחריים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים לכל הכלים.
--[no]show_make_env
כברירת מחדל: "false"-
מוסיפים את סביבת "Make" בפלט.
תגים:affects_outputs
,terminal_output
- אפשרויות שמפרטות או משנות קלט כללי לפקודת Bazel שלא נכללת בקטגוריות אחרות:
--experimental_resolved_file_instead_of_workspace=<a string>
כברירת מחדל: ""-
אם הקובץ לא ריק, צריך לקרוא את הקובץ שנפתר במקום את הקובץ WORKSPACE
תגים:changes_inputs
- אפשרויות לשמירה במטמון ולהפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: הצגת תיאור - יש לציין קובץ שיוגדר בו את כלי ההורדה מרחוק. הקובץ מורכב משורות, וכל אחת מהן מתחילה בהוראה (`allow` , `block` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות רישיון
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--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
תגים:no_op
,deprecated
,experimental
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
--[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` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות התקנה בנייד
היא מקבלת בירושה את כל האפשרויות מ-build.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים:loading_and_analysis
--[no]experimental_repository_cache_hardlinks
כברירת מחדל: "false"-
אם היא מוגדרת, המטמון של מאגר הנתונים יקשר באופן חזק את הקובץ במקרה של היט של המטמון, במקום להעתיק אותו. כך תוכלו לחסוך מקום בכונן.
תגים: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
--[no]ignore_dev_dependency
כברירת מחדל: "false"-
אם הערך הוא true, המערכת של Bazel מתעלמת מ-'bazel_dep` ומ-'use_extensions' שהוכרז כ-'dev_dependency' ב-MODULE.bazel של מודול הבסיס. הערה: המערכת תמיד מתעלמת מתלויי הפיתוח האלה ב-MODULE.bazel אם הוא לא מודול הבסיס, ללא קשר לערך של הדגל הזה.
תגים:loading_and_analysis
- נצברו
--registry=<a string>
שימושים מרובים -
ציון המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודולים של Bazel. הסדר חשוב: המודולים ייבדקו קודם כל במרשמים קודמים, והם יחזרו למרשמים מאוחרים יותר רק אם הם חסרים קודם.
תגים:changes_inputs
- ברירת מחדל של
--repository_cache=<a path>
: הצגת תיאור -
קביעת מיקום המטמון של הערכים שהורדו שהתקבלו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט מבקשת השבתה של המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בביצוע גרסאות:
--mode=<classic, classic_internal_test_do_not_use or skylark>
כברירת מחדל: "classic"-
עליך לבחור איך להפעיל את ההתקנה של המכשיר הנייד. "classic" מפעיל את הגרסה הנוכחית של ההתקנה לנייד. "skylark" משתמש בגרסה החדשה של Starlark, שיש בה תמיכה ל-android_test.
תגים:loading_and_analysis
,execution
,incompatible_change
- אפשרויות שמגדירות את שרשרת הכלים המשמשת לביצוע הפעולה:
--adb=<a string>
כברירת מחדל: ""-
קובץ בינארי של adb לשימוש בפקודה 'mobile-install' אם לא הוגדר, ייעשה שימוש ב-SDK של Android שצוין באפשרות שורת הפקודה -android_sdk (או בברירת המחדל של SDK אם לא צוין Android_sdk) .
תגים:changes_inputs
- אפשרויות ששולטות בפלט של הפקודה:
--[no]incremental
כברירת מחדל: "false"-
האם לבצע התקנה מצטברת? אם כן, נסו להימנע ממצב שבו יש צורך בעבודה מיותרת על ידי קריאת המצב של המכשיר שבו תתבצע ההתקנה של הקוד ושימוש במידע זה כדי להימנע מעבודה מיותרת. אם הערך הוא False (ברירת המחדל), תמיד לבצע התקנה מלאה.
תגים:loading_and_analysis
--[no]split_apks
כברירת מחדל: "false"-
האם להשתמש בקובצי APK מפוצלים כדי להתקין ולעדכן את האפליקציה במכשיר. הגדרה זו פועלת רק במכשירים עם Marshmallow ואילך
תגים:loading_and_analysis
,affects_outputs
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, וכך ישפיעו על הערך שלו, בניגוד לקיומו:
- נצברו
--adb_arg=<a string>
שימושים מרובים -
ארגומנטים נוספים להעברה ל-adb. בדרך כלל משמש להקצאת מכשיר להתקנה.
תגים:action_command_lines
--debug_app
-
אם צריך לחכות לכלי לניפוי באגים לפני הפעלת האפליקציה.
הרחבה אל:
--start=DEBUG
תגים:execution
--device=<a string>
כברירת מחדל: ""-
המספר הסידורי של מכשיר ה-ADb. אם לא צוין אחרת, ייעשה שימוש במכשיר הראשון.
תגים:action_command_lines
--start=<no, cold, warm or debug>
כברירת מחדל: "NO"-
איך האפליקציה אמורה להתחיל לפעול אחרי ההתקנה. יש להגדיר את הערך WARM כדי לשמור ולשחזר את מצב האפליקציה על התקנות מצטברות.
תגים:execution
--start_app
-
האם להפעיל את האפליקציה לאחר ההתקנה.
הרחבה אל:
--start=COLD
תגים:execution
- אפשרויות שמשפיעות על מידת הדיוק של קלט ב-Bazel (הגדרות כללים, שילובי דגלים וכו'):
--experimental_repository_hash_file=<a string>
כברירת מחדל: ""-
אם הקובץ לא ריק, צריך לציין קובץ שמכיל ערך שהשגיאה שלו נפתרה, שעבורו יש לאמת את הגיבובים של ספריית המאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שבהם יש לאמת את הגיבוב של ספריית הפלט, בתנאי שהקובץ צוין על ידי --Experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build, שאפשר לגשת אליו באמצעות קובצי BUILD, קובצי .bzl או WORKSPACE.
--[no]experimental_allow_top_level_aspects_parameters
כברירת מחדל: "true"-
No-op
תגים:no_op
,deprecated
,experimental
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
--[no]experimental_record_metrics_for_all_mnemonics
כברירת מחדל: "false"- כברירת מחדל, מספר פעולות הפעולה מוגבל ל-20 הרכיבים המסחריים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים לכל הכלים.
--incremental_install_verbosity=<a string>
כברירת מחדל: ""-
הדרגת מלל להתקנה מצטברת. יש להגדיר את הערך 1 ליומן ניפוי באגים.
תגים:bazel_monitoring
- אפשרויות המציינות או משנות קלט גנרי לפקודת Bazel שאינה מתאימה לקטגוריות אחרות:
--experimental_resolved_file_instead_of_workspace=<a string>
כברירת מחדל: ""-
אם הקובץ לא ריק, צריך לקרוא את הקובץ שנפתר במקום את הקובץ WORKSPACE
תגים:changes_inputs
- אפשרויות לשמירה במטמון ולהפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: הצגת תיאור - יש לציין קובץ שיוגדר בו את כלי ההורדה מרחוק. הקובץ מורכב משורות, וכל אחת מהן מתחילה בהוראה (`allow` , `block` או `rewrite`) ואחריה שם מארח (עבור ‘allow’ and `block`) או שני דפוסים, שאחד מהם צריך להתאים כנגדו, ואחד לשימוש ככתובת URL חלופית עם הפניות חלופיות החל מ-`$1`. ייתכן שיש מספר הנחיות 'rewrite' שאותה כתובת URL תוחזר לאותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריות אחרות:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות Print_action
היא מקבלת בירושה את כל האפשרויות מ-build.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
--check_direct_dependencies=<off, warning or error>
כברירת מחדל: "warning"-
יש לבדוק אם התלות הישירות מסוג `bazel_dep` המופיעות במודול הבסיס הן אותן גרסאות שמוצגות בתרשים התלויות שהסתיים. הערכים החוקיים הם 'off' כדי להשבית את הבדיקה, 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה או 'שגיאה' כדי להעביר אותה למצב של תקלה.
תגים:loading_and_analysis
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים כדי לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
--[no]experimental_enable_bzlmod
כברירת מחדל: "false"-
אם הערך הוא true, Bazel מנסה לטעון מאגרים חיצוניים ממערכת Bzlmod לפני שהם מעיינים בקובץ WORKSPACE.
תגים: