bazel [<startup options>] <command> [<args>]או
bazel [<startup options>] <command> [<args>] -- [<target patterns>]לעיון בתחביר דפוסי יעד משתמש's.
התחביר של האפשרות
ניתן להעביר אפשרויות ל-Bazel בדרכים שונות. כדי להשתמש באפשרויות שצריך להזין להן ערך, צריך להזין סימן שווה או רווח:
--<option>=<value> --<option> <value>אפשרויות מסוימות יכולות להכיל טופס קצר עם תו אחד. במקרה כזה, צריך להעביר את הטופס הקצר עם מקף בודד ורווח.
-<short_form> <value>
ניתן להפעיל את האפשרויות הבוליאניות כך:
--<option> --<option>=[true|yes|1]ולהשבית אותן באופן הבא:
--no<option> --<option>=[false|no|0]
כברירת מחדל, האפשרויות של שלושה דברים מוגדרות באופן אוטומטי, וניתן להפעיל אותן באופן הבא:
--<option>=[true|yes|1]או משביתים אותן באופן הבא:
--no<option> --<option>=[false|no|0]
פקודות
analyze-profile |
ניתוח נתוני פרופיל build. |
aquery |
מנתח את היעדים הנתונים ושולח שאילתות לגבי תרשים הפעולות. |
build |
יצירת היעדים שצוינו. |
canonicalize-flags |
קביעת שורה של אפשרויות בזלת. |
clean |
מסיר קובצי פלט ואופציונלי גם מפסיק את השרת. |
coverage |
הסקריפט הזה יוצר דוח כיסוי קוד עבור יעדי בדיקה ספציפיים. |
cquery |
טוען, מנתח ושולח שאילתות לגבי היעדים שצוינו עם התצורות. |
dump |
Dump של המצב הפנימי של תהליך שרת הבסיס. |
fetch |
מאחזר מאגרים חיצוניים שהם דרישות מוקדמות ליעדים. |
help |
תוכלו להדפיס תוכן עם פקודות או אינדקס. |
info |
מוצגים פרטי זמן ריצה על שרת הבסיס. |
license |
מדפיס את רישיון התוכנה. |
mobile-install |
התקנת יעדים למכשירים ניידים. |
modquery |
שליחת שאילתות בתרשים התרשים החיצוני של Bzlmod |
print_action |
מדפיס את זרועות שורת הפקודה כדי להרכיב קובץ. |
query |
הפעלת שאילתת תרשים תלות. |
run |
מריץ את היעד שצוין. |
shutdown |
מפסיק את שרת ה-Bazel. |
sync |
סינכרון של כל המאגרים שצוינו בקובץ סביבת העבודה |
test |
יוצר ומפעיל את יעדי הבדיקה שצוינו. |
version |
הדפסת פרטי הגרסה של bazel. |
אפשרויות להפעלה
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- ברירת מחדל של
--[no]autodetect_server_javabase
: "true" -
כשמעבירים -noautodetect_server_Javabase, Bazel לא נוטש ל-JDK המקומי כדי להפעיל את שרת ה-Bazel ויוצא מהמסוף.
תגים:affects_outputs
,loses_incremental_state
- ברירת מחדל של
--[no]batch
: "false" -
אם המדיניות מוגדרת, Bazel יפעל כתהליך לקוח ללא שרת, במקום במצב לקוח/שרת רגיל. האפשרות הזו הוצאה משימוש ותוסר, אם אתם רוצים למנוע שרתים ממשיכים, כדאי לסגור את השרת באופן מפורש.
תגים:loses_incremental_state
,bazel_internal_configuration
,deprecated
- ברירת מחדל של
--[no]batch_cpu_scheduling
: "false" -
רק ב-Linux; שימוש ב 'batch' תזמון CPU for Blaze. המדיניות הזו שימושית לעומסי עבודה (workloads) לא אינטראקטיביים, אבל הם לא רוצים להפחית את הערך הנחמד שלהם. 'man 2 sche_setscheduler'. אם הערך הוא False, מערכת Bazel לא תבצע קריאה למערכת.
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--bazelrc=<path>
: תיאור -
המיקום של קובץ ה- .bazelrc שכולל את ערכי ברירת המחדל של אפשרויות Bazel. /dev/null יתעלם מכל תבנית נוספת מסוג ' --bazelrc' , שמועילה להשבתה של חיפוש קובץ rc של משתמש. למשל ב-build של גרסה.
ניתן לציין אפשרות זו גם מספר פעמים.
למשל, אם קוראים את `--bazelrc=x.rc --bazelrc=y.rc --bazelrc=/dev/null --bazelrc=z.rc`,
1) מתבצעת קריאה ל-x.rc ול-y.rc.
2) המערכת מתעלמת מ-z.rc עקב הגרסה הקודמת: /dev/null.
אם לא צוין דבר, Bazel משתמשת בקובץ .bazelrc הראשון שהיא מוצאת בשני המיקומים הבאים: ספריית סביבת העבודה ולאחר מכן בספריית הבית של המשתמש.
הערה: האפשרויות בשורת הפקודה תמיד יחליפו כל אפשרות ב-bazelrc.
תגים:changes_inputs
- ברירת מחדל של
--[no]block_for_lock
: "true" -
כשמעבירים את -noblock_for_lock, מערכת Bazel לא מחכה לפקודה שמסתיימת, אלא כשהיא יוצאת באופן מיידי.
תגים:eagerness_to_exit
- ברירת מחדל של
--[no]client_debug
: "false" -
אם הערך מוגדר נכון, יש לרשום את פרטי ניפוי הבאגים מהלקוח ל-stderr. שינוי האפשרות הזו לא יגרום להפעלה מחדש של השרת.
תגים:affects_outputs
,bazel_monitoring
- ברירת מחדל של
--connect_timeout_secs=<an integer>
: "30" -
משך הזמן שהלקוח ממתין לכל ניסיון להתחבר לשרת
תגים:bazel_internal_configuration
- ברירת מחדל של
--[no]expand_configs_in_place
: "true" -
השינוי של סימון -config מוגדר כך שלא ישתנה בהרחבה של נקודה קבועה בין אפשרויות rc רגילות לבין אפשרויות שצוינו בשורת הפקודה.
תגים:no_op
,deprecated
- ברירת מחדל של
--failure_detail_out=<path>
: תיאור -
אם המדיניות מוגדרת, היא מציינת מיקום לכתיבה של הודעת Protobuf שנכשלו, אם השרת חווה כשל ולא יכול לדווח עליו באמצעות gRPC, כרגיל. אחרת, המיקום יהיה ${OUTPUT_base}/failure_detail.rawproto.
תגים:affects_outputs
,loses_incremental_state
- ברירת מחדל של
--[no]home_rc
: "true" -
אם אין לך צורך לחפש את קובץ ה-Bazelrc בכתובת $HOME/.bazelrc
תגים:changes_inputs
- ברירת מחדל של
--[no]idle_server_tasks
: "true" -
הפעלת System.gc() כאשר השרת לא פעיל
תגים:loses_incremental_state
,host_machine_resource_optimizations
- ברירת מחדל של
--[no]ignore_all_rc_files
: "false" -
משביתים את כל קובצי ה-rc, ללא קשר לערכים של סימונים אחרים שמשנים את תוכן ה-rc, גם אם הסימונים האלה מופיעים מאוחר יותר ברשימת אפשרויות האתחול.
תגים:changes_inputs
- ברירת מחדל של
--io_nice_level={-1,0,1,2,3,4,5,6,7}
: "-1" -
רק ב-Linux. ניתן להגדיר רמה בין 0 ל-7 לתזמון IO שעושה את התוצאות הטובות ביותר באמצעות קריאת המערכת sys_ioprio_set. 0 הוא העדיפות הגבוהה ביותר, 7 הוא הדירוג הנמוך ביותר. מתזמן התזמון עשוי להתחשב רק בעדיפות 4. אם מוגדר ערך שלילי, Bazel לא מבצעת קריאת מערכת.
תגים:host_machine_resource_optimizations
--local_startup_timeout_secs=<an integer>
כברירת מחדל: "120"-
משך הזמן המקסימלי שהלקוח ממתין לחיבור לשרת
תגים:bazel_internal_configuration
- ברירת מחדל של
--macos_qos_class=<a string>
: "default" -
קביעת רמת השירות של QoS של שרת הבסיס בעת הפעלה ב-macOS. הסימון הזה לא משפיע על כל הפלטפורמות האחרות, אבל הוא נתמך כדי לוודא שאפשר לשתף קובצי rc ביניהם ללא שינויים. הערכים האפשריים הם: אינטראקציית משתמש, ביוזמת המשתמש, ברירת מחדל, כלי עזר ורקע.
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--max_idle_secs=<integer>
: "10800" -
מספר השניות ששרת ה-build ימתין ללא פעילות לפני הכיבוי. אפס פירושו שהשרת לא ייכבה אף פעם. האפשרות הזו נקראה רק בזמן ההפעלה של השרת. שינוי האפשרות הזו לא יגרום להפעלה מחדש של השרת.
תגים:eagerness_to_exit
,loses_incremental_state
- ברירת מחדל של
--output_base=<path>
: תיאור -
אם היא מוגדרת, המדיניות מציינת את מיקום הפלט שאליו נכתב כל פלט המודל. אחרת, המיקום יהיה ${OUTPUT_ROOT}/_blze_${USER}/${MD5_OF_WORKSPACE_ROOT}. הערה: אם מציינים אפשרות אחרת מהפעלה אחת של Bazel לערך הזה, סביר להניח שתפתחו שרת Bazel חדש. Bazel מפעיל שרת אחד בלבד לכל בסיס פלט שצוין. בדרך כלל יש בסיס פלט אחד לכל סביבת עבודה. עם זאת, כשבוחרים באפשרות הזו, יכולים להיות מספר בסיסים של פלט לכל סביבת עבודה, ובכך להפעיל כמה גרסאות build עבור אותו לקוח בו-זמנית באותו מכונה. הוראות: #&39;bazel עזרה בהשבתה' איך לסגור שרת Bazel.
תגים:affects_outputs
,loses_incremental_state
- ברירת מחדל של
--output_user_root=<path>
: תיאור -
הספרייה הספציפית למשתמש מתחתיה נכתבת כל פלטת ה-build; כברירת מחדל, זו פונקציה של $USER, אבל על ידי ציון קבוע, ניתן לשתף פלטי build בין משתמשים שמשתפים פעולה.
תגים:affects_outputs
,loses_incremental_state
- ברירת מחדל של
--[no]preemptible
: "false" -
אם הערך הוא True, ניתן למנוע את הפעלת הפקודה אם פקודה אחרת מתחילה.
תגים:eagerness_to_exit
- ברירת מחדל של
--server_jvm_out=<path>
: תיאור -
המיקום שבו כותבים את הפלט של השרת ב-JVM'. אם המדיניות לא מוגדרת, ברירת המחדל היא מיקום ב-פלט_בסיס.
תגים:affects_outputs
,loses_incremental_state
- ברירת מחדל של
--[no]shutdown_on_low_sys_mem
: "false" -
אם ה-max_idle_secs מוגדר ושרת ה-build לא היה פעיל למשך זמן מה, יש לכבות את השרת כשהמערכת חלשה ב-RAM בחינם. ב-Linux בלבד.
תגים:eagerness_to_exit
,loses_incremental_state
- ברירת מחדל של
--[no]system_rc
: "true" -
אפשר לחפש את הבזאר בכל המערכת.
תגים:changes_inputs
- ברירת מחדל של
--[no]unlimit_coredumps
: "false" -
מגדילה את המגבלה של Coredump הרך עד למגבלה הקשיחה כדי לאפשר עיבוד ליבה של השרת (כולל JVM) והלקוח, בתנאים משותפים. סמנו את הדגל הזה בבזאר פעם אחת ושכחו אותו כך שתוכלו לקבל טריגרים כאשר תיתקלו במצב שמפעיל אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[no]watchfs
: "false" -
אם הערך true, Bazel מנסה להשתמש בשירות הצפייה בקבצים של מערכת ההפעלה עבור שינויים מקומיים במקום לסרוק כל קובץ לשינוי.
תגים:deprecated
- ברירת מחדל של
--[no]windows_enable_symlinks
: "false" -
אם הקישור נכון, המערכת תיצור קישורים סימבוליים אמיתיים ב-Windows במקום להעתיק את הקובץ. כדי להפעיל את מצב 'מפתח' של Windows, יש להפעיל את Windows 10 בגרסה 1703 ומעלה.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[no]workspace_rc
: "true" -
האם לחפש את קובץ ה-Bazelrc של Workspace? או לא, בכתובת $workspace/.bazelrc
תגים:changes_inputs
- אפשרויות שונות, לא נכללות בקטגוריה אחרת
- נצברו
--host_jvm_args=<jvm_arg>
שימושים מרובים - סימונים שצריך להעביר ל-JVM שמפעיל את Blaze.
--host_jvm_debug
-
אפשרות נוחות להוסיף עוד התרעות אתחול לגבי JVM, שגורמות ל-JVM להמתין במהלך ההפעלה עד שיקושרו מכלי לניפוי באגים התואם ל-JDWP (כמו Eclipse) ליציאה 5005.
הרחבה של:
--host_jvm_args=-Xdebug
--host_jvm_args=-Xrunjdwp:transport=dt_socket,server=y,address=5005
- ברירת מחדל של
--host_jvm_profile=<profiler_name>
: "" - אפשרות נוחות להוסיף מספר התרעות סטארט-אפ ספציפיות לפרופילי ניפוי באגים או ניפוי באגים. ל-Bazel יש רשימה של ערכים ידועים שהיא ממפה להתרעות אתחול ב-JVM בתוך הקוד, ויכול להיות שהם מחפשים נתיבים בתוך הקוד שנמצאים בהם קבצים מסוימים.
- ברירת מחדל של
--server_javabase=<jvm path>
: "" - נתיב אל ה-JVM המשמש לביצוע Bazel עצמו.
אפשרויות נפוצות לכל הפקודות
- אפשרויות השולטות בביצוע גרסת build:
- ברירת מחדל של
--experimental_oom_more_eagerly_threshold=<an integer>
: "100" -
אם הדגל הזה מוגדר כערך נמוך מ-100, Bazel תהיה OOM אם, לאחר שני אחוזים מלאים של GC', עדיין יהיה תפוס של יותר מהאחוז הזה של הערימה (דור קודם).
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--experimental_ui_max_stdouterr_bytes=<an integer in (-1)-1073741819 range>
: "1048576" -
הגודל המקסימלי של קובצי stdout / stderr שיודפסו במסוף. -1 לא מרמז על מגבלה.
תגים:execution
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לקיומו:
- נצברו
--repo_env=<a 'name=value' assignment with an optional value part>
שימושים מרובים -
קביעת משתני סביבה נוספים שיהיו זמינים רק לכללי מאגר הנתונים. הערה: כללי המאגר רואים את הסביבה המלאה בכל מקרה, אבל בצורה כזו ניתן להעביר פרטי תצורה למאגרים באמצעות ביטול התוקף של תרשים הפעולה.
תגים:action_command_lines
- אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
- ברירת מחדל של
--[no]check_bzl_visibility
: "true" -
אם המדיניות מושבתת, שגיאות חשיפה ב-Bzl בהצהרות load() יורדות לאזהרות.
תגים:build_file_semantics
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי .bzl או קובצי WORKSPACE.:
- ברירת מחדל של
--[no]enable_bzlmod
: "false" -
אם המדיניות מקבלת את הערך True, המדיניות מאפשרת למערכת ניהול התלות של Bzlmod לקבל עדיפות על פני WORKSPACE. מידע נוסף זמין בכתובת https://bazel.build/docs/bzlmod.
תגים:loading_and_analysis
- ברירת מחדל של
--[no]experimental_action_resource_set
: "true" -
אם המדיניות מוגדרת כ-True, הפרמטרים ctx.actions.run() ו-ctx.actions.run_shell() מקבלים פרמטר פרמטר_של משאב לביצוע מקומי. אחרת, ברירת המחדל היא 250MB לזיכרון ומעבד אחד.
תגים:execution
,build_file_semantics
,experimental
-
אם מוגדר כ-true, התגים יופצו מיעד לפעולות' דרישות ביצוע; אחרת התגים לא יופצו. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/8830.
תגים:build_file_semantics
,experimental
- ברירת מחדל של
--[no]experimental_analysis_test_call
: "true" -
אם המדיניות מוגדרת כ-True, זמינה שיחה מקורית מסוג Analysis_test.
תגים:loading_and_analysis
,build_file_semantics
,experimental
- ברירת מחדל של
--[no]experimental_bzl_visibility
: "true" -
כשהאפשרות הזו מופעלת, המערכת משתמשת בפונקציה 'visible()' שקובצי .bzl עשויים לקרוא לה במהלך ההערכה ברמה העליונה כדי להגדיר את החשיפה שלהם למטרות אמירות מסוג load() .
תגים:loading_and_analysis
,experimental
-
אם המדיניות מוגדרת כ-True, מאפייני הכללים ושיטות ה-API של Starlark יהיו זמינים עבור הכלל cc_shared_library
תגים:build_file_semantics
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_disable_external_package
: "false" -
אם המדיניות מוגדרת כ-True, החבילה החיצונית //חיצונית שנוצרה באופן אוטומטי לא תהיה זמינה יותר. מאחר ש-Bazel עדיין לא יכולה לנתח את הקובץ 'external/BUILD', אבל כדורי הארץ יגיעו לחיצוני/ מהחבילה ללא שם יפעלו.
תגים:loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--[no]experimental_enable_android_migration_apis
: "false" -
אם המדיניות מוגדרת כ-True, ממשקי ה-API הנדרשים תומכים במיגרציה של Android Starlark.
תגים:build_file_semantics
- ברירת מחדל של
--[no]experimental_get_fixed_configured_action_env
: "false" -
אם האפשרות מופעלת, הערך action.env יחזיר גם משתני סביבה קבועים שצוינו באמצעות הגדרת תכונות.
תגים:loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_google_legacy_api
: "false" -
אם המדיניות מוגדרת כ-True, תהיה לך אפשרות לראות כמה קטעי קוד ניסיוניים של Starlark Build API שקשורים לקוד מדור קודם של Google.
תגים:loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_lazy_template_expansion
: "true" -
אם המדיניות מוגדרת כ-True, ctx.actions.expand_template() מקבל פרמטרtemplateDict עבור הערכה מעוכבת של ערכי החלפה.
תגים:execution
,build_file_semantics
,experimental
- ברירת מחדל של
--[no]experimental_platforms_api
: "false" -
אם המדיניות מוגדרת כ-True, היא מאפשרת להשתמש בכמה ממשקי API של Starlark שקשורים לפלטפורמה לניפוי באגים.
תגים:loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_repo_remote_exec
: "false" -
אם המדיניות מוגדרת כ-TRUE, יש ל-Database_rule כמה יכולות ביצוע מרחוק.
תגים:build_file_semantics
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_sibling_repository_layout
: "false" -
אם היא מוגדרת כ-true, מאגרים שאינם ראשיים נטועים כקישורים מקושרים למאגר הראשי בבסיס הביצוע. כלומר, כל המאגרים הם ילדים ישירים של הספרייה $פלט_בסיס/פועלים. התוצאה היא הסרה של $פלט_בסיס/execution_root/__main__/external עבור הספרייה ברמה העליונה בפועל 'external'.
תגים:action_command_lines
,bazel_internal_configuration
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--[no]incompatible_always_check_depset_elements
: "true" -
יש לבדוק את החוקיות של אלמנטים שנוספו למאגרים, בכל המבנים. האלמנטים חייבים להיות בלתי משתנים, אבל בעבר בנאי ה-depset(direct=...) שכח לבדוק אותם. אפשר להשתמש בפינגלים במקום ברשימות ברכיבי המאגר. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/10313.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_depset_for_libraries_to_link_getter
: "true" -
כשהאפשרות מוגדרת כ-Bazel כבר לא מחזירה רשימה מהכתובת link_context.library_to_link, אבל במקום זאת היא מחזירה פונקציה.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_disable_starlark_host_transitions
: "false" -
אם היא מוגדרת כ-true, מאפייני הכלל לא יכולים להגדיר 'cfg = "host"'. במקום זאת, הכללים צריכים להגדיר את #&33;cfg = "exec"'
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_disable_target_provider_fields
: "false" -
אם היא מוגדרת כ-True, משביתים את היכולת לגשת לספקים באובייקטים 'target' באמצעות תחביר של שדה. במקום זאת, יש להשתמש בתחביר של מפתח הספק. לדוגמה, במקום להשתמש ב-`ctx.attr.dep.my_info` כדי לגשת ל-'my_info' מתוך פונקציית הטמעת כלל, השתמשו ב-`ctx.attr.dep[MyInfo]`. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/9014.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_disallow_empty_glob
: "false" -
אם היא מוגדרת כ-True, ערך ברירת המחדל של הארגומנט 'allow_blank' של glob() הוא False.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_disallow_legacy_javainfo
: "true" -
הוצא משימוש. לא.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_disallow_struct_provider_syntax
: "false" -
אם היא מוגדרת כ-True, ייתכן שפונקציות ההטמעה של הכלל לא יחזירו מבנה. במקום זאת, הם צריכים להחזיר רשימה של מופעים של ספקים.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_existing_rules_immutable_view
: "true" -
אם היא מוגדרת כ-True, המדיניות המקומית.existing_rule ו-native.existing_rules מחזירות אובייקטי תצוגה פשוטים שאינם משתנים, במקום הכתבה הניתנת לשינוי.
תגים:build_file_semantics
,loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_fix_package_group_reporoot_syntax
: "true" -
במאפיין 'חבילות' של package_group' משנה את המשמעות של הערך "//..." כדי להפנות לכל החבילות במאגר הנוכחי, במקום את כל החבילות בכל מאגר. ניתן להשתמש בערך המיוחד "public" במקום "//..." כדי לקבל את ההתנהגות הישנה. סימון זה דורש הפעלה של --incompatible_package_group_has_public_yntax.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_java_common_parameters
: "true" -
אם המדיניות מוגדרת כ-True, יוסרו הפרמטרים 'פלט_פלט' ו'מארח_Javabase' ב-pack_sources ו-host_Javabase.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_new_actions_api
: "true" -
אם המדיניות מוגדרת כ-True, ה-API ליצירת פעולות זמין רק ב-'ctx.actions', לא ב-'ctx'.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_no_attr_license
: "true" -
אם היא מוגדרת כ-True, משביתה את הפונקציה 'attr.license'.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_no_implicit_file_export
: "false" -
אם קובצי המקור מוגדרים, הם משמשים כפרטיים, אלא אם מייצאים אותם באופן מפורש. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/proposals/blob/master/designs/2019-10-24-file-visible.md
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_no_rule_outputs_param
: "false" -
אם היא מוגדרת כ-True, משביתה את הפרמטר `פלטים` בפונקציה `rule(` Starlark.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_package_group_has_public_syntax
: "true" -
במאפיין 'packages' של package_group&, מאפשר לכתוב "public" או "private" כדי לציין את כל החבילות או אין חבילות בהתאמה.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_require_linker_input_cc_api
: "true" -
אם המדיניות מוגדרת כ-True, הכלל Create_linking_context יחייב את linker_inputs במקום ספריות_to_link. גם הקישורים הישנים של link_context יושבתו, ו-linker_inputs יהיה זמין רק.
תגים:build_file_semantics
,loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_run_shell_command_string
: "true" -
אם היא מוגדרת כ-true, פרמטר הפקודה של actions.run_shell יקבל רק מחרוזת
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_stop_exporting_language_modules
: "false" -
אם האפשרות הזו מופעלת, מודולים ספציפיים לשפה (למשל 'cc_common') לא זמינים בקובצי .bzl של משתמשים, וניתן להפעיל אותם רק ממאגרי הכללים הרלוונטיים.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_struct_has_no_methods
: "false" -
השבתה של השיטות to_proto ו-to_proto של מבנה, שמזהרות את מרחב השמות של המבנה. במקום זאת, יש להשתמש ב-json.encode או ב-json.encode_indent עבור JSON, או ב-proto.encode_text עבור textproto.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_top_level_aspects_require_providers
: "false" -
אם המדיניות מוגדרת כ-True, הספקים מהרמה העליונה יכבדו את הספקים הנדרשים ויפעלו רק ביעדים ברמה העליונה שהכללים שלהם'. הספקים שמתפרסמים עומדים בדרישות של הספקים הרלוונטיים.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_unambiguous_label_stringification
: "true" -
כשהאפשרות מוגדרת ב-Ballel, המחרוזת של @//foo:bar תוחלף ל-@//foo:bar, במקום ל-//foo:bar. יש לכך השפעה רק על ההתנהגות של str(), האופרטור % וכן הלאה. ההתנהגות של repr() לא משתנה. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/15916.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_use_cc_configure_from_rules_cc
: "false" -
כשהאפשרות מוגדרת כ-TRUE, Bazel לא תאפשר יותר להשתמש בתג cc_configure מ- @bazel_tools. פרטים נוספים והוראות העברה זמינים בכתובת https://github.com/bazelbuild/bazel/issues/10134.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_visibility_private_attributes_at_definition
: "false" -
אם המדיניות מוגדרת כ-True, מתבצעת בדיקה לגבי החשיפה של מאפייני כלל פרטי לגבי הגדרת הכלל, ולא לגבי השימוש בכלל.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--max_computation_steps=<a long integer>
: "0" -
המספר המקסימלי של שלבי חישוב ב-Starlark שניתן לבצע באמצעות קובץ BUILD (אפס הוא לא הגבלה).
תגים:build_file_semantics
- ברירת מחדל של
--nested_set_depth_limit=<an integer>
: "3500" -
העומק המקסימלי של התרשים בתוך מערך הנתונים (המכונה גם NestedSet), שמעליו ייבנה ה-depset() .
תגים:loading_and_analysis
- אפשרויות שגורמות לאופטימיזציה של זמן ה-build:
- ברירת מחדל של
--[no]incompatible_do_not_split_linking_cmdline
: "true" -
כשנכון, Bazel לא משנה יותר סימונים של שורת פקודה שמשמשים לקישור, וגם לא קובעת באופן סלקטיבי אילו סימונים מועברים לקובץ הפרמטר, ואילו לא. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/7670.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]keep_state_after_build
: "true" -
אם הערך הוא False, Blaze ימחק את מצב הזיכרון מה-build הזה כשה-build יסתיים. לגרסאות ה-build הבאות לא יהיו צבירה ביחס לזה.
תגים:loses_incremental_state
--skyframe_high_water_mark_threshold=<an integer>
כברירת מחדל: "85"-
סימון לצורך הגדרה מתקדמת של מנוע Skyframe הפנימי של Bazel&33. אם תזוהה ב-Bazel שהשימוש באחוז הערימה המאוחסן שלו הוא לפחות הסף הזה, מצב ה-Skyframe הזמני לא יהיה נחוץ יותר. השינוי הזה עשוי לאפשר לכם לצמצם את ההשפעה של רצועת הקירות על הקירות (GC) כאשר, מה שגורם לטריגר של GC הוא (i) שגורם לשימוש בזיכרון במצב זמני זה, וגם (ii) יקר יותר מיצירת המדינה כשיש צורך.
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--[no]track_incremental_state
: "true" -
אם המדיניות מוגדרת כ-False, ב-Blaze לא יישמרו נתונים שמאפשרים לבטל את התוקף שלה ולבצע הערכה מחדש של גרסאות build מצטברות, כדי לחסוך בזיכרון של גרסת ה-build הזו. לגרסאות ה-build הבאות לא יהיו צבירה ביחס לזה. בדרך כלל כדאי לציין - אצווה כאשר מגדירים אותה כ-False.
תגים:loses_incremental_state
- אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]announce_rc
: "false" -
האם יש אפשרות להודיע על אפשרויות RC.
תגים:affects_outputs
- ברירת מחדל של
--[no]attempt_to_print_relative_paths
: "false" -
כשמדפיסים את חלק המיקום של הודעות, נסו להשתמש בנתיב ביחס לספריית סביבת העבודה או לאחת מהספריות שצוינו על ידי --package_path.
תגים:terminal_output
- ברירת מחדל של
--bes_backend=<a string>
: "" -
ההגדרה קובעת את נקודת הקצה העורפי של שירות Build (BES) בפורמט [SCHEME://]HOST[:PORT]. ברירת המחדל היא להשבית את ההעלאות של BES. סכימות נתמכות הן grpc ו-grpcs (GRPC עם TLS מופעל). אם לא סופקה סכימה, Bazel מניחה שהיא GRPs.
תגים:affects_outputs
- ברירת מחדל של
--[no]bes_check_preceding_lifecycle_events
: "false" -
מגדירים את השדהcheck_precering_lifecycle_events_present ב-PublishBuildToolEventStreamRequest שמבקשים מ-BES לבדוק אם הוא קיבל בעבר אירועי InvocationAttemptStarted ו-BuildEnqueued שתואמים לאירוע הנוכחי בכלי.
תגים:affects_outputs
- נצברו
--bes_header=<a 'name=value' assignment>
שימושים מרובים -
יש לציין כותרת בטופס NAME=VALUE שתיכלל בבקשות BES. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
תגים:affects_outputs
- ברירת מחדל של
--bes_instance_name=<a string>
: תיאור -
ההגדרה קובעת את שם המופע שבו BES ימשיך להיות מועלה. ברירת המחדל היא null.
תגים:affects_outputs
- נצברו
--bes_keywords=<comma-separated list of options>
שימושים מרובים -
ציון רשימה של מילות מפתח להתראות שיתווספו אל ברירת המחדל של קבוצת מילות המפתח שפורסמו ב-BES ("command_name=<command_name> ", "protocol_name=BEP"). ברירת המחדל היא 'ללא'.
תגים:affects_outputs
- ברירת מחדל של
--[no]bes_lifecycle_events
: "true" -
ההגדרה קובעת אם לפרסם אירועים במחזור החיים של BES. (ברירת המחדל היא 'true').
תגים:affects_outputs
- ברירת מחדל של
--bes_oom_finish_upload_timeout=<An immutable length of time.>
: "10m" -
קביעת משך הזמן לשמירת הבסיס של BES/BEP בזמן OOMing. הסימון הזה מבטיח שסגירה של ה-JVM חמורה מאוד על ידי GC ולא ניתן להתקדם בשרשור כלשהו של משתמשים.
תגים:bazel_monitoring
- ברירת מחדל של
--bes_outerr_buffer_size=<an integer>
: "10240" -
ההגדרה קובעת את הגודל המקסימלי של stdout או std כדי לאחסן במאגר נתונים זמני ב-BEP, לפני שמדווחים עליו כאירוע התקדמות. כתיבה של הודעות אישיות עדיין מדווחת באירוע יחיד, גם אם הערך גדול מהערך שצוין עד -bes_outerr_chunk_size.
תגים:affects_outputs
- ברירת מחדל של
--bes_outerr_chunk_size=<an integer>
: "1048576" -
ההגדרה מציינת את הגודל המקסימלי של stdout או stderr לשליחה ל-BEP בהודעה אחת.
תגים:affects_outputs
- ברירת מחדל של
--bes_proxy=<a string>
: תיאור - מתחברים לשירות Build של אירועים דרך שרת proxy. כרגע אפשר להשתמש בסימון הזה רק כדי להגדיר שקע דומיין (Unix:/path/to/socket) ב-Unix:
- ברירת מחדל של
--bes_results_url=<a string>
: "" -
ההגדרה קובעת את כתובת ה-URL הבסיסית שבה המשתמש יכול להציג את המידע שמשודר בקצה העורפי של BES. Bazel תייצר פלט של כתובת ה-URL המצורפת למסוף ההפעלה.
תגים:terminal_output
- ברירת מחדל של
--bes_timeout=<An immutable length of time.>
: "0s" -
ההגדרה מציינת את משך הזמן הנדרש להוספה של BES/BEP לאחר סיום הבנייה והבדיקות. זמן קצוב לתפוגה חוקי הוא מספר טבעי ואחריו יחידה: ימים (d), שעות (h), דקות (m), שניות (s) ואלפיות שנייה (אלפיות השנייה). ערך ברירת המחדל הוא '0' כלומר, אין זמן קצוב לתפוגה.
תגים:affects_outputs
- ברירת מחדל של
--build_event_binary_file=<a string>
: "" -
אם הקובץ לא ריק, כותבים ייצוג בינארי של ערכים מופרדים בקובץ ה-build של הפרוטוקול ב-build. המשמעות של האפשרות הזו היא --bes_upload_mode=Pending_for_upload_complete.
תגים:affects_outputs
- ברירת מחדל של
--[no]build_event_binary_file_path_conversion
: "true" -
אפשר להמיר מסלולים בייצוג הקובץ הבינארי של פרוטוקול האירוע Build ל-URI חוקי יותר ברחבי העולם. כשהאפשרות מושבתת, סכמת file:// URI תמיד תשמש
תגים:affects_outputs
- ברירת מחדל של
--build_event_json_file=<a string>
: "" -
אם הקובץ לא ריק, צריך לכתוב סידור של JSON בפרוטוקול פרוטוקול build של הקובץ.
תגים:affects_outputs
- ברירת מחדל של
--[no]build_event_json_file_path_conversion
: "true" -
כשאפשר, המרת נתיבים בייצוג קובץ json של פרוטוקול build build ל-URI חוקי יותר בעולם. אם משביתים את הסכימה, הסכימה של file:// URI תמיד תשמש
תגים:affects_outputs
- ברירת מחדל של
--build_event_max_named_set_of_file_entries=<an integer>
: "-1" -
המספר המקסימלי של רשומות לאירוע בודד בשם name_set_of_files; המערכת מתעלמת מערכים קטנים מ-2 ולא מתבצעת פיצול אירועים. היא מיועדת להגביל את גודל האירוע המקסימלי בפרוטוקול אירוע build, אם כי אין לה שליטה ישירה על גודל האירוע. הגודל הכולל של האירועים הוא פונקציה של מבנה הקבוצה ואורך הקבצים ו-URI, שעשויים להשתנות בהתאם לפונקציית הגיבוב.
תגים:affects_outputs
- ברירת מחדל של
--[no]build_event_publish_all_actions
: "false" -
אם צריך לפרסם את כל הפעולות.
תגים:affects_outputs
- ברירת מחדל של
--build_event_text_file=<a string>
: "" -
אם הקובץ לא ריק, כותבים ייצוג טקסטואלי של פרוטוקול האירוע build בקובץ הזה
תגים:affects_outputs
- ברירת מחדל של
--[no]build_event_text_file_path_conversion
: "true" -
כשהדבר אפשרי, אפשר להמיר נתיבים בייצוג קובץ הטקסט של פרוטוקול build של URI ל ועם מזהי URI חוקיים יותר בכל העולם. אם המדיניות מושבתת, תמיד ייעשה שימוש בסכימת ה-file:// URI
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_announce_profile_path
: "false" -
אם המדיניות מופעלת, המדיניות מוסיפה ליומן את נתיב פרופיל ה-JSON.
תגים:affects_outputs
,bazel_monitoring
- ברירת מחדל של
--[no]experimental_bep_target_summary
: "false" - אם רוצים לפרסם אירועי סיכום סיכום.
- ברירת מחדל של
--[no]experimental_build_event_expand_filesets
: "false" -
אם הערך הוא TRUE, מרחיבים את FilesApps ב-BEP כשמציגים קובצי פלט.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" -
אם הערך הוא True, יש לפתור בצורה מלאה את סמלי הקישור היחסיים של Fileset ב-BEP כשמציגים קובצי פלט. נדרשת -experimental_build_event_expand_filesets.
תגים:affects_outputs
- ברירת מחדל של
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
מספר הפעמים המקסימלי שחברת Bazel מנסה להעלות אירוע build.
תגים:bazel_internal_configuration
- ברירת מחדל של
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
השהיה מינימלית עד לעיכוב מעריכי של ניסיונות חוזרים כאשר העלאה של BEP נכשלה. (מעריך: 1.6)
תגים:bazel_internal_configuration
- ברירת מחדל של
--experimental_build_event_upload_strategy=<a string>
: תיאור -
בחירה איך להעלות פריטי מידע שנוצרים בתהליך פיתוח (Artifact) המוזכרים בפרוטוקול של אירוע ה-build.
תגים:affects_outputs
- נצברו
--experimental_profile_additional_tasks=<phase, action, action_check, action_lock, action_release, action_update, action_complete, info, create_package, remote_execution, local_execution, scanner, local_parse, upload_time, process_time, remote_queue, remote_setup, fetch, vfs_stat, vfs_dir, vfs_readlink, vfs_md5, vfs_xattr, vfs_delete, vfs_open, vfs_read, vfs_write, vfs_glob, vfs_vmfs_stat, vfs_vmfs_dir, vfs_vmfs_read, wait, thread_name, thread_sort_index, skyframe_eval, skyfunction, critical_path, critical_path_component, handle_gc_notification, action_counts, local_cpu_usage, system_cpu_usage, local_memory_usage, system_memory_usage, system_network_up_usage, system_network_down_usage, workers_memory_usage, system_load_average, starlark_parser, starlark_user_fn, starlark_builtin_fn, starlark_user_compiled_fn, starlark_repository_fn, action_fs_staging, remote_cache_check, remote_download, remote_network, filesystem_traversal, worker_execution, worker_setup, worker_borrow, worker_working, worker_copying_outputs, credential_helper or unknown>
שימושים מרובים -
קביעת משימות פרופיל נוספות שייכללו בפרופיל.
תגים:affects_outputs
,bazel_monitoring
- ברירת מחדל של
--[no]experimental_profile_include_primary_output
: "false" -
כולל את המאפיין הנוסף "out" באירועי הפעולה, שמכיל את נתיב ה-exe אל הפלט הראשי של הפעולה.
תגים:affects_outputs
,bazel_monitoring
- ברירת מחדל של
--[no]experimental_profile_include_target_label
: "false" -
כוללת תווית יעד באירועי פעולה' נתוני פרופיל JSON.
תגים:affects_outputs
,bazel_monitoring
- ברירת מחדל של
--[no]experimental_stream_log_file_uploads
: "false" -
אפשר להעביר העלאות של קובצי יומן ישירות לאחסון המרוחק, במקום לכתוב אותם בדיסק.
תגים:affects_outputs
- ברירת מחדל של
--experimental_workspace_rules_log_file=<a path>
: תיאור - אפשר לתעד אירועים מסוימים של כללי Workspace בקובץ הזה כפרמטרים מופרדים של WorkspaceEvent.
- ברירת מחדל של
--[no]generate_json_trace_profile
: "auto" -
אם האפשרות מופעלת, Bazel יוצרת פרופיל build וכותבת פרופיל בפורמט JSON לקובץ בבסיס הפלט. צפייה בפרופיל על ידי טעינה אל chrome://trace. כברירת מחדל, Bazel כותבת את הפרופיל עבור כל הפקודות ושאילתות הדומות ל-build.
תגים:affects_outputs
,bazel_monitoring
- ברירת מחדל של
--[no]heap_dump_on_oom
: "false" -
אם מדובר ב קובץ ה-Dump ייכתב כך: <פלט_בסיס>/<invocation_id>.heapdump.hprof. האפשרות הזו מחליפה ביעילות את -XX:+HeapDumpOnOutOfMemoryError, שלא משפיעה על מפני שאירועי OOM נתפסים ומופנה אוטומטית ל-Runtime#halt.
תגים:bazel_monitoring
- ברירת מחדל של
--[no]legacy_important_outputs
: "true" -
אפשר להשתמש בכך כדי להסתיר יצירה של שדה חשוב_פלט קודם באירוע Targetcomplete. נדרשים שילובים חשובים של Basel עד ResultStore.
תגים:affects_outputs
- ברירת מחדל של
--logging=<0 <= an integer <= 6>
: "3" -
רמת הרישום ביומן.
תגים:affects_outputs
- ברירת מחדל של
--memory_profile=<a path>
: תיאור -
אם היא מוגדרת, כותבים את נתוני השימוש בזיכרון בקובץ שצוין בשלב השלב וערימה יציבה ליומן הראשי בסיום הבנייה.
תגים:affects_outputs
,bazel_monitoring
- ברירת מחדל של
--memory_profile_stable_heap_parameters=<two integers, separated by a comma>
: "1,0" -
כדי לשפר את אופן החישוב של תמונת מצב הערימה היציבה בסיום מבנה הדגם. צריך להיות שני מספרים שלמים המופרדים באמצעות פסיק. הפרמטר הראשון הוא מספר ה-GC לביצוע. הפרמטר השני הוא מספר השניות שיש להמתין בין מספרי GC.
תגים:bazel_monitoring
- ברירת מחדל של
--profile=<a path>
: תיאור -
אם המדיניות מוגדרת, פרופיל ב-Bazel וכתיבה של הנתונים בקובץ שצוין. כדי לנתח את הפרופיל, השתמשו בפרופיל Baz Analysis.
תגים:affects_outputs
,bazel_monitoring
- ברירת מחדל של
--[no]slim_profile
: "true" -
כדי להקטין את פרופיל ה-JSON, צריך למזג אירועים אם הפרופיל גדול מדי.
תגים:affects_outputs
,bazel_monitoring
- ברירת מחדל של
--starlark_cpu_profile=<a string>
: "" -
כותבים לקובץ שצוין פרופיל שימוש במעבד (CPU) בכל השרשורים של Starlark.
תגים:bazel_monitoring
- ברירת מחדל של
--tool_tag=<a string>
: "" -
שם של כלי שיש לשייך אליו את ההפעלה הזו של Bazel.
תגים:affects_outputs
,bazel_monitoring
- נצברו
--ui_event_filters=<Convert list of comma separated event kind to list of filters>
שימושים מרובים -
ההגדרה קובעת אילו אירועים יוצגו בממשק המשתמש. ניתן להוסיף או להסיר אירועים לאירועי ברירת המחדל באמצעות +/-, או לשנות את ברירת המחדל שמוגדרת ישירות בהקצאה ישירה. קבוצת סוגי האירועים הנתמכים כוללת INFO, DEBUG, ERROR ועוד.
תגים:terminal_output
- אפשרויות שונות, ללא שיוך לקטגוריה אחרת:
- נצברו
--build_metadata=<a 'name=value' assignment>
שימושים מרובים -
זוגות של מחרוזות מפתח-ערך מותאמים אישית שצריך לספק באירוע build.
תגים:terminal_output
- ברירת מחדל של
--color=<yes, no or auto>
: "auto" - שימוש בפקדים של הטרמינל לצביעה של הפלט.
- נצברו
--config=<a string>
שימושים מרובים - בוחרת קטעי config נוספים מקובצי ה-rc. עבור כל <command> היא גם שולפת את האפשרויות מתוך <command>:<config> אם קיים קטע כזה; אם הקטע הזה לא קיים בקובץ rc., ה-Blaze נכשל עם שגיאה. קטעי ה-config ושילובי הדגלים שהם מקבילים להם נמצאים בקובצי התצורה של כלים/*.blzerc.
- ברירת מחדל של
--curses=<yes, no or auto>
: "auto" - יש לך אפשרות להשתמש בפקדי הסמן של הטרמינל כדי למזער את הפלט של הגלילה.
- ברירת מחדל של
--[no]enable_platform_specific_config
: "false" - אם הערך הוא true, Bazel אוספת שורות config ספציפיות ל-OS-Bazelrc. לדוגמה, אם מערכת ההפעלה של המארח היא Linux ואתם מפעילים build של Bazel, Bazel לוקחת שורות שמתחילות ב-build:linux. מזהי ה-OS הנתמכים הם Linux , macos , Windows , Freebsd ו-openbsd. הפעלת סימון זה זהה לשימוש ב- --config=linux ב-Linux, --config=windows ב-Windows וכו'.
- נצברו
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
שימושים מרובים - הגדרת עזרה לגבי פרטי כניסה לשימוש באחזור פרטי הכניסה של ההיקף (דומיין). פרטי כניסה מ-credentials Credentials מקבלים עדיפות על פני פרטי כניסה מ-<code>--google_default_credentials</code>, `--google_credentials` או <code>.netrc</code>. אפשר לראות אותם בכתובת https://github.com/bazelbuild/proposs22-z
- ברירת מחדל של
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30m" - ההגדרה קובעת את משך הזמן שבו פרטי הכניסה ששמורים ב'פרטי כניסה' יישמרו במטמון.
- ברירת מחדל של
--experimental_credential_helper_timeout=<An immutable length of time.>
: "5s" - הגדרת הזמן הקצוב לתפוגה עבור 'פרטי הכניסה'. עוזרי הכניסה שלא יגיבו בזמן הקצוב לתפוגה ייכשלו.
- ברירת מחדל של
--[no]experimental_skymeld_ui
: "false" -
מוצגות גם התקדמות הניתוח וגם התקדמות שלב הביצוע, כששניהם פועלים בו-זמנית.
תגים:terminal_output
- ברירת מחדל של
--[no]experimental_windows_watchfs
: "false" - אם הערך הוא true, מופעלת תמיכה ניסיונית ב-Windows עבור --watchfs. אחרת - Watchfsis is non-op ב-Windows. הקפידו להפעיל גם --watchfs.
- ברירת מחדל של
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - רשימה של היקפי אימות ב-Google Cloud, המופרדים באמצעות פסיקים.
- ברירת מחדל של
--google_credentials=<a string>
: תיאור - ההגדרה קובעת את הקובץ שממנו יתקבלו פרטי הכניסה לאימות. פרטים נוספים זמינים בכתובת https://cloud.google.com/docs/authentication.
- ברירת מחדל של
--[no]google_default_credentials
: "false" - אם צריך להשתמש ב 'פרטי הכניסה שמוגדרים כברירת מחדל באפליקציית Google' לאימות. פרטים נוספים זמינים בכתובת https://cloud.google.com/docs/authentication. מושבת כברירת מחדל.
- ברירת מחדל של
--grpc_keepalive_time=<An immutable length of time.>
: תיאור - הגדרת פינגים בשידור חי עבור חיבורי gRPC יוצאים. אם המדיניות הזו מוגדרת, Bazel שולחת פינגים אחרי פרק הזמן הזה ללא פעולות קריאה בחיבור, אבל רק אם יש לפחות קריאה אחת אחת מסוג gRPC בהמתנה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. פינגים בשידור חי מושבתים כברירת מחדל. עליך לתאם עם בעל השירות לפני הפעלת ההגדרה הזו. לדוגמה, כדי להגדיר ערך של 30 שניות לסימון הזה, צריך לעשות זאת כך: grpc_keepalive_time=30s
- ברירת מחדל של
--grpc_keepalive_timeout=<An immutable length of time.>
: "20s" - הגדרת זמן קצוב לתפוגה של שמירת נתונים פעילה עבור חיבורי gRPC יוצאים. אם פינגים מסוג keep-alive מופעלים באמצעות --grpc_keepalive_time, תם הזמן הקצוב (Bazel) של Bazel אם לא מתקבלת פינג אחרי פרק הזמן הזה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. אם פינגים פעילים נשארים מושבתים, המערכת מתעלמת מההגדרה הזו.
- ברירת מחדל של
--[no]incompatible_disallow_symlink_file_to_dir
: "true" -
אם המדיניות מוגדרת כ-TRUE, `ctx.actions.symlink` לא יתיר קישור אוטומטי של קובץ לספרייה.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_remove_rule_name_parameter
: "true" -
אם הערך הוא TRUE, לא ניתן לקרוא ל-'rule''עם הפרמטר 'name'.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]progress_in_terminal_title
: "false" - אפשר להציג את התקדמות הפקודה בכותרת הטרמינל. מועיל לראות למה ה-Bazal עושה כשיש כרטיסיות מרובות בטרמינל.
- ברירת מחדל של
--[no]show_progress
: "true" - הצגת הודעות התקדמות במהלך ה-build.
- ברירת מחדל של
--show_progress_rate_limit=<a double>
: "0.2" - מספר השניות המינימלי בין הודעות התקדמות בפלט.
- ברירת מחדל של
--[no]show_timestamps
: "false" - הכללת חותמות זמן בהודעות
- ברירת מחדל של
--tls_certificate=<a string>
: תיאור - יש לציין נתיב לאישור TLS שהוא מהימן לחתימה על אישורי שרת.
- ברירת מחדל של
--tls_client_certificate=<a string>
: תיאור - ציון אישור הלקוח של TLS (אבטחת שכבת התעבורה) לשימוש. צריך גם לספק מפתח לקוח כדי להפעיל אימות לקוח.
- ברירת מחדל של
--tls_client_key=<a string>
: תיאור - צריך לציין את מפתח הלקוח ב-TLS שבו רוצים להשתמש. צריך גם לספק אישור לקוח כדי להפעיל את אימות הלקוח.
- ברירת מחדל של
--ui_actions_shown=<an integer>
: "8" -
מספר הפעולות המקבילות שמוצגות בסרגל ההתקדמות המפורט. כל פעולה מוצגת בשורה נפרדת. בסרגל ההתקדמות מוצג תמיד לפחות סרגל אחד, וכל המספרים שקטנים מ-1 ממופים ל-1.
תגים:terminal_output
- ברירת מחדל של
--[no]watchfs
: "false" - ב-Linux/macOS: אם המדיניות מוגדרת כ-TRUE, Bazel מנסה להשתמש בשירות הצפייה בקבצים של מערכת ההפעלה עבור שינויים מקומיים במקום לסרוק כל קובץ ולחפש שינוי. ב-Windows: הדגל הזה אינו פעיל כרגע, אך ניתן להפעיל אותו בשילוב עם -experimental_windows_watchfs. בכל מערכות ההפעלה: ההתנהגות לא מוגדרת אם סביבת העבודה נמצאת במערכת הקבצים של הקבצים, והעריכה מתבצעת במחשב מרוחק.
אפשרויות פרופיל לניתוח נתונים
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות שמשפיעות בצורה מדויקת על האופן שבו Bazel אוכפת קלטי build תקינים (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--dump=<text or raw>
[-d
]: תיאור -
פלט פרופיל נתונים מלא בפרופיל
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות שאילתה
העברה בירושה את כל האפשרויות מיצירה.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות שמשפיעות בצורה מדויקת על האופן שבו Bazel אוכפת קלטי build תקינים (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות הקשורות לפלט שאילתות וסמנטיקה:
- ברירת מחדל של
--aspect_deps=<off, conservative or precise>
: "conservative" -
איך לפתור בעיה של יחסי גובה-רוחב כאשר פורמט הפלט הוא בפורמט {xml,proto,record}. 'off' פירוש הדבר שלא נפתרים יחסי תלות ו'שמרני' (ברירת המחדל) מוסיפים את כל יחסי הגובה-רוחב המוצהרים, בין אם הם קיבלו את רמת התלויות הישירות ובין אם לא. חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, כך שהוא איטי יותר מהמצבים האחרים. כמו כן, אפילו מצב מדויק אינו מדויק לחלוטין: ההחלטה אם לחשב היבט מסוים נקבעת בשלב הניתוח, שאינו פועל במהלך &b3Query;'
תגים:build_file_semantics
- ברירת מחדל של
--[no]deduplicate_depsets
: "true" -
אפשר לבטל כפילויות של ילדים ללא עצים ב-dep_set_of_files בפלט הסופי (toto/textproto/json). הפעולה הזו לא מבטלת כפילויות של דיוורים שאינם משותפים הורה מיידי. המדיניות הזו לא משפיעה על הרשימה הסופית בפועל של פריטי מידע שנוצרו בתהליך פיתוח (Artifact) של הפעולות.
תגים:terminal_output
- ברירת מחדל של
--[no]graph:factored
: "true" -
אם הערך הוא True, התרשים ייקרא 'fact האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים:terminal_output
- ברירת מחדל של
--graph:node_limit=<an integer>
: "512" -
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; הערך 1- יגרום לכך שלא ייחתך. האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים:terminal_output
- ברירת מחדל של
--[no]implicit_deps
: "true" -
אם האפשרות הזאת מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלות שבו השאילתה פועלת. תלות משתמעת היא זו שלא צוינה במפורש בקובץ BUILD, אך נוספה על ידי ה-bazel. עבור שאילתה, אפשרות זו שולטת בסינון ערכות כלים שנפתרו.
תגים:build_file_semantics
- ברירת מחדל של
--[no]include_artifacts
: "true" -
כולל שמות של קלט ופלט של הפלט (גדול בפוטנציאל).
תגים:terminal_output
- ברירת מחדל של
--[no]include_aspects
: "true" -
aquery, שאילתה: האם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: no-op (מאפיינים תמיד במעקב).
תגים:terminal_output
- ברירת מחדל של
--[no]include_commandline
: "true" -
כולל את התוכן של שורות הפקודות לביצוע בפלט (גדול בפוטנציאל).
תגים:terminal_output
- ברירת מחדל של
--[no]include_file_write_contents
: "false" -
יש לכלול את תוכן הקובץ עבור הפעולות FileWrite ו-SourceSymlinkManifest (גדול בפוטנציאל).
תגים:terminal_output
- ברירת מחדל של
--[no]include_param_files
: "false" -
יש לכלול את התוכן של קובצי הפרמטרים שנעשה בהם שימוש בפקודה (פוטנציאליים). הערה: כשמפעילים את התכונה הזו, הסימון 'include_commandline' יופעל באופן אוטומטי.
תגים:terminal_output
- ברירת מחדל של
--[no]incompatible_display_source_file_location
: "true" -
True, כברירת מחדל, יוצג היעד של קובץ המקור. אם True, מציג את המיקום של שורה 1 של קובצי מקור בפלטי מיקום. הסימון הזה קיים רק למטרות העברה.
תגים:terminal_output
,incompatible_change
- ברירת מחדל של
--[no]incompatible_package_group_includes_double_slash
: "true" -
אם האפשרות הזו מופעלת, בעת הפקת המאפיין 'packs' של package_group&, הסימן '//' הראשי לא יושמט.
תגים:terminal_output
,incompatible_change
- ברירת מחדל של
--[no]infer_universe_scope
: "false" -
אם המדיניות set ו- לתשומת ליבכם, הערך של uniuni_scope כפי שהוסק עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, allalleps) הוא לא מה שאתם רוצים, לכן עליכם להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים ודוגמאות זמינים בכתובת https://bazel.build/reference/query#sky-query. אם --univers_scope מוגדר, המערכת מתעלמת מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'שאילתה' (כלומר, לא 'cquery').
תגים:loading_and_analysis
- ברירת מחדל של
--[no]line_terminator_null
: "false" -
אם כל פורמט יסתיים ב-\0 במקום בפורמט חדש.
תגים:terminal_output
- ברירת מחדל של
--[no]nodep_deps
: "true" -
אם המדיניות מופעלת, נקודות שפל מתוך "nodep" ייכללו בתרשים התלות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep". היא "visible". מריצים ומנתחים את הפלט של 'info Build-language' כדי ללמוד על כל המאפיינים "nodep"בשפת ה-build.
תגים:build_file_semantics
- ברירת מחדל של
--output=<a string>
: "text" -
הפורמט שבו יש להדפיס את תוצאות השאילתה. הערכים המותרים ל-query הם: text, textproto, Proto, jsonproto.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:default_values
: "true" -
אם מוגדר כ-True, נכללים מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- --פלט=פרוטו
תגים:terminal_output
- ברירת מחדל של
--[no]proto:definition_stack
: "false" -
מאכלס את השדה Proto-stack, שמתעד כל מופע של כלל ה-Starstark שבו מוגדרת המחלקה בכלל.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:flatten_selects
: "true" -
אם המדיניות מופעלת, מאפיינים ניתנים להגדרה שנוצרו על ידי Select() שטוחים. עבור סוגי רשימות, הייצוג השטוח הוא רשימה המכילה כל ערך של המפה שנבחרה פעם אחת בלבד. סוגי הפיגועים שטוחים איזה null.
תגים:build_file_semantics
- ברירת מחדל של
--[no]proto:include_synthetic_attribute_hash
: "false" -
אם רוצים לחשב ולאכלס את המאפיין $internal_attr_Hash.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:instantiation_stack
: "false" -
אכלוס מחסנית קריאות של כל הנחיה. כדי לעשות זאת, יש צורך במקבץ סטאק
תגים:terminal_output
- ברירת מחדל של
--[no]proto:locations
: "true" -
אם בכלל, כדאי לשלוח פרטי מיקום בפלט אב.
תגים:terminal_output
- ברירת מחדל של
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
רשימת מאפיינים המופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להוציא פלט. האפשרות הזו רלוונטית ל--פלט=פרוטו.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:rule_inputs_and_outputs
: "true" -
אפשר גם לאכלס את השדותכללי_קלט וכלל_פלט.
תגים:terminal_output
- ברירת מחדל של
--[no]relative_locations
: "false" -
אם הערך הוא TRUE, המיקום של קובצי BUILD ב-XML ובפלטי אב יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא יהיה עקבי בין מחשבים. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במכשירים שונים.
תגים:terminal_output
- ברירת מחדל של
--[no]skyframe_state
: "false" -
ללא צורך בניתוח נוסף, שולחים את תרשים הפעולה הנוכחי מ-Skyframe. הערה: ציון היעד באמצעות --skyframe_state אינו נתמך כרגע. הסימון הזה זמין רק באמצעות
תגים:terminal_output
- ברירת מחדל של
--[no]tool_deps
: "true" -
שאילתה: אם היא מושבתת, יחסי תלות ב-'מארח הגדרה' או 'execution' יעדים לא ייכללו בתרשים התלות שעליו פועלת השאילתה. קצה 'הגדרת תצורה למארחים' כזה מהכלל של #&39;proto_library' מפנה בדרך כלל למהדר הפרוטוקול, בדרך כלל מצביע על כלי שהופעל במהלך ה-build במקום על חלק מאותה תוכנית 'target'
שאילתה: אם היא מושבתת, היא מסננת את כל היעדים שהוגדרו שחוצים מעבר של מארח או ביצוע, מהיעד שהוגדר ברמה העליונה שגילו את היעד שהוגדר. כלומר, אם היעד ברמה העליונה נמצא בתצורת היעד, יוחזרו רק יעדים שהוגדרו בתצורת היעד. אם היעד ברמה העליונה נמצא בתצורת המארח, יוחזרו רק יעדים שהוגדרו על ידי המארח. אפשרות זו לא תכלול שרשראות כלים שנפתרו.
תגים:build_file_semantics
- ברירת מחדל של
--universe_scope=<comma-separated list of options>
: "" -
קבוצה של דפוסי יעד (מופרדים באמצעות פסיקים) המופרדים בפסיקים. השאילתה עשויה להתבצע ביקום שהוגדר על ידי הסגירה העקיפה של היעדים שצוינו. האפשרות הזו משמשת לפקודות השאילתה ושאילתת השאילתה.
עבור השאילתה, הקלט לאפשרות הזו הוא היעדים שבנו כל התשובות, ולכן האפשרות הזו עשויה להשפיע על התצורות והמעברים. אם אפשרות זו אינה מוגדרת, ההנחה היא שהיעדים ברמה העליונה הם היעדים המנותחים מביטוי השאילתה. הערה לגבי שאילתה: אם לא מציינים את האפשרות הזו, ייתכן שה-build לא יפעל אם לא ניתן ליצור יעדים מביטוי השאילתה עם האפשרויות ברמה העליונה.
תגים:loading_and_analysis
- אפשרויות הקשורות לפלט Bzlmod וסמנטיקה:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
- אפשרויות ששולטות בביצוע של גרסאות build:
- ברירת מחדל של
--[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" -
אם האפשרות הזו מופעלת, קבוצות הקבצים יתייחסו לכל פריטי המידע שנוצרו בתהליך הפיתוח כקבצים רגילים. הם לא חוצה ספריות ולא יהיו רגישים לקישורים סימבוליים.
תגים:execution
- ברירת מחדל של
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
ניתן להוסיף או להסיר מפתחות מידע על ביצוע של פעולה על סמך הקובץ של הפעולה. רלוונטי רק לפעולות התומכות בפרטי הביצוע. פעולות נפוצות רבות תומכות בפרטי ביצוע, כמו Genrule, CppCompile, Javac, StarlarkAction, TestRunner. כשמציינים כמה ערכים, הסדר חשוב כי ביטויים רבים עשויים לחול על אותו אזכור.
תחביר: "regex=[+-]key,regex=[+-]key,...".
דוגמאות:
'.*=+x,.*=-y,.*=+z' מוסיף את #&39;x' ו-'z' את פרטי הביצוע של #&39;y' ומסירים אותם.
'Genrule=+requires-x' add 'requires-x' לפרטי הביצוע של כל פעולות הז'אנר.
'(?!Genrule).*=-requires-x' removed 'requires-x' מפרטי ההפעלה של כל הפעולות שאינן ז'אנר.
תגים:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
הפעלה של עובדים ב-Android Dex ופעולות סוכר קבועות.
מתרחב אל:
--strategy=Desugar=worker
--strategy=DexBuilder=worker
תגים:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
הפעלת מעבד משאבים קבוע של Android באמצעות עובדים.
הרחבה אל:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
2
{1/2--internal_persistent_busybox_tools
--persistent_multiplex_android_dex_desugar
-
הפעלה של עובדים עם Multiplex דק' ופעולות סוכר
מתרחב אל:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers
תגים:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
הפעלה של מעבד משאבים (cast) עקבי ב-Android עם עובדים.
הרחבה אל:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
2
{1/2--persistent_android_resource_processor
--persistent_multiplex_android_tools
-
הפעלת כלים עקביים ומוכפלים ב-Android (Dexs, הסרת ניפוי באגים, עיבוד משאבים).
מתרחבת אל:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
תגים:host_machine_resource_optimizations
,execution
- אפשרויות שמגדירות את ה-chainch המשמש לביצוע הפעולה:
- ברירת מחדל של
--android_compiler=<a string>
: תיאור -
המהדר של היעד ל-Android.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_crosstool_top=<a build target label>
: "//external:android/crosstool" -
המיקום של המהדר C++ המשמש לגרסאות של Android.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_grte_top=<a label>
: תיאור -
יעד grte_top ב-Android.
תגים:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_manifest_merger=<legacy, android or force_android>
: "android" -
בחירת המיזוג של המניפסט לשימוש בכללי android_binary. סימון לבדיקה כדי לעבור למיזוג המניפסט של Android מהמיזוג הקודם.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_platforms=<a build target label>
: "" -
מגדירה את הפלטפורמות שבהן היעדים של android_binary משתמשים. אם מציינים כמה פלטפורמות, הקובץ הבינארי הוא חבילות APK בעלות אחוזי שומן, המכילות קבצים בינאריים מקומיים לכל פלטפורמת יעד שצוינה.
תגים:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_sdk=<a build target label>
: "@bazel_tools//tools/android:sdk" -
ההגדרה קובעת Android SDK/פלטפורמה המשמשת לבניית אפליקציות ל-Android.
תגים:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--apple_compiler=<a string>
: תיאור -
מהדר היעד של Apple. שימושי לבחירת וריאציות של כלי עבודה (למשל: xcode-beta).
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--apple_crosstool_top=<a build target label>
: "@bazel_tools//tools/cpp:toolchain" -
התווית של חבילת כלי ההובלה לשימוש בכללי Apple ו-Objc ובתלויים שלהם.
תגים:loses_incremental_state
,changes_inputs
- ברירת מחדל של
--apple_grte_top=<a build target label>
: תיאור -
היעד grte_top של Apple.
תגים:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--cc_output_directory_tag=<a string>
: "" -
קביעת סיומת שתתווסף לספריית התצורה.
תגים:affects_outputs
,explicit_in_output_path
- ברירת מחדל של
--compiler=<a string>
: תיאור -
המהדר C++ המשמש לאיסוף היעד.
תגים:loading_and_analysis
,execution
- ברירת מחדל של
--coverage_output_generator=<a build target label>
: "@bazel_tools//tools/test:lcov_merger" -
המיקום של הקובץ הבינארי המשמש לעיבוד דוחות כיסוי גולמיים לאחר העיבוד. נכון לעכשיו זו צריכה להיות קבוצת קבצים הכוללת קובץ אחד, הקובץ הבינארי. ברירת המחדל היא '//tools/test:lcov_merger'.
תגים:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
ברירת מחדל: "@bazel_tools//tools/test:coverage_report_מחולל"-
המיקום של הקובץ הבינארי המשמש להפקת דוחות כיסוי. נכון לעכשיו זו צריכה להיות קבוצת קבצים הכוללת קובץ אחד, הקובץ הבינארי. ברירת המחדל היא '//tools/test:coverage_report_מחולל'.
תגים:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ברירת מחדל: "@bazel_tools//tools/test:coverage_support"-
המיקום של קובצי התמיכה הנדרשים על סמך הקלט של כל פעולת בדיקה שאוספת כיסוי קוד. ברירת המחדל היא '//tools/test:coverage_support'.
תגים:changes_inputs
,affects_outputs
,loading_and_analysis
- ברירת מחדל של
--crosstool_top=<a build target label>
: "@bazel_tools//tools/cpp:toolchain" -
התווית של חבילת כלי ההובלה שתשמש להרכבת קוד C++.
תגים:loading_and_analysis
,changes_inputs
,affects_outputs
- ברירת מחדל של
--custom_malloc=<a build target label>
: תיאור -
ההגדרה קובעת הטמעה מותאמת אישית של Malloc. ההגדרה הזו מבטלת את המאפיינים של Malאיך להשתמש בכללי build.
תגים:changes_inputs
,affects_outputs
- נצברו
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
שימושים מרובים -
רשימה של ביטויים רגולריים המופרדים בפסיקים, שלכל אחד מהם יש קידומת (-) שלילי, מוקצית (=) לרשימה של יעדי ערך מופרדים בפסיקים. אם יעד מסוים לא תואם אף ביטוי שלילי וביטוי חיובי אחד לפחות, רזולוציית הכלים שלו תתבצע כאילו היא הצהירה על ערכי האילוץ כאילוצי ביצוע. דוגמה: //demo,-test=@platforms//cpus:x86_64 יתווסף #&39;x86_64' לכל יעד תחת //demo, מלבד אלה שהשם שלהם מכיל 'test'.
תגים:loading_and_analysis
- ברירת מחדל של
--[no]experimental_enable_objc_cc_deps
: "true" -
קבלת כללים מסוג objc_* שתלויים ב-cc_library וגורמת לקיום יחסי תלות של objc עם --cpu המוגדר כ-"ios_<--ios_cpu>" עבור כל ערך ב- --ios_multi_cpu.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]experimental_include_xcode_execution_requirements
: "false" -
אם היא מוגדרת, מוסיפים את דרישת הביצוע "requires-xcode:{version}" לכל פעולת Xcode. אם גרסת ה-xcode כוללת תווית עם מקפים, צריך להוסיף גם "requires-xcode-label:{version_label}" דרישת ביצוע.
תגים:loses_incremental_state
,loading_and_analysis
,execution
- ברירת מחדל של
--[no]experimental_prefer_mutual_xcode
: "true" -
אם מוגדר True, יש להשתמש ב-Xcode העדכני ביותר שזמין גם מקומית וגם מרחוק. אם False, או אם אין גרסאות הדדיות זמינות, משתמשים בגרסת Xcode המקומית שנבחרה באמצעות xcode-select.
תגים:loses_incremental_state
- נצברו
--extra_execution_platforms=<comma-separated list of options>
שימושים מרובים -
הפלטפורמות הזמינות כפלטפורמות לביצוע פעולות. אפשר לציין פלטפורמות לפי יעד מדויק או כתבנית יעד. המערכת תתייחס לפלטפורמות האלה לפני אלה המוצהרות בקובץ ה-WORKSPACE על ידי sign_execution_platforms() .
תגים:execution
- נצברו
--extra_toolchains=<comma-separated list of options>
שימושים מרובים -
הכללים בנוגע לכלים של כלי עבודה שנלקחים בחשבון במהלך מציאת פתרון לכלים. ניתן לציין ערכות הכלים לפי יעד מדויק, או כתבנית יעד. חשוב לזכור את ערכות הכלים האלה לפני ההשקה שלהן בקובץ ה-WORKSPACE באמצעות record_toolchains() .
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--grte_top=<a label>
: תיאור -
תווית לספריית ליבצ'ק שמסומנת. ערך ברירת המחדל נבחר על ידי רצועת הכלים, וכמעט אף פעם לא צריך לשנות אותו.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_compiler=<a string>
: תיאור -
המהדר C++ המשמש לאיסוף של מארח. המערכת מתעלמת ממנו אם --host_crosstool_top לא מוגדר.
תגים:loading_and_analysis
,execution
- ברירת מחדל של
--host_crosstool_top=<a build target label>
: תיאור -
כברירת מחדל, האפשרויות מהלך --crosstool_top ו-- מהדר משמשות גם להגדרת המארח. אם הדגל הזה צוין, Bazel משתמשת ב-libc ובמהדר המוגדר כברירת מחדל עבור ה-crosstool_top הנתון.
תגים:loading_and_analysis
,changes_inputs
,affects_outputs
- ברירת מחדל של
--host_grte_top=<a label>
: תיאור -
אם מציינים, ההגדרה הזו מבטלת את הספרייה ברמה העליונה libc (--grte_top) של תצורת המארח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_platform=<a build target label>
: "" -
התווית של כלל הפלטפורמה שמתארת את מערכת האירוח.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: "true" -
אם הערך הוא true, Bazel לא יאפשר לציין extension_if_all_available ב-flag_sets(לקבלת הוראות העברה, יש לעיין בכתובת https://github.com/bazelbuild/bazel/issues/7008).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
אם הערך true, Bazel לא תפעיל את 'host' 'nonhost' תכונות בכלי C++ (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/7407).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enable_android_toolchain_resolution
: "false" -
שימוש ברזולוציה של Toolchain כדי לבחור את ה-SDK ל-Android לכללי Android (סטארלרק ו-Native)
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
שימוש ברזולוציית כלים כדי לבחור את ה-SDK של Apple לכללי התפוחים (Starlark ו-Native)
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
True
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: "true" -
אם הערך true, Bazel יתלונן כשמאפייני cc_toolchain.cpu ו-cc_toolchain.devguider מוגדרים (מידע נוסף זמין במאמר https://github.com/bazelbuild/bazel/issues/7075).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_remove_legacy_whole_archive
: "true" -
אם הדבר נכון, כברירת מחדל, Bazel לא תקשר קשרי תלות של ספרייה כארכיון כולו (בכתובת https://github.com/bazelbuild/bazel/issues/7362 ניתן למצוא הוראות העברה).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_require_ctx_in_configure_features
: "true" -
אם הערך true, Bazel ידרוש פרמטר 'ctx' in to cc_common.configure_features (מידע נוסף בכתובת https://github.com/bazelbuild/bazel/issues/7793).
תגים:loading_and_analysis
,incompatible_change
-
שימוש באובייקטים משותפים בממשק אם הם נתמכים על ידי ערכת הכלים. כל שרשראות הכלים של ELF תומכות בשלב זה בהגדרה הזו.
תגים:loading_and_analysis
,affects_outputs
,affects_outputs
- ברירת מחדל של
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
ההגדרה קובעת את גרסת ה-SDK של iOS לפיתוח אפליקציות ל-iOS. אם לא צוין, נעשה שימוש בגרסת ברירת מחדל של iOS SDK מ-'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
ההגדרה קובעת את גרסת ה-macOS SDK שבה משתמשים כדי לבנות אפליקציות ל-macOS. אם לא צוין, נעשה שימוש בגרסת macOS SDK המוגדרת כברירת מחדל מ-'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--minimum_os_version=<a string>
: תיאור -
גרסת מערכת ההפעלה המינימלית שהאוסף שלך מטרגט.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--platform_mappings=<a relative path>
: "" -
המיקום של קובץ מיפוי שמתאר באיזו פלטפורמה להשתמש אם לא הוגדרה פלטפורמה או באילו סימונים להגדיר כשהפלטפורמה כבר קיימת. חייב להיות יחסי לשורש הראשי של סביבת העבודה. ברירת המחדל היא 'platform_mappings' (קובץ שנמצא מתחת לרמה הבסיסית (root) של סביבת עבודה).
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--platforms=<a build target label>
: "" -
התוויות של כללי הפלטפורמה שמתארות את פלטפורמות היעד של הפקודה הנוכחית.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--python2_path=<a string>
: תיאור -
הוצא משימוש, לא-מושבת. מושבת על ידי `--incompatible_use_python_toolchains`.
תגים:no_op
,deprecated
- ברירת מחדל של
--python3_path=<a string>
: תיאור -
הוצא משימוש, לא-מושבת. מושבת על ידי `--incompatible_use_python_toolchains`.
תגים:no_op
,deprecated
- ברירת מחדל של
--python_path=<a string>
: תיאור -
הנתיב המוחלט של המתרגם ב-Python הופעל כדי להפעיל יעדים ב-Python בפלטפורמת היעד. הוצאה משימוש, הושבתה על ידי --incompatible_use_python_toolchains.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--python_top=<a build target label>
: תיאור -
התווית של py_runtime שמייצגת את התרגום של Python הופעלה להפעלת יעדים של Python בפלטפורמת היעד. הוצאה משימוש, הושבתה על ידי --incompatible_use_python_toolchains.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--target_platform_fallback=<a build target label>
: "@local_config_platform//:host" -
התווית של כלל הפלטפורמה שצריך להשתמש בה אם לא הוגדרה פלטפורמת יעד, ואין מיפוי פלטפורמה שתואם לקבוצת הסימונים הנוכחית.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
ההגדרה קובעת את גרסת ה-SDK של tvOS שבה משתמשים כדי ליצור אפליקציות TV. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של TV SDK מ-'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
ההגדרה קובעת את גרסת ה-SDK של WatchOS שבה משתמשים כדי לבנות אפליקציות שעון. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של WatchOS SDK מגרסה 'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--xcode_version=<a string>
: תיאור -
אם צוין, נעשה שימוש ב-Xcode של הגרסה הנתונה לפעולות build רלוונטיות. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של הביצוע של Xcode.
תגים:loses_incremental_state
- ברירת מחדל של
--xcode_version_config=<a build target label>
: "@bazel_tools//tools/cpp:host_xcodes" -
התווית של הכלל xcode_config שיש להשתמש בה לבחירת הגרסה של Xcode בתצורת ה-build.
תגים:loses_incremental_state
,loading_and_analysis
- אפשרויות ששולטות בפלט של הפקודה:
- ברירת מחדל של
--[no]apple_enable_auto_dsym_dbg
: "false" -
אם צריך לאלץ יצירה של קובצי ניפוי באגים (.dSYM) עבור גרסאות build ל-dbg.
תגים:affects_outputs
,action_command_lines
- ברירת מחדל של
--[no]apple_generate_dsym
: "false" -
האם ליצור קובצי ניפוי באגים ( .dSYM)?
תגים:affects_outputs
,action_command_lines
- ברירת מחדל של
--[no]build_runfile_links
: "true" -
אם הערך הוא true, יש ליצור יערות קישור ריצה עבור כל היעדים. אם False, כותבים מניפסטים רק כשהדבר אפשרי.
תגים:affects_outputs
- ברירת מחדל של
--[no]build_runfile_manifests
: "true" -
אם הערך הוא True, צריך לכתוב מניפסטים מסוג Runfiles בכל היעדים. אם FALSE, משמיטים אותן. הבדיקות המקומיות לא יפעלו אם הן יהיו שקריות.
תגים:affects_outputs
- ברירת מחדל של
--[no]build_test_dwp
: "false" -
אם האפשרות מופעלת, כשפותחים בדיקות C++ באופן סטטי ובצורה קפדנית, המערכת תיצור באופן אוטומטי גם קובץ .dwp עבור הקובץ הבינארי של הבדיקה.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--cc_proto_library_header_suffixes=<comma-separated list of options>
: ".pb.h" -
המערכת מגדירה את הקידומות של קובצי הכותרת שיוצרים ב-cc_proto_library.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--cc_proto_library_source_suffixes=<comma-separated list of options>
: ".pb.cc" -
מגדיר את הקידומות של קובצי המקור ש-cc_proto_library יוצר.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
אפשר לבצע פעולות נוספות על גרסאות API חלופיות של Java ב-proto_library.
תגים:affects_outputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_proto_extra_actions
: "false" -
אפשר לבצע פעולות נוספות על גרסאות API חלופיות של Java ב-proto_library.
תגים:affects_outputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_save_feature_state
: "false" -
שומרים את המצב של תכונות מופעלות ומבוקשות כפלט של הידור.
תגים:affects_outputs
,experimental
- ברירת מחדל של
--fission=<a set of compilation modes>
: "no" -
ההגדרה קובעת אילו מצבי הידור משתמשים בפיקוח עבור אוספי +C+. יכולים להיות כל שילובים של {'speedbuild', 'dbg', 'opt'} או ערכים מיוחדים 'yes' כדי להפעיל את כל המצבים &&339;no' כדי להשבית את כל המצבים.
תגים:loading_and_analysis
,action_command_lines
,affects_outputs
- ברירת מחדל של
--[no]legacy_external_runfiles
: "true" -
אם המדיניות מוגדרת כ-TRUE, יש לבנות יערות סימבונק של Runruns עבור מאגרים חיצוניים בכפוף ל- .runfiles/wsname/external/repo (בנוסף ל- .runfiles/repo).
תגים:affects_outputs
- ברירת מחדל של
--[no]objc_generate_linkmap
: "false" -
ההגדרה קובעת אם ליצור קובץ מפת קישור.
תגים:affects_outputs
- ברירת מחדל של
--[no]save_temps
: "false" -
אם המדיניות מוגדרת, פלט זמני מ-gcc יישמר. דוגמאות לקובצי .s (קוד ליצירת מקטע), קובצי .i (C מעובד מראש) וקובצי .ii (C++ ). לפני העיבוד:
תגים:affects_outputs
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לעצם קיומו:
- נצברו
--action_env=<a 'name=value' assignment with an optional value part>
שימושים מרובים -
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם הגדרת יעד. אפשר לציין משתנים לפי שם. במקרה כזה, הערך יילקח מסביבת ההפעלה, או מצמד name=value שקובע את הערך בלי קשר לסביבת ההפעלה. ניתן להשתמש באפשרות זו כמה פעמים. לאפשרויות המוגדרות לאותו משתנה, המנצחים האחרונים, האפשרויות המצטברות למשתנים שונים.
תגים:action_command_lines
- ברירת מחדל של
--android_cpu=<a string>
: "armeabi-v7a" -
מעבד ה-Android לטירגוט.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]android_databinding_use_androidx
: "false" -
יוצרים קובצי התאמת נתונים ל-AndroidX. האפשרות הזו משמשת רק לקישור נתונים v2.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--[no]android_databinding_use_v3_4_args
: "false" -
שימוש ב-Android Databining v2 עם ארגומנט 3.4.0
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--android_dynamic_mode=<off, default or fully>
: "off" -
קביעה אם קישורי +C+ של כללי Android יקושרו באופן דינמי כאשר cc_binary לא ייצור באופן מפורש ספרייה משותפת. 'default' פירוש הדבר שבסיס הפנים יבחר אם לקשר באופן דינמי. 'ly' כלומר כל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי ברובו.
תגים:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
כברירת מחדל: "alphabetical"-
מגדיר את סדר המניפסטים שהועברו למיזוג המניפסט עבור קבצים בינאריים של Android. 'ALPHABETLY' פירושו שהמניפסטים ממוינים לפי הנתיב ביחס לרכיב ה-exe. ALPHABETical_BY_CONFIGURATION פירושו שהמניפסטים ממוינים לפי נתיבים ביחס לספריית התצורה בספריית הפלט. המשמעות של DEPENDENCY היא שמניפסטים מסודרים לפי כל ספרייה שנמצאת לפני המניפסטים של יחסי התלות שלה.
תגים:action_command_lines
,execution
- ברירת מחדל של
--[no]android_resource_shrinking
: "false" -
הפעלת כיווץ משאבים ל-APK_android_binary שמשתמשים ב-ProGuard
תגים:affects_outputs
,loading_and_analysis
- נצברו
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst>
שימושים מרובים -
יש לציין את מצב קוד ה-API של Apple לצורך שלבי הידור שמטרגטים את ארכיטקטורת המכשירים. הערכים צריכים להיות בפורמט '[platform=]mode' כאשר הפלטפורמה (שחייבת להיות 'ios', 'macos', 'tvos' או 'watchos') היא אופציונלית. אם צוין, מצב מצב הקידוד חל על הפלטפורמה הזו באופן ספציפי. אם לא נתון, הוא חל על כל הפלטפורמות. המצב חייב להיות 'none', 'embedded_סמןs' או 'embedded' ייתכן שהאפשרות הזו תוצג כמה פעמים.
תגים:loses_incremental_state
- ברירת מחדל של
--[no]build_python_zip
: "auto" -
יצירת קובץ ZIP של קובץ הפעלה בצורת פיליון. ב-Windows, השבתה בפלטפורמות אחרות
תגים:affects_outputs
- נצברו
--catalyst_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה של ארכיטקטורה המופרדת בפסיקים שבשבילה לבנות קבצים בינאריים של Apple Catalyst.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--[no]collect_code_coverage
: "false" -
אם תציינו זאת, Bazel תפיק קוד אינסטרומנטציה (באמצעות אינסטרומנטציה אופליין, במידת האפשר) ותאסוף מידע על כיסוי במהלך הבדיקות. השינוי ישפיע רק על יעדים שתואמים לשיטה --instrumentation_filter. בדרך כלל, אין לציין אפשרות זו ישירות – 'Bazelcover' במקום זאת יש להשתמש בפקודה.
תגים:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ברירת מחדל: "speedbuild"-
מציינים את המצב שבו יוצג הקובץ הבינארי. ערכים: 'speedbuild', 'dbg', 'opt'.
תגים:affects_outputs
,action_command_lines
,explicit_in_output_path
- נצברו
--conlyopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc במהלך הידור קובצי המקור של C.
תגים:action_command_lines
,affects_outputs
- נצברו
--copt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-ccC.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--cpu=<a string>
: "" -
מעבד היעד.
תגים:changes_inputs
,affects_outputs
,explicit_in_output_path
- ברירת מחדל של
--cs_fdo_absolute_path=<a string>
: תיאור -
יש להשתמש בפרטי הפרופיל של CSFDO כדי לבצע אופטימיזציה של האוסף. מציינים את שם הנתיב המוחלט של קובץ ה-ZIP המכיל את קובץ הפרופיל, קובץ גולמי מסוג LLVM או קובץ שנוסף לאינדקס.
תגים:affects_outputs
- ברירת מחדל של
--cs_fdo_instrument=<a string>
: תיאור -
יצירת קבצים בינאריים עם אינסטרומנטציה של FDO רגישה להקשר. עם המהדר Clang/LLVM, הוא מקבל גם את שם הספרייה שמתחתיו יושלכו קובצי הפרופיל הגולמי בזמן הריצה.
תגים:affects_outputs
- ברירת מחדל של
--cs_fdo_profile=<a build target label>
: תיאור -
cs_fdo_profile המייצג את הפרופיל הרגיש של ההקשר שישמש לאופטימיזציה.
תגים:affects_outputs
- נצברו
--cxxopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc כשעורכים קובצי מקור ב-C++.
תגים:action_command_lines
,affects_outputs
- נצברו
--define=<a 'name=value' assignment>
שימושים מרובים -
כל אפשרות --הגדרה מציינת מטלה למשתנה build.
תגים:changes_inputs
,affects_outputs
- ברירת מחדל של
--dynamic_mode=<off, default or fully>
: "default" -
ההגדרה קובעת אם הקבצים הבינאריים מסוג C++ יקושרו באופן דינמי. 'default' פירושו ש-Bazel תבחר אם לקשר באופן דינמי. 'ly' כלומר כל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי ברובו.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--[no]enable_fdo_profile_absolute_path
: "true" -
אם המדיניות מוגדרת, שימוש ב-fdo_lbolute_profile_path יגדיל את השגיאה.
תגים:affects_outputs
- ברירת מחדל של
--[no]enable_runfiles
: "auto" -
הפעלה של עץ קישור סימולטני (runfiles); כברירת מחדל, התכונה מושבתת ב-Windows, בפלטפורמות אחרות.
תגים:affects_outputs
- נצברו
--experimental_action_listener=<a build target label>
שימושים מרובים -
הוצא משימוש לטובת היבטים. אפשר להשתמש ב-action_listener כדי לצרף action_action לביצוע פעולות build קיימות.
תגים:execution
,experimental
- ברירת מחדל של
--[no]experimental_android_compress_java_resources
: "false" -
דחיסת משאבים של Java ב-APK
תגים:affects_outputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_android_databinding_v2
: "false" -
שימוש בגרסה 2 של קישור ל-Android
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--[no]experimental_android_resource_shrinking
: "false" -
הפעלת כיווץ משאבים ל-APK_android_binary שמשתמשים ב-ProGuard
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
להשתמש בכלי Rex כדי לכתוב מחדש קובצי Dex
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
יש להשתמש במחרוזות האלה כאפשרויות מהדר dataLayer של objc Builder.
תגים:action_command_lines
- ברירת מחדל של
--[no]experimental_omitfp
: "false" -
אם המדיניות מוגדרת כ-True, יש להשתמש ב-libunhost עבור שחרור מחסניות (stackunack) ולהידור באמצעות -fomit-frame-pointer ו- -fסינכרוני-un Wind-tables.
תגים:action_command_lines
,affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_platform_in_output_dir
: "false" -
אם הערך הוא True, פלטפורמת היעד תשמש בשם של ספריית הפלט במקום ביחידת העיבוד המרכזית (CPU).
תגים:affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_use_llvm_covmap
: "false" -
אם צוין, Bazel תיצור פרטי מפה של llvm-cov במקום gcov כש-collect_code_coverage מופעל.
תגים:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--fat_apk_cpu=<comma-separated list of options>
: "armeabi-v7a" -
הגדרת האפשרות הזו מאפשרת חבילות APK בעלות שומן, המכילות קבצים בינאריים מקומיים לכל ארכיטקטורת היעד שצוינה, לדוגמה, --fat_APK_cpu=x86,armeabi-v7a. אם הדגל הזה צוין, המערכת תתעלם מ-android_cpu בהתאם לתלויים בכללי android_binary.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]fat_apk_hwasan
: "false" -
אם רוצים ליצור פיצולים מסוג HWASAN.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--fdo_instrument=<a string>
: תיאור -
יצירת קבצים בינאריים עם אינסטרומנטציה של FDO. עם המהדר Clang/LLVM, הוא מקבל גם את שם הספרייה שמתחתיו יושלכו קובצי הפרופיל הגולמי בזמן הריצה.
תגים:affects_outputs
- ברירת מחדל של
--fdo_optimize=<a string>
: תיאור -
יש לך אפשרות להשתמש בפרטי הפרופיל ב-FDO כדי לבצע אופטימיזציה של האוסף. יש לציין את השם של קובץ ZIP המכיל עץ קבצים עם הסיומת .gcda, קובץ afdo המכיל פרופיל אוטומטי או קובץ פרופיל LLVM. סימון זה מקבל גם קבצים שצוינו כתוויות (למשל `//foo/bar:file.afdo` – ייתכן שיהיה עליך להוסיף הנחיית ’exports_files’ לחבילה המתאימה) ותוויות המפנות ליעדים ’fdo_profile’. סימון זה יוחלף על ידי הכלל 'fdo_profile'.
תגים:affects_outputs
- ברירת מחדל של
--fdo_prefetch_hints=<a build target label>
: תיאור -
להשתמש ברמזים למטמון מראש.
תגים:affects_outputs
- ברירת מחדל של
--fdo_profile=<a build target label>
: תיאור -
פרופיל העסק fdo_profile משמש לאופטימיזציה של הפרופיל.
תגים:affects_outputs
- נצברו
--features=<a string>
שימושים מרובים -
כברירת מחדל, כל התכונות יופעלו או יושבתו. ציון -<feature> ישבית את התכונה באופן גלובלי. תכונות שליליות תמיד מבטלות תכונות חיוביות. הסימון הזה משמש להשקת שינויי ברירת מחדל בתכונות ללא גרסת Bazel.
תגים:changes_inputs
,affects_outputs
- ברירת מחדל של
--[no]force_pic
: "false" -
אם המדיניות מופעלת, כל האוספים של C++ מייצרים קוד עצמאי למיקום ("-fPIC"), קישורים מעדיפים ספריות מוגדרות מראש של PIC על פני ספריות שאינן מסוג PIC, וקישורים מייצרים קובצי הפעלה שאינם תלויי מיקום ("-Pie").
תגים:loading_and_analysis
,affects_outputs
- נצברו
--host_action_env=<a 'name=value' assignment with an optional value part>
שימושים מרובים -
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם תצורות מארח או ביצוע. אפשר לציין משתנים לפי שם. במקרה כזה, הערך יילקח מסביבת ההפעלה, או מצמד name=value שקובע את הערך בלי קשר לסביבת ההפעלה. ניתן להשתמש באפשרות זו כמה פעמים. לאפשרויות המוגדרות לאותו משתנה, המנצחים האחרונים, האפשרויות המצטברות למשתנים שונים.
תגים:action_command_lines
- ברירת מחדל של
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
ציון המצב שבו ייעשה שימוש בכלים ששימשו ליצירת ה-build. ערכים: 'speedbuild', 'dbg', 'opt'.
תגים:affects_outputs
,action_command_lines
- נצברו
--host_conlyopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc במהלך הידור קובצי המקור של C עבור כלי מארח.
תגים:action_command_lines
,affects_outputs
- נצברו
--host_copt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-cc עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_cpu=<a string>
: "" -
המעבד (CPU) המארח.
תגים:changes_inputs
,affects_outputs
- נצברו
--host_cxxopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-cc עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_force_python=<PY2 or PY3>
: תיאור -
עוקפת את הגרסה ב-Python של תצורת המארח. יכול להיות "PY2" או "PY3".
תגים:loading_and_analysis
,affects_outputs
- נצברו
--host_linkopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc בעת קישור כלים למארח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת macOS תואמת מינימלית ליעדים של מארח. אם לא צוין, נעשה שימוש ב-'macos_sdk_version'.
תגים:loses_incremental_state
- נצברו
--host_swiftcopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-swiftc עבור כלים למארחים.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--[no]incompatible_avoid_conflict_dlls
: "true" -
אם אפשרות זו מופעלת, כל הספריות המקושרות מסוג C++ (DLL) שנוצרו על ידי cc_library ב-Windows יעברו שינוי שם ל-name_{Hash}.dll, שם הגיבוב מחושב על סמך ה-RepositoryName ונתיב החבילה DLL'. האפשרות הזו שימושית כשיש חבילה אחת שתלויה בכמה cc_library עם אותו שם (לדוגמה //foo/bar1:utils ו-//foo/bar2:utils).
תגים:loading_and_analysis
,affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_merge_genfiles_directory
: "true" -
אם המדיניות מוגדרת כ-True, ספריית הגנרטורים מקופלת בספריית bin.
תגים:affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_use_platforms_repo_for_constraints
: "true" -
אם הערך מקבל את הערך True, הגדרות אילוץ של @bazel_tools יוסרו.
תגים:affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]instrument_test_targets
: "false" -
כשהאפשרות 'כיסוי' מופעלת, המדיניות הזו קובעת אם לשקול כללים להגדרת אינסטרומנטציה. במהלך ההגדרה, המערכת מוסיפה אמצעי בדיקה שכוללים --instrumentation_filter. אחרת, כללי הבדיקה תמיד לא ייכללו באינסטרומנטציה של הכיסוי.
תגים:affects_outputs
- ברירת מחדל
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-/Javatests[/:],-/test/Java[/:]" -
אם מפעילים את הכיסוי, המערכת מחילה רק כללים שהשמות שלהם נכללים במסנן שצוין לפי ביטוי רגולרי. כללים עם קידומת '-' אינם נכללים במקום זאת. לתשומת ליבכם: רק כללים שאינם בדיקות נמשכים לאינדקס, אלא אם מפעילים את --instrument_test_targets.
תגים:affects_outputs
- ברירת מחדל של
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסה מינימלית של iOS שתואמת לסימולטורים ולסימולטורים מבוססי יעד. אם לא צוין, נעשה שימוש ב-'ios_sdk_version'.
תגים:loses_incremental_state
- נצברו
--ios_multi_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה מופרדת בפסיקים של ארכיטקטורה שאפשר לבנות באמצעותה ios_application. התוצאה היא קובץ בינארי אוניברסלי המכיל את כל הארכיטקטורה שצוינה.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--[no]legacy_whole_archive
: "true" -
הוצאה משימוש, הוחלפה על ידי --incompatible_remove_Legacy_whole_archive (לפרטים נוספים: https://github.com/bazelbuild/bazel/issues/7362). במצב מופעל, יש להשתמש ב-allall-archive כדי להשתמש בכללים של cc_binary שיש להם linkshared=True וב-linkstatic=True או '-static' ב-linkopts. הערך הזה מיועד לתאימות לאחור בלבד. במקום זאת, עדיף להשתמש תמיד ב-linklink=1, היכן שנדרש.
תגים:action_command_lines
,affects_outputs
,deprecated
- נצברו
--linkopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc בזמן הקישור.
תגים:action_command_lines
,affects_outputs
- נצברו
--ltobackendopt=<a string>
שימושים מרובים -
אפשרות נוספת למעבר לשלב הקצה העורפי של LTO (בקטע --features=thin_lto).
תגים:action_command_lines
,affects_outputs
- נצברו
--ltoindexopt=<a string>
שימושים מרובים -
אפשרות נוספת למעבר לשלב ההוספה לאינדקס של LTO (בקטע --features=thin_lto).
תגים:action_command_lines
,affects_outputs
- נצברו
--macos_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה של ארכיטקטורה שמופרדת בפסיקים שבשבילה צריך ליצור קבצים בינאריים של Apple macOS.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת macOS תואמת מינימלית ליעדים. אם לא צוין, נעשה שימוש ב-'macos_sdk_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--[no]objc_debug_with_GLIBCXX
: "false" -
אם המדיניות מוגדרת, ומצב העריכה מוגדר כך: 'dbg', GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC ו-GLIBCPP_CONCEPT_CHECKS.
תגים:action_command_lines
- ברירת מחדל של
--[no]objc_enable_binary_stripping
: "false" -
האם לבצע רצועות של סימנים וקוד לא פעיל בבינאריים מקושרים. אם בוחרים את הסימון הזה וגם את הסימון 'compilation_mode=opt', המערכת תסיר מחרוזות בינאריות.
תגים:action_command_lines
- נצברו
--objccopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-cc במהלך הידור קובצי המקור 'יעד-C/C++'.
תגים:action_command_lines
- נצברו
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
שימושים מרובים -
אפשרויות נוספות להעברה סלקטיבית ל-cc כשעורכים קבצים מסוימים. ניתן להעביר את האפשרות הזו כמה פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. המונח regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (יש לעיין גם ב-(instrumentation_filter). האפשרות_1 עד Option_n מתייחסת לאפשרויות שרירותיות של שורות פקודה. אם אפשרות מכילה פסיק, צריך לצטט לוכסן הפוך. האפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --for
תגים:action_command_lines
,affects_outputs
- נצברו
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
שימושים מרובים - אפשרויות נוספות להעברה סלקטיבית לקצה העורפי של LTO (בקטע --features=thin_lto) כשעורכים אובייקטים בקצה העורפי. ניתן להעביר את האפשרות הזו כמה פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. כאשר regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים, Option_1 עד Option_n מתייחסת לאפשרויות שרירותיות של שורות פקודה. אם אפשרות מכילה פסיק, צריך לצטט לוכסן הפוך. האפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --per
- ברירת מחדל של
--platform_suffix=<a string>
: תיאור -
קביעת סיומת שתתווסף לספריית התצורה.
תגים:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ברירת מחדל של
--propeller_optimize=<a build target label>
: תיאור -
יש להשתמש בפרטי פרופיל ה-Proproler כדי לבצע אופטימיזציה של יעד ה-build.פרופיל דו-שיח חייב להכיל לפחות אחד משני קבצים, פרופיל ב-cc ופרופיל ישן. הדגל הזה מקבל תווית build שחייבת להפנות לקובצי הקלט של פרופיל המדחף. לדוגמה, קובץ ה-BUILD שמגדיר את התווית, ב-a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) הוראה יכולה להיות זמינה כדי להוסיף את הקבצים הבאים יש להשתמש באפשרות הזו באופן הבא: --propeller_optimize=//a/b:propeller_profile
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--propeller_optimize_absolute_cc_profile=<a string>
: תיאור -
שם הנתיב המוחלט של קובץ cc_profile עבור גרסאות build שעברו אופטימיזציה של Profeler.
תגים:affects_outputs
- ברירת מחדל של
--propeller_optimize_absolute_ld_profile=<a string>
: תיאור -
שם הנתיב המוחלט של קובץ ld_profile עבור גרסאות build שעברו אופטימיזציה ל-Propleler.
תגים:affects_outputs
- ברירת מחדל של
--run_under=<a prefix in front of command>
: תיאור -
קידומת שצריך להוסיף לפני קובצי ההפעלה עבור הפקודות 'test' &'run' אם הערך הוא 'foo -bar' ושורת הפקודה היא 'test_binary -baz' , שורת הפקודה הסופית היא 'foo -bar test_binary -baz'. . היא יכולה להיות גם תווית ליעד הפעלה. לדוגמה: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target', '//package:target #
תגים:action_command_lines
-
אם True, ספריות מקוריות שמכילות פונקציונליות זהה ישותפו בין היעדים השונים
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--[no]stamp
: "false" -
פריטים בינאריים בחותמת עם התאריך, שם המשתמש, שם המארח, פרטי סביבת העבודה וכו'
תגים:affects_outputs
- ברירת מחדל של
--strip=<always, sometimes or never>
: "sometimes" -
ההגדרה קובעת אם להסיר בינאריים וספריות משותפות (באמצעות "-Wl,--strip-debug"). ערך ברירת המחדל של 'sometimes' פירושו רצועת אם if- --compilation_mode=fastbuild.
תגים:affects_outputs
- נצברו
--stripopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה כאשר יוצרים קובץ בינארי של '<name>.stripped'
תגים:action_command_lines
,affects_outputs
- נצברו
--swiftcopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה לאוסף של Swift.
תגים:action_command_lines
- נצברו
--tvos_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה של ארכיטקטורה שמופרדת בפסיקים שבשבילה צריך לבנות קבצים בינאריים של Apple TV.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת ה-TVOS תואמת מינימלית לסימולטורים וליעדים של היעד. אם לא צוין, נעשה שימוש ב-'tvos_sdk_version'.
תגים:loses_incremental_state
- נצברו
--watchos_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה של ארכיטקטורה המופרדת בפסיקים שבשבילה לבנות קבצים בינאריים של AppleOS.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסה מינימלית של WatchOS תואמת לסימולטורים ולסימולטורים מבוססי יעד. אם לא צוין, נעשה שימוש ב-'watchos_sdk_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--xbinary_fdo=<a build target label>
: תיאור -
יש לך אפשרות להשתמש בפרטי הפרופיל ב-XbinaryFDO כדי לבצע אופטימיזציה של האוסף. קביעת השם של פרופיל בינארי כברירת מחדל. אם משתמשים באפשרות הזו יחד עם --fdo_instrument/--fdo_optimize/--fdo_profile, האפשרויות האלה תמיד יקבלו את הערך כאילו xbinary_fdo לא צוין.
תגים:affects_outputs
- אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
- ברירת מחדל של
--auto_cpu_environment_group=<a build target label>
: "" -
מציינים את המאפייןEnvironment_group [קבוצת_סביבה] שישמש למיפוי אוטומטי של ערכי pu לערכי target_environment.
תגים:changes_inputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]check_licenses
: "false" -
צריך לוודא שמגבלות הרישוי שנקבעות על ידי חבילות תלויות לא מתנגשות עם מצבי ההפצה של היעדים שאתם יוצרים. כברירת מחדל, הרישיונות לא נבדקים.
תגים:build_file_semantics
- ברירת מחדל של
--[no]check_visibility
: "true" -
אם המדיניות מושבתת, שגיאות חשיפה בתלויות יעד יורדו לאזהרות.
תגים:build_file_semantics
- ברירת מחדל של
--[no]desugar_for_android
: "true" -
האם לבצע פענוח קוד בייט 8 של סוכר לפני פענוח הקוד?
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]desugar_java8_libs
: "false" -
האם לכלול ספריות Java 8 נתמכות באפליקציות למכשירים מדור קודם.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--[no]enforce_constraints
: "true" -
לבדוק את הסביבות שבהן כל יעד תואם, ומדווח על שגיאות אם לכל יעד יש יחסי תלות שלא תומכים באותן סביבות
תגים:build_file_semantics
- ברירת מחדל של
--[no]experimental_allow_android_library_deps_without_srcs
: "false" -
סימון כדי לעזור במעבר מהמדיניות של אי-אפשר להשתמש בכללי android_library ללא כינויים באמצעות נקודות שפל. יש לנקות את המאגר כדי שההוצאה תתבצע כברירת מחדל.
תגים:eagerness_to_exit
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_check_desugar_deps
: "true" -
האם כדאי לבדוק שוב את ניפוי הבאגים הנכון ברמה הבינארית של Android.
תגים:eagerness_to_exit
,loading_and_analysis
,experimental
- ברירת מחדל של
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
כשהאפשרות מופעלת, בודקים אם התלות של aar_import הסתיימו. האכיפה הזו עלולה לפרוץ את הבנייה, או להוביל רק לאזהרות.
תגים:loading_and_analysis
- ברירת מחדל של
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "default" -
אם הערך הוא true, המערכת בודקת שיעד של Java מצהיר במפורש על כל היעדים שנעשה בהם שימוש ישיר כתלויות.
תגים:build_file_semantics
,eagerness_to_exit
- ברירת מחדל של
--[no]incompatible_check_testonly_for_output_files
: "false" -
אם האפשרות הזו מופעלת, יש לבדוק רק את היעדים הנדרשים שהם קובצי פלט, על ידי חיפוש הבדיקה בלבד של כלל היצירה. ההגדרה הזו תואמת לבדיקת הניראות.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_disable_native_android_rules
: "false" -
אם המדיניות מופעלת, השימוש הישיר בכללי Android המקוריים מושבת. יש להשתמש בכללי Starlark ל-Android בכתובת https://github.com/bazelbuild/rules_android
תגים:eagerness_to_exit
,incompatible_change
- ברירת מחדל של
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
לא צריך להשתמש בהגדרה הזו. אפשר לשמור כאן לצורך תאימות לאחור.
תגים:eagerness_to_exit
,incompatible_change
- ברירת מחדל של
--[no]incompatible_force_strict_header_check_from_starlark
: "true" -
אם האפשרות מופעלת, ניתן להגדיר בדיקת כותרות מחמירה ב-Starlark API
תגים:loading_and_analysis
,changes_inputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
אם הדבר נכון, Bazel תוודא גם שההכללה של הספרייה היא ברמה העליונה (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/10047).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]strict_filesets
: "false" -
אם האפשרות הזו מופעלת, קבצים שחוצים את גבולות החבילה מדווחים כשגיאות. הוא לא פועל כאשר Check_fileset_dependencies_recursively מושבת.
תגים:build_file_semantics
,eagerness_to_exit
- ברירת מחדל של
--strict_proto_deps=<off, warn, error, strict or default>
: "error" -
אלא אם האפשרות מושבתת, המערכת בודקת שיעד Proto_library מצהיר באופן מפורש על כל היעדים שנעשה בהם שימוש ישיר כתלויות.
תגים:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ברירת מחדל של
--strict_public_imports=<off, warn, error, strict or default>
: "off" -
אלא אם האפשרות מושבתת, המערכת בודקת שיעד Proto_library מצהיר באופן מפורש על כל היעדים שנעשה בהם שימוש ב 'ייבוא ציבורי'.
תגים:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ברירת מחדל של
--[no]strict_system_includes
: "false" -
אם הערך הוא True, צריך להצהיר גם על כותרות שנמצאות דרך נתיבים (-isystem).
תגים:loading_and_analysis
,eagerness_to_exit
- נצברו
--target_environment=<a build target label>
שימושים מרובים -
מצהירה על סביבת היעד הזו. הערך חייב להיות תווית של כלל "enrinoment" אם צוין, כל היעדים ברמה העליונה חייבים להתאים לסביבה הזו.
תגים:changes_inputs
- אפשרויות שמשפיעות על הפלט של החתימה של גרסת build:
- ברירת מחדל של
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
הטמעה שתשמש לחתימה על חבילות APK
תגים:action_command_lines
,affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]device_debug_entitlements
: "true" -
אם המדיניות מוגדרת ומצב האוסף לא 'opt' אפליקציות objc יכללו הרשאות לניפוי באגים בזמן החתימה.
תגים:changes_inputs
- ברירת מחדל של
--ios_signing_cert_name=<a string>
: תיאור -
שם האישור לשימוש בחתימת iOS. אם המדיניות לא מוגדרת, תוחזר לפרופיל ניהול התצורה. יכול להיות העדפת הזהות של אישור המפתח או מחרוזת המשנה של השם הנפוץ באישור, בהתאם לדף האדם של ה-Codesign ' (מפתח רישום).
תגים:action_command_lines
- האפשרות הזו משפיעה על סמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו בקובצי BUILD, קובצי .bzl או קובצי WORKSPACE.:
- ברירת מחדל של
--[no]incompatible_disallow_legacy_py_provider
: "true" -
לא, המערכת תסיר אותה בקרוב.
תגים:loading_and_analysis
,incompatible_change
- אפשרויות שקובעות את אופן הפעולה של סביבת הבדיקה או של אופרטור הבדיקה:
- ברירת מחדל של
--[no]allow_analysis_failures
: "false" -
אם הערך מקבל את הערך 'true', כשל בניתוח של יעד הוא מפיץ את המופע של target&ailureInfo המכיל את תיאור השגיאה, במקום לגרום לכשל ב-build.
תגים:loading_and_analysis
,experimental
- ברירת מחדל של
--analysis_testing_deps_limit=<an integer>
: "2000" -
מגדיר את המספר המקסימלי של יחסי תלות זמניים באמצעות מאפיין של כלל עם מעבר לתצורה for_analysis_testing. חריגה מהמגבלה תגרום לשגיאה בכלל.
תגים:loading_and_analysis
- ברירת מחדל של
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
אם כשלים אמיתיים בפעולת dex2oat יגרמו לקריסה של המודל במקום לבצע Dex2oat בזמן ריצה של הבדיקה.
תגים:loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_android_use_parallel_dex2oat
: "false" -
משתמשים ב-dex2oat במקביל כדי להאיץ את android_test.
תגים:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- ברירת מחדל של
--[no]ios_memleaks
: "false" -
הפעלה של בדיקת דליפות זיכרון ביעדי ios_test.
תגים:action_command_lines
- ברירת מחדל של
--ios_simulator_device=<a string>
: תיאור -
המכשיר להדמיית הפעלה של אפליקציה ל-iOS בסימולטור, לדוגמה 'iPhone 6'. ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים:test_runner
- ברירת מחדל של
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת ה-iOS שצריך להפעיל בסימולטור בזמן ההפעלה או הבדיקה. המערכת תתעלם מהמדיניות הזו עבור כללי ios_test אם מכשיר היעד צוין בכלל.
תגים:test_runner
- נצברו
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
שימושים מרובים - ההגדרה קובעת את מספר הפעמים שיש להריץ כל בדיקה. אם אחד מהניסיונות נכשל מסיבה כלשהי, הבדיקה כולה תיחשב כושלת. בדרך כלל, הערך שצוין הוא מספר שלם בלבד. דוגמה: -runs_per_test=3 יפעיל את כל הבדיקות 3 פעמים. תחביר חלופי: regex_filter@runs_per_test. כאשר Run_per_test הוא ערך של מספר שלם ו-regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (ראו גם --instrumentation_filter). דוגמה: --runs_per_test=//foo/.*,-//foo/bar/.*@3 מריץ את כל הבדיקות ב-//foo/ אבל לא מתחת ל-foo/bar שלוש פעמים. ניתן להעביר את האפשרות הזו כמה פעמים. הארגומנט האחרון שהועבר תואם לעדיפות. אם אין תוצאות תואמות, הבדיקה תופעל פעם אחת בלבד.
- נצברו
--test_env=<a 'name=value' assignment with an optional value part>
שימושים מרובים -
ההגדרה קובעת משתני סביבה נוספים שיוחדרו לסביבת הרצה של הבדיקה. אפשר לציין משתנים לפי שם. במקרה כזה, הערך שלהם ייקרא מסביבת הלקוח ב-Bazel או באמצעות צמד name=value. אפשר להשתמש באפשרות הזו כמה פעמים כדי לציין כמה משתנים. בשימוש רק באמצעות הפקודה 'bazel' .
תגים:test_runner
- ברירת מחדל של
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - כדאי לשנות את ערכי ברירת המחדל של הזמן הקצוב לתפוגה של בדיקות (בדקות) אם יצוין ערך חיובי אחד שלם, הוא יחליף את כל הקטגוריות. אם ציינתם 4 מספרים שלמים המופרדים בפסיקים, הם יחליפו את הזמן הקצוב לתפוגה עבור קצר, בינוני, ארוך ותמידי (בסדר הזה). בכל אחד מהפורמטים, הערך 1- מורה ל-blaze להשתמש בברירות המחדל של הזמן הקצוב לתפוגה עבור קטגוריה זו.
- ברירת מחדל של
--tvos_simulator_device=<a string>
: תיאור -
המכשיר להדמיית הפעלה של אפליקציית tvOS בסימולטור, למשל 'Apple TV 1080p' ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים:test_runner
- ברירת מחדל של
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת ה-tvOS שפועלת בסימולטור בזמן הפעלה או בדיקה.
תגים:test_runner
- ברירת מחדל של
--watchos_simulator_device=<a string>
: תיאור -
המכשיר להדמיית הפעלה של אפליקציית WatchOS בסימולטור, למשל 'Apple Watch – 38mm' ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים:test_runner
- ברירת מחדל של
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת ה-watchOS שמופעלת בסימולטור כשמריצים או בודקים.
תגים:test_runner
- ברירת מחדל של
--[no]zip_undeclared_test_outputs
: "true" -
אם הערך הוא True, פלט של בדיקות לא מוצהרות יועברו לארכיון בקובץ ZIP.
תגים:test_runner
- אפשרויות הקשורות לפלט שאילתות וסמנטיקה:
- ברירת מחדל של
--aspect_deps=<off, conservative or precise>
: "conservative" -
איך לפתור בעיה של יחסי גובה-רוחב כאשר פורמט הפלט הוא בפורמט {xml,proto,record}. 'off' פירוש הדבר שלא נפתרים יחסי תלות ו'שמרני' (ברירת המחדל) מוסיפים את כל יחסי הגובה-רוחב המוצהרים, בין אם הם קיבלו את רמת התלויות הישירות ובין אם לא. חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, כך שהוא איטי יותר מהמצבים האחרים. כמו כן, אפילו מצב מדויק אינו מדויק לחלוטין: ההחלטה אם לחשב היבט מסוים נקבעת בשלב הניתוח, שאינו פועל במהלך &b3Query;'
תגים:build_file_semantics
- ברירת מחדל של
--[no]deduplicate_depsets
: "true" -
אפשר לבטל כפילויות של ילדים ללא עצים ב-dep_set_of_files בפלט הסופי (toto/textproto/json). הפעולה הזו לא מבטלת כפילויות של דיוורים שאינם משותפים הורה מיידי. המדיניות הזו לא משפיעה על הרשימה הסופית בפועל של פריטי מידע שנוצרו בתהליך פיתוח (Artifact) של הפעולות.
תגים:terminal_output
- ברירת מחדל של
--[no]graph:factored
: "true" -
אם הערך הוא True, התרשים ייקרא 'fact האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים:terminal_output
- ברירת מחדל של
--graph:node_limit=<an integer>
: "512" -
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; הערך 1- יגרום לכך שלא ייחתך. האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים:terminal_output
- ברירת מחדל של
--[no]implicit_deps
: "true" -
אם האפשרות הזאת מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלות שבו השאילתה פועלת. תלות משתמעת היא זו שלא צוינה במפורש בקובץ BUILD, אך נוספה על ידי ה-bazel. עבור שאילתה, אפשרות זו שולטת בסינון ערכות כלים שנפתרו.
תגים:build_file_semantics
- ברירת מחדל של
--[no]include_artifacts
: "true" -
כולל שמות של קלט ופלט של הפלט (גדול בפוטנציאל).
תגים:terminal_output
- ברירת מחדל של
--[no]include_aspects
: "true" -
aquery, שאילתה: האם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: no-op (מאפיינים תמיד במעקב).
תגים:terminal_output
- ברירת מחדל של
--[no]include_commandline
: "true" -
כולל את התוכן של שורות הפקודות לביצוע בפלט (גדול בפוטנציאל).
תגים:terminal_output
- ברירת מחדל של
--[no]include_file_write_contents
: "false" -
יש לכלול את תוכן הקובץ עבור הפעולות FileWrite ו-SourceSymlinkManifest (גדול בפוטנציאל).
תגים:terminal_output
- ברירת מחדל של
--[no]include_param_files
: "false" -
יש לכלול את התוכן של קובצי הפרמטרים שנעשה בהם שימוש בפקודה (פוטנציאליים). הערה: כשמפעילים את התכונה הזו, הסימון 'include_commandline' יופעל באופן אוטומטי.
תגים:terminal_output
- ברירת מחדל של
--[no]incompatible_display_source_file_location
: "true" -
True, כברירת מחדל, יוצג היעד של קובץ המקור. אם True, מציג את המיקום של שורה 1 של קובצי מקור בפלטי מיקום. הסימון הזה קיים רק למטרות העברה.
תגים:terminal_output
,incompatible_change
- ברירת מחדל של
--[no]incompatible_package_group_includes_double_slash
: "true" -
אם האפשרות הזו מופעלת, בעת הפקת המאפיין 'packs' של package_group&, הסימן '//' הראשי לא יושמט.
תגים:terminal_output
,incompatible_change
- ברירת מחדל של
--[no]infer_universe_scope
: "false" -
אם המדיניות set ו- לתשומת ליבכם, הערך של uniuni_scope כפי שהוסק עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, allalleps) הוא לא מה שאתם רוצים, לכן עליכם להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים ודוגמאות זמינים בכתובת https://bazel.build/reference/query#sky-query. אם --univers_scope מוגדר, המערכת מתעלמת מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'שאילתה' (כלומר, לא 'cquery').
תגים:loading_and_analysis
- ברירת מחדל של
--[no]line_terminator_null
: "false" -
אם כל פורמט יסתיים ב-\0 במקום בפורמט חדש.
תגים:terminal_output
- ברירת מחדל של
--[no]nodep_deps
: "true" -
אם המדיניות מופעלת, נקודות שפל מתוך "nodep" ייכללו בתרשים התלות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep". היא "visible". מריצים ומנתחים את הפלט של 'info Build-language' כדי ללמוד על כל המאפיינים "nodep"בשפת ה-build.
תגים:build_file_semantics
- ברירת מחדל של
--output=<a string>
: "text" -
הפורמט שבו יש להדפיס את תוצאות השאילתה. הערכים המותרים ל-query הם: text, textproto, Proto, jsonproto.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:default_values
: "true" -
אם מוגדר כ-True, נכללים מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- --פלט=פרוטו
תגים:terminal_output
- ברירת מחדל של
--[no]proto:definition_stack
: "false" -
מאכלס את השדה Proto-stack, שמתעד כל מופע של כלל ה-Starstark שבו מוגדרת המחלקה בכלל.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:flatten_selects
: "true" -
אם המדיניות מופעלת, מאפיינים ניתנים להגדרה שנוצרו על ידי Select() שטוחים. עבור סוגי רשימות, הייצוג השטוח הוא רשימה המכילה כל ערך של המפה שנבחרה פעם אחת בלבד. סוגי הפיגועים שטוחים איזה null.
תגים:build_file_semantics
- ברירת מחדל של
--[no]proto:include_synthetic_attribute_hash
: "false" -
אם רוצים לחשב ולאכלס את המאפיין $internal_attr_Hash.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:instantiation_stack
: "false" -
אכלוס מחסנית קריאות של כל הנחיה. כדי לעשות זאת, יש צורך במקבץ סטאק
תגים:terminal_output
- ברירת מחדל של
--[no]proto:locations
: "true" -
אם בכלל, כדאי לשלוח פרטי מיקום בפלט אב.
תגים:terminal_output
- ברירת מחדל של
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
רשימת מאפיינים המופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להוציא פלט. האפשרות הזו רלוונטית ל--פלט=פרוטו.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:rule_inputs_and_outputs
: "true" -
אפשר גם לאכלס את השדותכללי_קלט וכלל_פלט.
תגים:terminal_output
- ברירת מחדל של
--[no]relative_locations
: "false" -
אם הערך הוא TRUE, המיקום של קובצי BUILD ב-XML ובפלטי אב יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא יהיה עקבי בין מחשבים. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במכשירים שונים.
תגים:terminal_output
- ברירת מחדל של
--[no]skyframe_state
: "false" -
ללא צורך בניתוח נוסף, שולחים את תרשים הפעולה הנוכחי מ-Skyframe. הערה: ציון היעד באמצעות --skyframe_state אינו נתמך כרגע. הסימון הזה זמין רק באמצעות
תגים:terminal_output
- ברירת מחדל של
--[no]tool_deps
: "true" -
שאילתה: אם היא מושבתת, יחסי תלות ב-'מארח הגדרה' או 'execution' יעדים לא ייכללו בתרשים התלות שעליו פועלת השאילתה. קצה 'הגדרת תצורה למארחים' כזה מהכלל של #&39;proto_library' מפנה בדרך כלל למהדר הפרוטוקול, בדרך כלל מצביע על כלי שהופעל במהלך ה-build במקום על חלק מאותה תוכנית 'target'
שאילתה: אם היא מושבתת, היא מסננת את כל היעדים שהוגדרו שחוצים מעבר של מארח או ביצוע, מהיעד שהוגדר ברמה העליונה שגילו את היעד שהוגדר. כלומר, אם היעד ברמה העליונה נמצא בתצורת היעד, יוחזרו רק יעדים שהוגדרו בתצורת היעד. אם היעד ברמה העליונה נמצא בתצורת המארח, יוחזרו רק יעדים שהוגדרו על ידי המארח. אפשרות זו לא תכלול שרשראות כלים שנפתרו.
תגים:build_file_semantics
- ברירת מחדל של
--universe_scope=<comma-separated list of options>
: "" -
קבוצה של דפוסי יעד (מופרדים באמצעות פסיקים) המופרדים בפסיקים. השאילתה עשויה להתבצע ביקום שהוגדר על ידי הסגירה העקיפה של היעדים שצוינו. האפשרות הזו משמשת לפקודות השאילתה ושאילתת השאילתה.
עבור השאילתה, הקלט לאפשרות הזו הוא היעדים שבנו כל התשובות, ולכן האפשרות הזו עשויה להשפיע על התצורות והמעברים. אם אפשרות זו אינה מוגדרת, ההנחה היא שהיעדים ברמה העליונה הם היעדים המנותחים מביטוי השאילתה. הערה לגבי שאילתה: אם לא מציינים את האפשרות הזו, ייתכן שה-build לא יפעל אם לא ניתן ליצור יעדים מביטוי השאילתה עם האפשרויות ברמה העליונה.
תגים:loading_and_analysis
- אפשרויות שגורמות לאופטימיזציה של זמן ה-build:
- ברירת מחדל של
--[no]collapse_duplicate_defines
: "false" -
כשהאפשרות מופעלת, ההגדרות המיותרות יוסרו בשלב מוקדם. כדי למנוע אובדן מיותר של מטמון הניתוח לסוגים מסוימים של גרסאות build מקבילות.
תגים:loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
יש לסנן את ProGuard ProgramJar כדי להסיר את כל הכיתות שנמצאות גם ב-LibraryJar.
תגים:action_command_lines
- ברירת מחדל של
--[no]experimental_inmemory_dotd_files
: "true" -
כשהאפשרות מופעלת, קובצי C++ .d יועברו בזיכרון ישירות מצומתי ה-build המרוחק במקום להיכתב לדיסק.
תגים:loading_and_analysis
,execution
,affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_inmemory_jdeps_files
: "true" -
אם האפשרות מופעלת, קובצי התלויות (.jdeps) שנוצרו מהאוספים של Java יועברו בזיכרון ישירות מצומתי ה-build המרוחק במקום להיכתב לדיסק.
תגים:loading_and_analysis
,execution
,affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_objc_include_scanning
: "false" -
האם לבצע סריקה עבור אובייקט C/C+ אובייקטיבי.
תגים:loading_and_analysis
,execution
,changes_inputs
- ברירת מחדל של
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "false" -
אם התכונה parse_headers מופעלת, אם לא קיים מקור באותו שם יעד, היא לא יוצרת פעולת רינדור נפרדת של כותרת.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
כשהאפשרות מופעלת, --trim_test_Configuration לא יקטע את תצורת הבדיקה של כללים שסומנו לבדיקה בלבד=1. כך אנחנו מצמצמים את הבעיות של התנגשות בין פעולות כאשר כללים שאינם בדיקות תלויים בכללים של cc_test. אין השפעה אם --trim_test_ Configuration היא FALSE.
תגים:loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]experimental_starlark_cc_import
: "false" -
אם ההגדרה מופעלת, אפשר להשתמש בגרסת Starlark של cc_import.
תגים:loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
כדי לצמצם את קלט הקלט לאוסף C/C++ , יש לנתח #include שורות מקובצי קלט. כך אפשר לשפר את הביצועים ואת הצבירה על ידי הקטנת הגודל של עצי ההזנה של האוסף. עם זאת, היא עלולה לשבור גרסאות build כי הסורק של כלי העריכה לא מטמיע באופן מלא את הסמנטיקה של מעבד המידע (CPU) לפני העיבוד. באופן ספציפי, הוא לא מבין הוראות #include דינמיות ומתעלם מלוגיקה מותנית של עיבוד מראש. השימוש הוא באחריותך בלבד. כל בעיה הנוגעת לסימון זה ייסגר.
תגים:loading_and_analysis
,execution
,changes_inputs
- ברירת מחדל של
--[no]incremental_dexing
: "true" -
רוב העבודה על דקס נפתחת בנפרד בכל קובץ ב-Jar.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]objc_use_dotd_pruning
: "true" -
אם המדיניות מוגדרת, קובצי .d שנוצרו על ידי ה-Clang ישמשו לגיזום קבוצת הקלט הנכנסת מהדרים objc.
תגים:changes_inputs
,loading_and_analysis
- ברירת מחדל של
--[no]process_headers_in_dependencies
: "false" -
כשיוצרים יעד //a:a, צריך לעבד כותרות בכל היעדים ש//a:a תלויים בהם (אם עיבוד הכותרת מופעל עבור Toolchain).
תגים:execution
- ברירת מחדל של
--[no]trim_test_configuration
: "true" -
כשהאפשרות מופעלת, האפשרויות שקשורות לבדיקה יימחקו מתחת לרמה העליונה של ה-build. כשהסימון הזה פעיל, לא ניתן ליצור בדיקות כתלויות של כללים שאינם בדיקות, אבל שינויים באפשרויות הקשורות לבדיקה לא יגרמו לניתוח מחדש של כללים שאינם בדיקות.
תגים:loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]use_singlejar_apkbuilder
: "true" -
האפשרות הזו הוצאה משימוש. לא חייבים להשתמש בה והיא תוסר בקרוב.
תגים:loading_and_analysis
- אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
הדפסת מידע על תוצאות ניפוי באגים במהלך רזולוציה של הכלי. בסימון נעשה שימוש בביטוי רגולרי, שנבדק ביחס לסוגי כלי עבודה ויעדים ספציפיים, כדי לראות באיזה ניפוי באגים. אפשר להפריד בין ביטויים רגולריים באמצעות ביטויים רגולריים, ולאחר מכן כל ביטוי רגולרי מסומן בנפרד. הערה: הפלט של הדגל הזה מורכב מאוד וככל הנראה יועיל רק למומחים בפתרון בעיות בכלי.
תגים:terminal_output
- אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
- נצברו
--flag_alias=<a 'name=value' flag alias>
שימושים מרובים -
מגדירים שם מקוצר לסימון Starlark. הוא צריך להזין צמד יחיד של מפתח-ערך בפורמט "<key>=<value>" כארגומנט.
תגים:changes_inputs
- ברירת מחדל של
--[no]incompatible_default_to_explicit_init_py
: "false" -
סימון זה משנה את התנהגות ברירת המחדל כך שקובצי __init__.py כבר לא נוצרים באופן אוטומטי בקבצים פועלים של יעדים ב-Python. באופן מדויק, אם יעד py_binary או py_test מוגדר מדור קודם, play_create_init מוגדר ל-"auto" (ברירת המחדל), הוא נחשב כ-false אם רק הסימון הזה מוגדר. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/10076.
תגים:affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
אם הדבר נכון, יעדים שנוצרו בתצורת Python 2 יופיעו בתוך שורש פלט שכולל את הסיומת ' -py2' בעוד שיעדים שנוצרו עבור Python 3 יופיעו בשורש ללא סיומת הקשורה ל-Python. כלומר, סימולציית הנוחות 'bazel-bin' תצביע על יעדים ב-Python 3 ולא על Python 2. אם האפשרות הזו מופעלת, מומלץ להפעיל גם את `--incompatible_py3_is_default`.
תגים:affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_py3_is_default
: "true" -
אם הערך הוא TRUE, היעדים 'py_binary' ו-'py_test' שלא מגדירים את המאפיינים 'python_version' (או 'default_python_version') יוגדרו כברירת מחדל ל-PY3 במקום ל-PY2. אם הדגל הזה מוגדר, מומלץ גם להגדיר את `--incompatible_py2_פלטs_are_suffixed`.
תגים:loading_and_analysis
,affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_use_python_toolchains
: "true" -
אם המדיניות מוגדרת כ-True, כללי ההפעלה של Python יפעלו לפי זמן הריצה של Python שצוין על ידי כלי הכלים של Python, ולא לפי זמן הריצה שנקבע על ידי דגלים מדור קודם כמו --python_top.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--python_version=<PY2 or PY3>
: תיאור -
מצב הגרסה הראשית של Python, 'PY2' או 'PY3'. חשוב לשים לב שמצב זה מבטל את היעדים 'py_binary' ו-'py_test' (גם אם הם לא מציינים במפורש גרסה), כך שאין בדרך כלל סיבה לספק את הדגל הזה.
תגים:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- אפשרויות שונות, ללא סיווג אחר.
--[no]cache_test_results
[-t
] ברירת מחדל: "auto"- אם מוגדר כ-'auto', Bazel מריץ בדיקה מחדש אם ורק: (1) בזל מזהה שינויים בבדיקה או בתלויות שלה, (2) הבדיקה מסומנת כחיצונית, (3) התבקשו מספר ריצות בדיקה עם -runs_per_test או(4) הבדיקה נכשלה בעבר. אם הכתובת היא 'yes' , Bazel שומרת במטמון את כל תוצאות הבדיקה, מלבד בדיקות שסומנו כחיצוניות. אם הכתובת היא 'no', Bazel לא שומרת תוצאות בדיקה.
- ברירת מחדל של
--[no]experimental_cancel_concurrent_tests
: "false" -
True האפשרות הזו שימושית רק בשילוב עם --runs_per_test_detects_flakes.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_fetch_all_coverage_outputs
: "false" -
אם הערך הוא True, מערכת Bazel מאחזרת את כל ספריית נתוני הכיסוי עבור כל בדיקה במהלך תקופת כיסוי.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_generate_llvm_lcov
: "false" -
אם זה יהיה נכון, כיסוי לגבי קלנג ייצור דוח LCOV.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_j2objc_header_map
: "true" - האם ליצור מפת כותרת של J2ObjC במקביל לתעתוק J2ObjC?
- ברירת מחדל של
--[no]experimental_j2objc_shorter_header_path
: "false" -
אם צריך ליצור עם נתיב כותרת קצר יותר (משתמשים ב-"_ios" במקום "_j2objc").
תגים:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
כברירת מחדל: "Javabuilder"- הפעלת ערכי נתיב מופחתים לאוספים של Java.
- ברירת מחדל של
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
מגבילים --experimental_run_android_lint_on_Java_rules לספריות תואמות ל-Android.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_run_android_lint_on_java_rules
: "false" -
האם לאמת את מקורות Java_*?
תגים:affects_outputs
- ברירת מחדל של
--[no]explicit_java_test_deps
: "false" - יש לציין באופן מפורש את התלות ב-JUnit או Hacrest ב-Java_test במקום לקבל בטעות נקודות דירוג מ-TestRunner'. בשלב זה מתאים לשימוש ב-Bazall.
- ברירת מחדל של
--host_java_launcher=<a build target label>
: תיאור - מרכז האפליקציות של Java שמשמש את הכלים להפעלה במהלך build.
- נצברו
--host_javacopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-Java בעת יצירת כלים המופעלים במהלך build.
- נצברו
--host_jvmopt=<a string>
שימושים מרובים - אפשרויות נוספות למעבר ל-Java VM במהלך בניית כלים שמופעלים במהלך ה-build. האפשרויות האלה יתווספו לאפשרויות ההפעלה של VM בכל יעד Java_binary.
- ברירת מחדל של
--[no]incompatible_exclusive_test_sandboxed
: "false" -
אם הערך הוא נכון, יופעלו בדיקות בלעדיות עם שיטת בידינג בארגז חול. מוסיפים תג 'local' כדי לאלץ הרצת בדיקה בלעדית באופן מקומי
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_strict_action_env
: "false" -
אם הערך true, Bazel משתמשת בסביבה עם ערך סטטי של Path ולא יורשת את LD_LIBRARI_Path. משתמשים בפונקציה --action_env=ENV_VARIABLE אם רוצים לרשת בירושה משתני סביבה ספציפיים מהלקוח, אך חשוב לזכור שפעולה זו יכולה למנוע שמירה במטמון של משתמשים שונים אם נעשה שימוש במטמון משותף.
תגים:loading_and_analysis
,incompatible_change
- נצברו
--j2objc_translation_flags=<comma-separated list of options>
שימושים מרובים - אפשרויות נוספות למעבר לכלי J2ObjC.
--java_debug
-
המכונה הווירטואלית של Java בבדיקת Java ממתינה לחיבור לכלי ניפוי באגים התואם ל-JDWP (כגון jdb) לפני התחלת הבדיקה. משתמע -test_פלט=שידור.
הרחבה אל:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ברירת מחדל של
--[no]java_deps
: "true" - יצירת פרטי תלות (כרגע, סוג ה-path של זמן הביצוע) לכל יעד Java.
- ברירת מחדל של
--[no]java_header_compilation
: "true" - להיעזר באיג'רים ישירות מהמקור.
- ברירת מחדל של
--java_language_version=<a string>
: "8" - גרסת השפה ב-Java
- ברירת מחדל של
--java_launcher=<a build target label>
: תיאור - מרכז האפליקציות של Java לשימוש כשיוצרים קבצים בינאריים של Java. אם הדגל הזה מוגדר כמחרוזת ריקה, המערכת תשתמש במפעיל JDK. המאפיין "מרכז האפליקציות" מבטל את הסימון הזה.
- ברירת מחדל של
--java_runtime_version=<a string>
: "local_jdk" - גרסת זמן הריצה של Java
- נצברו
--javacopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-Java.
- נצברו
--jvmopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-Java VM. האפשרויות האלה יתווספו לאפשרויות ההפעלה של VM בכל יעד Java_binary.
- ברירת מחדל של
--legacy_main_dex_list_generator=<a build target label>
: תיאור - קביעת הקובץ הבינארי שבו יש להשתמש כדי ליצור את רשימת הכיתות שחייבות להיות בשרת ה-proxy הראשי במהלך הידור ה-Multiplexex הקודם.
- נצברו
--plugin=<a build target label>
שימושים מרובים - יישומי פלאגין לשימוש ב-build. פועלים כרגע עם Java_plugins.
- ברירת מחדל של
--proguard_top=<a build target label>
: תיאור - ההגדרה של ProGuard היא הגרסה שבה יש להסיר קוד בינארי של Java.
--proto_compiler=<a build target label>
ברירת מחדל: "@bazel_tools//tools/proto:protoc"-
התווית של המהדר לאבות.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_cc=<a build target label>
: "@bazel_tools//tools/proto:cc_toolchain" -
תווית של Proto_lang_toolchain() שמתארת איך להדר Cto++ Proto
תגים:
affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ברירת מחדל: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
תווית של proto_lang_toolchain() שמתארת איך להדר j2objc Protos
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_java=<a build target label>
: "@bazel_tools//tools/proto:Java_toolchain" -
תווית של proto_lang_toolchain() שמתארת איך להדר פרוטאורה של Java
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_javalite=<a build target label>
: "@bazel_tools//tools/proto:Javalite_toolchain" -
תווית Proto_lang_toolchain() שמתארת איך להדר פרוטומות של JavaLite
תגים:affects_outputs
,loading_and_analysis
- נצברו
--protocopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה אל מהדר הפרוטוקול.
תגים:affects_outputs
- ברירת מחדל של
--[no]runs_per_test_detects_flakes
: "false" - אם הערך מקבל את הערך True, כל פיצול שבו עובר ניסיון ריצה/ניסיון אחד לפחות ולפחות ניסיון ריצה אחד/ניסיון אחד נכשל, מקבל את הסטטוס FLAKY.
- ברירת מחדל של
--shell_executable=<a path>
: תיאור -
נתיב מוחלט להפעלה של קונכיות לשימוש בבזל. אם האפשרות הזו לא מוגדרת, המשתנה של סביבת BAZEL_SH מוגדר בהפעלה הראשונה של Bazel (שמפעילה שרת Bazel), ה-Bazel משתמש באפשרות הזו. אם אף אחד מהם לא מוגדר, Bazel משתמשת בנתיב ברירת מחדל בתוך הקוד בהתאם למערכת ההפעלה שבה היא פועלת (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, כל השאר: /bin/bash). שימו לב שהשימוש במעטפת שלא תואם ל-Bash עלול לגרום לכשל בבנייה או לכשלים בזמן ריצה של הקבצים הבינאריים שנוצרו.
תגים:loading_and_analysis
- נצברו
--test_arg=<a string>
שימושים מרובים - קביעת אפשרויות וארגומנטים נוספים שצריך להעביר לקובץ ההפעלה של הבדיקה. ניתן להשתמש מספר פעמים כדי לציין כמה ארגומנטים. אם יבוצעו כמה בדיקות, כל אחת מהן תקבל ארגומנטים זהים. בשימוש רק באמצעות הפקודה 'bazel' .
- ברירת מחדל של
--test_filter=<a string>
: תיאור - קביעת מסנן להעברת למסגרת הבדיקה. משמש להגבלת הבדיקות. לתשומת ליבכם: אין לכך השפעה על היעדים המובנים.
- ברירת מחדל של
--test_result_expiration=<an integer>
: "-1" - האפשרות הזו הוצאה משימוש ואין לה השפעה.
- ברירת מחדל של
--[no]test_runner_fail_fast
: "false" - אם ההרצה לא תתבצע מהר, אפשר יהיה להריץ אותה. הרצת הבדיקה צריכה להפסיק את הביצוע אחרי הכשל הראשון.
- ברירת מחדל של
--test_sharding_strategy=<explicit or disabled>
: "explicit" - יש לציין את השיטה לפיצול הבדיקה: 'explicit' כדי להשתמש בפיצול רק אם קיים המאפיין 'shard_count' 'disabled' לעולם לא להשתמש בפיצול בדיקה.
- ברירת מחדל של
--tool_java_language_version=<a string>
: "8" - גרסת השפה של Java המשמשת לביצוע הכלים הנחוצים במהלך גרסת ה-build
- ברירת מחדל של
--tool_java_runtime_version=<a string>
: "remotejdk_11" - גרסת זמן הריצה של Java המשמשת לביצוע כלים במהלך ה-build
- ברירת מחדל של
--[no]use_ijars
: "true" - כשהאפשרות הזו מופעלת, הידור ה-Java משתמש בקונטיינרים של ממשק. כתוצאה מכך, האוסף המצטבר יהיה מהיר יותר, אבל הודעות השגיאה עשויות להיות שונות.
אפשרויות Build
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בהפעלה של גרסת build:
- ברירת מחדל של
--[no]check_up_to_date
: "false" -
אין לבצע את ה-build, רק צריך לבדוק אם הוא מעודכן. אם כל היעדים עדכניים, ה-build הושלם בהצלחה. אם צריך לבצע שלב כלשהו, דיווח על שגיאה וה-build ייכשל.
תגים:execution
- ברירת מחדל של
--dynamic_local_execution_delay=<an integer>
: "1000" -
כמה אלפיות שנייה יש לדחות את הביצוע המקומי, אם ההפעלה מרחוק הייתה מהירה יותר במהלך build לפחות פעם אחת?
תגים:execution
,host_machine_resource_optimizations
- נצברו
--dynamic_local_strategy=<a '[name=]value1[,..,valueN]' assignment>
שימושים מרובים -
האסטרטגיות המקומיות, לפי סדר העדיפויות. עובר 'local' כפי שהמנמון מגדיר את ברירת המחדל לנגינה לא מוגדרת. מבצע [mnemonic=]local_strategi[,local_strategi,...]
תגים:execution
,host_machine_resource_optimizations
- נצברו
--dynamic_remote_strategy=<a '[name=]value1[,..,valueN]' assignment>
שימושים מרובים -
האסטרטגיות המרוחקות שיש להשתמש בהן עבור המאפיין הרלוונטי. עובר 'שלט רחוק' כשמֶננה מוגדרת כברירת המחדל לנגינה לא מוגדרת. עובר [mnemonic=]remote_strategi[,remote_strategi,...]
תגים:execution
,host_machine_resource_optimizations
- ברירת מחדל של
--experimental_docker_image=<a string>
: "" -
יש לציין שם של תמונת Docker (למשל "ubuntu:latest") שבו יש להשתמש כדי לבצע פעולה שמתבצעת בארגז חול בעת שימוש בשיטת Docker והפעולה עצמה לא מכילה מאפיין של תמונת מאגר ב-remote_execution_Assets בתיאור הפלטפורמה. הערך של הדגל הזה מועבר מילולית ל-'docker Run' לכן הוא תומך בתחביר ובמנגנונים זהים לאלה של Docker עצמה.
תגים:execution
- ברירת מחדל של
--[no]experimental_docker_use_customized_images
: "true" -
אם האפשרות הזו מופעלת, תהיה לך אפשרות להזריק את המזהה וה-id של המשתמש הנוכחי לתמונה ב-Docker לפני השימוש בה. פעולה זו נדרשת אם ה-build / הבדיקות תלויות במשתמש שיש לו שם וספריית בית בתוך מאגר התגים. פעולה זו מופעלת כברירת מחדל, אך ניתן להשבית אותה אם תכונת ההתאמה האישית האוטומטית של תמונות אינה פועלת במקרה שלך, או אם ידוע לך שאין צורך בה.
תגים:execution
- ברירת מחדל של
--[no]experimental_dynamic_exclude_tools
: "true" -
כשהאפשרות מוגדרת, יעדים שמוגדרים כ- "בכלי&מירכאות; לא כפופים לביצוע דינמי. סביר להניח שיעדים כאלה לא יחושבו באופן מצטבר, ולכן לא כדאי להוציא כסף על מחזורים מקומיים.
תגים:execution
,host_machine_resource_optimizations
- ברירת מחדל של
--experimental_dynamic_local_load_factor=<a double>
: "0" -
לקבוע כמה עומס מביצוע דינמי לביצוע במכונה המקומית. הדגל הזה מתאים את מספר הפעולות בהפעלה דינמית שנתזמן בו-זמנית. הוא מבוסס על מספר המעבדים שמערכת Blaze מחשיבה כזמינים. ניתן לשלוט בהם באמצעות התכונה הניסיונית --local_cpu_resources.
אם הסימון הזה הוא 0, כל הפעולות מתוכננות באופן מקומי. אם > 0, מספר הפעולות המתוזמנות באופן מקומי מוגבל במספר המעבדים הזמינים. אם < 1, גורם הטעינה משמש להפחתת מספר הפעולות המתוזמנות באופן מקומי, כאשר מספר הפעולות הממתינות לתזמון גבוה. כך תפחיתו את העומס על המכונה המקומית במקרים של בנייה נקייה, שבה המכונה המקומית לא תתרום הרבה.
תגים:execution
,host_machine_resource_optimizations
- ברירת מחדל של
--experimental_dynamic_slow_remote_time=<An immutable length of time.>
: "0" -
אם >0, משך הזמן של פעולת הפעלה דינמית חייב להיות מופעל מרחוק בלבד לפני שאנחנו נותנים עדיפות לביצוע מקומי כדי להימנע ממצבי זמן קצוב לתפוגה מרחוק. הדבר עלול לגרום לבעיות מסוימות במערכת ההפעלה מרחוק. אין להפעיל את האפשרות הזו בלי לעקוב אחר בעיות בביצוע מרחוק.
תגים:execution
,host_machine_resource_optimizations
- ברירת מחדל של
--[no]experimental_enable_docker_sandbox
: "false" -
הפעלת ארגז חול מבוסס Docker. לאפשרות הזו אין השפעה אם Docker לא מותקן.
תגים:execution
--experimental_persistent_javac
-
להפעיל את המהדר הניסיוני של Java.
הרחבה של:
--strategy=Javac=worker
--strategy=JavaIjar=local
--strategy=JavaDeployJar=local
--strategy=JavaSourceJar=local
--strategy=Turbine=local
תגים:execution
,host_machine_resource_optimizations
- ברירת מחדל של
--experimental_sandbox_async_tree_delete_idle_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "0" -
אם הערך הוא 0, צריך למחוק את העצים בארגז החול בסיום הפעולה (לגרום לעיכוב בביצוע הפעולה). אם הערך גדול מאפס, יש למחוק את שלושת המאגרים האלה במאגר שרשורים אסינכרוני שגודלו 1 כאשר ה-build פועל, והוא גדל לגודל שצוין בסימון הזה כאשר השרת לא פעיל.
תגים:host_machine_resource_optimizations
,execution
- ברירת מחדל של
--experimental_sandboxfs_path=<a string>
: "sandboxfs" -
הנתיב לבינארי של ארגז החול צריך להיות בשימוש כאשר --experimental_use_sandboxfs נכון. אם השם הבסיסי הוא השם הבינארי הראשון שמופיע בשם הזה בנתיב Path Analytics.
תגים:host_machine_resource_optimizations
,execution
- ברירת מחדל של
--[no]experimental_split_xml_generation
: "true" -
אם הדגל הזה הוגדר ופעולת בדיקה לא יוצרת קובץ Test.xml, Bazel משתמשת בפעולה נפרדת כדי ליצור קובץ דמה מסוג XML.xml שמכיל את יומן הבדיקה. אחרת, Bazel יוצרת test.xml כחלק מפעולת הבדיקה.
תגים:execution
- ברירת מחדל של
--experimental_total_worker_memory_limit_mb=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
: "0" -
אם המגבלה של יותר מעובד אחד שלא תהיה פעילה גבוהה יותר, ייתכן שההרוג של כל העובדים יפוג אם ניצלת את כל הזיכרון.
תגים:execution
,host_machine_resource_optimizations
- ברירת מחדל של
--[no]experimental_use_hermetic_linux_sandbox
: "false" -
אם המדיניות מוגדרת כ-True, אין לטעון את השורש. יש לטעון רק את מה שסופק עם sandbox_add_Mountain_pair. קובצי קלט יקושרו באופן רציף לארגז החול במקום למקושר מארגז החול. אם קובצי הקלט של הפעולה ממוקמים במערכת קבצים שונה מארגז החול, קובצי הקלט יועתקו במקום זאת.
תגים:execution
- ברירת מחדל של
--[no]experimental_use_sandboxfs
: "false" -
משתמשים ב-Sandboxf כדי ליצור את הפעולות' מפעילים ספריות במקום לבנות עץ קישור סימבולי. אם "yes", הקובץ הבינארי שסופק על ידי -experimental_sandboxfs_path חייב להיות חוקי ולהתאים לגרסה נתמכת של sandboxfs. אם "auto", ייתכן שהקובץ הבינארי יהיה חסר או לא תואם.
תגים:host_machine_resource_optimizations
,execution
- ברירת מחדל של
--[no]experimental_use_windows_sandbox
: "false" - שימוש בארגז החול של Windows כדי להריץ פעולות. אם "yes", הקובץ הבינארי שסופק על ידי -experimental_windows_sandbox_path חייב להיות חוקי ולהתאים לגרסה נתמכת של sandboxf. אם "auto", ייתכן שהקובץ הבינארי יהיה חסר או לא תואם.
- ברירת מחדל של
--experimental_windows_sandbox_path=<a string>
: "BazelSandbox.exe" - הנתיב לבינארי של ארגז החול של Windows שיש להשתמש בו ---experimental_use_windows_sandbox נכון. אם השם הבסיסי הוא השם הבינארי הראשון שמופיע בשם הזה בנתיב Path Analytics.
- ברירת מחדל של
--[no]experimental_worker_as_resource
: "false" -
כשהאפשרות מופעלת, העובדים מצרפים משאבים מ-Resource Manager.
תגים:execution
,host_machine_resource_optimizations
- ברירת מחדל של
--[no]experimental_worker_cancellation
: "false" -
אם האפשרות הזו מופעלת, Bazel יכולה לשלוח בקשות ביטול לעובדים שתומכים בהן.
תגים:execution
- ברירת מחדל של
--[no]experimental_worker_multiplex
: "true" -
אם האפשרות הזו מופעלת, עובדים שתומכים בתכונת הכפל הניסיונית ישתמשו בתכונה הזו.
תגים:execution
,host_machine_resource_optimizations
- ברירת מחדל של
--[no]experimental_worker_multiplex_sandboxing
: "false" -
אם האפשרות מופעלת, עובדי Multiplex יועברו לארגז חול באמצעות ספריית ארגז חול נפרדת לכל בקשת עבודה. רק עובדים שיש להם 'supports-multix-sandboxing' דרישה להפעלה בארגז חול.
תגים:execution
- ברירת מחדל של
--[no]experimental_worker_strict_flagfiles
: "false" -
אם המדיניות מופעלת, ארגומנטים של פעולות לעובדים שלא עומדים בדרישות של מפרט העובד יגרמו לשגיאה. בארגומנטים של עובדים חייב להיות ארגומנט @flagfile אחד בלבד בתור הארגומנטים של רשימת הארגומנטים.
תגים:execution
- ברירת מחדל של
--genrule_strategy=<comma-separated list of options>
: "" -
יש לציין כיצד לבצע יצירת כללי. הסימון הזה ייצא משימוש. במקום זאת, אפשר להשתמש ב- --spawn_strategi=<value> כדי לשלוט בכל הפעולות או ב--strategi=Genrule=<value> כדי לשלוט רק בכללים.
תגים:execution
- נצברו
--high_priority_workers=<a string>
שימושים מרובים -
מוניקה של עובדים שרוצים לפעול בעדיפות גבוהה. כאשר עובדים עם עדיפות גבוהה פועלים, כל שאר העובדים מווסתים.
תגים:execution
- ברירת מחדל של
--[no]incompatible_remote_dangling_symlinks
: "true" -
אם המדיניות מוגדרת כ-True ו- --incompatible_remote_symlinks הוא גם נכון, קישורים מסולסלים בפלטי פעולה מורשים להתנתק.
תגים:execution
,incompatible_change
- ברירת מחדל של
--[no]incompatible_remote_symlinks
: "true" -
אם המדיניות מוגדרת כ-TRUE, Bazel תייצג קישורים סימבוליים בפלטי פעולות בפרוטוקול השמירה במטמון/הביצוע מרחוק. אחרת, יתבצע מעקב אחר קישורים סימבוליים ויוצגו כקבצים או כספריות. פרטים נוספים זמינים בדף #6631.
תגים:execution
,incompatible_change
- ברירת מחדל של
--[no]incompatible_sandbox_hermetic_tmp
: "false" -
אם המדיניות מוגדרת כ-True, לכל ארגז חול של Linux תהיה ספרייה ייעודית ריקה שתותקן בתור /tmp ולא לשיתוף עם /tmp עם מערכת הקבצים של המארח. משתמשים ב- --sandbox_add_Mountain_pair=/tmp כדי להמשיך לראות את המארח /t33;s/tmp בכל ארגזי החול.
תגים:execution
- ברירת מחדל של
--[no]internal_spawn_scheduler
: "false" -
אפשרות מציין מיקום כדי שנוכל לדעת ב-Blaze אם מתזמן ההתרעה הופעל.
תגים:execution
,host_machine_resource_optimizations
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] ברירת מחדל: "auto"-
מספר המשימות במקביל. הפרמטר מכיל מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ואחריו אופציונלי (למשל, [-|*]<float>) למשל. "auto", "HOST_CPUS*.5". הערכים צריכים להיות בין 1 ל-5000. ערכים גדולים מ-2,500 עלולים לגרום לבעיות בזיכרון. "auto" מחשב ברירת מחדל סבירה על סמך משאבים למארחים.
תגים:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] ברירת מחדל: "false"-
אפשר להמשיך כמה שיותר אחרי השגיאה. לא ניתן לנתח את היעד שנכשל או את היעד שתלוי בו, אבל יש דרישות מוקדמות נוספות ליעדים האלה.
תגים:eagerness_to_exit
- ברירת מחדל של
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
מספר השרשורים המקבילים שיש להשתמש בהם בשלב הטעינה/הניתוח.נלקחים מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ובדרך כלל מוסיפים פעולה ([-|*]<float>) למשל. "auto", "HOST_CPUS*.5". "auto" מגדיר ברירת מחדל סבירה על סמך משאבים למארחים. הערך חייב להיות לפחות 1.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[no]reuse_sandbox_directories
: "false" -
אם המדיניות מוגדרת כ-True, אפשר להשתמש שוב בספריות שבהן נעשה שימוש בהפעלה לא ב-Sandbox כדי להימנע מעלויות מיותרות להגדרה.
תגים:host_machine_resource_optimizations
,execution
- ברירת מחדל של
--sandbox_base=<a string>
: "" -
מאפשרת ל-Sandbox ליצור את ספריות ארגז החול מתחת לנתיב הזה. אפשר לציין נתיב ב-tmpfs (כמו /run/shm) כדי לשפר את הביצועים לעיתים קרובות כאשר גרסאות build / בדיקות כוללות קובצי קלט רבים. הערה: יש צורך בשטח RAM מספיק ובשטח פנוי בכונן ה-tmpf כדי לשמור פלט וקובצי ביניים שנוצרו על ידי הפעלת פעולות.
תגים:host_machine_resource_optimizations
,execution
- ברירת מחדל של
--[no]sandbox_explicit_pseudoterminal
: "false" -
הפעלה מפורשת של יצירת פסאודומינרליים לפעולות בארגז חול. בהפצה לינארית מסוימת צריך להגדיר את מזהה הקבוצה כ-&339;tty' בתוך ארגז החול כדי שפסאודומטרינים יפעלו. אם זה גורם לבעיות, המערכת יכולה להשבית את הסימון הזה כדי לאפשר שימוש בקבוצות אחרות.
תגים:execution
- נצברו
--sandbox_tmpfs_path=<an absolute path>
שימושים מרובים -
לפעולות בארגז חול, יש להציב ספרייה ריקה וכתיבה בנתיב המוחלט הזה (אם אין תמיכה בהטמעת ארגז החול, יש להתעלם ממנה).
תגים:host_machine_resource_optimizations
,execution
- ברירת מחדל של
--spawn_strategy=<comma-separated list of options>
: "" -
מציינים כברירת מחדל איך יבוצעו פעולות ריבוי. מקבלת רשימת אסטרטגיות המופרדות בפסיקים, מהעדיפות הגבוהה ביותר לנמוכה. עבור כל פעולה, Bazel בוחרת את האסטרטגיה עם העדיפות הגבוהה ביותר שיכולה לבצע את הפעולה. ערך ברירת המחדל הוא "remote,work,sandboxed,local". פרטים נוספים זמינים בכתובת https://blog.bazel.build/2019/06/19/list-strategi.html.
תגים:execution
- נצברו
--strategy=<a '[name=]value1[,..,valueN]' assignment>
שימושים מרובים -
יש לציין איך להפיץ אוסף של פעולות הפקה אחרות. מקבלת רשימת אסטרטגיות המופרדות בפסיקים, מהעדיפות הגבוהה ביותר לנמוכה. עבור כל פעולה, Bazel בוחרת את האסטרטגיה עם העדיפות הגבוהה ביותר שיכולה לבצע את הפעולה. ערך ברירת המחדל הוא "remote,work,sandboxed,local". הדגל הזה מבטל את הערכים שהוגדרו על ידי --spawn_strategi (וכן --genrule_strategi אם משתמשים בהם ב-Genemonic Genrule). פרטים נוספים זמינים בכתובת https://blog.bazel.build/2019/06/19/list-strategi.html.
תגים:execution
- נצברו
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
שימושים מרובים -
כדאי לשנות את שיטת ה-Spמקו. לפרטים על התאמות של ביטוי רגולרי_filter יש לעיין בקטע --per_file_copt. נעשה שימוש ב-regex_filter הראשון שתואם לתיאור. אפשרות זו מבטלת סימונים אחרים לציון אסטרטגיה. דוגמה: --strategi_regexp=//foo.*\.cc,-//foo/bar=local הוא סימן להרצת פעולות באמצעות שיטה מקומית, אם התיאורים שלהן תואמים ל-//foo.*.cc אבל לא ל-//foo/bar. דוגמה: --strategi_regexp='Compiling.*/bar=local --strate יהיו
תגים:execution
- נצברו
--worker_extra_flag=<a 'name=value' assignment>
שימושים מרובים -
התרעות נוספות על פקודות שיועברו לתהליכים של עובדים, בנוסף ל- -persistent_worker, לפי זכרונות (לדוגמה --worker_extra_flag=Javac=--debug.
תגים:execution
,host_machine_resource_optimizations
- נצברו
--worker_max_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
שימושים מרובים -
כמה מופעים של תהליך עבודה (למשל, המהדר הקבוע של Java) יכולים לפעול אם משתמשים בשיטה 'worker' ניתן לציין את הערך [name=value] כדי להקצות ערך שונה לכל עובד. הפרמטר מכיל מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ואחריו אופציונלי (למשל, [-|*]<float>) למשל. "auto", "HOST_CPUS*.5". 'auto' מחשבת ברירת מחדל סבירה בהתאם לקיבולת המכונה. "=value" מגדיר ברירת מחדל לניבים לא מוגדרים.
תגים:execution
,host_machine_resource_optimizations
- נצברו
--worker_max_multiplex_instances=<[name=]value, where value is an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
שימושים מרובים -
כמה בקשות של WorkRequest נדרשות למספר עובדים במקביל, אם משתמשים בשיטת 'worker' עם ניתן לציין את הערך [name=value] כדי להקצות ערך שונה לכל עובד. הפרמטר מכיל מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ואחריו אופציונלי (למשל, [-|*]<float>) למשל. "auto", "HOST_CPUS*.5". 'auto' מחשבת ברירת מחדל סבירה בהתאם לקיבולת המכונה. "=value" מגדיר ברירת מחדל לניבים לא מוגדרים.
תגים:execution
,host_machine_resource_optimizations
- ברירת מחדל של
--[no]worker_quit_after_build
: "false" -
אם ההגדרה מופעלת, כל העובדים מפסיקים לאחר סיום ה-build.
תגים:execution
,host_machine_resource_optimizations
- ברירת מחדל של
--[no]worker_sandboxing
: "false" -
כשהאפשרות מופעלת, העובדים יוצאו לסביבת ארגז חול.
תגים:execution
- ברירת מחדל של
--[no]worker_verbose
: "false" - אם אפשרות זו מופעלת, הדפסה של הודעות מפורט כאשר העובדים מתחילים, נסגרים, ...
- אפשרויות שמגדירות את כלי השירות המשמש לביצוע הפעולה:
- ברירת מחדל של
--[no]incompatible_disable_runtimes_filegroups
: "false" -
אין הוצאה משימוש.
תגים:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- ברירת מחדל של
--[no]incompatible_dont_emit_static_libgcc
: "true" -
אין הוצאה משימוש.
תגים:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- ברירת מחדל של
--[no]incompatible_linkopts_in_user_link_flags
: "true" -
No-op שהוצא משימוש.
תגים:action_command_lines
,loading_and_analysis
,deprecated
,incompatible_change
- אפשרויות ששולטות בפלט של הפקודה:
- ברירת מחדל של
--[no]build
: "true" -
יש לבצע את ההרכב. זו ההתנהגות הרגילה. ציון -nobuild גורם ל-build לעצור לפני ביצוע פעולות ה-build, ומחזיר אפס אם שלבי הטעינה והניתוח של החבילה הושלמו בהצלחה. מצב זה שימושי לבדיקת השלבים האלה.
תגים:execution
,affects_outputs
- ברירת מחדל של
--[no]experimental_run_validations
: "true" -
יש להשתמש במקום זאת --run_validations.
תגים:execution
,affects_outputs
- ברירת מחדל של
--[no]experimental_use_validation_aspect
: "false" -
האם להריץ פעולות אימות באמצעות היבט כלשהו (לשילוב במקביל עם בדיקות)?
תגים:execution
,affects_outputs
- נצברו
--output_groups=<comma-separated list of options>
שימושים מרובים -
רשימה של שמות של קבוצות פלט המופרדים בפסיקים, שלכל אחד מהם יש קידומת + או -. קבוצה שקידומתה מתחילה ב-+ מתווספת לקבוצת ברירת המחדל של קבוצות פלט, ואילו קבוצה עם קידומת - תוסר מקבוצת ברירת המחדל. אם לפחות קבוצה אחת לא כוללת קידומת, המערכת תשמיט את קבוצת ברירת המחדל של קבוצות הפלט. לדוגמה,
תגים:execution
,affects_outputs
- ברירת מחדל של
--[no]run_validations
: "true" -
האם להריץ פעולות אימות כחלק מה-build? פרטים נוספים זמינים בכתובת https://bazel.build/rules/rules#validation_actions
תגים:execution
,affects_outputs
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, וכך להשפיע על הערך שלו, בניגוד לעצם קיומו:
- נצברו
--aspects=<comma-separated list of options>
שימושים מרובים - רשימת היבטים המופרדים בפסיקים, שיחולו על יעדים ברמה העליונה. ברשימה, אם היבט some_aspect מציין ספקי היבט נדרשים דרך additional_aspect_providers, אז ערך some_aspect יפעל לאחר כל היבט שהוזכר לפניו ברשימת ההיבטים שהספקים שלהם מפרסמים שמצייתים לספקי הצד הנדרשים. בנוסף, לרכיב no_aspect תהיה אפשרות להפעיל אחרי כל ההיבטים הנדרשים שצוינו. לאחר מכן, ל-some_aspect תהיה גישה לערכים של אותם היבטים. <bzl-file-label>%<aspect_name>, לדוגמה '//tools:my_def.bzl%my_aspect', כאשר 'my_aspect' הוא ערך ברמה עליונה מכלי קובץ/my_def.bzl
- ברירת מחדל של
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
המספר המקסימלי של קבצים פתוחים מותר במהלך העלאת תוכן של BEP.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_convenience_symlinks
: "normal" -
סימון זה יקבע איך ינוהלו הקישורים הסימבוליים (הסמלים המקבילים שמופיעים בסביבת העבודה אחרי ה-build). ערכים אפשריים:
רגילה (ברירת מחדל): כל סוג של קישור סימולציית נוחות ייווצר או יימחק, כפי שנקבע על ידי ה-build.
נקי: כל הקישורים הסימבוליים יימחקו ללא תנאי.
התעלמות: הקישורים הקטנים נשארים לבד.
log_only: יצירת הודעות יומן כאילו הן #&39;normal' הועברו, אך לא מתבצעות בפועל פעולות של מערכת קבצים (שימושיות לכלים).
לידיעתך, ניתן להשפיע רק על קישורים סימבוליים ששמותיהם נוצרים על ידי הערך הנוכחי, --symlink_prefix. אם הקידומת משתנה, כל קישור קיים קיים יישאר ריק.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_convenience_symlinks_bep_event
: "false" -
הסימון הזה קובע אם נפרסם את אירוע buildConvenienceSymlinksIdentified ל-BuildEventProtocol. אם הערך הוא true, ל-BuildEventProtocol תהיה רשומה עבור consoleSymlinksIdentified, הכוללת את כל קישורי הנוחות שנוצרו בסביבת העבודה שלך. אם הערך הוא FALSE, הרשומה נוחת SymlinksIdentified ב-BuildEventProtocol תהיה ריקה.
תגים:affects_outputs
- נצברו
--experimental_multi_cpu=<comma-separated list of options>
שימושים מרובים -
הוצא משימוש. לא.
תגים:affects_outputs
,experimental
--remote_download_minimal
-
לא תתבצע הורדה של פלטי build מרוחקים אל המכונה המקומית. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=minimal.
הרחבה אל:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=minimal
תגים:affects_outputs
- ברירת מחדל של
--remote_download_outputs=<all, minimal or toplevel>
: "all" -
אם המדיניות מוגדרת כ-'minimal' לא מורידה פלט של build מרחוק אל המכונה המקומית, חוץ מאלה הנדרשות על ידי פעולות מקומיות. אם המדיניות מוגדרת כ-'toplevel' היא פועלת כך'minimal' מלבד זאת, מתבצעת הורדה של פלט של יעדים ברמה העליונה למחשב המקומי. שתי האפשרויות יכולות לקצר משמעותית את זמני הבנייה אם רוחב הפס של הרשת הוא צוואר בקבוק.
תגים:affects_outputs
- ברירת מחדל של
--remote_download_symlink_template=<a string>
: "" -
במקום להוריד פלט של build מרחוק, אפשר ליצור קישורים סימבוליים. ניתן לציין את יעד הקישורים המסמלים בצורת מחרוזת תבנית. מחרוזת התבנית הזו עשויה להכיל {hash} ו-{size_bytes} שמתרחבים לאובייקט ולגודל בבייטים, בהתאמה. הקישורים הסמליים האלה עשויים, למשל, להפנות למערכת קבצים של FUSE שטוענת אובייקטים מ-CAS לפי דרישה.
תגים:affects_outputs
--remote_download_toplevel
-
רק מכונה מקומית יכולה להוריד פלט מרחוק של יעדים ברמה העליונה. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=toplevel.
מתרחב אל:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel
תגים:affects_outputs
- ברירת מחדל של
--symlink_prefix=<a string>
: תיאור -
הקידומת שמצורפת לכל אחד מסמלי הקישור לנוחות שנוצרות אחרי גרסת ה-build. אם לא מופיעה, ערך ברירת המחדל הוא השם של כלי ה-build ואחריו מקף. אם הכתובת '/' מועברת, לא נוצר קישור סימולטני ולא נוצרת אזהרה. אזהרה: הפונקציונליות המיוחדת של '/' תוצא משימוש בקרוב. במקומה יש להשתמש ב- --experimental_convenience_symlinks=ignore.
תגים:affects_outputs
- אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
- ברירת מחדל של
--[no]experimental_docker_privileged
: "false" -
אם האפשרות מופעלת, Bazel תעביר את הסימון 'בעדיפות' ל-'דוקטור בהרצה' בעת הרצת פעולות. יכול להיות שהדרישה הזו תדרוש את גרסת ה-build שלכם, אבל היא גם עלולה לפגוע בהימור.
תגים:execution
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_sandboxfs_map_symlink_targets
: "false" -
אם הערך הוא true, מתבצע מיפוי של היעדים של הקישורים הסמליים שצוינו כקלטים של פעולות בארגז החול. תכונה זו קיימת אך ורק כדי לעקוף כללי באגים שאינם עושים זאת בעצמם. יש להסיר אותה לאחר תיקון כל הכללים.
תגים:host_machine_resource_optimizations
,execution
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- ברירת מחדל של
--[no]incompatible_legacy_local_fallback
: "true" -
אם המדיניות מוגדרת כ-True, המדיניות מאפשרת להשתמש בחלופה המשתמעת מהדור הקודם מארגז החול לשיטה מקומית. בסופו של דבר, הדגל הזה יוגדר כברירת מחדל כ-false ולאחר מכן יוגדר כ'לא-פעילות'. ניתן להשתמש במקום זאת ב---stratety, --spawn_strategi או --Dynamic_local_strategi כדי להגדיר חזרה למצב ראשוני.
תגים:execution
,incompatible_change
- נצברו
--sandbox_add_mount_pair=<a single path or a 'source:target' pair>
שימושים מרובים -
צריך להוסיף זוג נתיבים נוסף כדי לטעון אותו בארגז החול.
תגים:execution
- נצברו
--sandbox_block_path=<a string>
שימושים מרובים -
לפעולות בארגז חול, יש למנוע גישה לנתיב הזה.
תגים:execution
- ברירת מחדל של
--[no]sandbox_default_allow_network
: "true" - הרשאת גישה לרשת כברירת מחדל לפעולות. ייתכן שהיא לא תפעל עם כל ההטמעות של ארגז החול.
- ברירת מחדל של
--[no]sandbox_fake_hostname
: "false" -
אפשר לשנות את שם המארח הנוכחי ל-'localhost' לפעולות בארגז חול.
תגים:execution
- ברירת מחדל של
--[no]sandbox_fake_username
: "false" -
אפשר לשנות את שם המשתמש הנוכחי ל-'nobody' לפעולות בארגז חול.
תגים:execution
- נצברו
--sandbox_writable_path=<a string>
שימושים מרובים -
לפעולות בארגז חול, יש ליצור ספרייה קיימת שניתן לכתוב בארגז החול (אם המערכת תומכת בהטמעה של ארגז החול, המערכת תתעלם ממנה).
תגים:execution
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי .bzl או קובצי WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- ברירת מחדל של
--[no]incompatible_config_setting_private_default_visibility
: "false" -
אם לא תואם_enforce_config_setting_visible=false, זו שגיאה. אחרת, אם הסימון הזה הוא false, כל הגדרת config_ללא מאפיין חשיפה בוטה היא //visible:public. אם הסימון הזה נכון, המאפיין config_setting תואם ללוגיקה של הרשאות הגישה שדומה לכל הכללים האחרים. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12933.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enforce_config_setting_visibility
: "true" -
אם המדיניות מוגדרת כ-True, יש לאכוף את הרשאות הגישה מסוג config_setting. אם הערך הוא False, כל config_setting גלויה לכל יעד. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים:loading_and_analysis
,incompatible_change
- אפשרויות שקובעות את אופן הפעולה של סביבת הבדיקה או של אופרטור הבדיקה:
- ברירת מחדל של
--[no]check_tests_up_to_date
: "false" -
אין להריץ בדיקות. יש לבדוק אם הן מעודכנות. אם כל תוצאות הבדיקות מעודכנות, הבדיקה הושלמה בהצלחה. אם יש צורך לבצע או להפעיל בדיקה כלשהי, מדווחת על שגיאה והבדיקה נכשלה. אם בוחרים באפשרות הזו, פירוש הדבר הוא --check_up_to_date.
תגים:execution
- נצברו
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
שימושים מרובים -
כל בדיקה תבוצע שוב עד למספר הפעמים שהוגדר, במקרה שהבדיקה נכשלה. בדיקות שנדרש בהן יותר מניסיון אחד מסומנות כ-'FLAKY' בסיכום הבדיקה. בדרך כלל, הערך שצוין הוא מספר שלם או המחרוזת 'default'. אם מספר שלם, כל הבדיקות יופעלו עד N פעמים. אם 'default', יבוצע ניסיון בדיקה אחד בלבד בבדיקות רגילות ושלושה בבדיקות שסומנו באופן מפורש ככללי על ידי הכלל שלהם (Flaky=1). תחביר חלופי: regex_filter@flky_test_attempts. כאשר Flaky_test_attempts נמצא למעלה, ו-regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (ראו גם --runs_per_test). דוגמה: -flky_test_attempts=//foo/.*,-//foo/bar/.*@3 ניתן להעביר את האפשרות הזו כמה פעמים. הארגומנט האחרון שהועבר תואם לעדיפות. אם לא נמצאה התאמה, ההתנהגות היא כאילו 'default' לעיל.
תגים:execution
- ברירת מחדל של
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
המספר המקסימלי של משימות בדיקה מקומיות שפועלות בו-זמנית. הפרמטר מכיל מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ואחריו אופציונלי (למשל, [-|*]<float>) למשל. "auto", "HOST_CPUS*.5". 0 פירושו שמשאבים מקומיים יגבילו את מספר משימות הבדיקה המקומיות להפעלה בו-זמנית. ההגדרה הזו גדולה יותר מהערך של jobs היא לא אפקטיבית.
תגים:execution
- ברירת מחדל של
--[no]test_keep_going
: "true" -
כשהבדיקה מושבתת, כל הבדיקות שלא עברו יגרמו להפסקה של כל ה-build. כברירת מחדל, כל הבדיקות פועלות, גם אם חלק מהן לא עוברות.
תגים:execution
- ברירת מחדל של
--test_strategy=<a string>
: "" -
קביעת השיטה שבה רוצים להפעיל בדיקות.
תגים:execution
- ברירת מחדל של
--test_tmpdir=<a path>
: תיאור - מפרט את הספרייה הזמנית הבסיסית עבור 'בדיקת B&z#39; לשימוש.
- אפשרויות שקשורות לפלט של Bzlmod וסמנטיקה:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]announce
: "false" -
הוצא משימוש. לא.
תגים:affects_outputs
- ברירת מחדל של
--[no]debug_spawn_scheduler
: "false" - ברירת מחדל של
--[no]experimental_bep_target_summary
: "false" - אם רוצים לפרסם אירועי סיכום סיכום.
- ברירת מחדל של
--[no]experimental_build_event_expand_filesets
: "false" -
אם הערך הוא TRUE, מרחיבים את FilesApps ב-BEP כשמציגים קובצי פלט.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" -
אם הערך הוא True, יש לפתור בצורה מלאה את סמלי הקישור היחסיים של Fileset ב-BEP כשמציגים קובצי פלט. נדרשת -experimental_build_event_expand_filesets.
תגים:affects_outputs
- ברירת מחדל של
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
מספר הפעמים המקסימלי שחברת Bazel מנסה להעלות אירוע build.
תגים:bazel_internal_configuration
- ברירת מחדל של
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
השהיה מינימלית עד לעיכוב מעריכי של ניסיונות חוזרים כאשר העלאה של BEP נכשלה. (מעריך: 1.6)
תגים:bazel_internal_configuration
- ברירת מחדל של
--experimental_build_event_upload_strategy=<a string>
: תיאור -
בחירה איך להעלות פריטי מידע שנוצרים בתהליך פיתוח (Artifact) המוזכרים בפרוטוקול של אירוע ה-build.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_collect_local_sandbox_action_metrics
: "true" -
כשהאפשרות מופעלת, נתונים סטטיסטיים של הפעלה (כמו זמן המשתמש והמערכת) מתועדים עבור פעולות שבוצעו באופן מקומי ושנעשה בהן שימוש בארגז חול
תגים:execution
- ברירת מחדל של
--[no]experimental_docker_verbose
: "false" -
אם האפשרות מופעלת, Bazel תדפיס הודעות מפורטות יותר לגבי אסטרטגיית ארגז החול של Docker.
תגים:execution
- ברירת מחדל של
--[no]experimental_materialize_param_files_directly
: "false" -
אם יוצרים קובצי עזר, צריך לעשות זאת בכתיבה ישירה לדיסק.
תגים:execution
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- ברירת מחדל של
--experimental_repository_resolved_file=<a string>
: "" -
אם לא ריק, כותבים ערך של Starlark עם הפרטים שנפתרו לגבי כל כללי המאגר של Starlark שבוצעו.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_stream_log_file_uploads
: "false" -
אפשר להעביר העלאות של קובצי יומן ישירות לאחסון המרוחק, במקום לכתוב אותם בדיסק.
תגים:affects_outputs
- ברירת מחדל של
--explain=<a path>
: תיאור -
מערכת המודל גורמת להסבר על כל שלב בביצוע ה-build. ההסבר נכתב בקובץ היומן שצוין.
תגים:affects_outputs
- ברירת מחדל של
--[no]legacy_important_outputs
: "true" -
אפשר להשתמש בכך כדי להסתיר יצירה של שדה חשוב_פלט קודם באירוע Targetcomplete. נדרשים שילובים חשובים של Basel עד ResultStore.
תגים:affects_outputs
- ברירת מחדל של
--[no]materialize_param_files
: "false" -
כותבים קובצי פרמטרים בינוניים לעץ הפלט גם כשמשתמשים בביצוע פעולות מרחוק. שימושי לניפוי באגים בפעולות. זה מרמז על כך – subsubmands ו- --verbose_failures.
תגים:execution
- ברירת מחדל של
--max_config_changes_to_show=<an integer>
: "3" -
כשמוחקים את מטמון הניתוח עקב שינוי באפשרויות build, מוצג מספר נתון של שמות אפשרויות. אם המספר הנתון הוא 1-, כל האפשרויות שהשתנו יוצגו.
תגים:terminal_output
- ברירת מחדל של
--max_test_output_bytes=<an integer>
: "-1" -
ההגדרה קובעת את הגודל המרבי של יומן בדיקה לכל משתמש כאשר --test_פלט הוא 'שגיאות' או 'all' כדאי להשתמש באפשרות הזו כדי למנוע הצפה של פלט הבדיקה עקב רעש מוגזם. כותרת הבדיקה נכללת בגודל היומן. ערכים שליליים לא מעידים על הגבלה. הפלט הוא כלום או לא שום דבר.
תגים:test_runner
,terminal_output
,execution
- ברירת מחדל של
--output_filter=<a valid Java regular expression>
: תיאור -
מוצגות רק אזהרות לגבי כללים עם שם שתואם לביטוי הרגולרי שסופק.
תגים:affects_outputs
- ברירת מחדל של
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
מספר השניות להמתנה בין שני דוחות על משרות שעדיין פעילות. ערך ברירת המחדל 0 פירושו להשתמש באלגוריתם המצטבר 10:30:60 המוגדר כברירת מחדל.
תגים:affects_outputs
- ברירת מחדל של
--remote_print_execution_messages=<failure, success or all>
: "failure" -
אתם יכולים לבחור מתי תרצו להדפיס הודעות של ביצוע מרחוק. הערכים התקינים הם 'כשל', כדי להדפיס רק כשלים, 'הצלחה' כדי להדפיס רק את ההצלחות, ו'הכול' כדי להדפיס תמיד.
תגים:terminal_output
- ברירת מחדל של
--[no]sandbox_debug
: "false" -
הפעלת תכונות ניפוי באגים לתכונה 'ארגז חול'. הדבר כולל שני דברים: קודם כול, התוכן הבסיסי של ארגז החול נשאר ללא שינוי לאחר יצירת build (ואם נעשה שימוש ב-Sandboxfs, מערכת הקבצים נשארת מותקנת במקום השני) ומדפיסה מידע נוסף על תוצאות ניפוי הבאגים במהלך הביצוע. פעולה זו יכולה לעזור למפתחים של כללי Bazel או Starlark עם כשלי ניפוי באגים בגלל קובצי קלט חסרים וכו'.
תגים:terminal_output
- ברירת מחדל של
--show_result=<an integer>
: "1" -
הצגת התוצאות של ה-build. עבור כל יעד, מציינים אם הוא הועלה, ואם כן, רשימה של קובצי פלט שנוצרו. הקבצים המודפסים הם מחרוזות נוחות להעתקה ולהדבקה למעטפת, כדי להפעיל אותן.
כדי להשתמש באפשרות הזו, נדרש ארגומנט של מספר שלם, שהוא מספר הסף של היעדים שעליהם לא מדפיסים את פרטי התוצאה. לכן אפס גורם למחיקת ההודעה ו-MAX_INT גורם להדפסת התוצאה להופיע תמיד. ברירת המחדל היא אחת.
תגים:affects_outputs
--[no]subcommands
[-s
] ברירת מחדל: "false"-
הצגת פקודות המשנה שבוצעו במהלך ה-build. סימונים קשורים: --execution_log_json_file, --execution_log_binary_file (לתיעוד פקודות משנה לקובץ בפורמט ידידותי לכלי).
תגים:terminal_output
- ברירת מחדל של
--test_output=<summary, errors, all or streamed>
: "summary" -
קביעת מצב הפלט הרצוי. הערכים החוקיים הם 'summary' לפלט סיכום של סטטוס בדיקה בלבד, 'errors' להדפסת יומני בדיקה גם עבור בדיקות שנכשלו, 'all' להדפסת יומנים עבור כל הבדיקות בזמן אמת (פעולה זו תאלץ את ביצוע הבדיקות באופן מקומי אחד בכל פעם --_).
תגים:test_runner
,terminal_output
,execution
- ברירת מחדל של
--test_summary=<short, terse, detailed, none or testcase>
: "short" -
ההגדרה היא הפורמט הרצוי של סיכום הבדיקה. ערכים חוקיים הם 'short' כדי להדפיס מידע רק על בדיקות שבוצעו, 'terse' כדי להדפיס מידע רק על בדיקות שנכשלו; 'detailed' כדי להדפיס סיכום מפורט בתרחיש של בדיקת בדיקה; אין להדפיס מידע מפורט על מקרים של מקרה בדיקה ו-39;
תגים:terminal_output
- ברירת מחדל של
--[no]verbose_explanations
: "false" -
יש להגדיל את המלל של ההסברים שהונפקו, אם ההסבר הזה מופעל. אין השפעה אם --Excel לא מופעל.
תגים:affects_outputs
- ברירת מחדל של
--[no]verbose_failures
: "false" -
אם פקודה לא מצליחה, מומלץ להדפיס את שורת הפקודה המלאה.
תגים:terminal_output
- אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
- נצברו
--aspects_parameters=<a 'name=value' assignment>
שימושים מרובים -
ההגדרה קובעת את הערכים של הפרמטרים של היבטים בשורת הפקודה. כל ערך של פרמטר מצוין דרך <param_name>=<param_value> לדוגמה, 'my_param=my_val' כאשר 'my_param' הוא פרמטר של היבט כלשהו ב'רשימת ההיבטים' או שהוא נדרש על ידי היבט ברשימה. ניתן להשתמש באפשרות הזו כמה פעמים. עם זאת, אסור להקצות ערכים לאותו פרמטר יותר מפעם אחת.
תגים:loading_and_analysis
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, קראו את הקובץ שצוין ולא את קובץ ה-WORKSPACE
תגים:changes_inputs
- ברירת מחדל של
--target_pattern_file=<a string>
: "" -
אם אפשרות זו מוגדרת, גרסת ה-build תקרא תבניות מהקובץ שנקרא כאן, במקום בשורת הפקודה. שגיאה בציון קובץ כאן וגם בדפוסי שורת פקודה.
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה מרחוק:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- ברירת מחדל של
--[no]experimental_guard_against_concurrent_changes
: "false" - כדי להשבית את הבדיקה של קובצי קלט עבור פעולה מסוימת לפני שמעלים אותה למטמון מרוחק, יש להשבית את הזמן. ייתכנו מקרים שבהם הליבה של Linux מעכבת כתיבה של קבצים, מה שעלול לגרום לתוצאות חיוביות שקריות.
- ברירת מחדל של
--experimental_remote_build_event_upload=<all or minimal>
: "all" - אם המדיניות מוגדרת כ-'all' כל הפלט המקומי שאליו מפנה BEP מועלה למטמון מרוחק. אם המדיניות מוגדרת כ-'minimal' פלטים מקומיים ש-BEP מפנה אליהם לא מועלים למטמון המרוחק, מלבד קבצים שחשובים לצרכנים של BEP (למשל יומני בדיקה ופרופיל תזמון). סכימת //:file משמשת לנתיבים של קבצים מקומיים וסכימת בייטstream:// משמשת לנתיבים של קבצים שהועלו (כבר). ברירת המחדל היא 'all'.
- ברירת מחדל של
--[no]experimental_remote_cache_async
: "false" - אם הערך הוא TRUE, מטמון I/O מרוחק יתרחש ברקע במקום להיווצר כחלק מ-S מדויקת.
- ברירת מחדל של
--[no]experimental_remote_cache_compression
: "false" - אם האפשרות מופעלת, אפשר לדחוס או לפרוס בועות של מטמון עם zstd.
- ברירת מחדל של
--experimental_remote_capture_corrupted_outputs=<a path>
: תיאור - נתיב לספרייה שבה יילכו פלטים פגומים.
- ברירת מחדל של
--experimental_remote_downloader=<a string>
: תיאור - URI של נקודת קצה ל-API של נכס מרוחק, שישמש כשרת proxy להורדה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. בכתובת: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- ברירת מחדל של
--[no]experimental_remote_downloader_local_fallback
: "false" - אם אתם רוצים לחזור לכלי ההורדה המקומי, אם ההורדה מרחוק נכשלה.
- ברירת מחדל של
--[no]experimental_remote_execution_keepalive
: "false" - האם להשתמש ב-Keepalive בשיחות ביצוע מרחוק?
- ברירת מחדל של
--experimental_remote_grpc_log=<a path>
: תיאור - אם צוין, נתיב לקובץ שבו יתבצע רישום של פרטים הקשורים לשיחת gRPC. היומן הזה מורכב מרצף של com.google.devtools.build.lib.remote.logging.remoteExecutionLog.LogEntry Protobufs עם כל הודעה המסומנת ב-varint המציין את גודל ההודעה הבאה עם פסיק.
- ברירת מחדל של
--[no]experimental_remote_mark_tool_inputs
: "false" - אם היא מוגדרת כ-True, ה-Bazel יסמן את הקלט בתור קלט לכלי הפעולה מרחוק. אפשר להשתמש באפשרות הזאת כדי להטמיע עובדים קבועים מרחוק.
- ברירת מחדל של
--[no]experimental_remote_merkle_tree_cache
: "false" - אם המדיניות מוגדרת כ-True, החישובים של עץ ה-Merkle יסונכרנו כדי לשפר את מהירות הבדיקה של ההיט המרוחק. ביצועי טביעת הרגל בזיכרון של המטמון נקבעים על ידי -experimental_remote_merkle_tree_cache_size.
- ברירת מחדל של
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - מספר עצי ה-Merkle שיש לזכור כדי לשפר את מהירות הבדיקה של ההיט המרוחק. אף על פי שהמטמון נחתך באופן אוטומטי בהתאם לטיפול בהפניות רכות של Java', יכול להיות ששגיאות "חסרות זיכרון" עלולות להיווצר אם הן גבוהות מדי. אם המדיניות מוגדרת כ-0, גודל המטמון הוא בלתי מוגבל. הערך האופטימלי משתנה בהתאם לגודל הפרויקט. ערך ברירת המחדל הוא 1,000.
- ברירת מחדל של
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - אם המדיניות מוגדרת כ-True, פלטים שאליהם מפנה BEP לא יועלו למטמון מרוחק אם לא ניתן יהיה לשמור במטמון את פעולת היצירה מרחוק.
- ברירת מחדל של
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
האם לשלוח את כל הערכים של כותרת רבת-ערך להורדה מרחוק ולא רק הראשונה.
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
אם המדיניות מוגדרת כ-True, נתיבי הפלט הם יחסיים לשורש הקלט במקום לספרייה הפעילה.
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_remote_results_ignore_disk
: "true" -
אם המדיניות מוגדרת כ-True, --noremote_upload_local_results ו--noremote_Accept_cached לא יחולו על מטמון הדיסק. אם נעשה שימוש במטמון משולב:
--noremote_upload_local_results יגרום לכתיבה של תוצאות במטמון הדיסק, אבל לא להעלאה למטמון המרוחק.
--noremote_confirm_cached יוביל לבדיקה של Bazel בתוצאות החיפוש במטמון הדיסק, אבל לא במטמון המרוחק.
פעולות ללא הפעלה מרחוק יכולות לפגוע במטמון הדיסק.
פרטים נוספים זמינים בדף #8216.
תגים:incompatible_change
- ברירת מחדל של
--[no]remote_accept_cached
: "true" - האם לקבל תוצאות של פעולות שנשמרו במטמון מרחוק?
- ברירת מחדל של
--remote_bytestream_uri_prefix=<a string>
: תיאור - שם המארח ושם המופע לשימוש ב-URI של בייט-בייט שכתובים במקורות נתונים של אירועים. אפשר להגדיר את האפשרות הזו כשמבצעים גרסאות build באמצעות שרת proxy. כתוצאה מכך, הערכים של -remote_executor ו--remote_instance_name לא תואמים יותר לשם הקנוני של שירות הביצוע מרחוק. אם היא לא מוגדרת, ברירת המחדל היא "${hostname}/${instance_name}".
- ברירת מחדל של
--remote_cache=<a string>
: תיאור - URI של נקודת קצה לשמירה במטמון. הסכימות הנתמכות הן http, https, grpc, grpcs (grpc עם TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. מציינים grpc://, http:// או Unix: כדי להשבית TLS. כדאי לעיין בכתובת https://bazel.build/remote/caching
- נצברו
--remote_cache_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות שנשמרו במטמון: --remote_cache_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- נצברו
--remote_default_exec_properties=<a 'name=value' assignment>
שימושים מרובים -
מגדירים את מאפייני ברירת המחדל של exe שישמשו כפלטפורמת הביצוע מרחוק, אם פלטפורמת ביצוע עדיין לא הגדירה exec_properties.
תגים:affects_outputs
- ברירת מחדל של
--remote_default_platform_properties=<a string>
: "" - מגדירים את מאפייני הפלטפורמה שמוגדרים כברירת מחדל ל-API לביצוע מרחוק, אם פלטפורמת הביצוע לא מוגדרת עדיין Remote_execution_property. המערכת תשתמש בערך הזה גם אם פלטפורמת המארח נבחרה כפלטפורמת ההפעלה לביצוע מרחוק.
- נצברו
--remote_downloader_header=<a 'name=value' assignment>
שימושים מרובים - יש לקבוע כותרת שתיכלל בבקשות להורדה מרחוק: --remote_downloader_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- נצברו
--remote_exec_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות ביצוע: --remote_exec_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- ברירת מחדל של
--remote_execution_priority=<an integer>
: "0" - העדיפות היחסית של הפעולות שיש לבצע מרחוק. הסמנטיקה של ערכי העדיפות הספציפית היא תלויה בשרת.
- ברירת מחדל של
--remote_executor=<a string>
: תיאור - מארח או מתארח:יציאה של נקודת קצה להפעלה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. צריך לציין grpc:// או Unix: כדי להשבית TLS.
- נצברו
--remote_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות: --remote_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- ברירת מחדל של
--remote_instance_name=<a string>
: "" - הערך שמועבר כ-Instance_name ב-API לביצוע מרחוק.
- ברירת מחדל של
--[no]remote_local_fallback
: "false" - האם לחזור לשיטה עצמאית של הפעלה מקומית אם ביצוע ההעברה מרחוק נכשל?
- ברירת מחדל של
--remote_local_fallback_strategy=<a string>
: "local" - לא, הוצא משימוש. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/7480.
- ברירת מחדל של
--remote_max_connections=<an integer>
: "100" -
הגבלת המספר המקסימלי של חיבורים בו-זמנית למטמון/קובץ הפעלה מרחוק. כברירת מחדל, הערך הוא 100. אם מגדירים את הערך כ-0, אין הגבלה.
עבור מטמון של HTTP מרחוק, חיבור TCP אחד יכול לטפל בבקשה אחת בכל פעם, כך ש-Bazel יכול לבצע בקשות בו-זמנית עד ל-remote_max_connections.
ב-gRPC מרוחק, יכול להיות שערוץ אחד בשם gRPC יוכל לטפל ביותר מ-100 בקשות בו-זמנית. לכן, Bazel יכולה לשלוח בקשות '--remote_max_connections * 100' בו-זמנית.
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--remote_proxy=<a string>
: תיאור - מתחברים למטמון המרוחק דרך שרת proxy. כרגע אפשר להשתמש בסימון הזה רק כדי להגדיר שקע דומיין (Unix:/path/to/socket) ב-Unix:
- ברירת מחדל של
--remote_result_cache_priority=<an integer>
: "0" - העדיפות היחסית של פעולות מרוחקות שנשמרו במטמון מרוחק. הסמנטיקה של ערכי העדיפות הספציפית היא תלויה בשרת.
- ברירת מחדל של
--remote_retries=<an integer>
: "5" - מספר הניסיונות המקסימלי לנסות שוב שגיאה זמנית. אם המדיניות מוגדרת כ-0, ניסיונות חוזרים מושבתים.
- ברירת מחדל של
--remote_timeout=<An immutable length of time.>
: "60s" - משך הזמן המרבי להמתנה לביצוע מרחוק ולשיחות במטמון. למטמון REST, זהו גם החיבור וגם הזמן הקצוב לתפוגה של קריאה. אפשר להשתמש ביחידות הבאות: ימים (d), שעות (h), דקות (m), שניות (s) ואלפיות שנייה (אלפיות השנייה). אם משמיטים את היחידה, הערך מפורש כשניות.
- ברירת מחדל של
--[no]remote_upload_local_results
: "true" - האם להעלות למטמון המרוחק תוצאות של פעולות שבוצעו באופן מקומי?
- ברירת מחדל של
--[no]remote_verify_downloads
: "true" - אם היא מוגדרת כ-true, Bazel תחשב את סכום הגיבוב של כל ההורדות המרוחקות ותשליך את הערכים השמורים במטמון מרחוק אם הם לא תואמים לערך הצפוי.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- ברירת מחדל של
--auto_output_filter=<none, all, packages or subpackages>
: "none" - אם לא בשדה ‘פלט_מסנן’, הערך של האפשרות הזו משמש ליצירת מסנן באופן אוטומטי. הערכים המותרים הם 'none' (בלי לסנן שום דבר / הצגת הכול), 'all' (סינון הכול / לא להציג שום דבר), 'packages' (כולל פלט מכללים בחבילות המוזכרים בשורת הפקודה Blaze), וגם 'subpackages' (כמו 'packages&#include9); עבור 'packs' 'subpackages' ערכים //Java/foo ו-//Javatests/foo כאל חבילה אחת)'
- ברירת מחדל של
--[no]build_manual_tests
: "false" - מתבצעת יצירה של יעדי בדיקה מתויגים 'ידני' 'ידני' הבדיקות לא מעובדות. אם רוצים להשתמש באפשרות הזו, צריך לבנות אותה (אבל לא לבצע אותה).
- ברירת מחדל של
--build_tag_filters=<comma-separated list of options>
: "" - ההגדרה מציינת רשימת תגים המופרדים בפסיקים. לפני כל תג אפשר להוסיף '-' כדי לציין תגים מוחרגים. רק היעדים האלה יווצרו שכוללים לפחות תג כלול אחד ולא מכילים תגים שאינם נכללים. האפשרות הזו לא משפיעה על קבוצת הבדיקות שמופעלות באמצעות הפקודה 'test' או שאינן כפופות לאפשרויות סינון הבדיקה, למשל '--test_tag_filters'
- ברירת מחדל של
--[no]build_tests_only
: "false" - אם צוין, המערכת תבנה רק כללים מסוג *_test ו-test_Suite המערכת תתעלם מיעדים אחרים שצוינו בשורת הפקודה. כברירת מחדל, כל מה שהתבקש ייבנה.
- ברירת מחדל של
--combined_report=<none or lcov>
: "none" - ההגדרה קובעת את סוג דוח הכיסוי המצטבר. בשלב זה, רק LCOV נתמך.
- ברירת מחדל של
--[no]compile_one_dependency
: "false" - יוצרים תלות אחת של קובצי הארגומנטים. זו פעולה שימושית לבדיקת קובצי מקור ב-IDE, למשל על ידי בניית יעד יחיד שתלוי בקובץ המקור כדי לזהות שגיאות בהקדם האפשרי במחזור העריכה/בנייה/בדיקה. הארגומנט הזה משפיע על האופן שבו כל הארגומנטים שאינם מסמנים מתפרשים. במקום לטרגט אותם כדי לבנות אותם, הם שמות הקבצים של המקור. עבור כל שם קובץ מקור יווצר יעד שרירותי שתלוי בו.
- ברירת מחדל של
--deleted_packages=<comma-separated list of package names>
: "" - רשימה של שמות של חבילות, מופרדים בפסיקים, שמערכת ה-build תתייחס אליהם שאינם קיימים, גם אם הם מוצגים במקום כלשהו בנתיב החבילה. כדאי להשתמש באפשרות הזו כשמוחקים חבילת משנה 'x/y' של חבילה קיימת 'x' לדוגמה, לאחר מחיקת x/y/BUILD בלקוח, מערכת ה-build עשויה להתלונן אם היא תיתקל בתווית '//x:y/z' אם היא עדיין מסופקת על ידי ערך package_path אחר. ציון [delete_packs x/y] מונע את הבעיה הזו.
- ברירת מחדל של
--[no]discard_analysis_cache
: "false" - אפשר למחוק את מטמון הניתוח מיד אחרי ששלב הניתוח מסתיים. מפחית את השימוש בזיכרון בכ-10%, אבל הופך את ה-build של מצטבר יותר לאט יותר.
- ברירת מחדל של
--disk_cache=<a path>
: תיאור - נתיב לספרייה שבה Bazel יכולה לקרוא ולכתוב פעולות ופלטי פעולות. אם הספרייה לא קיימת, היא תיווצר.
- ברירת מחדל של
--embed_label=<a one-line string>
: "" - הטמעת גרסה קודמת של בקרה על גרסה או תווית בינארית
- ברירת מחדל של
--execution_log_binary_file=<a path>
: תיאור - עליך לרשום את הסדינים שבוצעו בקובץ הזה כפרוטוקולים של ספרדים מופרדים, בהתאם לכתובת src/main/protobuf/spawn.proto. תחילה כותבים את היומן בלי סדר, ואז בסוף ההפעלה הם ממוינים בסדר קבוע (יכול להיות מצריך מעבד וזיכרון). סימונים קשורים: --execution_log_json_file (פורמט json של טקסט שהוזמן), --experimental_execution_log_file (פורמט בינארי לא מורשה), --subcommands (להצגת פקודות משנה בפלט מסוף).
- ברירת מחדל של
--execution_log_json_file=<a path>
: תיאור - עליך לתעד את הסדינים שבוצעו בקובץ הזה כייצוג json של פרוטוסים מופרדים בפסיקים, בהתאם ל- src/main/protobuf/spawn.proto. תחילה כותבים את היומן בלי סדר, ואז בסוף ההפעלה הם ממוינים בסדר קבוע (יכול להיות מצריך מעבד וזיכרון). סימונים קשורים: סימונים קשורים: --execution_log_binary_file (פורמט בינארי בינארי שהוזמן), --experimental_execution_log_file (פורמט Protobuf בינארי ללא הזמנה), --subcommands (להצגת פקודות משנה בפלט מסוף).
- ברירת מחדל של
--[no]expand_test_suites
: "true" -
מומלץ להרחיב את יעדי test_Suite לבדיקות ההרכב שלהם לפני הניתוח. אם הדגל הזה מופעל (ברירת המחדל), דפוסי יעד שליליים יחולו על הבדיקות השייכות לחבילת הבדיקה, אחרת הם לא יפעלו. השבתה של הסימון הזה שימושית כשמחילים היבטים ברמה העליונה בשורת הפקודה: ואז אפשר לנתח מטרות בדיקה של suite.
תגים:loading_and_analysis
- נצברו
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
שימושים מרובים - הגדרת עזרה לגבי פרטי כניסה לשימוש באחזור פרטי הכניסה של ההיקף (דומיין). פרטי כניסה מ-credentials Credentials מקבלים עדיפות על פני פרטי כניסה מ-<code>--google_default_credentials</code>, `--google_credentials` או <code>.netrc</code>. אפשר לראות אותם בכתובת https://github.com/bazelbuild/proposs22-z
- ברירת מחדל של
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30m" - ההגדרה קובעת את משך הזמן שבו פרטי הכניסה ששמורים ב'פרטי כניסה' יישמרו במטמון.
- ברירת מחדל של
--experimental_credential_helper_timeout=<An immutable length of time.>
: "5s" - הגדרת הזמן הקצוב לתפוגה עבור 'פרטי הכניסה'. עוזרי הכניסה שלא יגיבו בזמן הקצוב לתפוגה ייכשלו.
- ברירת מחדל של
--experimental_execution_log_file=<a path>
: תיאור - עליך לרשום את הסדינים שבוצעו בקובץ הזה כפרוטוקולים של ספרדים מופרדים, בהתאם לכתובת src/main/protobuf/spawn.proto. הקובץ הזה נכתב לפי סדר הביצוע של סדונים. סימונים קשורים: --execution_log_binary_file (פורמט בינארי בינארי שהובטח), --execution_log_json_file (פורמט json של טקסט שהוזמן), --subcommands (להצגת פקודות משנה בפלט מסוף).
- ברירת מחדל של
--[no]experimental_execution_log_spawn_metrics
: "false" - הכללת מדדי S מרכזן ביומן הביצוע.
- ברירת מחדל של
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - הוצא משימוש לטובת היבטים. מסננים של קבוצות יעדים שעבורן אפשר לתזמן פעולות נוספות.
- ברירת מחדל של
--[no]experimental_extra_action_top_level_only
: "false" - הוצא משימוש לטובת היבטים. תזמון פעולות נוספות מסוג action_actions רק ביעדים ברמה עליונה.
- ברירת מחדל של
--[no]experimental_prioritize_local_actions
: "true" -
אם הן מוגדרות, פעולות שניתן להפעיל באופן מקומי מקבלים רק הזדמנות ראשונה לרכוש משאבים, עובדים באופן דינמי מקבלים הזדמנות שנייה, ופעולות נפרדות שמתבצעות באופן דינמי ומתבצעות לאחרונה.
תגים:execution
--experimental_spawn_scheduler
-
מפעילים ביצוע דינמי על ידי הרצת פעולות באופן מקומי וגם מרחוק. Bazel מצטיינת בכל פעולה מקומית ומרוחקת, ובוחרת את הפעולה שמסתיימת ראשונה. אם פעולה תומכת בעובדים, הפעולה המקומית תתבצע במצב עובד קבוע. כדי להפעיל ביצוע דינמי של רכיב פעולה ספציפי, יש להשתמש בסימונים '--internal_spawn_scheduler' וב-'--strategi=<mnemonic>=Dynamic'.
הרחבה של:
--internal_spawn_scheduler
--spawn_strategy=dynamic
- ברירת מחדל של
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - רשימה של היקפי אימות ב-Google Cloud, המופרדים באמצעות פסיקים.
- ברירת מחדל של
--google_credentials=<a string>
: תיאור - ההגדרה קובעת את הקובץ שממנו יתקבלו פרטי הכניסה לאימות. פרטים נוספים זמינים בכתובת https://cloud.google.com/docs/authentication.
- ברירת מחדל של
--[no]google_default_credentials
: "false" - אם צריך להשתמש ב 'פרטי הכניסה שמוגדרים כברירת מחדל באפליקציית Google' לאימות. פרטים נוספים זמינים בכתובת https://cloud.google.com/docs/authentication. מושבת כברירת מחדל.
- ברירת מחדל של
--grpc_keepalive_time=<An immutable length of time.>
: תיאור - הגדרת פינגים בשידור חי עבור חיבורי gRPC יוצאים. אם המדיניות הזו מוגדרת, Bazel שולחת פינגים אחרי פרק הזמן הזה ללא פעולות קריאה בחיבור, אבל רק אם יש לפחות קריאה אחת אחת מסוג gRPC בהמתנה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. פינגים בשידור חי מושבתים כברירת מחדל. עליך לתאם עם בעל השירות לפני הפעלת ההגדרה הזו. לדוגמה, כדי להגדיר ערך של 30 שניות לסימון הזה, צריך לעשות זאת כך: grpc_keepalive_time=30s
- ברירת מחדל של
--grpc_keepalive_timeout=<An immutable length of time.>
: "20s" - הגדרת זמן קצוב לתפוגה של שמירת נתונים פעילה עבור חיבורי gRPC יוצאים. אם פינגים מסוג keep-alive מופעלים באמצעות --grpc_keepalive_time, תם הזמן הקצוב (Bazel) של Bazel אם לא מתקבלת פינג אחרי פרק הזמן הזה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. אם פינגים פעילים נשארים מושבתים, המערכת מתעלמת מההגדרה הזו.
- ברירת מחדל של
--[no]ignore_unsupported_sandboxing
: "false" - אין להדפיס אזהרה כשאין תמיכה במערכת הזו בארגז חול.
- ברירת מחדל של
--[no]incompatible_dont_use_javasourceinfoprovider
: "false" -
לא:
תגים:incompatible_change
- ברירת מחדל של
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" - יש להגדיר באופן מפורש את המספר הכולל של ליבות מעבד (CPU) מקומיות שזמינות ל-Bazel להוצאה על פעולות build שמבוצעות באופן מקומי. משתנה מספר שלם, או "HOST_CPUS" ואופציונלית גם [-|*]<float> (למשל, HOST_CPUS*.5 כדי להשתמש במחצית מליבות המעבד (CPU) הזמינות. כברירת מחדל, ("HOST_CPUS" ), Bazel תשלח שאילתה לתצורת המערכת כדי להעריך את מספר הליבות של המעבד (CPU).
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
ברירת מחדל: "HOST_RAM*.67"- יש להגדיר במפורש את סך כל זיכרון ה-RAM המארח המקומי (ב-MB) הזמין ל-Bazel להוצאה על פעולות build שמבוצעות באופן מקומי. משתנה מספר שלם, או "HOST_RAM" ואופציונלית מופיע [-|*]<float> (למשל, HOST_RAM*.5 כדי להשתמש בחצי מזיכרון ה-RAM הזמין). כברירת מחדל, ("HOST_RAM*.67" ), Bazel תשלח שאילתה לתצורת המערכת כדי להעריך את כמות ה-RAM הזמינה, ומשתמשת ב-67% ממנה.
- ברירת מחדל של
--local_termination_grace_seconds=<an integer>
: "15" - הגיע הזמן להמתין בין סיום התהליך המקומי לבין הזמן הקצוב לתפוגה וסגירה ידנית.
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
- ברירת מחדל של
--package_path=<colon-separated list of options>
: "%workspace%" - רשימה מופרדת בנקודתיים של מיקומים לחיפוש חבילות. רכיבים שמתחילים ב-'%workspace%' הם יחסיים לסביבת העבודה המקיפה. אם לא מופיעה או ריקה, ברירת המחדל היא הפלט של 'bazel information default-package-path'.
- ברירת מחדל של
--[no]show_loading_progress
: "true" - אם מופעל, גורם ל-Bazel להדפיס הודעות &&;טעינת חבילה:".
- ברירת מחדל של
--test_lang_filters=<comma-separated list of options>
: "" - קביעת רשימה של שפות בדיקה המופרדות בפסיקים. אפשר להוסיף לפני כל שפה את המילים " '-' כדי לציין שפות מוחרגות. יימצאו רק יעדי הבדיקה שנכתבו בשפות שצוינו. השם המשמש לכל שפה צריך להיות זהה לתחילית השפה בכלל *_test, למשל, אחד מהתווים #&39;cc', 'Java', 'py' וכו'. האפשרות הזו משפיעה על --build_tests_only ועל פקודת הבדיקה.
- ברירת מחדל של
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - ההגדרה מציינת רשימה של גודלי בדיקה המופרדים בפסיקים. לפני כל גודל אפשר להוסיף לפני #&39;-' כדי לציין גדלים שאינם נכללים. יימצאו רק יעדי בדיקה המכילים לפחות גודל כולל אחד ואינם מכילים גדלים שלא נכללו. האפשרות הזו משפיעה על ההתנהגות של --build_tests_only ועל פקודת הבדיקה.
- ברירת מחדל של
--test_tag_filters=<comma-separated list of options>
: "" - קביעת רשימה של תגי בדיקה המופרדים בפסיקים. לפני כל תג אפשר להוסיף '-' כדי לציין תגים מוחרגים. יימצאו רק יעדי בדיקה כאלה שמכילים לפחות תג כלול אחד ואינם מכילים תגים שאינם נכללים. האפשרות הזו משפיעה על ההתנהגות של --build_tests_only ועל פקודת הבדיקה.
- ברירת מחדל של
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - מפרטת רשימה של זמני קצוב לתפוגה המופרדים בפסיקים. אפשר לבחור לפני כל פרק זמן שמסתיים ב-'-' כדי לציין זמנים הקצוב לתפוגה שהוחרגו. יימצאו רק יעדי בדיקה שמכילים לפחות זמן קצוב לתפוגה אחד, ואינם כוללים תקופות זמן קצוב לתפוגה שהוחרגו. האפשרות הזו משפיעה על ההתנהגות של --build_tests_only ועל פקודת הבדיקה.
- ברירת מחדל של
--tls_certificate=<a string>
: תיאור - יש לציין נתיב לאישור TLS שהוא מהימן לחתימה על אישורי שרת.
- ברירת מחדל של
--tls_client_certificate=<a string>
: תיאור - ציון אישור הלקוח של TLS (אבטחת שכבת התעבורה) לשימוש. צריך גם לספק מפתח לקוח כדי להפעיל אימות לקוח.
- ברירת מחדל של
--tls_client_key=<a string>
: תיאור - צריך לציין את מפתח הלקוח ב-TLS שבו רוצים להשתמש. צריך גם לספק אישור לקוח כדי להפעיל את אימות הלקוח.
- ברירת מחדל של
--workspace_status_command=<path>
: "" - מוצגת פקודה בהתחלה של גרסת ה-build כדי לספק מידע על סטטוס סביבת העבודה בצורת צמדי מפתח/ערך. לעיון במפרט המלא, יש לעיין במדריך למשתמש. לדוגמה, אפשר לעיין גם בכלים/buildstamp/get_workspace_status.
- אפשרויות ששולטות בביצוע של גרסאות build:
- ברירת מחדל של
--[no]check_up_to_date
: "false" -
אין לבצע את ה-build, רק צריך לבדוק אם הוא מעודכן. אם כל היעדים עדכניים, ה-build הושלם בהצלחה. אם צריך לבצע שלב כלשהו, דיווח על שגיאה וה-build ייכשל.
תגים:execution
- ברירת מחדל של
--[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.xml שמכיל את יומן הבדיקה. אחרת, Bazel יוצרת test.xml כחלק מפעולת הבדיקה.
תגים:execution
- ברירת מחדל של
--[no]experimental_strict_fileset_output
: "false" -
אם האפשרות הזו מופעלת, קבוצות הקבצים יתייחסו לכל פריטי המידע שנוצרו בתהליך הפיתוח כקבצים רגילים. הם לא חוצה ספריות ולא יהיו רגישים לקישורים סימבוליים.
תגים:execution
- ברירת מחדל של
--genrule_strategy=<comma-separated list of options>
: "" -
יש לציין כיצד לבצע יצירת כללי. הסימון הזה ייצא משימוש. במקום זאת, אפשר להשתמש ב- --spawn_strategi=<value> כדי לשלוט בכל הפעולות או ב--strategi=Genrule=<value> כדי לשלוט רק בכללים.
תגים:execution
--jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
[-j
] ברירת מחדל: "auto"-
מספר המשימות במקביל. הפרמטר מכיל מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ואחריו אופציונלי (למשל, [-|*]<float>) למשל. "auto", "HOST_CPUS*.5". הערכים צריכים להיות בין 1 ל-5000. ערכים גדולים מ-2,500 עלולים לגרום לבעיות בזיכרון. "auto" מחשב ברירת מחדל סבירה על סמך משאבים למארחים.
תגים:host_machine_resource_optimizations
,execution
--[no]keep_going
[-k
] ברירת מחדל: "false"-
אפשר להמשיך כמה שיותר אחרי השגיאה. לא ניתן לנתח את היעד שנכשל או את היעד שתלוי בו, אבל יש דרישות מוקדמות נוספות ליעדים האלה.
תגים:eagerness_to_exit
- ברירת מחדל של
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
מספר השרשורים המקבילים שיש להשתמש בהם בשלב הטעינה/הניתוח.נלקחים מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ובדרך כלל מוסיפים פעולה ([-|*]<float>) למשל. "auto", "HOST_CPUS*.5". "auto" מגדיר ברירת מחדל סבירה על סמך משאבים למארחים. הערך חייב להיות לפחות 1.
תגים:bazel_internal_configuration
- ברירת מחדל של
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
ניתן להוסיף או להסיר מפתחות מידע על ביצוע של פעולה על סמך הקובץ של הפעולה. רלוונטי רק לפעולות התומכות בפרטי הביצוע. פעולות נפוצות רבות תומכות בפרטי ביצוע, כמו Genrule, CppCompile, Javac, StarlarkAction, TestRunner. כשמציינים כמה ערכים, הסדר חשוב כי ביטויים רבים עשויים לחול על אותו אזכור.
תחביר: "regex=[+-]key,regex=[+-]key,...".
דוגמאות:
'.*=+x,.*=-y,.*=+z' מוסיף את #&39;x' ו-'z' את פרטי הביצוע של #&39;y' ומסירים אותם.
'Genrule=+requires-x' add 'requires-x' לפרטי הביצוע של כל פעולות הז'אנר.
'(?!Genrule).*=-requires-x' removed 'requires-x' מפרטי ההפעלה של כל הפעולות שאינן ז'אנר.
תגים:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
הפעלה של עובדים ב-Android Dex ופעולות סוכר קבועות.
מתרחב אל:
--strategy=Desugar=worker
--strategy=DexBuilder=worker
תגים:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
הפעלת מעבד משאבים קבוע של Android באמצעות עובדים.
הרחבה אל:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
2
{1/2--internal_persistent_busybox_tools
--persistent_multiplex_android_dex_desugar
-
הפעלה של עובדים עם Multiplex דק' ופעולות סוכר
מתרחב אל:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers
תגים:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
הפעלה של מעבד משאבים (cast) עקבי ב-Android עם עובדים.
הרחבה אל:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
2
{1/2--persistent_android_resource_processor
--persistent_multiplex_android_tools
-
הפעלת כלים עקביים ומוכפלים ב-Android (Dexs, הסרת ניפוי באגים, עיבוד משאבים).
מתרחב אל:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
תגים:host_machine_resource_optimizations
,execution
- ברירת מחדל של
--spawn_strategy=<comma-separated list of options>
: "" -
מציינים כברירת מחדל איך יבוצעו פעולות ריבוי. מקבלת רשימת אסטרטגיות המופרדות בפסיקים, מהעדיפות הגבוהה ביותר לנמוכה. עבור כל פעולה, Bazel בוחרת את האסטרטגיה עם העדיפות הגבוהה ביותר שיכולה לבצע את הפעולה. ערך ברירת המחדל הוא "remote,work,sandboxed,local". פרטים נוספים זמינים בכתובת https://blog.bazel.build/2019/06/19/list-strategi.html.
תגים:execution
- נצברו
--strategy=<a '[name=]value1[,..,valueN]' assignment>
שימושים מרובים -
יש לציין איך להפיץ אוסף של פעולות הפקה אחרות. מקבלת רשימת אסטרטגיות המופרדות בפסיקים, מהעדיפות הגבוהה ביותר לנמוכה. עבור כל פעולה, Bazel בוחרת את האסטרטגיה עם העדיפות הגבוהה ביותר שיכולה לבצע את הפעולה. ערך ברירת המחדל הוא "remote,work,sandboxed,local". הדגל הזה מבטל את הערכים שהוגדרו על ידי --spawn_strategi (וכן --genrule_strategi אם משתמשים בהם ב-Genemonic Genrule). פרטים נוספים זמינים בכתובת https://blog.bazel.build/2019/06/19/list-strategi.html.
תגים:execution
- נצברו
--strategy_regexp=<a '<RegexFilter>=value[,value]' assignment>
שימושים מרובים -
כדאי לשנות את שיטת ה-Spמקו. לפרטים על התאמות של ביטוי רגולרי_filter יש לעיין בקטע --per_file_copt. נעשה שימוש ב-regex_filter הראשון שתואם לתיאור. אפשרות זו מבטלת סימונים אחרים לציון אסטרטגיה. דוגמה: --strategi_regexp=//foo.*\.cc,-//foo/bar=local הוא סימן להרצת פעולות באמצעות שיטה מקומית, אם התיאורים שלהן תואמים ל-//foo.*.cc אבל לא ל-//foo/bar. דוגמה: --strategi_regexp='Compiling.*/bar=local --strate יהיו
תגים:execution
- אפשרויות שמגדירות את כלי הכלים המשמש לביצוע פעולות:
- ברירת מחדל של
--android_compiler=<a string>
: תיאור -
המהדר של היעד ל-Android.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_crosstool_top=<a build target label>
: "//external:android/crosstool" -
המיקום של המהדר C++ המשמש לגרסאות של Android.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_grte_top=<a label>
: תיאור -
יעד grte_top ב-Android.
תגים:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_manifest_merger=<legacy, android or force_android>
: "android" -
בחירת המיזוג של המניפסט לשימוש בכללי android_binary. סימון לבדיקה כדי לעבור למיזוג המניפסט של Android מהמיזוג הקודם.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_platforms=<a build target label>
: "" -
מגדירה את הפלטפורמות שבהן היעדים של android_binary משתמשים. אם מציינים כמה פלטפורמות, הקובץ הבינארי הוא חבילות APK בעלות אחוזי שומן, המכילות קבצים בינאריים מקומיים לכל פלטפורמת יעד שצוינה.
תגים:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_sdk=<a build target label>
: "@bazel_tools//tools/android:sdk" -
ההגדרה קובעת Android SDK/פלטפורמה המשמשת לבניית אפליקציות ל-Android.
תגים:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--apple_compiler=<a string>
: תיאור -
מהדר היעד של Apple. שימושי לבחירת וריאציות של כלי עבודה (למשל: xcode-beta).
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--apple_crosstool_top=<a build target label>
: "@bazel_tools//tools/cpp:toolchain" -
התווית של חבילת כלי ההובלה לשימוש בכללי Apple ו-Objc ובתלויים שלהם.
תגים:loses_incremental_state
,changes_inputs
- ברירת מחדל של
--apple_grte_top=<a build target label>
: תיאור -
היעד grte_top של Apple.
תגים:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--cc_output_directory_tag=<a string>
: "" -
קביעת סיומת שתתווסף לספריית התצורה.
תגים:affects_outputs
,explicit_in_output_path
- ברירת מחדל של
--compiler=<a string>
: תיאור -
המהדר C++ המשמש לאיסוף היעד.
תגים:loading_and_analysis
,execution
- ברירת מחדל של
--coverage_output_generator=<a build target label>
: "@bazel_tools//tools/test:lcov_merger" -
המיקום של הקובץ הבינארי המשמש לעיבוד דוחות כיסוי גולמיים לאחר העיבוד. נכון לעכשיו זו צריכה להיות קבוצת קבצים הכוללת קובץ אחד, הקובץ הבינארי. ברירת המחדל היא '//tools/test:lcov_merger'.
תגים:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
ברירת מחדל: "@bazel_tools//tools/test:coverage_report_מחולל"-
המיקום של הקובץ הבינארי המשמש להפקת דוחות כיסוי. נכון לעכשיו זו צריכה להיות קבוצת קבצים הכוללת קובץ אחד, הקובץ הבינארי. ברירת המחדל היא '//tools/test:coverage_report_מחולל'.
תגים:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ברירת מחדל: "@bazel_tools//tools/test:coverage_support"-
המיקום של קובצי התמיכה הנדרשים על סמך הקלט של כל פעולת בדיקה שאוספת כיסוי קוד. ברירת המחדל היא '//tools/test:coverage_support'.
תגים:changes_inputs
,affects_outputs
,loading_and_analysis
- ברירת מחדל של
--crosstool_top=<a build target label>
: "@bazel_tools//tools/cpp:toolchain" -
התווית של חבילת כלי ההובלה שתשמש להרכבת קוד C++.
תגים:loading_and_analysis
,changes_inputs
,affects_outputs
- ברירת מחדל של
--custom_malloc=<a build target label>
: תיאור -
ההגדרה קובעת הטמעה מותאמת אישית של Malloc. ההגדרה הזו מבטלת את המאפיינים של Malאיך להשתמש בכללי build.
תגים:changes_inputs
,affects_outputs
- נצברו
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
שימושים מרובים -
רשימה של ביטויים רגולריים המופרדים בפסיקים, שלכל אחד מהם יש קידומת (-) שלילי, מוקצית (=) לרשימה של יעדי ערך מופרדים בפסיקים. אם יעד מסוים לא תואם אף ביטוי שלילי וביטוי חיובי אחד לפחות, רזולוציית הכלים שלו תתבצע כאילו היא הצהירה על ערכי האילוץ כאילוצי ביצוע. דוגמה: //demo,-test=@platforms//cpus:x86_64 יתווסף #&39;x86_64' לכל יעד תחת //demo, מלבד אלה שהשם שלהם מכיל 'test'.
תגים:loading_and_analysis
- ברירת מחדל של
--[no]experimental_enable_objc_cc_deps
: "true" -
קבלת כללים מסוג objc_* שתלויים ב-cc_library וגורמת לקיום יחסי תלות של objc עם --cpu המוגדר כ-"ios_<--ios_cpu>" עבור כל ערך ב- --ios_multi_cpu.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]experimental_include_xcode_execution_requirements
: "false" -
אם היא מוגדרת, מוסיפים את דרישת הביצוע "requires-xcode:{version}" לכל פעולת Xcode. אם גרסת ה-xcode כוללת תווית עם מקפים, צריך להוסיף גם "requires-xcode-label:{version_label}" דרישת ביצוע.
תגים:loses_incremental_state
,loading_and_analysis
,execution
- ברירת מחדל של
--[no]experimental_prefer_mutual_xcode
: "true" -
אם מוגדר True, יש להשתמש ב-Xcode העדכני ביותר שזמין גם מקומית וגם מרחוק. אם False, או אם אין גרסאות הדדיות זמינות, משתמשים בגרסת Xcode המקומית שנבחרה באמצעות xcode-select.
תגים:loses_incremental_state
- נצברו
--extra_execution_platforms=<comma-separated list of options>
שימושים מרובים -
הפלטפורמות הזמינות כפלטפורמות לביצוע פעולות. אפשר לציין פלטפורמות לפי יעד מדויק או כתבנית יעד. המערכת תתייחס לפלטפורמות האלה לפני אלה המוצהרות בקובץ ה-WORKSPACE על ידי sign_execution_platforms() .
תגים:execution
- נצברו
--extra_toolchains=<comma-separated list of options>
שימושים מרובים -
הכללים בנוגע לכלים של כלי עבודה שנלקחים בחשבון במהלך מציאת פתרון לכלים. ניתן לציין ערכות הכלים לפי יעד מדויק, או כתבנית יעד. חשוב לזכור את ערכות הכלים האלה לפני ההשקה שלהן בקובץ ה-WORKSPACE באמצעות record_toolchains() .
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--grte_top=<a label>
: תיאור -
תווית לספריית ליבצ'ק שמסומנת. ערך ברירת המחדל נבחר על ידי רצועת הכלים, וכמעט אף פעם לא צריך לשנות אותו.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_compiler=<a string>
: תיאור -
המהדר C++ המשמש לאיסוף של מארח. המערכת מתעלמת ממנו אם --host_crosstool_top לא מוגדר.
תגים:loading_and_analysis
,execution
- ברירת מחדל של
--host_crosstool_top=<a build target label>
: תיאור -
כברירת מחדל, האפשרויות מהלך --crosstool_top ו-- מהדר משמשות גם להגדרת המארח. אם הדגל הזה צוין, Bazel משתמשת ב-libc ובמהדר המוגדר כברירת מחדל עבור ה-crosstool_top הנתון.
תגים:loading_and_analysis
,changes_inputs
,affects_outputs
- ברירת מחדל של
--host_grte_top=<a label>
: תיאור -
אם מציינים, ההגדרה הזו מבטלת את הספרייה ברמה העליונה libc (--grte_top) של תצורת המארח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_platform=<a build target label>
: "" -
התווית של כלל הפלטפורמה שמתארת את מערכת האירוח.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: "true" -
אם הערך הוא true, Bazel לא יאפשר לציין extension_if_all_available ב-flag_sets(לקבלת הוראות העברה, יש לעיין בכתובת https://github.com/bazelbuild/bazel/issues/7008).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
אם הערך true, Bazel לא תפעיל את 'host' 'nonhost' תכונות בכלי C++ (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/7407).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enable_android_toolchain_resolution
: "false" -
שימוש ברזולוציה של Toolchain כדי לבחור את ה-SDK ל-Android לכללי Android (סטארלרק ו-Native)
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
שימוש ברזולוציית כלים כדי לבחור את ה-SDK של Apple לכללי התפוחים (Starlark ו-Native)
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
True
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: "true" -
אם הערך true, Bazel יתלונן כשמאפייני cc_toolchain.cpu ו-cc_toolchain.devguider מוגדרים (מידע נוסף זמין במאמר https://github.com/bazelbuild/bazel/issues/7075).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_remove_legacy_whole_archive
: "true" -
אם הדבר נכון, כברירת מחדל, Bazel לא תקשר קשרי תלות של ספרייה כארכיון כולו (בכתובת https://github.com/bazelbuild/bazel/issues/7362 ניתן למצוא הוראות העברה).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_require_ctx_in_configure_features
: "true" -
אם הערך true, Bazel ידרוש פרמטר 'ctx' in to cc_common.configure_features (מידע נוסף בכתובת https://github.com/bazelbuild/bazel/issues/7793).
תגים:loading_and_analysis
,incompatible_change
-
שימוש באובייקטים משותפים בממשק אם הם נתמכים על ידי ערכת הכלים. כל שרשראות הכלים של ELF תומכות בשלב זה בהגדרה הזו.
תגים:loading_and_analysis
,affects_outputs
,affects_outputs
- ברירת מחדל של
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
ההגדרה קובעת את גרסת ה-SDK של iOS לפיתוח אפליקציות ל-iOS. אם לא צוין, נעשה שימוש בגרסת ברירת מחדל של iOS SDK מ-'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
ההגדרה קובעת את גרסת ה-macOS SDK שבה משתמשים כדי לבנות אפליקציות ל-macOS. אם לא צוין, נעשה שימוש בגרסת macOS SDK המוגדרת כברירת מחדל מ-'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--minimum_os_version=<a string>
: תיאור -
גרסת מערכת ההפעלה המינימלית שהאוסף שלך מטרגט.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--platform_mappings=<a relative path>
: "" -
המיקום של קובץ מיפוי שמתאר באיזו פלטפורמה להשתמש אם לא הוגדרה פלטפורמה או באילו סימונים להגדיר כשהפלטפורמה כבר קיימת. חייב להיות יחסי לשורש הראשי של סביבת העבודה. ברירת המחדל היא 'platform_mappings' (קובץ שנמצא מתחת לרמה הבסיסית (root) של סביבת עבודה).
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--platforms=<a build target label>
: "" -
התוויות של כללי הפלטפורמה שמתארות את פלטפורמות היעד של הפקודה הנוכחית.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--python2_path=<a string>
: תיאור -
הוצא משימוש, לא-מושבת. מושבת על ידי `--incompatible_use_python_toolchains`.
תגים:no_op
,deprecated
- ברירת מחדל של
--python3_path=<a string>
: תיאור -
הוצא משימוש, לא-מושבת. מושבת על ידי `--incompatible_use_python_toolchains`.
תגים:no_op
,deprecated
- ברירת מחדל של
--python_path=<a string>
: תיאור -
הנתיב המוחלט של המתרגם ב-Python הופעל כדי להפעיל יעדים ב-Python בפלטפורמת היעד. הוצאה משימוש, הושבתה על ידי --incompatible_use_python_toolchains.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--python_top=<a build target label>
: תיאור -
התווית של py_runtime שמייצגת את התרגום של Python הופעלה להפעלת יעדים של Python בפלטפורמת היעד. הוצאה משימוש, הושבתה על ידי --incompatible_use_python_toolchains.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--target_platform_fallback=<a build target label>
: "@local_config_platform//:host" -
התווית של כלל הפלטפורמה שצריך להשתמש בה אם לא הוגדרה פלטפורמת יעד, ואין מיפוי פלטפורמה שתואם לקבוצת הסימונים הנוכחית.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
ההגדרה קובעת את גרסת ה-SDK של tvOS שבה משתמשים כדי ליצור אפליקציות TV. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של TV SDK מ-'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
ההגדרה קובעת את גרסת ה-SDK של WatchOS שבה משתמשים כדי לבנות אפליקציות שעון. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של WatchOS SDK מגרסה 'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--xcode_version=<a string>
: תיאור -
אם צוין, נעשה שימוש ב-Xcode של הגרסה הנתונה לפעולות build רלוונטיות. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של הביצוע של Xcode.
תגים:loses_incremental_state
- ברירת מחדל של
--xcode_version_config=<a build target label>
: "@bazel_tools//tools/cpp:host_xcodes" -
התווית של הכלל xcode_config שיש להשתמש בה לבחירת הגרסה של Xcode בתצורת ה-build.
תגים:loses_incremental_state
,loading_and_analysis
- אפשרויות ששולטות בפלט של הפקודה:
- ברירת מחדל של
--[no]apple_enable_auto_dsym_dbg
: "false" -
אם צריך לאלץ יצירה של קובצי ניפוי באגים (.dSYM) עבור גרסאות build ל-dbg.
תגים:affects_outputs
,action_command_lines
- ברירת מחדל של
--[no]apple_generate_dsym
: "false" -
האם ליצור קובצי ניפוי באגים ( .dSYM)?
תגים:affects_outputs
,action_command_lines
- ברירת מחדל של
--[no]build
: "true" -
יש לבצע את ההרכב. זו ההתנהגות הרגילה. ציון -nobuild גורם ל-build לעצור לפני ביצוע פעולות ה-build, ומחזיר אפס אם שלבי הטעינה והניתוח של החבילה הושלמו בהצלחה. מצב זה שימושי לבדיקת השלבים האלה.
תגים:execution
,affects_outputs
- ברירת מחדל של
--[no]build_runfile_links
: "true" -
אם הערך הוא true, יש ליצור יערות קישור ריצה עבור כל היעדים. אם False, כותבים מניפסטים רק כשהדבר אפשרי.
תגים:affects_outputs
- ברירת מחדל של
--[no]build_runfile_manifests
: "true" -
אם הערך הוא True, צריך לכתוב מניפסטים מסוג Runfiles בכל היעדים. אם FALSE, משמיטים אותן. הבדיקות המקומיות לא יפעלו אם הן יהיו שקריות.
תגים:affects_outputs
- ברירת מחדל של
--[no]build_test_dwp
: "false" -
אם האפשרות מופעלת, כשפותחים בדיקות C++ באופן סטטי ובצורה קפדנית, המערכת תיצור באופן אוטומטי גם קובץ .dwp עבור הקובץ הבינארי של הבדיקה.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--cc_proto_library_header_suffixes=<comma-separated list of options>
: ".pb.h" -
המערכת מגדירה את הקידומות של קובצי הכותרת שיוצרים ב-cc_proto_library.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--cc_proto_library_source_suffixes=<comma-separated list of options>
: ".pb.cc" -
מגדיר את הקידומות של קובצי המקור ש-cc_proto_library יוצר.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
אפשר לבצע פעולות נוספות על גרסאות API חלופיות של Java ב-proto_library.
תגים:affects_outputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_proto_extra_actions
: "false" -
אפשר לבצע פעולות נוספות על גרסאות API חלופיות של Java ב-proto_library.
תגים:affects_outputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_run_validations
: "true" -
יש להשתמש במקום זאת --run_validations.
תגים:execution
,affects_outputs
- ברירת מחדל של
--[no]experimental_save_feature_state
: "false" -
שומרים את המצב של תכונות מופעלות ומבוקשות כפלט של הידור.
תגים:affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_use_validation_aspect
: "false" -
האם להריץ פעולות אימות באמצעות היבט כלשהו (לשילוב במקביל עם בדיקות)?
תגים:execution
,affects_outputs
- ברירת מחדל של
--fission=<a set of compilation modes>
: "no" -
ההגדרה קובעת אילו מצבי הידור משתמשים בפיקוח עבור אוספי +C+. יכולים להיות כל שילובים של {'speedbuild', 'dbg', 'opt'} או ערכים מיוחדים 'yes' כדי להפעיל את כל המצבים &&339;no' כדי להשבית את כל המצבים.
תגים:loading_and_analysis
,action_command_lines
,affects_outputs
- ברירת מחדל של
--[no]legacy_external_runfiles
: "true" -
אם המדיניות מוגדרת כ-TRUE, יש לבנות יערות סימבונק של Runruns עבור מאגרים חיצוניים בכפוף ל- .runfiles/wsname/external/repo (בנוסף ל- .runfiles/repo).
תגים:affects_outputs
- ברירת מחדל של
--[no]objc_generate_linkmap
: "false" -
ההגדרה קובעת אם ליצור קובץ מפת קישור.
תגים:affects_outputs
- נצברו
--output_groups=<comma-separated list of options>
שימושים מרובים -
רשימה של שמות של קבוצות פלט המופרדים בפסיקים, שלכל אחד מהם יש קידומת + או -. קבוצה שקידומתה מתחילה ב-+ מתווספת לקבוצת ברירת המחדל של קבוצות פלט, ואילו קבוצה עם קידומת - תוסר מקבוצת ברירת המחדל. אם לפחות קבוצה אחת לא כוללת קידומת, המערכת תשמיט את קבוצת ברירת המחדל של קבוצות הפלט. לדוגמה,
תגים:execution
,affects_outputs
- ברירת מחדל של
--[no]run_validations
: "true" -
האם להריץ פעולות אימות כחלק מה-build? פרטים נוספים זמינים בכתובת https://bazel.build/rules/rules#validation_actions
תגים:execution
,affects_outputs
- ברירת מחדל של
--[no]save_temps
: "false" -
אם המדיניות מוגדרת, פלט זמני מ-gcc יישמר. דוגמאות לקובצי .s (קוד ליצירת מקטע), קובצי .i (C מעובד מראש) וקובצי .ii (C++ ). לפני העיבוד:
תגים:affects_outputs
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לעצם קיומו:
- נצברו
--action_env=<a 'name=value' assignment with an optional value part>
שימושים מרובים -
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם הגדרת יעד. אפשר לציין משתנים לפי שם. במקרה כזה, הערך יילקח מסביבת ההפעלה, או מצמד name=value שקובע את הערך בלי קשר לסביבת ההפעלה. ניתן להשתמש באפשרות זו כמה פעמים. לאפשרויות המוגדרות לאותו משתנה, המנצחים האחרונים, האפשרויות המצטברות למשתנים שונים.
תגים:action_command_lines
- ברירת מחדל של
--android_cpu=<a string>
: "armeabi-v7a" -
מעבד ה-Android לטירגוט.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]android_databinding_use_androidx
: "false" -
יוצרים קובצי התאמת נתונים ל-AndroidX. האפשרות הזו משמשת רק לקישור נתונים v2.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--[no]android_databinding_use_v3_4_args
: "false" -
שימוש ב-Android Databining v2 עם ארגומנט 3.4.0
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--android_dynamic_mode=<off, default or fully>
: "off" -
קביעה אם קישורי +C+ של כללי Android יקושרו באופן דינמי כאשר cc_binary לא ייצור באופן מפורש ספרייה משותפת. 'default' פירוש הדבר שבסיס הפנים יבחר אם לקשר באופן דינמי. 'ly' כלומר כל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי ברובו.
תגים:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
כברירת מחדל: "alphabetical"-
מגדיר את סדר המניפסטים שהועברו למיזוג המניפסט עבור קבצים בינאריים של Android. 'ALPHABETLY' פירושו שהמניפסטים ממוינים לפי הנתיב ביחס לרכיב ה-exe. ALPHABETical_BY_CONFIGURATION פירושו שהמניפסטים ממוינים לפי נתיבים ביחס לספריית התצורה בספריית הפלט. המשמעות של DEPENDENCY היא שמניפסטים מסודרים לפי כל ספרייה שנמצאת לפני המניפסטים של יחסי התלות שלה.
תגים:action_command_lines
,execution
- ברירת מחדל של
--[no]android_resource_shrinking
: "false" -
הפעלת כיווץ משאבים ל-APK_android_binary שמשתמשים ב-ProGuard
תגים:affects_outputs
,loading_and_analysis
- נצברו
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst>
שימושים מרובים -
יש לציין את מצב קוד ה-API של Apple לצורך שלבי הידור שמטרגטים את ארכיטקטורת המכשירים. הערכים צריכים להיות בפורמט '[platform=]mode' כאשר הפלטפורמה (שחייבת להיות 'ios', 'macos', 'tvos' או 'watchos') היא אופציונלית. אם צוין, מצב מצב הקידוד חל על הפלטפורמה הזו באופן ספציפי. אם לא נתון, הוא חל על כל הפלטפורמות. המצב חייב להיות 'none', 'embedded_סמןs' או 'embedded' ייתכן שהאפשרות הזו תוצג כמה פעמים.
תגים:loses_incremental_state
- נצברו
--aspects=<comma-separated list of options>
שימושים מרובים - רשימת היבטים המופרדים בפסיקים, שיחולו על יעדים ברמה העליונה. ברשימה, אם היבט some_aspect מציין ספקי היבט נדרשים דרך additional_aspect_providers, אז ערך some_aspect יפעל לאחר כל היבט שהוזכר לפניו ברשימת ההיבטים שהספקים שלהם מפרסמים שמצייתים לספקי הצד הנדרשים. בנוסף, לרכיב no_aspect תהיה אפשרות להפעיל אחרי כל ההיבטים הנדרשים שצוינו. לאחר מכן, ל-some_aspect תהיה גישה לערכים של אותם היבטים. <bzl-file-label>%<aspect_name>, לדוגמה '//tools:my_def.bzl%my_aspect', כאשר 'my_aspect' הוא ערך ברמה עליונה מכלי קובץ/my_def.bzl
- ברירת מחדל של
--[no]build_python_zip
: "auto" -
יצירת קובץ ZIP של קובץ הפעלה בצורת פיליון. ב-Windows, השבתה בפלטפורמות אחרות
תגים:affects_outputs
- נצברו
--catalyst_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה של ארכיטקטורה המופרדת בפסיקים שבשבילה לבנות קבצים בינאריים של Apple Catalyst.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--[no]collect_code_coverage
: "false" -
אם תציינו זאת, Bazel תפיק קוד אינסטרומנטציה (באמצעות אינסטרומנטציה אופליין, במידת האפשר) ותאסוף מידע על כיסוי במהלך הבדיקות. השינוי ישפיע רק על יעדים שתואמים לשיטה --instrumentation_filter. בדרך כלל, אין לציין אפשרות זו ישירות – 'Bazelcover' במקום זאת יש להשתמש בפקודה.
תגים:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ברירת מחדל: "speedbuild"-
מציינים את המצב שבו יוצג הקובץ הבינארי. ערכים: 'speedbuild', 'dbg', 'opt'.
תגים:affects_outputs
,action_command_lines
,explicit_in_output_path
- נצברו
--conlyopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc במהלך הידור קובצי המקור של C.
תגים:action_command_lines
,affects_outputs
- נצברו
--copt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-ccC.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--cpu=<a string>
: "" -
מעבד היעד.
תגים:changes_inputs
,affects_outputs
,explicit_in_output_path
- ברירת מחדל של
--cs_fdo_absolute_path=<a string>
: תיאור -
יש להשתמש בפרטי הפרופיל של CSFDO כדי לבצע אופטימיזציה של האוסף. מציינים את שם הנתיב המוחלט של קובץ ה-ZIP המכיל את קובץ הפרופיל, קובץ גולמי מסוג LLVM או קובץ שנוסף לאינדקס.
תגים:affects_outputs
- ברירת מחדל של
--cs_fdo_instrument=<a string>
: תיאור -
יצירת קבצים בינאריים עם אינסטרומנטציה של FDO רגישה להקשר. עם המהדר Clang/LLVM, הוא מקבל גם את שם הספרייה שמתחתיו יושלכו קובצי הפרופיל הגולמי בזמן הריצה.
תגים:affects_outputs
- ברירת מחדל של
--cs_fdo_profile=<a build target label>
: תיאור -
cs_fdo_profile המייצג את הפרופיל הרגיש של ההקשר שישמש לאופטימיזציה.
תגים:affects_outputs
- נצברו
--cxxopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc כשעורכים קובצי מקור ב-C++.
תגים:action_command_lines
,affects_outputs
- נצברו
--define=<a 'name=value' assignment>
שימושים מרובים -
כל אפשרות --הגדרה מציינת מטלה למשתנה build.
תגים:changes_inputs
,affects_outputs
- ברירת מחדל של
--dynamic_mode=<off, default or fully>
: "default" -
ההגדרה קובעת אם הקבצים הבינאריים מסוג C++ יקושרו באופן דינמי. 'default' פירושו ש-Bazel תבחר אם לקשר באופן דינמי. 'ly' כלומר כל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי ברובו.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--[no]enable_fdo_profile_absolute_path
: "true" -
אם המדיניות מוגדרת, שימוש ב-fdo_lbolute_profile_path יגדיל את השגיאה.
תגים:affects_outputs
- ברירת מחדל של
--[no]enable_runfiles
: "auto" -
הפעלה של עץ קישור סימולטני (runfiles); כברירת מחדל, התכונה מושבתת ב-Windows, בפלטפורמות אחרות.
תגים:affects_outputs
- נצברו
--experimental_action_listener=<a build target label>
שימושים מרובים -
הוצא משימוש לטובת היבטים. אפשר להשתמש ב-action_listener כדי לצרף action_action לביצוע פעולות build קיימות.
תגים:execution
,experimental
- ברירת מחדל של
--[no]experimental_android_compress_java_resources
: "false" -
דחיסת משאבים של Java ב-APK
תגים:affects_outputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_android_databinding_v2
: "false" -
שימוש בגרסה 2 של קישור ל-Android
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--[no]experimental_android_resource_shrinking
: "false" -
הפעלת כיווץ משאבים ל-APK_android_binary שמשתמשים ב-ProGuard
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
להשתמש בכלי Rex כדי לכתוב מחדש קובצי Dex
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--[no]experimental_convenience_symlinks
: "normal" -
סימון זה יקבע איך ינוהלו הקישורים הסימבוליים (הסמלים המקבילים שמופיעים בסביבת העבודה אחרי ה-build). ערכים אפשריים:
רגילה (ברירת מחדל): כל סוג של קישור סימולציית נוחות ייווצר או יימחק, כפי שנקבע על ידי ה-build.
נקי: כל הקישורים הסימבוליים יימחקו ללא תנאי.
התעלמות: הקישורים הקטנים נשארים לבד.
log_only: יצירת הודעות יומן כאילו הן #&39;normal' הועברו, אך לא מתבצעות בפועל פעולות של מערכת קבצים (שימושיות לכלים).
לידיעתך, ניתן להשפיע רק על קישורים סימבוליים ששמותיהם נוצרים על ידי הערך הנוכחי, --symlink_prefix. אם הקידומת משתנה, כל קישור קיים קיים יישאר ריק.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_convenience_symlinks_bep_event
: "false" -
הסימון הזה קובע אם נפרסם את אירוע buildConvenienceSymlinksIdentified ל-BuildEventProtocol. אם הערך הוא true, ל-BuildEventProtocol תהיה רשומה עבור consoleSymlinksIdentified, הכוללת את כל קישורי הנוחות שנוצרו בסביבת העבודה שלך. אם הערך הוא FALSE, הרשומה נוחת SymlinksIdentified ב-BuildEventProtocol תהיה ריקה.
תגים:affects_outputs
- נצברו
--experimental_multi_cpu=<comma-separated list of options>
שימושים מרובים -
הוצא משימוש. לא.
תגים:affects_outputs
,experimental
- ברירת מחדל של
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
יש להשתמש במחרוזות האלה כאפשרויות מהדר dataLayer של objc Builder.
תגים:action_command_lines
- ברירת מחדל של
--[no]experimental_omitfp
: "false" -
אם המדיניות מוגדרת כ-True, יש להשתמש ב-libunhost עבור שחרור מחסניות (stackunack) ולהידור באמצעות -fomit-frame-pointer ו- -fסינכרוני-un Wind-tables.
תגים:action_command_lines
,affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_platform_in_output_dir
: "false" -
אם הערך הוא True, פלטפורמת היעד תשמש בשם של ספריית הפלט במקום ביחידת העיבוד המרכזית (CPU).
תגים:affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_use_llvm_covmap
: "false" -
אם צוין, Bazel תיצור פרטי מפה של llvm-cov במקום gcov כש-collect_code_coverage מופעל.
תגים:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--fat_apk_cpu=<comma-separated list of options>
: "armeabi-v7a" -
הגדרת האפשרות הזו מאפשרת חבילות APK בעלות שומן, המכילות קבצים בינאריים מקומיים לכל ארכיטקטורת היעד שצוינה, לדוגמה, --fat_APK_cpu=x86,armeabi-v7a. אם הדגל הזה צוין, המערכת תתעלם מ-android_cpu בהתאם לתלויים בכללי android_binary.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]fat_apk_hwasan
: "false" -
אם רוצים ליצור פיצולים מסוג HWASAN.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--fdo_instrument=<a string>
: תיאור -
יצירת קבצים בינאריים עם אינסטרומנטציה של FDO. עם המהדר Clang/LLVM, הוא מקבל גם את שם הספרייה שמתחתיו יושלכו קובצי הפרופיל הגולמי בזמן הריצה.
תגים:affects_outputs
- ברירת מחדל של
--fdo_optimize=<a string>
: תיאור -
יש לך אפשרות להשתמש בפרטי הפרופיל ב-FDO כדי לבצע אופטימיזציה של האוסף. יש לציין את השם של קובץ ZIP המכיל עץ קבצים עם הסיומת .gcda, קובץ afdo המכיל פרופיל אוטומטי או קובץ פרופיל LLVM. סימון זה מקבל גם קבצים שצוינו כתוויות (למשל `//foo/bar:file.afdo` – ייתכן שיהיה עליך להוסיף הנחיית ’exports_files’ לחבילה המתאימה) ותוויות המפנות ליעדים ’fdo_profile’. סימון זה יוחלף על ידי הכלל 'fdo_profile'.
תגים:affects_outputs
- ברירת מחדל של
--fdo_prefetch_hints=<a build target label>
: תיאור -
להשתמש ברמזים למטמון מראש.
תגים:affects_outputs
- ברירת מחדל של
--fdo_profile=<a build target label>
: תיאור -
פרופיל העסק fdo_profile משמש לאופטימיזציה של הפרופיל.
תגים:affects_outputs
- נצברו
--features=<a string>
שימושים מרובים -
כברירת מחדל, כל התכונות יופעלו או יושבתו. ציון -<feature> ישבית את התכונה באופן גלובלי. תכונות שליליות תמיד מבטלות תכונות חיוביות. הסימון הזה משמש להשקת שינויי ברירת מחדל בתכונות ללא גרסת Bazel.
תגים:changes_inputs
,affects_outputs
- ברירת מחדל של
--[no]force_pic
: "false" -
אם המדיניות מופעלת, כל האוספים של C++ מייצרים קוד עצמאי למיקום ("-fPIC"), קישורים מעדיפים ספריות מוגדרות מראש של PIC על פני ספריות שאינן מסוג PIC, וקישורים מייצרים קובצי הפעלה שאינם תלויי מיקום ("-Pie").
תגים:loading_and_analysis
,affects_outputs
- נצברו
--host_action_env=<a 'name=value' assignment with an optional value part>
שימושים מרובים -
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם תצורות מארח או ביצוע. אפשר לציין משתנים לפי שם. במקרה כזה, הערך יילקח מסביבת ההפעלה, או מצמד name=value שקובע את הערך בלי קשר לסביבת ההפעלה. ניתן להשתמש באפשרות זו כמה פעמים. לאפשרויות המוגדרות לאותו משתנה, המנצחים האחרונים, האפשרויות המצטברות למשתנים שונים.
תגים:action_command_lines
- ברירת מחדל של
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
ציון המצב שבו ייעשה שימוש בכלים ששימשו ליצירת ה-build. ערכים: 'speedbuild', 'dbg', 'opt'.
תגים:affects_outputs
,action_command_lines
- נצברו
--host_conlyopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc במהלך הידור קובצי המקור של C עבור כלי מארח.
תגים:action_command_lines
,affects_outputs
- נצברו
--host_copt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-cc עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_cpu=<a string>
: "" -
המעבד (CPU) המארח.
תגים:changes_inputs
,affects_outputs
- נצברו
--host_cxxopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-cc עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_force_python=<PY2 or PY3>
: תיאור -
עוקפת את הגרסה ב-Python של תצורת המארח. יכול להיות "PY2" או "PY3".
תגים:loading_and_analysis
,affects_outputs
- נצברו
--host_linkopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc בעת קישור כלים למארח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת macOS תואמת מינימלית ליעדים של מארח. אם לא צוין, נעשה שימוש ב-'macos_sdk_version'.
תגים:loses_incremental_state
- נצברו
--host_swiftcopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-swiftc עבור כלים למארחים.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--[no]incompatible_avoid_conflict_dlls
: "true" -
אם אפשרות זו מופעלת, כל הספריות המקושרות מסוג C++ (DLL) שנוצרו על ידי cc_library ב-Windows יעברו שינוי שם ל-name_{Hash}.dll, שם הגיבוב מחושב על סמך ה-RepositoryName ונתיב החבילה DLL'. האפשרות הזו שימושית כשיש חבילה אחת שתלויה בכמה cc_library עם אותו שם (לדוגמה //foo/bar1:utils ו-//foo/bar2:utils).
תגים:loading_and_analysis
,affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_merge_genfiles_directory
: "true" -
אם המדיניות מוגדרת כ-True, ספריית הגנרטורים מקופלת בספריית bin.
תגים:affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_use_platforms_repo_for_constraints
: "true" -
אם הערך מקבל את הערך True, הגדרות אילוץ של @bazel_tools יוסרו.
תגים:affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]instrument_test_targets
: "false" -
כשהאפשרות 'כיסוי' מופעלת, המדיניות הזו קובעת אם לשקול כללים להגדרת אינסטרומנטציה. במהלך ההגדרה, המערכת מוסיפה אמצעי בדיקה שכוללים --instrumentation_filter. אחרת, כללי הבדיקה תמיד לא ייכללו באינסטרומנטציה של הכיסוי.
תגים:affects_outputs
- ברירת מחדל
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-/Javatests[/:],- /test/Java[/:]" -
אם מפעילים את הכיסוי, המערכת מחילה רק כללים שהשמות שלהם נכללים במסנן שצוין לפי ביטוי רגולרי. כללים עם קידומת '-' אינם נכללים במקום זאת. לתשומת ליבכם: רק כללים שאינם בדיקות נמשכים לאינדקס, אלא אם מפעילים את --instrument_test_targets.
תגים:affects_outputs
- ברירת מחדל של
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסה מינימלית של iOS שתואמת לסימולטורים ולסימולטורים מבוססי יעד. אם לא צוין, נעשה שימוש ב-'ios_sdk_version'.
תגים:loses_incremental_state
- נצברו
--ios_multi_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה מופרדת בפסיקים של ארכיטקטורה שאפשר לבנות באמצעותה ios_application. התוצאה היא קובץ בינארי אוניברסלי המכיל את כל הארכיטקטורה שצוינה.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--[no]legacy_whole_archive
: "true" -
הוצאה משימוש, הוחלפה על ידי --incompatible_remove_Legacy_whole_archive (לפרטים נוספים: https://github.com/bazelbuild/bazel/issues/7362). במצב מופעל, יש להשתמש ב-allall-archive כדי להשתמש בכללים של cc_binary שיש להם linkshared=True וב-linkstatic=True או '-static' ב-linkopts. הערך הזה מיועד לתאימות לאחור בלבד. במקום זאת, עדיף להשתמש תמיד ב-linklink=1, היכן שנדרש.
תגים:action_command_lines
,affects_outputs
,deprecated
- נצברו
--linkopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc בזמן הקישור.
תגים:action_command_lines
,affects_outputs
- נצברו
--ltobackendopt=<a string>
שימושים מרובים -
אפשרות נוספת למעבר לשלב הקצה העורפי של LTO (בקטע --features=thin_lto).
תגים:action_command_lines
,affects_outputs
- נצברו
--ltoindexopt=<a string>
שימושים מרובים -
אפשרות נוספת למעבר לשלב ההוספה לאינדקס של LTO (בקטע --features=thin_lto).
תגים:action_command_lines
,affects_outputs
- נצברו
--macos_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה של ארכיטקטורה שמופרדת בפסיקים שבשבילה צריך ליצור קבצים בינאריים של Apple macOS.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת macOS תואמת מינימלית ליעדים. אם לא צוין, נעשה שימוש ב-'macos_sdk_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--[no]objc_debug_with_GLIBCXX
: "false" -
אם המדיניות מוגדרת, ומצב העריכה מוגדר כך: 'dbg', GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC ו-GLIBCPP_CONCEPT_CHECKS.
תגים:action_command_lines
- ברירת מחדל של
--[no]objc_enable_binary_stripping
: "false" -
האם לבצע רצועות של סימנים וקוד לא פעיל בבינאריים מקושרים. אם בוחרים את הסימון הזה וגם את הסימון 'compilation_mode=opt', המערכת תסיר מחרוזות בינאריות.
תגים:action_command_lines
- נצברו
--objccopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-cc במהלך הידור קובצי המקור 'יעד-C/C++'.
תגים:action_command_lines
- נצברו
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
שימושים מרובים -
אפשרויות נוספות להעברה סלקטיבית ל-cc כשעורכים קבצים מסוימים. ניתן להעביר את האפשרות הזו כמה פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. המונח regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (יש לעיין גם ב-(instrumentation_filter). האפשרות_1 עד Option_n מתייחסת לאפשרויות שרירותיות של שורות פקודה. אם אפשרות מכילה פסיק, צריך לצטט לוכסן הפוך. האפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --for
תגים:action_command_lines
,affects_outputs
- נצברו
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
שימושים מרובים - אפשרויות נוספות להעברה סלקטיבית לקצה העורפי של LTO (בקטע --features=thin_lto) כשעורכים אובייקטים בקצה העורפי. ניתן להעביר את האפשרות הזו כמה פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. כאשר regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים, Option_1 עד Option_n מתייחסת לאפשרויות שרירותיות של שורות פקודה. אם אפשרות מכילה פסיק, צריך לצטט לוכסן הפוך. האפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --per
- ברירת מחדל של
--platform_suffix=<a string>
: תיאור -
קביעת סיומת שתתווסף לספריית התצורה.
תגים:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ברירת מחדל של
--propeller_optimize=<a build target label>
: תיאור -
יש להשתמש בפרטי פרופיל ה-Proproler כדי לבצע אופטימיזציה של יעד ה-build.פרופיל דו-שיח חייב להכיל לפחות אחד משני קבצים, פרופיל ב-cc ופרופיל ישן. הדגל הזה מקבל תווית build שחייבת להפנות לקובצי הקלט של פרופיל המדחף. לדוגמה, קובץ ה-BUILD שמגדיר את התווית, ב-a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) הוראה יכולה להיות זמינה כדי להוסיף את הקבצים הבאים יש להשתמש באפשרות הזו באופן הבא: --propeller_optimize=//a/b:propeller_profile
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--propeller_optimize_absolute_cc_profile=<a string>
: תיאור -
שם הנתיב המוחלט של קובץ cc_profile עבור גרסאות build שעברו אופטימיזציה של Profeler.
תגים:affects_outputs
- ברירת מחדל של
--propeller_optimize_absolute_ld_profile=<a string>
: תיאור -
שם הנתיב המוחלט של קובץ ld_profile עבור גרסאות build שעברו אופטימיזציה ל-Propleler.
תגים:affects_outputs
- ברירת מחדל של
--run_under=<a prefix in front of command>
: תיאור -
קידומת שצריך להוסיף לפני קובצי ההפעלה עבור הפקודות 'test' &'run' אם הערך הוא 'foo -bar' ושורת הפקודה היא 'test_binary -baz' , שורת הפקודה הסופית היא 'foo -bar test_binary -baz'. . היא יכולה להיות גם תווית ליעד הפעלה. לדוגמה: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target', '//package:target #
תגים:action_command_lines
-
אם True, ספריות מקוריות שמכילות פונקציונליות זהה ישותפו בין היעדים השונים
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--[no]stamp
: "false" -
פריטים בינאריים בחותמת עם התאריך, שם המשתמש, שם המארח, פרטי סביבת העבודה וכו'
תגים:affects_outputs
- ברירת מחדל של
--strip=<always, sometimes or never>
: "sometimes" -
ההגדרה קובעת אם להסיר בינאריים וספריות משותפות (באמצעות "-Wl,--strip-debug"). ערך ברירת המחדל של 'sometimes' פירושו רצועת אם if- --compilation_mode=fastbuild.
תגים:affects_outputs
- נצברו
--stripopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה כאשר יוצרים קובץ בינארי של '<name>.stripped'
תגים:action_command_lines
,affects_outputs
- נצברו
--swiftcopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה לאוסף של Swift.
תגים:action_command_lines
- ברירת מחדל של
--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>
שימושים מרובים -
רשימה של ארכיטקטורה המופרדת בפסיקים שבשבילה לבנות קבצים בינאריים של AppleOS.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסה מינימלית של WatchOS תואמת לסימולטורים ולסימולטורים מבוססי יעד. אם לא צוין, נעשה שימוש ב-'watchos_sdk_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--xbinary_fdo=<a build target label>
: תיאור -
יש לך אפשרות להשתמש בפרטי הפרופיל ב-XbinaryFDO כדי לבצע אופטימיזציה של האוסף. קביעת השם של פרופיל בינארי כברירת מחדל. אם משתמשים באפשרות הזו יחד עם --fdo_instrument/--fdo_optimize/--fdo_profile, האפשרויות האלה תמיד יקבלו את הערך כאילו xbinary_fdo לא צוין.
תגים:affects_outputs
- אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
- ברירת מחדל של
--auto_cpu_environment_group=<a build target label>
: "" -
מציינים את המאפייןEnvironment_group [קבוצת_סביבה] שישמש למיפוי אוטומטי של ערכי pu לערכי target_environment.
תגים:changes_inputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]check_licenses
: "false" -
צריך לוודא שמגבלות הרישוי שנקבעות על ידי חבילות תלויות לא מתנגשות עם מצבי ההפצה של היעדים שאתם יוצרים. כברירת מחדל, הרישיונות לא נבדקים.
תגים:build_file_semantics
- ברירת מחדל של
--[no]check_visibility
: "true" -
אם המדיניות מושבתת, שגיאות חשיפה בתלויות יעד יורדו לאזהרות.
תגים:build_file_semantics
- ברירת מחדל של
--[no]desugar_for_android
: "true" -
האם לבצע פענוח קוד בייט 8 של סוכר לפני פענוח הקוד?
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]desugar_java8_libs
: "false" -
האם לכלול ספריות Java 8 נתמכות באפליקציות למכשירים מדור קודם.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--[no]enforce_constraints
: "true" -
לבדוק את הסביבות שבהן כל יעד תואם, ומדווח על שגיאות אם לכל יעד יש יחסי תלות שלא תומכים באותן סביבות
תגים:build_file_semantics
- ברירת מחדל של
--[no]experimental_allow_android_library_deps_without_srcs
: "false" -
סימון כדי לעזור במעבר מהמדיניות של אי-אפשר להשתמש בכללי android_library ללא כינויים באמצעות נקודות שפל. יש לנקות את המאגר כדי שההוצאה תתבצע כברירת מחדל.
תגים:eagerness_to_exit
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_check_desugar_deps
: "true" -
האם כדאי לבדוק שוב את ניפוי הבאגים הנכון ברמה הבינארית של Android.
תגים:eagerness_to_exit
,loading_and_analysis
,experimental
- ברירת מחדל של
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
כשהאפשרות מופעלת, בודקים אם התלות של aar_import הסתיימו. האכיפה הזו עלולה לפרוץ את הבנייה, או להוביל רק לאזהרות.
תגים:loading_and_analysis
- ברירת מחדל של
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "default" -
אם הערך הוא true, המערכת בודקת שיעד של Java מצהיר במפורש על כל היעדים שנעשה בהם שימוש ישיר כתלויות.
תגים:build_file_semantics
,eagerness_to_exit
- ברירת מחדל של
--[no]incompatible_check_testonly_for_output_files
: "false" -
אם האפשרות הזו מופעלת, יש לבדוק רק את היעדים הנדרשים שהם קובצי פלט, על ידי חיפוש הבדיקה בלבד של כלל היצירה. ההגדרה הזו תואמת לבדיקת הניראות.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_disable_native_android_rules
: "false" -
אם המדיניות מופעלת, השימוש הישיר בכללי Android המקוריים מושבת. יש להשתמש בכללי Starlark ל-Android בכתובת https://github.com/bazelbuild/rules_android
תגים:eagerness_to_exit
,incompatible_change
- ברירת מחדל של
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
לא צריך להשתמש בהגדרה הזו. אפשר לשמור כאן לצורך תאימות לאחור.
תגים:eagerness_to_exit
,incompatible_change
- ברירת מחדל של
--[no]incompatible_force_strict_header_check_from_starlark
: "true" -
אם האפשרות מופעלת, ניתן להגדיר בדיקת כותרות מחמירה ב-Starlark API
תגים:loading_and_analysis
,changes_inputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
אם הדבר נכון, Bazel תוודא גם שההכללה של הספרייה היא ברמה העליונה (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/10047).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]strict_filesets
: "false" -
אם האפשרות הזו מופעלת, קבצים שחוצים את גבולות החבילה מדווחים כשגיאות. הוא לא פועל כאשר Check_fileset_dependencies_recursively מושבת.
תגים:build_file_semantics
,eagerness_to_exit
- ברירת מחדל של
--strict_proto_deps=<off, warn, error, strict or default>
: "error" -
אלא אם האפשרות מושבתת, המערכת בודקת שיעד Proto_library מצהיר באופן מפורש על כל היעדים שנעשה בהם שימוש ישיר כתלויות.
תגים:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ברירת מחדל של
--strict_public_imports=<off, warn, error, strict or default>
: "off" -
אלא אם האפשרות מושבתת, המערכת בודקת שיעד Proto_library מצהיר באופן מפורש על כל היעדים שנעשה בהם שימוש ב 'ייבוא ציבורי'.
תגים:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ברירת מחדל של
--[no]strict_system_includes
: "false" -
אם הערך הוא True, צריך להצהיר גם על כותרות שנמצאות דרך נתיבים (-isystem).
תגים:loading_and_analysis
,eagerness_to_exit
- נצברו
--target_environment=<a build target label>
שימושים מרובים -
מצהירה על סביבת היעד הזו. הערך חייב להיות תווית של כלל "enrinoment" אם צוין, כל היעדים ברמה העליונה חייבים להתאים לסביבה הזו.
תגים:changes_inputs
- אפשרויות שמשפיעות על הפלט של החתימה של גרסת build:
- ברירת מחדל של
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
הטמעה שתשמש לחתימה על חבילות APK
תגים:action_command_lines
,affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]device_debug_entitlements
: "true" -
אם המדיניות מוגדרת ומצב האוסף לא 'opt' אפליקציות objc יכללו הרשאות לניפוי באגים בזמן החתימה.
תגים:changes_inputs
- ברירת מחדל של
--ios_signing_cert_name=<a string>
: תיאור -
שם האישור לשימוש בחתימת iOS. אם המדיניות לא מוגדרת, תוחזר לפרופיל ניהול התצורה. יכול להיות העדפת הזהות של אישור המפתח או מחרוזת המשנה של השם הנפוץ באישור, בהתאם לדף האדם של ה-Codesign ' (מפתח רישום).
תגים:action_command_lines
- האפשרות הזו משפיעה על סמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו בקובצי BUILD, קובצי .bzl או קובצי WORKSPACE.:
- ברירת מחדל של
--[no]incompatible_config_setting_private_default_visibility
: "false" -
אם לא תואם_enforce_config_setting_visible=false, זו שגיאה. אחרת, אם הסימון הזה הוא false, כל הגדרת config_ללא מאפיין חשיפה בוטה היא //visible:public. אם הסימון הזה נכון, המאפיין config_setting תואם ללוגיקה של הרשאות הגישה שדומה לכל הכללים האחרים. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12933.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_disallow_legacy_py_provider
: "true" -
לא, המערכת תסיר אותה בקרוב.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enforce_config_setting_visibility
: "true" -
אם המדיניות מוגדרת כ-True, יש לאכוף את הרשאות הגישה מסוג config_setting. אם הערך הוא False, כל config_setting גלויה לכל יעד. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים:loading_and_analysis
,incompatible_change
- אפשרויות שקובעות את אופן הפעולה של סביבת הבדיקה או של אופרטור הבדיקה:
- ברירת מחדל של
--[no]allow_analysis_failures
: "false" -
אם הערך מקבל את הערך 'true', כשל בניתוח של יעד הוא מפיץ את המופע של target&ailureInfo המכיל את תיאור השגיאה, במקום לגרום לכשל ב-build.
תגים:loading_and_analysis
,experimental
- ברירת מחדל של
--analysis_testing_deps_limit=<an integer>
: "2000" -
מגדיר את המספר המקסימלי של יחסי תלות זמניים באמצעות מאפיין של כלל עם מעבר לתצורה for_analysis_testing. חריגה מהמגבלה תגרום לשגיאה בכלל.
תגים:loading_and_analysis
- ברירת מחדל של
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
אם כשלים אמיתיים בפעולת dex2oat יגרמו לקריסה של המודל במקום לבצע Dex2oat בזמן ריצה של הבדיקה.
תגים:loading_and_analysis
,experimental
- ברירת מחדל של
--[no]check_tests_up_to_date
: "false" -
אין להריץ בדיקות. יש לבדוק אם הן מעודכנות. אם כל תוצאות הבדיקות מעודכנות, הבדיקה הושלמה בהצלחה. אם יש צורך לבצע או להפעיל בדיקה כלשהי, מדווחת על שגיאה והבדיקה נכשלה. אם בוחרים באפשרות הזו, פירוש הדבר הוא --check_up_to_date.
תגים:execution
- ברירת מחדל של
--[no]experimental_android_use_parallel_dex2oat
: "false" -
משתמשים ב-dex2oat במקביל כדי להאיץ את android_test.
תגים:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- נצברו
--flaky_test_attempts=<a positive integer, the string "default", or test_regex@attempts. This flag may be passed more than once>
שימושים מרובים -
כל בדיקה תבוצע שוב עד למספר הפעמים שהוגדר, במקרה שהבדיקה נכשלה. בדיקות שנדרש בהן יותר מניסיון אחד מסומנות כ-'FLAKY' בסיכום הבדיקה. בדרך כלל, הערך שצוין הוא מספר שלם או המחרוזת 'default'. אם מספר שלם, כל הבדיקות יופעלו עד N פעמים. אם 'default', יבוצע ניסיון בדיקה אחד בלבד בבדיקות רגילות ושלושה בבדיקות שסומנו באופן מפורש ככללי על ידי הכלל שלהם (Flaky=1). תחביר חלופי: regex_filter@flky_test_attempts. כאשר Flaky_test_attempts נמצא למעלה, ו-regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (ראו גם --runs_per_test). דוגמה: -flky_test_attempts=//foo/.*,-//foo/bar/.*@3 ניתן להעביר את האפשרות הזו כמה פעמים. הארגומנט האחרון שהועבר תואם לעדיפות. אם לא נמצאה התאמה, ההתנהגות היא כאילו 'default' לעיל.
תגים:execution
- ברירת מחדל של
--[no]ios_memleaks
: "false" -
הפעלה של בדיקת דליפות זיכרון ביעדי ios_test.
תגים:action_command_lines
- ברירת מחדל של
--ios_simulator_device=<a string>
: תיאור -
המכשיר להדמיית הפעלה של אפליקציה ל-iOS בסימולטור, לדוגמה 'iPhone 6'. ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים:test_runner
- ברירת מחדל של
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת ה-iOS שצריך להפעיל בסימולטור בזמן ההפעלה או הבדיקה. המערכת תתעלם מהמדיניות הזו עבור כללי ios_test אם מכשיר היעד צוין בכלל.
תגים:test_runner
- ברירת מחדל של
--local_test_jobs=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
המספר המקסימלי של משימות בדיקה מקומיות שפועלות בו-זמנית. הפרמטר מכיל מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ואחריו אופציונלי (למשל, [-|*]<float>) למשל. "auto", "HOST_CPUS*.5". 0 פירושו שמשאבים מקומיים יגבילו את מספר משימות הבדיקה המקומיות להפעלה בו-זמנית. ההגדרה הזו גדולה יותר מהערך של jobs היא לא אפקטיבית.
תגים:execution
- נצברו
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
שימושים מרובים - ההגדרה קובעת את מספר הפעמים שיש להריץ כל בדיקה. אם אחד מהניסיונות נכשל מסיבה כלשהי, הבדיקה כולה תיחשב כושלת. בדרך כלל, הערך שצוין הוא מספר שלם בלבד. דוגמה: -runs_per_test=3 יפעיל את כל הבדיקות 3 פעמים. תחביר חלופי: regex_filter@runs_per_test. כאשר Run_per_test הוא ערך של מספר שלם ו-regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (ראו גם --instrumentation_filter). דוגמה: --runs_per_test=//foo/.*,-//foo/bar/.*@3 מריץ את כל הבדיקות ב-//foo/ אבל לא מתחת ל-foo/bar שלוש פעמים. ניתן להעביר את האפשרות הזו כמה פעמים. הארגומנט האחרון שהועבר תואם לעדיפות. אם אין תוצאות תואמות, הבדיקה תופעל פעם אחת בלבד.
- נצברו
--test_env=<a 'name=value' assignment with an optional value part>
שימושים מרובים -
ההגדרה קובעת משתני סביבה נוספים שיוחדרו לסביבת הרצה של הבדיקה. אפשר לציין משתנים לפי שם. במקרה כזה, הערך שלהם ייקרא מסביבת הלקוח ב-Bazel או באמצעות צמד name=value. אפשר להשתמש באפשרות הזו כמה פעמים כדי לציין כמה משתנים. בשימוש רק באמצעות הפקודה 'bazel' .
תגים:test_runner
- ברירת מחדל של
--[no]test_keep_going
: "true" -
כשהבדיקה מושבתת, כל הבדיקות שלא עברו יגרמו להפסקה של כל ה-build. כברירת מחדל, כל הבדיקות פועלות, גם אם חלק מהן לא עוברות.
תגים:execution
- ברירת מחדל של
--test_strategy=<a string>
: "" -
קביעת השיטה שבה רוצים להפעיל בדיקות.
תגים:execution
- ברירת מחדל של
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - כדאי לשנות את ערכי ברירת המחדל של הזמן הקצוב לתפוגה של בדיקות (בדקות) אם יצוין ערך חיובי אחד שלם, הוא יחליף את כל הקטגוריות. אם ציינתם 4 מספרים שלמים המופרדים בפסיקים, הם יחליפו את הזמן הקצוב לתפוגה עבור קצר, בינוני, ארוך ותמידי (בסדר הזה). בכל אחד מהפורמטים, הערך 1- מורה ל-blaze להשתמש בברירות המחדל של הזמן הקצוב לתפוגה עבור קטגוריה זו.
- ברירת מחדל של
--test_tmpdir=<a path>
: תיאור - מפרט את הספרייה הזמנית הבסיסית עבור 'בדיקת B&z#39; לשימוש.
- ברירת מחדל של
--tvos_simulator_device=<a string>
: תיאור -
המכשיר להדמיית הפעלה של אפליקציית tvOS בסימולטור, למשל 'Apple TV 1080p' ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים:test_runner
- ברירת מחדל של
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת ה-tvOS שפועלת בסימולטור בזמן הפעלה או בדיקה.
תגים:test_runner
- ברירת מחדל של
--watchos_simulator_device=<a string>
: תיאור -
המכשיר להדמיית הפעלה של אפליקציית WatchOS בסימולטור, למשל 'Apple Watch – 38mm' ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים:test_runner
- ברירת מחדל של
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת ה-watchOS שמופעלת בסימולטור כשמריצים או בודקים.
תגים:test_runner
- ברירת מחדל של
--[no]zip_undeclared_test_outputs
: "true" -
אם הערך הוא True, פלט של בדיקות לא מוצהרות יועברו לארכיון בקובץ ZIP.
תגים:test_runner
- אפשרויות שגורמות לאופטימיזציה של זמן ה-build:
- ברירת מחדל של
--[no]collapse_duplicate_defines
: "false" -
כשהאפשרות מופעלת, ההגדרות המיותרות יוסרו בשלב מוקדם. כדי למנוע אובדן מיותר של מטמון הניתוח לסוגים מסוימים של גרסאות build מקבילות.
תגים:loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
יש לסנן את ProGuard ProgramJar כדי להסיר את כל הכיתות שנמצאות גם ב-LibraryJar.
תגים:action_command_lines
- ברירת מחדל של
--[no]experimental_inmemory_dotd_files
: "true" -
כשהאפשרות מופעלת, קובצי C++ .d יועברו בזיכרון ישירות מצומתי ה-build המרוחק במקום להיכתב לדיסק.
תגים:loading_and_analysis
,execution
,affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_inmemory_jdeps_files
: "true" -
אם האפשרות מופעלת, קובצי התלויות (.jdeps) שנוצרו מהאוספים של Java יועברו בזיכרון ישירות מצומתי ה-build המרוחק במקום להיכתב לדיסק.
תגים:loading_and_analysis
,execution
,affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_objc_include_scanning
: "false" -
האם לבצע סריקה עבור אובייקט C/C+ אובייקטיבי.
תגים:loading_and_analysis
,execution
,changes_inputs
- ברירת מחדל של
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "false" -
אם התכונה parse_headers מופעלת, אם לא קיים מקור באותו שם יעד, היא לא יוצרת פעולת רינדור נפרדת של כותרת.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
כשהאפשרות מופעלת, --trim_test_Configuration לא יקטע את תצורת הבדיקה של כללים שסומנו לבדיקה בלבד=1. כך אנחנו מצמצמים את הבעיות של התנגשות בין פעולות כאשר כללים שאינם בדיקות תלויים בכללים של cc_test. אין השפעה אם --trim_test_ Configuration היא FALSE.
תגים:loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]experimental_starlark_cc_import
: "false" -
אם ההגדרה מופעלת, אפשר להשתמש בגרסת Starlark של cc_import.
תגים:loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
כדי לצמצם את קלט הקלט לאוסף C/C++ , יש לנתח #include שורות מקובצי קלט. כך אפשר לשפר את הביצועים ואת הצבירה על ידי הקטנת הגודל של עצי ההזנה של האוסף. עם זאת, היא עלולה לשבור גרסאות build כי הסורק של כלי העריכה לא מטמיע באופן מלא את הסמנטיקה של מעבד המידע (CPU) לפני העיבוד. באופן ספציפי, הוא לא מבין הוראות #include דינמיות ומתעלם מלוגיקה מותנית של עיבוד מראש. השימוש הוא באחריותך בלבד. כל בעיה הנוגעת לסימון זה ייסגר.
תגים:loading_and_analysis
,execution
,changes_inputs
- ברירת מחדל של
--[no]incremental_dexing
: "true" -
רוב העבודה על דקס נפתחת בנפרד בכל קובץ ב-Jar.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]objc_use_dotd_pruning
: "true" -
אם המדיניות מוגדרת, קובצי .d שנוצרו על ידי ה-Clang ישמשו לגיזום קבוצת הקלט הנכנסת מהדרים objc.
תגים:changes_inputs
,loading_and_analysis
- ברירת מחדל של
--[no]process_headers_in_dependencies
: "false" -
כשיוצרים יעד //a:a, צריך לעבד כותרות בכל היעדים ש //a:a תלויים בהם (אם עיבוד הכותרת מופעל עבור Toolchain).
תגים:execution
- ברירת מחדל של
--[no]trim_test_configuration
: "true" -
כשהאפשרות מופעלת, האפשרויות שקשורות לבדיקה יימחקו מתחת לרמה העליונה של ה-build. כשהסימון הזה פעיל, לא ניתן ליצור בדיקות כתלויות של כללים שאינם בדיקות, אבל שינויים באפשרויות הקשורות לבדיקה לא יגרמו לניתוח מחדש של כללים שאינם בדיקות.
תגים:loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]use_singlejar_apkbuilder
: "true" -
האפשרות הזו הוצאה משימוש. לא חייבים להשתמש בה והיא תוסר בקרוב.
תגים:loading_and_analysis
- אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]announce
: "false" -
הוצא משימוש. לא.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_bep_target_summary
: "false" - אם רוצים לפרסם אירועי סיכום סיכום.
- ברירת מחדל של
--[no]experimental_build_event_expand_filesets
: "false" -
אם הערך הוא TRUE, מרחיבים את FilesApps ב-BEP כשמציגים קובצי פלט.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_build_event_fully_resolve_fileset_symlinks
: "false" -
אם הערך הוא True, יש לפתור בצורה מלאה את סמלי הקישור היחסיים של Fileset ב-BEP כשמציגים קובצי פלט. נדרשת -experimental_build_event_expand_filesets.
תגים:affects_outputs
- ברירת מחדל של
--experimental_build_event_upload_max_retries=<an integer>
: "4" -
מספר הפעמים המקסימלי שחברת Bazel מנסה להעלות אירוע build.
תגים:bazel_internal_configuration
- ברירת מחדל של
--experimental_build_event_upload_retry_minimum_delay=<An immutable length of time.>
: "1s" -
השהיה מינימלית עד לעיכוב מעריכי של ניסיונות חוזרים כאשר העלאה של BEP נכשלה. (מעריך: 1.6)
תגים:bazel_internal_configuration
- ברירת מחדל של
--experimental_build_event_upload_strategy=<a string>
: תיאור -
בחירה איך להעלות פריטי מידע שנוצרים בתהליך פיתוח (Artifact) המוזכרים בפרוטוקול של אירוע ה-build.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_materialize_param_files_directly
: "false" -
אם יוצרים קובצי עזר, צריך לעשות זאת בכתיבה ישירה לדיסק.
תגים:execution
- ברירת מחדל של
--[no]experimental_stream_log_file_uploads
: "false" -
אפשר להעביר העלאות של קובצי יומן ישירות לאחסון המרוחק, במקום לכתוב אותם בדיסק.
תגים:affects_outputs
- ברירת מחדל של
--explain=<a path>
: תיאור -
מערכת המודל גורמת להסבר על כל שלב בביצוע ה-build. ההסבר נכתב בקובץ היומן שצוין.
תגים:affects_outputs
- ברירת מחדל של
--[no]legacy_important_outputs
: "true" -
אפשר להשתמש בכך כדי להסתיר יצירה של שדה חשוב_פלט קודם באירוע Targetcomplete. נדרשים שילובים חשובים של Basel עד ResultStore.
תגים:affects_outputs
- ברירת מחדל של
--[no]materialize_param_files
: "false" -
כותבים קובצי פרמטרים בינוניים לעץ הפלט גם כשמשתמשים בביצוע פעולות מרחוק. שימושי לניפוי באגים בפעולות. זה מרמז על כך – subsubmands ו- --verbose_failures.
תגים:execution
- ברירת מחדל של
--max_config_changes_to_show=<an integer>
: "3" -
כשמוחקים את מטמון הניתוח עקב שינוי באפשרויות build, מוצג מספר נתון של שמות אפשרויות. אם המספר הנתון הוא 1-, כל האפשרויות שהשתנו יוצגו.
תגים:terminal_output
- ברירת מחדל של
--max_test_output_bytes=<an integer>
: "-1" -
ההגדרה קובעת את הגודל המרבי של יומן בדיקה לכל משתמש כאשר --test_פלט הוא 'שגיאות' או 'all' כדאי להשתמש באפשרות הזו כדי למנוע הצפה של פלט הבדיקה עקב רעש מוגזם. כותרת הבדיקה נכללת בגודל היומן. ערכים שליליים לא מעידים על הגבלה. הפלט הוא כלום או לא שום דבר.
תגים:test_runner
,terminal_output
,execution
- ברירת מחדל של
--output_filter=<a valid Java regular expression>
: תיאור -
מוצגות רק אזהרות לגבי כללים עם שם שתואם לביטוי הרגולרי שסופק.
תגים:affects_outputs
- ברירת מחדל של
--progress_report_interval=<an integer in 0-3600 range>
: "0" -
מספר השניות להמתנה בין שני דוחות על משרות שעדיין פעילות. ערך ברירת המחדל 0 פירושו להשתמש באלגוריתם המצטבר 10:30:60 המוגדר כברירת מחדל.
תגים:affects_outputs
- ברירת מחדל של
--show_result=<an integer>
: "1" -
הצגת התוצאות של ה-build. עבור כל יעד, מציינים אם הוא הועלה, ואם כן, רשימה של קובצי פלט שנוצרו. הקבצים המודפסים הם מחרוזות נוחות להעתקה ולהדבקה למעטפת, כדי להפעיל אותן.
כדי להשתמש באפשרות הזו, נדרש ארגומנט של מספר שלם, שהוא מספר הסף של היעדים שעליהם לא מדפיסים את פרטי התוצאה. לכן אפס גורם למחיקת ההודעה ו-MAX_INT גורם להדפסת התוצאה להופיע תמיד. ברירת המחדל היא אחת.
תגים:affects_outputs
--[no]subcommands
[-s
] ברירת מחדל: "false"-
הצגת פקודות המשנה שבוצעו במהלך ה-build. סימונים קשורים: --execution_log_json_file, --execution_log_binary_file (לתיעוד פקודות משנה לקובץ בפורמט ידידותי לכלי).
תגים:terminal_output
- ברירת מחדל של
--test_output=<summary, errors, all or streamed>
: "summary" -
קביעת מצב הפלט הרצוי. הערכים החוקיים הם 'summary' לפלט סיכום של סטטוס בדיקה בלבד, 'errors' להדפסת יומני בדיקה גם עבור בדיקות שנכשלו, 'all' להדפסת יומנים עבור כל הבדיקות בזמן אמת (פעולה זו תאלץ את ביצוע הבדיקות באופן מקומי אחד בכל פעם --_).
תגים:test_runner
,terminal_output
,execution
- ברירת מחדל של
--test_summary=<short, terse, detailed, none or testcase>
: "short" -
ההגדרה היא הפורמט הרצוי של סיכום הבדיקה. ערכים חוקיים הם 'short' כדי להדפיס מידע רק על בדיקות שבוצעו, 'terse' כדי להדפיס מידע רק על בדיקות שנכשלו; 'detailed' כדי להדפיס סיכום מפורט בתרחיש של בדיקת בדיקה; אין להדפיס מידע מפורט על מקרים של מקרה בדיקה ו-39;
תגים:terminal_output
- ברירת מחדל של
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
הדפסת מידע על תוצאות ניפוי באגים במהלך רזולוציה של הכלי. בסימון נעשה שימוש בביטוי רגולרי, שנבדק ביחס לסוגי כלי עבודה ויעדים ספציפיים, כדי לראות באיזה ניפוי באגים. אפשר להפריד בין ביטויים רגולריים באמצעות ביטויים רגולריים, ולאחר מכן כל ביטוי רגולרי מסומן בנפרד. הערה: הפלט של הדגל הזה מורכב מאוד וככל הנראה יועיל רק למומחים בפתרון בעיות בכלי.
תגים:terminal_output
- ברירת מחדל של
--[no]verbose_explanations
: "false" -
יש להגדיל את המלל של ההסברים שהונפקו, אם ההסבר הזה מופעל. אין השפעה אם --Excel לא מופעל.
תגים:affects_outputs
- ברירת מחדל של
--[no]verbose_failures
: "false" -
אם פקודה לא מצליחה, מומלץ להדפיס את שורת הפקודה המלאה.
תגים:terminal_output
- אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
- נצברו
--aspects_parameters=<a 'name=value' assignment>
שימושים מרובים -
ההגדרה קובעת את הערכים של הפרמטרים של היבטים בשורת הפקודה. כל ערך של פרמטר מצוין דרך <param_name>=<param_value> לדוגמה, 'my_param=my_val' כאשר 'my_param' הוא פרמטר של היבט כלשהו ב'רשימת ההיבטים' או שהוא נדרש על ידי היבט ברשימה. ניתן להשתמש באפשרות הזו כמה פעמים. עם זאת, אסור להקצות ערכים לאותו פרמטר יותר מפעם אחת.
תגים:loading_and_analysis
- נצברו
--flag_alias=<a 'name=value' flag alias>
שימושים מרובים -
מגדירים שם מקוצר לסימון Starlark. הוא צריך להזין צמד יחיד של מפתח-ערך בפורמט "<key>=<value>" כארגומנט.
תגים:changes_inputs
- ברירת מחדל של
--[no]incompatible_default_to_explicit_init_py
: "false" -
סימון זה משנה את התנהגות ברירת המחדל כך שקובצי __init__.py כבר לא נוצרים באופן אוטומטי בקבצים פועלים של יעדים ב-Python. באופן מדויק, אם יעד py_binary או py_test מוגדר מדור קודם, play_create_init מוגדר ל-"auto" (ברירת המחדל), הוא נחשב כ-false אם רק הסימון הזה מוגדר. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/10076.
תגים:affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
אם הדבר נכון, יעדים שנוצרו בתצורת Python 2 יופיעו בתוך שורש פלט שכולל את הסיומת ' -py2' בעוד שיעדים שנוצרו עבור Python 3 יופיעו בשורש ללא סיומת הקשורה ל-Python. כלומר, סימולציית הנוחות 'bazel-bin' תצביע על יעדים ב-Python 3 ולא על Python 2. אם האפשרות הזו מופעלת, מומלץ להפעיל גם את `--incompatible_py3_is_default`.
תגים:affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_py3_is_default
: "true" -
אם הערך הוא TRUE, היעדים 'py_binary' ו-'py_test' שלא מגדירים את המאפיינים 'python_version' (או 'default_python_version') יוגדרו כברירת מחדל ל-PY3 במקום ל-PY2. אם הדגל הזה מוגדר, מומלץ גם להגדיר את `--incompatible_py2_פלטs_are_suffixed`.
תגים:loading_and_analysis
,affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_use_python_toolchains
: "true" -
אם המדיניות מוגדרת כ-True, כללי ההפעלה של Python יפעלו לפי זמן הריצה של Python שצוין על ידי כלי הכלים של Python, ולא לפי זמן הריצה שנקבע על ידי דגלים מדור קודם כמו --python_top.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--python_version=<PY2 or PY3>
: תיאור -
מצב הגרסה הראשית של Python, 'PY2' או 'PY3'. חשוב לשים לב שמצב זה מבטל את היעדים 'py_binary' ו-'py_test' (גם אם הם לא מציינים במפורש גרסה), כך שאין בדרך כלל סיבה לספק את הדגל הזה.
תגים:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- ברירת מחדל של
--target_pattern_file=<a string>
: "" -
אם אפשרות זו מוגדרת, גרסת ה-build תקרא תבניות מהקובץ שנקרא כאן, במקום בשורת הפקודה. שגיאה בציון קובץ כאן וגם בדפוסי שורת פקודה.
תגים:changes_inputs
- אפשרויות שונות, ללא שיוך לקטגוריה אחרת:
- ברירת מחדל של
--[no]build_manual_tests
: "false" - מתבצעת יצירה של יעדי בדיקה מתויגים 'ידני' 'ידני' הבדיקות לא מעובדות. אם רוצים להשתמש באפשרות הזו, צריך לבנות אותה (אבל לא לבצע אותה).
- ברירת מחדל של
--build_tag_filters=<comma-separated list of options>
: "" - ההגדרה מציינת רשימת תגים המופרדים בפסיקים. לפני כל תג אפשר להוסיף '-' כדי לציין תגים מוחרגים. רק היעדים האלה יווצרו שכוללים לפחות תג כלול אחד ולא מכילים תגים שאינם נכללים. האפשרות הזו לא משפיעה על קבוצת הבדיקות שמופעלות באמצעות הפקודה 'test' או שאינן כפופות לאפשרויות סינון הבדיקה, למשל '--test_tag_filters'
- ברירת מחדל של
--[no]build_tests_only
: "false" - אם צוין, המערכת תבנה רק כללים מסוג *_test ו-test_Suite המערכת תתעלם מיעדים אחרים שצוינו בשורת הפקודה. כברירת מחדל, כל מה שהתבקש ייבנה.
--[no]cache_test_results
[-t
] ברירת מחדל: "auto"- אם מוגדר כ-'auto', Bazel מריץ בדיקה מחדש אם ורק: (1) בזל מזהה שינויים בבדיקה או בתלויות שלה, (2) הבדיקה מסומנת כחיצונית, (3) התבקשו מספר ריצות בדיקה עם -runs_per_test או(4) הבדיקה נכשלה בעבר. אם הכתובת היא 'yes' , Bazel שומרת במטמון את כל תוצאות הבדיקה, מלבד בדיקות שסומנו כחיצוניות. אם הכתובת היא 'no', Bazel לא שומרת תוצאות בדיקה.
- ברירת מחדל של
--[no]compile_one_dependency
: "false" - יוצרים תלות אחת של קובצי הארגומנטים. זו פעולה שימושית לבדיקת קובצי מקור ב-IDE, למשל על ידי בניית יעד יחיד שתלוי בקובץ המקור כדי לזהות שגיאות בהקדם האפשרי במחזור העריכה/בנייה/בדיקה. הארגומנט הזה משפיע על האופן שבו כל הארגומנטים שאינם מסמנים מתפרשים. במקום לטרגט אותם כדי לבנות אותם, הם שמות הקבצים של המקור. עבור כל שם קובץ מקור יווצר יעד שרירותי שתלוי בו.
- ברירת מחדל של
--deleted_packages=<comma-separated list of package names>
: "" - רשימה של שמות של חבילות, מופרדים בפסיקים, שמערכת ה-build תתייחס אליהם שאינם קיימים, גם אם הם מוצגים במקום כלשהו בנתיב החבילה. כדאי להשתמש באפשרות הזו כשמוחקים חבילת משנה 'x/y' של חבילה קיימת 'x' לדוגמה, לאחר מחיקת x/y/BUILD בלקוח, מערכת ה-build עשויה להתלונן אם היא תיתקל בתווית '//x:y/z' אם היא עדיין מסופקת על ידי ערך package_path אחר. ציון [delete_packs x/y] מונע את הבעיה הזו.
- ברירת מחדל של
--[no]discard_analysis_cache
: "false" - אפשר למחוק את מטמון הניתוח מיד אחרי ששלב הניתוח מסתיים. מפחית את השימוש בזיכרון בכ-10%, אבל הופך את ה-build של מצטבר יותר לאט יותר.
- ברירת מחדל של
--execution_log_binary_file=<a path>
: תיאור - עליך לרשום את הסדינים שבוצעו בקובץ הזה כפרוטוקולים של ספרדים מופרדים, בהתאם לכתובת src/main/protobuf/spawn.proto. תחילה כותבים את היומן בלי סדר, ואז בסוף ההפעלה הם ממוינים בסדר קבוע (יכול להיות מצריך מעבד וזיכרון). סימונים קשורים: --execution_log_json_file (פורמט json של טקסט שהוזמן), --experimental_execution_log_file (פורמט בינארי לא מורשה), --subcommands (להצגת פקודות משנה בפלט מסוף).
- ברירת מחדל של
--execution_log_json_file=<a path>
: תיאור - עליך לתעד את הסדינים שבוצעו בקובץ הזה כייצוג json של פרוטוסים מופרדים בפסיקים, בהתאם ל- src/main/protobuf/spawn.proto. תחילה כותבים את היומן בלי סדר, ואז בסוף ההפעלה הם ממוינים בסדר קבוע (יכול להיות מצריך מעבד וזיכרון). סימונים קשורים: סימונים קשורים: --execution_log_binary_file (פורמט בינארי בינארי שהוזמן), --experimental_execution_log_file (פורמט Protobuf בינארי ללא הזמנה), --subcommands (להצגת פקודות משנה בפלט מסוף).
- ברירת מחדל של
--[no]expand_test_suites
: "true" -
מומלץ להרחיב את יעדי test_Suite לבדיקות ההרכב שלהם לפני הניתוח. אם הדגל הזה מופעל (ברירת המחדל), דפוסי יעד שליליים יחולו על הבדיקות השייכות לחבילת הבדיקה, אחרת הם לא יפעלו. השבתה של הסימון הזה שימושית כשמחילים היבטים ברמה העליונה בשורת הפקודה: ואז אפשר לנתח מטרות בדיקה של suite.
תגים:loading_and_analysis
- ברירת מחדל של
--[no]experimental_cancel_concurrent_tests
: "false" -
True האפשרות הזו שימושית רק בשילוב עם --runs_per_test_detects_flakes.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--experimental_execution_log_file=<a path>
: תיאור - עליך לרשום את הסדינים שבוצעו בקובץ הזה כפרוטוקולים של ספרדים מופרדים, בהתאם לכתובת src/main/protobuf/spawn.proto. הקובץ הזה נכתב לפי סדר הביצוע של סדונים. סימונים קשורים: --execution_log_binary_file (פורמט בינארי בינארי שהובטח), --execution_log_json_file (פורמט json של טקסט שהוזמן), --subcommands (להצגת פקודות משנה בפלט מסוף).
- ברירת מחדל של
--[no]experimental_execution_log_spawn_metrics
: "false" - הכללת מדדי S מרכזן ביומן הביצוע.
- ברירת מחדל של
--experimental_extra_action_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "" - הוצא משימוש לטובת היבטים. מסננים של קבוצות יעדים שעבורן אפשר לתזמן פעולות נוספות.
- ברירת מחדל של
--[no]experimental_extra_action_top_level_only
: "false" - הוצא משימוש לטובת היבטים. תזמון פעולות נוספות מסוג action_actions רק ביעדים ברמה עליונה.
- ברירת מחדל של
--[no]experimental_fetch_all_coverage_outputs
: "false" -
אם הערך הוא True, מערכת Bazel מאחזרת את כל ספריית נתוני הכיסוי עבור כל בדיקה במהלך תקופת כיסוי.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_generate_llvm_lcov
: "false" -
אם זה יהיה נכון, כיסוי לגבי קלנג ייצור דוח LCOV.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_j2objc_header_map
: "true" - האם ליצור מפת כותרת של J2ObjC במקביל לתעתוק J2ObjC?
- ברירת מחדל של
--[no]experimental_j2objc_shorter_header_path
: "false" -
אם צריך ליצור עם נתיב כותרת קצר יותר (משתמשים ב-"_ios" במקום "_j2objc").
תגים:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
כברירת מחדל: "Javabuilder"- הפעלת ערכי נתיב מופחתים לאוספים של Java.
- ברירת מחדל של
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
מגבילים --experimental_run_android_lint_on_Java_rules לספריות תואמות ל-Android.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_prioritize_local_actions
: "true" -
אם הן מוגדרות, פעולות שניתן להפעיל באופן מקומי מקבלים רק הזדמנות ראשונה לרכוש משאבים, עובדים באופן דינמי מקבלים הזדמנות שנייה, ופעולות נפרדות שמתבצעות באופן דינמי ומתבצעות לאחרונה.
תגים:execution
- ברירת מחדל של
--[no]experimental_run_android_lint_on_java_rules
: "false" -
האם לאמת את מקורות Java_*?
תגים:affects_outputs
- ברירת מחדל של
--[no]explicit_java_test_deps
: "false" - יש לציין באופן מפורש את התלות ב-JUnit או Hacrest ב-Java_test במקום לקבל בטעות נקודות דירוג מ-TestRunner'. בשלב זה מתאים לשימוש ב-Bazall.
- ברירת מחדל של
--host_java_launcher=<a build target label>
: תיאור - מרכז האפליקציות של Java שמשמש את הכלים להפעלה במהלך build.
- נצברו
--host_javacopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-Java בעת יצירת כלים המופעלים במהלך build.
- נצברו
--host_jvmopt=<a string>
שימושים מרובים - אפשרויות נוספות למעבר ל-Java VM במהלך בניית כלים שמופעלים במהלך ה-build. האפשרויות האלה יתווספו לאפשרויות ההפעלה של VM בכל יעד Java_binary.
- ברירת מחדל של
--[no]incompatible_exclusive_test_sandboxed
: "false" -
אם הערך הוא נכון, יופעלו בדיקות בלעדיות עם שיטת בידינג בארגז חול. מוסיפים תג 'local' כדי לאלץ הרצת בדיקה בלעדית באופן מקומי
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_strict_action_env
: "false" -
אם הערך true, Bazel משתמשת בסביבה עם ערך סטטי של Path ולא יורשת את LD_LIBRARI_Path. משתמשים בפונקציה --action_env=ENV_VARIABLE אם רוצים לרשת בירושה משתני סביבה ספציפיים מהלקוח, אך חשוב לזכור שפעולה זו יכולה למנוע שמירה במטמון של משתמשים שונים אם נעשה שימוש במטמון משותף.
תגים:loading_and_analysis
,incompatible_change
- נצברו
--j2objc_translation_flags=<comma-separated list of options>
שימושים מרובים - אפשרויות נוספות למעבר לכלי J2ObjC.
--java_debug
-
המכונה הווירטואלית של Java בבדיקת Java ממתינה לחיבור לכלי ניפוי באגים התואם ל-JDWP (כגון jdb) לפני התחלת הבדיקה. משתמע -test_פלט=שידור.
הרחבה אל:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ברירת מחדל של
--[no]java_deps
: "true" - יצירת פרטי תלות (כרגע, סוג ה-path של זמן הביצוע) לכל יעד Java.
- ברירת מחדל של
--[no]java_header_compilation
: "true" - להיעזר באיג'רים ישירות מהמקור.
- ברירת מחדל של
--java_language_version=<a string>
: "8" - גרסת השפה ב-Java
- ברירת מחדל של
--java_launcher=<a build target label>
: תיאור - מרכז האפליקציות של Java לשימוש כשיוצרים קבצים בינאריים של Java. אם הדגל הזה מוגדר כמחרוזת ריקה, המערכת תשתמש במפעיל JDK. המאפיין "מרכז האפליקציות" מבטל את הסימון הזה.
- ברירת מחדל של
--java_runtime_version=<a string>
: "local_jdk" - גרסת זמן הריצה של Java
- נצברו
--javacopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-Java.
- נצברו
--jvmopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-Java VM. האפשרויות האלה יתווספו לאפשרויות ההפעלה של VM בכל יעד Java_binary.
- ברירת מחדל של
--legacy_main_dex_list_generator=<a build target label>
: תיאור - קביעת הקובץ הבינארי שבו יש להשתמש כדי ליצור את רשימת הכיתות שחייבות להיות בשרת ה-proxy הראשי במהלך הידור ה-Multiplexex הקודם.
- ברירת מחדל של
--local_cpu_resources=<an integer, or "HOST_CPUS", optionally followed by [-|*]<float>.>
: "HOST_CPUS" - יש להגדיר באופן מפורש את המספר הכולל של ליבות מעבד (CPU) מקומיות שזמינות ל-Bazel להוצאה על פעולות build שמבוצעות באופן מקומי. משתנה מספר שלם, או "HOST_CPUS" ואופציונלית גם [-|*]<float> (למשל, HOST_CPUS*.5 כדי להשתמש במחצית מליבות המעבד (CPU) הזמינות. כברירת מחדל, ("HOST_CPUS" ), Bazel תשלח שאילתה לתצורת המערכת כדי להעריך את מספר הליבות של המעבד (CPU).
--local_ram_resources=<an integer, or "HOST_RAM", optionally followed by [-|*]<float>.>
ברירת מחדל: "HOST_RAM*.67"- יש להגדיר במפורש את סך כל זיכרון ה-RAM המארח המקומי (ב-MB) הזמין ל-Bazel להוצאה על פעולות build שמבוצעות באופן מקומי. משתנה מספר שלם, או "HOST_RAM" ואופציונלית מופיע [-|*]<float> (למשל, HOST_RAM*.5 כדי להשתמש בחצי מזיכרון ה-RAM הזמין). כברירת מחדל, ("HOST_RAM*.67" ), Bazel תשלח שאילתה לתצורת המערכת כדי להעריך את כמות ה-RAM הזמינה, ומשתמשת ב-67% ממנה.
- ברירת מחדל של
--local_termination_grace_seconds=<an integer>
: "15" - הגיע הזמן להמתין בין סיום התהליך המקומי לבין הזמן הקצוב לתפוגה וסגירה ידנית.
- ברירת מחדל של
--package_path=<colon-separated list of options>
: "%workspace%" - רשימה מופרדת בנקודתיים של מיקומים לחיפוש חבילות. רכיבים שמתחילים ב-'%workspace%' הם יחסיים לסביבת העבודה המקיפה. אם לא מופיעה או ריקה, ברירת המחדל היא הפלט של 'bazel information default-package-path'.
- נצברו
--plugin=<a build target label>
שימושים מרובים - יישומי פלאגין לשימוש ב-build. פועלים כרגע עם Java_plugins.
- ברירת מחדל של
--proguard_top=<a build target label>
: תיאור - ההגדרה של ProGuard היא הגרסה שבה יש להסיר קוד בינארי של Java.
--proto_compiler=<a build target label>
ברירת מחדל: "@bazel_tools//tools/proto:protoc"-
התווית של המהדר לאבות.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_cc=<a build target label>
: "@bazel_tools//tools/proto:cc_toolchain" -
תווית של Proto_lang_toolchain() שמתארת איך להדר Cto++ Proto
תגים:
affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ברירת מחדל: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
תווית של proto_lang_toolchain() שמתארת איך להדר j2objc Protos
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_java=<a build target label>
: "@bazel_tools//tools/proto:Java_toolchain" -
תווית של proto_lang_toolchain() שמתארת איך להדר פרוטאורה של Java
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_javalite=<a build target label>
: "@bazel_tools//tools/proto:Javalite_toolchain" -
תווית Proto_lang_toolchain() שמתארת איך להדר פרוטומות של JavaLite
תגים:affects_outputs
,loading_and_analysis
- נצברו
--protocopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה אל מהדר הפרוטוקול.
תגים:affects_outputs
- ברירת מחדל של
--[no]runs_per_test_detects_flakes
: "false" - אם הערך מקבל את הערך True, כל פיצול שבו עובר ניסיון ריצה/ניסיון אחד לפחות ולפחות ניסיון ריצה אחד/ניסיון אחד נכשל, מקבל את הסטטוס FLAKY.
- ברירת מחדל של
--shell_executable=<a path>
: תיאור -
נתיב מוחלט להפעלה של קונכיות לשימוש בבזל. אם האפשרות הזו לא מוגדרת, המשתנה של סביבת BAZEL_SH מוגדר בהפעלה הראשונה של Bazel (שמפעילה שרת Bazel), ה-Bazel משתמש באפשרות הזו. אם אף אחד מהם לא מוגדר, Bazel משתמשת בנתיב ברירת מחדל בתוך הקוד בהתאם למערכת ההפעלה שבה היא פועלת (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, כל השאר: /bin/bash). שימו לב שהשימוש במעטפת שלא תואם ל-Bash עלול לגרום לכשל בבנייה או לכשלים בזמן ריצה של הקבצים הבינאריים שנוצרו.
תגים:loading_and_analysis
- ברירת מחדל של
--[no]show_loading_progress
: "true" - אם מופעל, גורם ל-Bazel להדפיס הודעות &&;טעינת חבילה:".
- נצברו
--test_arg=<a string>
שימושים מרובים - קביעת אפשרויות וארגומנטים נוספים שצריך להעביר לקובץ ההפעלה של הבדיקה. ניתן להשתמש מספר פעמים כדי לציין כמה ארגומנטים. אם יבוצעו כמה בדיקות, כל אחת מהן תקבל ארגומנטים זהים. בשימוש רק באמצעות הפקודה 'bazel' .
- ברירת מחדל של
--test_filter=<a string>
: תיאור - קביעת מסנן להעברת למסגרת הבדיקה. משמש להגבלת הבדיקות. לתשומת ליבכם: אין לכך השפעה על היעדים המובנים.
- ברירת מחדל של
--test_lang_filters=<comma-separated list of options>
: "" - קביעת רשימה של שפות בדיקה המופרדות בפסיקים. אפשר להוסיף לפני כל שפה את המילים " '-' כדי לציין שפות מוחרגות. יימצאו רק יעדי הבדיקה שנכתבו בשפות שצוינו. השם המשמש לכל שפה צריך להיות זהה לתחילית השפה בכלל *_test, למשל, אחד מהתווים #&39;cc', 'Java', 'py' וכו'. האפשרות הזו משפיעה על --build_tests_only ועל פקודת הבדיקה.
- ברירת מחדל של
--test_result_expiration=<an integer>
: "-1" - האפשרות הזו הוצאה משימוש ואין לה השפעה.
- ברירת מחדל של
--[no]test_runner_fail_fast
: "false" - אם ההרצה לא תתבצע מהר, אפשר יהיה להריץ אותה. הרצת הבדיקה צריכה להפסיק את הביצוע אחרי הכשל הראשון.
- ברירת מחדל של
--test_sharding_strategy=<explicit or disabled>
: "explicit" - יש לציין את השיטה לפיצול הבדיקה: 'explicit' כדי להשתמש בפיצול רק אם קיים המאפיין 'shard_count' 'disabled' לעולם לא להשתמש בפיצול בדיקה.
- ברירת מחדל של
--test_size_filters=<comma-separated list of values: small, medium, large or enormous>
: "" - ההגדרה מציינת רשימה של גודלי בדיקה המופרדים בפסיקים. לפני כל גודל אפשר להוסיף לפני #&39;-' כדי לציין גדלים שאינם נכללים. יימצאו רק יעדי בדיקה המכילים לפחות גודל כולל אחד ואינם מכילים גדלים שלא נכללו. האפשרות הזו משפיעה על ההתנהגות של --build_tests_only ועל פקודת הבדיקה.
- ברירת מחדל של
--test_tag_filters=<comma-separated list of options>
: "" - קביעת רשימה של תגי בדיקה המופרדים בפסיקים. לפני כל תג אפשר להוסיף '-' כדי לציין תגים מוחרגים. יימצאו רק יעדי בדיקה כאלה שמכילים לפחות תג כלול אחד ואינם מכילים תגים שאינם נכללים. האפשרות הזו משפיעה על ההתנהגות של --build_tests_only ועל פקודת הבדיקה.
- ברירת מחדל של
--test_timeout_filters=<comma-separated list of values: short, moderate, long or eternal>
: "" - מפרטת רשימה של זמני קצוב לתפוגה המופרדים בפסיקים. אפשר לבחור לפני כל פרק זמן שמסתיים ב-'-' כדי לציין זמנים הקצוב לתפוגה שהוחרגו. יימצאו רק יעדי בדיקה שמכילים לפחות זמן קצוב לתפוגה אחד, ואינם כוללים תקופות זמן קצוב לתפוגה שהוחרגו. האפשרות הזו משפיעה על ההתנהגות של --build_tests_only ועל פקודת הבדיקה.
- ברירת מחדל של
--tool_java_language_version=<a string>
: "8" - גרסת השפה של Java המשמשת לביצוע הכלים הנחוצים במהלך גרסת ה-build
- ברירת מחדל של
--tool_java_runtime_version=<a string>
: "remotejdk_11" - גרסת זמן הריצה של Java המשמשת לביצוע כלים במהלך ה-build
- ברירת מחדל של
--[no]use_ijars
: "true" - כשהאפשרות הזו מופעלת, הידור ה-Java משתמש בקונטיינרים של ממשק. כתוצאה מכך, האוסף המצטבר יהיה מהיר יותר, אבל הודעות השגיאה עשויות להיות שונות.
אפשרויות סימון כקנוניות
העברה בירושה את כל האפשרויות מיצירה.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בפלט של הפקודה:
- ברירת מחדל של
--[no]canonicalize_policy
: "false" -
פלט של המדיניות הקנונית, לאחר הרחבה וסינון. כדי לשמור על פלט נקי, הארגומנטים של פקודות קנוניות לא יוצגו כאשר אפשרות זו מוגדרת כ-true. חשוב לשים לב שהפקודה שצוינה על ידי --for_command משפיעה על המדיניות המסוננים, ואם לא צוינה הפקודה, פקודת ברירת המחדל היא 'build'
תגים:affects_outputs
,terminal_output
- ברירת מחדל של
--[no]show_warnings
: "false" -
אזהרות של מנתח הפלט לשגיאה רגילה (למשל, לגבי אפשרויות סימון מתנגשות).
תגים:affects_outputs
,terminal_output
- אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- ברירת מחדל של
--[no]incompatible_config_setting_private_default_visibility
: "false" -
אם לא תואם_enforce_config_setting_visible=false, זו שגיאה. אחרת, אם הסימון הזה הוא false, כל הגדרת config_ללא מאפיין חשיפה בוטה היא //visible:public. אם הסימון הזה נכון, המאפיין config_setting תואם ללוגיקה של הרשאות הגישה שדומה לכל הכללים האחרים. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12933.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enforce_config_setting_visibility
: "true" -
אם המדיניות מוגדרת כ-True, יש לאכוף את הרשאות הגישה מסוג config_setting. אם הערך הוא False, כל config_setting גלויה לכל יעד. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים:loading_and_analysis
,incompatible_change
- אפשרויות שקשורות לפלט Bzlmod וסמנטיקה:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, קראו את הקובץ שצוין ולא את קובץ ה-WORKSPACE
תגים:changes_inputs
- ברירת מחדל של
--for_command=<a string>
: "build" -
פקודה שעבורה האפשרויות צריכות להיות קנוניות.
תגים:affects_outputs
,terminal_output
- ברירת מחדל של
--invocation_policy=<a string>
: "" -
יישום של מדיניות הפעלה באפשרויות הקנוניות.
תגים:affects_outputs
,terminal_output
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- ברירת מחדל של
--deleted_packages=<comma-separated list of package names>
: "" - רשימה של שמות של חבילות, מופרדים בפסיקים, שמערכת ה-build תתייחס אליהם שאינם קיימים, גם אם הם מוצגים במקום כלשהו בנתיב החבילה. כדאי להשתמש באפשרות הזו כשמוחקים חבילת משנה 'x/y' של חבילה קיימת 'x' לדוגמה, לאחר מחיקת x/y/BUILD בלקוח, מערכת ה-build עשויה להתלונן אם היא תיתקל בתווית '//x:y/z' אם היא עדיין מסופקת על ידי ערך package_path אחר. ציון [delete_packs x/y] מונע את הבעיה הזו.
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
- ברירת מחדל של
--package_path=<colon-separated list of options>
: "%workspace%" - רשימה מופרדת בנקודתיים של מיקומים לחיפוש חבילות. רכיבים שמתחילים ב-'%workspace%' הם יחסיים לסביבת העבודה המקיפה. אם לא מופיעה או ריקה, ברירת המחדל היא הפלט של 'bazel information default-package-path'.
- ברירת מחדל של
--[no]show_loading_progress
: "true" - אם מופעל, גורם ל-Bazel להדפיס הודעות &&;טעינת חבילה:".
אפשרויות ניקוי
העברה בירושה את כל האפשרויות מיצירה.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בפלט של הפקודה:
- ברירת מחדל של
--[no]async
: "false" -
אם הערך הוא True, ניקוי הפלט הוא אסינכרוני. כשהפקודה הזו תסתיים, אפשר יהיה לבצע פקודות חדשות באותו לקוח, אף על פי שהמחיקה עשויה להתבצע ברקע.
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--[no]expunge
: "false" -
אם המדיניות מוגדרת כ-True, ניקוי של עץ העבודה המקורי של ה-Bazal הזה כולל את כל הקבצים הזמניים שנוצרו ברקע ויצירה של קובצי פלט. במקרה כזה, שרת ה-Bazel פועל.
תגים:host_machine_resource_optimizations
--expunge_async
-
אם צוין, ניקוי באופן אסינכרוני של כל עץ העבודה של מופע הבסיס הזה, שכולל את כל קובצי ה-Bazal שנוצרו באופן זמני ובניית קובצי פלט, ומפסיק את שרת ה-Bazal אם הוא פועל. כשהפקודה הזו תסתיים, אפשר יהיה לבצע פקודות חדשות באותו לקוח, אף על פי שהמחיקה עשויה להתבצע ברקע.
מתרחב אל:
--expunge
--async
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--[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
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות הגדרה
אפשרויות כיסוי
העברה בירושה את כל האפשרויות מבדיקה.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות שמשפיעות בצורה מדויקת על האופן שבו Bazel אוכפת קלטי build תקינים (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות שאילתה
העברה בירושה את כל האפשרויות מבדיקה.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות שמשפיעות בצורה מדויקת על האופן שבו Bazel אוכפת קלטי build תקינים (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות הקשורות לפלט שאילתות וסמנטיקה:
- ברירת מחדל של
--aspect_deps=<off, conservative or precise>
: "conservative" -
איך לפתור בעיה של יחסי גובה-רוחב כאשר פורמט הפלט הוא בפורמט {xml,proto,record}. 'off' פירוש הדבר שלא נפתרים יחסי תלות ו'שמרני' (ברירת המחדל) מוסיפים את כל יחסי הגובה-רוחב המוצהרים, בין אם הם קיבלו את רמת התלויות הישירות ובין אם לא. חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, כך שהוא איטי יותר מהמצבים האחרים. כמו כן, אפילו מצב מדויק אינו מדויק לחלוטין: ההחלטה אם לחשב היבט מסוים נקבעת בשלב הניתוח, שאינו פועל במהלך &b3Query;'
תגים:build_file_semantics
- ברירת מחדל של
--[no]graph:factored
: "true" -
אם הערך הוא True, התרשים ייקרא 'fact האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים:terminal_output
- ברירת מחדל של
--graph:node_limit=<an integer>
: "512" -
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; הערך 1- יגרום לכך שלא ייחתך. האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים:terminal_output
- ברירת מחדל של
--[no]implicit_deps
: "true" -
אם האפשרות הזאת מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלות שבו השאילתה פועלת. תלות משתמעת היא זו שלא צוינה במפורש בקובץ BUILD, אך נוספה על ידי ה-bazel. עבור שאילתה, אפשרות זו שולטת בסינון ערכות כלים שנפתרו.
תגים:build_file_semantics
- ברירת מחדל של
--[no]include_aspects
: "true" -
aquery, שאילתה: האם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: no-op (מאפיינים תמיד במעקב).
תגים:terminal_output
- ברירת מחדל של
--[no]incompatible_display_source_file_location
: "true" -
True, כברירת מחדל, יוצג היעד של קובץ המקור. אם True, מציג את המיקום של שורה 1 של קובצי מקור בפלטי מיקום. הסימון הזה קיים רק למטרות העברה.
תגים:terminal_output
,incompatible_change
- ברירת מחדל של
--[no]incompatible_package_group_includes_double_slash
: "true" -
אם האפשרות הזו מופעלת, בעת הפקת המאפיין 'packs' של package_group&, הסימן '//' הראשי לא יושמט.
תגים:terminal_output
,incompatible_change
- ברירת מחדל של
--[no]infer_universe_scope
: "false" -
אם המדיניות set ו- לתשומת ליבכם, הערך של uniuni_scope כפי שהוסק עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, allalleps) הוא לא מה שאתם רוצים, לכן עליכם להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים ודוגמאות זמינים בכתובת https://bazel.build/reference/query#sky-query. אם --univers_scope מוגדר, המערכת מתעלמת מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'שאילתה' (כלומר, לא 'cquery').
תגים:loading_and_analysis
- ברירת מחדל של
--[no]line_terminator_null
: "false" -
אם כל פורמט יסתיים ב-\0 במקום בפורמט חדש.
תגים:terminal_output
- ברירת מחדל של
--[no]nodep_deps
: "true" -
אם המדיניות מופעלת, נקודות שפל מתוך "nodep" ייכללו בתרשים התלות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep". היא "visible". מריצים ומנתחים את הפלט של 'info Build-language' כדי ללמוד על כל המאפיינים "nodep"בשפת ה-build.
תגים:build_file_semantics
- ברירת מחדל של
--output=<a string>
: "label" -
הפורמט שבו יש להדפיס את תוצאות השאילתה. הערכים המותרים ל-cquery הם: label, label_kind, textproto, passs, proto, jsonproto. אם בוחרים 'transitions' צריך גם לציין את האפשרות --transitions=(lite|full).
תגים:terminal_output
- ברירת מחדל של
--[no]proto:default_values
: "true" -
אם מוגדר כ-True, נכללים מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- --פלט=פרוטו
תגים:terminal_output
- ברירת מחדל של
--[no]proto:definition_stack
: "false" -
מאכלס את השדה Proto-stack, שמתעד כל מופע של כלל ה-Starstark שבו מוגדרת המחלקה בכלל.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:flatten_selects
: "true" -
אם המדיניות מופעלת, מאפיינים ניתנים להגדרה שנוצרו על ידי Select() שטוחים. עבור סוגי רשימות, הייצוג השטוח הוא רשימה המכילה כל ערך של המפה שנבחרה פעם אחת בלבד. סוגי הפיגועים שטוחים איזה null.
תגים:build_file_semantics
- ברירת מחדל של
--[no]proto:include_configurations
: "true" -
כשהפרוטוקול מופעל, פלט אב יכלול מידע על ההגדרות. כאשר המדיניות מושבתת,פורמט הפלט אב השאילתה דומה לפורמט פלט שאילתה.
תגים:affects_outputs
- ברירת מחדל של
--[no]proto:include_synthetic_attribute_hash
: "false" -
אם רוצים לחשב ולאכלס את המאפיין $internal_attr_Hash.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:instantiation_stack
: "false" -
אכלוס מחסנית קריאות של כל הנחיה. כדי לעשות זאת, יש צורך במקבץ סטאק
תגים:terminal_output
- ברירת מחדל של
--[no]proto:locations
: "true" -
אם בכלל, כדאי לשלוח פרטי מיקום בפלט אב.
תגים:terminal_output
- ברירת מחדל של
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
רשימת מאפיינים המופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להוציא פלט. האפשרות הזו רלוונטית ל--פלט=פרוטו.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:rule_inputs_and_outputs
: "true" -
אפשר גם לאכלס את השדותכללי_קלט וכלל_פלט.
תגים:terminal_output
- ברירת מחדל של
--[no]relative_locations
: "false" -
אם הערך הוא TRUE, המיקום של קובצי BUILD ב-XML ובפלטי אב יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא יהיה עקבי בין מחשבים. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במכשירים שונים.
תגים:terminal_output
- ברירת מחדל של
--show_config_fragments=<off, direct or transitive>
: "off" -
הצגת קטעי התצורה הנדרשים על ידי כלל והתלות העקיפות שלו. אפשרות זו יכולה לעזור לכם להעריך עד כמה אפשר לחתוך תרשים יעד שהוגדר.
תגים:affects_outputs
- ברירת מחדל של
--starlark:expr=<a string>
: "" -
ביטוי Starlark לעיצוב של כל יעד שמוגדר במצב cquery's --pla=starlark. היעד שהוגדר מוגבל ל-'target' אם לא צוין --starlar:expr or --starlark:file, האפשרות הזו תוגדר כברירת מחדל ל-'str(target.label)' אירעה שגיאה לציון גם -starstark:expr וגם --starlark:file.
תגים:terminal_output
- ברירת מחדל של
--starlark:file=<a string>
: "" -
שם של קובץ שמגדיר פונקציית Starlark שנקראת 'format', מתוך ארגומנט אחד, שחל על כל יעד מוגדר כדי לעצב אותו כמחרוזת. אירעה שגיאה לציון גם -starstark:expr וגם --starlark:file. לקבלת עזרה נוספת --
תגים:terminal_output
- ברירת מחדל של
--[no]tool_deps
: "true" -
שאילתה: אם היא מושבתת, יחסי תלות ב-'מארח הגדרה' או 'execution' יעדים לא ייכללו בתרשים התלות שעליו פועלת השאילתה. קצה 'הגדרת תצורה למארחים' כזה מהכלל של #&39;proto_library' מפנה בדרך כלל למהדר הפרוטוקול, בדרך כלל מצביע על כלי שהופעל במהלך ה-build במקום על חלק מאותה תוכנית 'target'
שאילתה: אם היא מושבתת, היא מסננת את כל היעדים שהוגדרו שחוצים מעבר של מארח או ביצוע, מהיעד שהוגדר ברמה העליונה שגילו את היעד שהוגדר. כלומר, אם היעד ברמה העליונה נמצא בתצורת היעד, יוחזרו רק יעדים שהוגדרו בתצורת היעד. אם היעד ברמה העליונה נמצא בתצורת המארח, יוחזרו רק יעדים שהוגדרו על ידי המארח. אפשרות זו לא תכלול שרשראות כלים שנפתרו.
תגים:build_file_semantics
- ברירת מחדל של
--transitions=<full, lite or none>
: "none" -
הפורמט שבו השאילתה תדפיס את פרטי המעבר.
תגים:affects_outputs
- ברירת מחדל של
--universe_scope=<comma-separated list of options>
: "" -
קבוצה של דפוסי יעד (מופרדים באמצעות פסיקים) המופרדים בפסיקים. השאילתה עשויה להתבצע ביקום שהוגדר על ידי הסגירה העקיפה של היעדים שצוינו. האפשרות הזו משמשת לפקודות השאילתה ושאילתת השאילתה.
עבור השאילתה, הקלט לאפשרות הזו הוא היעדים שבנו כל התשובות, ולכן האפשרות הזו עשויה להשפיע על התצורות והמעברים. אם אפשרות זו אינה מוגדרת, ההנחה היא שהיעדים ברמה העליונה הם היעדים המנותחים מביטוי השאילתה. הערה לגבי שאילתה: אם לא מציינים את האפשרות הזו, ייתכן שה-build לא יפעל אם לא ניתן ליצור יעדים מביטוי השאילתה עם האפשרויות ברמה העליונה.
תגים:loading_and_analysis
- אפשרויות הקשורות לפלט Bzlmod וסמנטיקה:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
- אפשרויות ששולטות בביצוע של גרסאות build:
- ברירת מחדל של
--[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" -
אם האפשרות הזו מופעלת, קבוצות הקבצים יתייחסו לכל פריטי המידע שנוצרו בתהליך הפיתוח כקבצים רגילים. הם לא חוצה ספריות ולא יהיו רגישים לקישורים סימבוליים.
תגים:execution
- ברירת מחדל של
--modify_execution_info=<regex=[+-]key,regex=[+-]key,...>
: "" -
ניתן להוסיף או להסיר מפתחות מידע על ביצוע של פעולה על סמך הקובץ של הפעולה. רלוונטי רק לפעולות התומכות בפרטי הביצוע. פעולות נפוצות רבות תומכות בפרטי ביצוע, כמו Genrule, CppCompile, Javac, StarlarkAction, TestRunner. כשמציינים כמה ערכים, הסדר חשוב כי ביטויים רבים עשויים לחול על אותו אזכור.
תחביר: "regex=[+-]key,regex=[+-]key,...".
דוגמאות:
'.*=+x,.*=-y,.*=+z' מוסיף את #&39;x' ו-'z' את פרטי הביצוע של #&39;y' ומסירים אותם.
'Genrule=+requires-x' add 'requires-x' לפרטי הביצוע של כל פעולות הז'אנר.
'(?!Genrule).*=-requires-x' removed 'requires-x' מפרטי ההפעלה של כל הפעולות שאינן ז'אנר.
תגים:execution
,affects_outputs
,loading_and_analysis
--persistent_android_dex_desugar
-
הפעלה של עובדים ב-Android Dex ופעולות סוכר קבועות.
מתרחב אל:
--strategy=Desugar=worker
--strategy=DexBuilder=worker
תגים:host_machine_resource_optimizations
,execution
--persistent_android_resource_processor
-
הפעלת מעבד משאבים קבוע של Android באמצעות עובדים.
הרחבה אל:
--internal_persistent_busybox_tools
--strategy=AaptPackage=worker
--strategy=AndroidResourceParser=worker
--strategy=AndroidResourceValidator=worker
--strategy=AndroidResourceCompiler=worker
--strategy=RClassGenerator=worker
--strategy=AndroidResourceLink=worker
--strategy=AndroidAapt2=worker
--strategy=AndroidAssetMerger=worker
--strategy=AndroidResourceMerger=worker
--strategy=AndroidCompiledResourceMerger=worker
--strategy=ManifestMerger=worker
--strategy=AndroidManifestMerger=worker
--strategy=Aapt2Optimize=worker
2
{1/2--internal_persistent_busybox_tools
--persistent_multiplex_android_dex_desugar
-
הפעלה של עובדים עם Multiplex דק' ופעולות סוכר
מתרחב אל:
--persistent_android_dex_desugar
--modify_execution_info=Desugar=+supports-multiplex-workers
--modify_execution_info=DexBuilder=+supports-multiplex-workers
תגים:host_machine_resource_optimizations
,execution
--persistent_multiplex_android_resource_processor
-
הפעלה של מעבד משאבים (cast) עקבי ב-Android עם עובדים.
הרחבה אל:
--persistent_android_resource_processor
--modify_execution_info=AaptPackage=+supports-multiplex-workers
--modify_execution_info=AndroidResourceParser=+supports-multiplex-workers
--modify_execution_info=AndroidResourceValidator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceCompiler=+supports-multiplex-workers
--modify_execution_info=RClassGenerator=+supports-multiplex-workers
--modify_execution_info=AndroidResourceLink=+supports-multiplex-workers
--modify_execution_info=AndroidAapt2=+supports-multiplex-workers
--modify_execution_info=AndroidAssetMerger=+supports-multiplex-workers
--modify_execution_info=AndroidResourceMerger=+supports-multiplex-workers
--modify_execution_info=AndroidCompiledResourceMerger=+supports-multiplex-workers
--modify_execution_info=ManifestMerger=+supports-multiplex-workers
--modify_execution_info=AndroidManifestMerger=+supports-multiplex-workers
--modify_execution_info=Aapt2Optimize=+supports-multiplex-workers
2
{1/2--persistent_android_resource_processor
--persistent_multiplex_android_tools
-
הפעלת כלים עקביים ומוכפלים ב-Android (Dexs, הסרת ניפוי באגים, עיבוד משאבים).
מתרחבת אל:
--persistent_multiplex_android_resource_processor
--persistent_multiplex_android_dex_desugar
תגים:host_machine_resource_optimizations
,execution
- אפשרויות שמגדירות את ה-chainch המשמש לביצוע הפעולה:
- ברירת מחדל של
--android_compiler=<a string>
: תיאור -
המהדר של היעד ל-Android.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_crosstool_top=<a build target label>
: "//external:android/crosstool" -
המיקום של המהדר C++ המשמש לגרסאות של Android.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_grte_top=<a label>
: תיאור -
יעד grte_top ב-Android.
תגים:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_manifest_merger=<legacy, android or force_android>
: "android" -
בחירת המיזוג של המניפסט לשימוש בכללי android_binary. סימון לבדיקה כדי לעבור למיזוג המניפסט של Android מהמיזוג הקודם.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_platforms=<a build target label>
: "" -
מגדירה את הפלטפורמות שבהן היעדים של android_binary משתמשים. אם מציינים כמה פלטפורמות, הקובץ הבינארי הוא חבילות APK בעלות אחוזי שומן, המכילות קבצים בינאריים מקומיים לכל פלטפורמת יעד שצוינה.
תגים:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--android_sdk=<a build target label>
: "@bazel_tools//tools/android:sdk" -
ההגדרה קובעת Android SDK/פלטפורמה המשמשת לבניית אפליקציות ל-Android.
תגים:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--apple_compiler=<a string>
: תיאור -
מהדר היעד של Apple. שימושי לבחירת וריאציות של כלי עבודה (למשל: xcode-beta).
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--apple_crosstool_top=<a build target label>
: "@bazel_tools//tools/cpp:toolchain" -
התווית של חבילת כלי ההובלה לשימוש בכללי Apple ו-Objc ובתלויים שלהם.
תגים:loses_incremental_state
,changes_inputs
- ברירת מחדל של
--apple_grte_top=<a build target label>
: תיאור -
היעד grte_top של Apple.
תגים:changes_inputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--cc_output_directory_tag=<a string>
: "" -
קביעת סיומת שתתווסף לספריית התצורה.
תגים:affects_outputs
,explicit_in_output_path
- ברירת מחדל של
--compiler=<a string>
: תיאור -
המהדר C++ המשמש לאיסוף היעד.
תגים:loading_and_analysis
,execution
- ברירת מחדל של
--coverage_output_generator=<a build target label>
: "@bazel_tools//tools/test:lcov_merger" -
המיקום של הקובץ הבינארי המשמש לעיבוד דוחות כיסוי גולמיים לאחר העיבוד. נכון לעכשיו זו צריכה להיות קבוצת קבצים הכוללת קובץ אחד, הקובץ הבינארי. ברירת המחדל היא '//tools/test:lcov_merger'.
תגים:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_report_generator=<a build target label>
ברירת מחדל: "@bazel_tools//tools/test:coverage_report_מחולל"-
המיקום של הקובץ הבינארי המשמש להפקת דוחות כיסוי. נכון לעכשיו זו צריכה להיות קבוצת קבצים הכוללת קובץ אחד, הקובץ הבינארי. ברירת המחדל היא '//tools/test:coverage_report_מחולל'.
תגים:changes_inputs
,affects_outputs
,loading_and_analysis
--coverage_support=<a build target label>
ברירת מחדל: "@bazel_tools//tools/test:coverage_support"-
המיקום של קובצי התמיכה הנדרשים על סמך הקלט של כל פעולת בדיקה שאוספת כיסוי קוד. ברירת המחדל היא '//tools/test:coverage_support'.
תגים:changes_inputs
,affects_outputs
,loading_and_analysis
- ברירת מחדל של
--crosstool_top=<a build target label>
: "@bazel_tools//tools/cpp:toolchain" -
התווית של חבילת כלי ההובלה שתשמש להרכבת קוד C++.
תגים:loading_and_analysis
,changes_inputs
,affects_outputs
- ברירת מחדל של
--custom_malloc=<a build target label>
: תיאור -
ההגדרה קובעת הטמעה מותאמת אישית של Malloc. ההגדרה הזו מבטלת את המאפיינים של Malאיך להשתמש בכללי build.
תגים:changes_inputs
,affects_outputs
- נצברו
--experimental_add_exec_constraints_to_targets=<a '<RegexFilter>=<label1>[,<label2>,...]' assignment>
שימושים מרובים -
רשימה של ביטויים רגולריים המופרדים בפסיקים, שלכל אחד מהם יש קידומת (-) שלילי, מוקצית (=) לרשימה של יעדי ערך מופרדים בפסיקים. אם יעד מסוים לא תואם אף ביטוי שלילי וביטוי חיובי אחד לפחות, רזולוציית הכלים שלו תתבצע כאילו היא הצהירה על ערכי האילוץ כאילוצי ביצוע. דוגמה: //demo,-test=@platforms//cpus:x86_64 יתווסף #&39;x86_64' לכל יעד תחת //demo, מלבד אלה שהשם שלהם מכיל 'test'.
תגים:loading_and_analysis
- ברירת מחדל של
--[no]experimental_enable_objc_cc_deps
: "true" -
קבלת כללים מסוג objc_* שתלויים ב-cc_library וגורמת לקיום יחסי תלות של objc עם --cpu המוגדר כ-"ios_<--ios_cpu>" עבור כל ערך ב- --ios_multi_cpu.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]experimental_include_xcode_execution_requirements
: "false" -
אם היא מוגדרת, מוסיפים את דרישת הביצוע "requires-xcode:{version}" לכל פעולת Xcode. אם גרסת ה-xcode כוללת תווית עם מקפים, צריך להוסיף גם "requires-xcode-label:{version_label}" דרישת ביצוע.
תגים:loses_incremental_state
,loading_and_analysis
,execution
- ברירת מחדל של
--[no]experimental_prefer_mutual_xcode
: "true" -
אם מוגדר True, יש להשתמש ב-Xcode העדכני ביותר שזמין גם מקומית וגם מרחוק. אם False, או אם אין גרסאות הדדיות זמינות, משתמשים בגרסת Xcode המקומית שנבחרה באמצעות xcode-select.
תגים:loses_incremental_state
- נצברו
--extra_execution_platforms=<comma-separated list of options>
שימושים מרובים -
הפלטפורמות הזמינות כפלטפורמות לביצוע פעולות. אפשר לציין פלטפורמות לפי יעד מדויק או כתבנית יעד. המערכת תתייחס לפלטפורמות האלה לפני אלה המוצהרות בקובץ ה-WORKSPACE על ידי sign_execution_platforms() .
תגים:execution
- נצברו
--extra_toolchains=<comma-separated list of options>
שימושים מרובים -
הכללים בנוגע לכלים של כלי עבודה שנלקחים בחשבון במהלך מציאת פתרון לכלים. ניתן לציין ערכות הכלים לפי יעד מדויק, או כתבנית יעד. חשוב לזכור את ערכות הכלים האלה לפני ההשקה שלהן בקובץ ה-WORKSPACE באמצעות record_toolchains() .
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--grte_top=<a label>
: תיאור -
תווית לספריית ליבצ'ק שמסומנת. ערך ברירת המחדל נבחר על ידי רצועת הכלים, וכמעט אף פעם לא צריך לשנות אותו.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_compiler=<a string>
: תיאור -
המהדר C++ המשמש לאיסוף של מארח. המערכת מתעלמת ממנו אם --host_crosstool_top לא מוגדר.
תגים:loading_and_analysis
,execution
- ברירת מחדל של
--host_crosstool_top=<a build target label>
: תיאור -
כברירת מחדל, האפשרויות מהלך --crosstool_top ו-- מהדר משמשות גם להגדרת המארח. אם הדגל הזה צוין, Bazel משתמשת ב-libc ובמהדר המוגדר כברירת מחדל עבור ה-crosstool_top הנתון.
תגים:loading_and_analysis
,changes_inputs
,affects_outputs
- ברירת מחדל של
--host_grte_top=<a label>
: תיאור -
אם מציינים, ההגדרה הזו מבטלת את הספרייה ברמה העליונה libc (--grte_top) של תצורת המארח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_platform=<a build target label>
: "" -
התווית של כלל הפלטפורמה שמתארת את מערכת האירוח.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--[no]incompatible_disable_expand_if_all_available_in_flag_set
: "true" -
אם הערך הוא true, Bazel לא יאפשר לציין extension_if_all_available ב-flag_sets(לקבלת הוראות העברה, יש לעיין בכתובת https://github.com/bazelbuild/bazel/issues/7008).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_dont_enable_host_nonhost_crosstool_features
: "true" -
אם הערך true, Bazel לא תפעיל את 'host' 'nonhost' תכונות בכלי C++ (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/7407).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enable_android_toolchain_resolution
: "false" -
שימוש ברזולוציה של Toolchain כדי לבחור את ה-SDK ל-Android לכללי Android (סטארלרק ו-Native)
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enable_apple_toolchain_resolution
: "false" -
שימוש ברזולוציית כלים כדי לבחור את ה-SDK של Apple לכללי התפוחים (Starlark ו-Native)
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_make_thinlto_command_lines_standalone
: "true" -
True
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_remove_cpu_and_compiler_attributes_from_cc_toolchain
: "true" -
אם הערך true, Bazel יתלונן כשמאפייני cc_toolchain.cpu ו-cc_toolchain.devguider מוגדרים (מידע נוסף זמין במאמר https://github.com/bazelbuild/bazel/issues/7075).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_remove_legacy_whole_archive
: "true" -
אם הדבר נכון, כברירת מחדל, Bazel לא תקשר קשרי תלות של ספרייה כארכיון כולו (בכתובת https://github.com/bazelbuild/bazel/issues/7362 ניתן למצוא הוראות העברה).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_require_ctx_in_configure_features
: "true" -
אם הערך true, Bazel ידרוש פרמטר 'ctx' in to cc_common.configure_features (מידע נוסף בכתובת https://github.com/bazelbuild/bazel/issues/7793).
תגים:loading_and_analysis
,incompatible_change
-
שימוש באובייקטים משותפים בממשק אם הם נתמכים על ידי ערכת הכלים. כל שרשראות הכלים של ELF תומכות בשלב זה בהגדרה הזו.
תגים:loading_and_analysis
,affects_outputs
,affects_outputs
- ברירת מחדל של
--ios_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
ההגדרה קובעת את גרסת ה-SDK של iOS לפיתוח אפליקציות ל-iOS. אם לא צוין, נעשה שימוש בגרסת ברירת מחדל של iOS SDK מ-'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--macos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
ההגדרה קובעת את גרסת ה-macOS SDK שבה משתמשים כדי לבנות אפליקציות ל-macOS. אם לא צוין, נעשה שימוש בגרסת macOS SDK המוגדרת כברירת מחדל מ-'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--minimum_os_version=<a string>
: תיאור -
גרסת מערכת ההפעלה המינימלית שהאוסף שלך מטרגט.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--platform_mappings=<a relative path>
: "" -
המיקום של קובץ מיפוי שמתאר באיזו פלטפורמה להשתמש אם לא הוגדרה פלטפורמה או באילו סימונים להגדיר כשהפלטפורמה כבר קיימת. חייב להיות יחסי לשורש הראשי של סביבת העבודה. ברירת המחדל היא 'platform_mappings' (קובץ שנמצא מתחת לרמה הבסיסית (root) של סביבת עבודה).
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--platforms=<a build target label>
: "" -
התוויות של כללי הפלטפורמה שמתארות את פלטפורמות היעד של הפקודה הנוכחית.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--python2_path=<a string>
: תיאור -
הוצא משימוש, לא-מושבת. מושבת על ידי `--incompatible_use_python_toolchains`.
תגים:no_op
,deprecated
- ברירת מחדל של
--python3_path=<a string>
: תיאור -
הוצא משימוש, לא-מושבת. מושבת על ידי `--incompatible_use_python_toolchains`.
תגים:no_op
,deprecated
- ברירת מחדל של
--python_path=<a string>
: תיאור -
הנתיב המוחלט של המתרגם ב-Python הופעל כדי להפעיל יעדים ב-Python בפלטפורמת היעד. הוצאה משימוש, הושבתה על ידי --incompatible_use_python_toolchains.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--python_top=<a build target label>
: תיאור -
התווית של py_runtime שמייצגת את התרגום של Python הופעלה להפעלת יעדים של Python בפלטפורמת היעד. הוצאה משימוש, הושבתה על ידי --incompatible_use_python_toolchains.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--target_platform_fallback=<a build target label>
: "@local_config_platform//:host" -
התווית של כלל הפלטפורמה שצריך להשתמש בה אם לא הוגדרה פלטפורמת יעד, ואין מיפוי פלטפורמה שתואם לקבוצת הסימונים הנוכחית.
תגים:affects_outputs
,changes_inputs
,loading_and_analysis
- ברירת מחדל של
--tvos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
ההגדרה קובעת את גרסת ה-SDK של tvOS שבה משתמשים כדי ליצור אפליקציות TV. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של TV SDK מ-'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--watchos_sdk_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
ההגדרה קובעת את גרסת ה-SDK של WatchOS שבה משתמשים כדי לבנות אפליקציות שעון. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של WatchOS SDK מגרסה 'xcode_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--xcode_version=<a string>
: תיאור -
אם צוין, נעשה שימוש ב-Xcode של הגרסה הנתונה לפעולות build רלוונטיות. אם לא צוין, נעשה שימוש בגרסת ברירת המחדל של הביצוע של Xcode.
תגים:loses_incremental_state
- ברירת מחדל של
--xcode_version_config=<a build target label>
: "@bazel_tools//tools/cpp:host_xcodes" -
התווית של הכלל xcode_config שיש להשתמש בה לבחירת הגרסה של Xcode בתצורת ה-build.
תגים:loses_incremental_state
,loading_and_analysis
- אפשרויות ששולטות בפלט של הפקודה:
- ברירת מחדל של
--[no]apple_enable_auto_dsym_dbg
: "false" -
אם צריך לאלץ יצירה של קובצי ניפוי באגים (.dSYM) עבור גרסאות build ל-dbg.
תגים:affects_outputs
,action_command_lines
- ברירת מחדל של
--[no]apple_generate_dsym
: "false" -
האם ליצור קובצי ניפוי באגים ( .dSYM)?
תגים:affects_outputs
,action_command_lines
- ברירת מחדל של
--[no]build_runfile_links
: "true" -
אם הערך הוא true, יש ליצור יערות קישור ריצה עבור כל היעדים. אם False, כותבים מניפסטים רק כשהדבר אפשרי.
תגים:affects_outputs
- ברירת מחדל של
--[no]build_runfile_manifests
: "true" -
אם הערך הוא True, צריך לכתוב מניפסטים מסוג Runfiles בכל היעדים. אם FALSE, משמיטים אותן. הבדיקות המקומיות לא יפעלו אם הן יהיו שקריות.
תגים:affects_outputs
- ברירת מחדל של
--[no]build_test_dwp
: "false" -
אם האפשרות מופעלת, כשפותחים בדיקות C++ באופן סטטי ובצורה קפדנית, המערכת תיצור באופן אוטומטי גם קובץ .dwp עבור הקובץ הבינארי של הבדיקה.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--cc_proto_library_header_suffixes=<comma-separated list of options>
: ".pb.h" -
המערכת מגדירה את הקידומות של קובצי הכותרת שיוצרים ב-cc_proto_library.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--cc_proto_library_source_suffixes=<comma-separated list of options>
: ".pb.cc" -
מגדיר את הקידומות של קובצי המקור ש-cc_proto_library יוצר.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_proto_descriptor_sets_include_source_info
: "false" -
אפשר לבצע פעולות נוספות על גרסאות API חלופיות של Java ב-proto_library.
תגים:affects_outputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_proto_extra_actions
: "false" -
אפשר לבצע פעולות נוספות על גרסאות API חלופיות של Java ב-proto_library.
תגים:affects_outputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_save_feature_state
: "false" -
שומרים את המצב של תכונות מופעלות ומבוקשות כפלט של הידור.
תגים:affects_outputs
,experimental
- ברירת מחדל של
--fission=<a set of compilation modes>
: "no" -
ההגדרה קובעת אילו מצבי הידור משתמשים בפיקוח עבור אוספי +C+. יכולים להיות כל שילובים של {'speedbuild', 'dbg', 'opt'} או ערכים מיוחדים 'yes' כדי להפעיל את כל המצבים &&339;no' כדי להשבית את כל המצבים.
תגים:loading_and_analysis
,action_command_lines
,affects_outputs
- ברירת מחדל של
--[no]legacy_external_runfiles
: "true" -
אם המדיניות מוגדרת כ-TRUE, יש לבנות יערות סימבונק של Runruns עבור מאגרים חיצוניים בכפוף ל- .runfiles/wsname/external/repo (בנוסף ל- .runfiles/repo).
תגים:affects_outputs
- ברירת מחדל של
--[no]objc_generate_linkmap
: "false" -
ההגדרה קובעת אם ליצור קובץ מפת קישור.
תגים:affects_outputs
- ברירת מחדל של
--[no]save_temps
: "false" -
אם המדיניות מוגדרת, פלט זמני מ-gcc יישמר. דוגמאות לקובצי .s (קוד ליצירת מקטע), קובצי .i (C מעובד מראש) וקובצי .ii (C++ ). לפני העיבוד:
תגים:affects_outputs
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לעצם קיומו:
- נצברו
--action_env=<a 'name=value' assignment with an optional value part>
שימושים מרובים -
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם הגדרת יעד. אפשר לציין משתנים לפי שם. במקרה כזה, הערך יילקח מסביבת ההפעלה, או מצמד name=value שקובע את הערך בלי קשר לסביבת ההפעלה. ניתן להשתמש באפשרות זו כמה פעמים. לאפשרויות המוגדרות לאותו משתנה, המנצחים האחרונים, האפשרויות המצטברות למשתנים שונים.
תגים:action_command_lines
- ברירת מחדל של
--android_cpu=<a string>
: "armeabi-v7a" -
מעבד ה-Android לטירגוט.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]android_databinding_use_androidx
: "false" -
יוצרים קובצי התאמת נתונים ל-AndroidX. האפשרות הזו משמשת רק לקישור נתונים v2.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--[no]android_databinding_use_v3_4_args
: "false" -
שימוש ב-Android Databining v2 עם ארגומנט 3.4.0
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--android_dynamic_mode=<off, default or fully>
: "off" -
קביעה אם קישורי +C+ של כללי Android יקושרו באופן דינמי כאשר cc_binary לא ייצור באופן מפורש ספרייה משותפת. 'default' פירוש הדבר שבסיס הפנים יבחר אם לקשר באופן דינמי. 'ly' כלומר כל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי ברובו.
תגים:affects_outputs
,loading_and_analysis
--android_manifest_merger_order=<alphabetical, alphabetical_by_configuration or dependency>
כברירת מחדל: "alphabetical"-
מגדיר את סדר המניפסטים שהועברו למיזוג המניפסט עבור קבצים בינאריים של Android. 'ALPHABETLY' פירושו שהמניפסטים ממוינים לפי הנתיב ביחס לרכיב ה-exe. ALPHABETical_BY_CONFIGURATION פירושו שהמניפסטים ממוינים לפי נתיבים ביחס לספריית התצורה בספריית הפלט. המשמעות של DEPENDENCY היא שמניפסטים מסודרים לפי כל ספרייה שנמצאת לפני המניפסטים של יחסי התלות שלה.
תגים:action_command_lines
,execution
- ברירת מחדל של
--[no]android_resource_shrinking
: "false" -
הפעלת כיווץ משאבים ל-APK_android_binary שמשתמשים ב-ProGuard
תגים:affects_outputs
,loading_and_analysis
- נצברו
--apple_bitcode=<'mode' or 'platform=mode', where 'mode' is none, embedded_markers or embedded, and 'platform' is ios, watchos, tvos, macos or catalyst>
שימושים מרובים -
יש לציין את מצב קוד ה-API של Apple לצורך שלבי הידור שמטרגטים את ארכיטקטורת המכשירים. הערכים צריכים להיות בפורמט '[platform=]mode' כאשר הפלטפורמה (שחייבת להיות 'ios', 'macos', 'tvos' או 'watchos') היא אופציונלית. אם צוין, מצב מצב הקידוד חל על הפלטפורמה הזו באופן ספציפי. אם לא נתון, הוא חל על כל הפלטפורמות. המצב חייב להיות 'none', 'embedded_סמןs' או 'embedded' ייתכן שהאפשרות הזו תוצג כמה פעמים.
תגים:loses_incremental_state
- ברירת מחדל של
--[no]build_python_zip
: "auto" -
יצירת קובץ ZIP של קובץ הפעלה בצורת פיליון. ב-Windows, השבתה בפלטפורמות אחרות
תגים:affects_outputs
- נצברו
--catalyst_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה של ארכיטקטורה המופרדת בפסיקים שבשבילה לבנות קבצים בינאריים של Apple Catalyst.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--[no]collect_code_coverage
: "false" -
אם תציינו זאת, Bazel תפיק קוד אינסטרומנטציה (באמצעות אינסטרומנטציה אופליין, במידת האפשר) ותאסוף מידע על כיסוי במהלך הבדיקות. השינוי ישפיע רק על יעדים שתואמים לשיטה --instrumentation_filter. בדרך כלל, אין לציין אפשרות זו ישירות – 'Bazelcover' במקום זאת יש להשתמש בפקודה.
תגים:affects_outputs
--compilation_mode=<fastbuild, dbg or opt>
[-c
] ברירת מחדל: "speedbuild"-
מציינים את המצב שבו יוצג הקובץ הבינארי. ערכים: 'speedbuild', 'dbg', 'opt'.
תגים:affects_outputs
,action_command_lines
,explicit_in_output_path
- נצברו
--conlyopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc במהלך הידור קובצי המקור של C.
תגים:action_command_lines
,affects_outputs
- נצברו
--copt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-ccC.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--cpu=<a string>
: "" -
מעבד היעד.
תגים:changes_inputs
,affects_outputs
,explicit_in_output_path
- ברירת מחדל של
--cs_fdo_absolute_path=<a string>
: תיאור -
יש להשתמש בפרטי הפרופיל של CSFDO כדי לבצע אופטימיזציה של האוסף. מציינים את שם הנתיב המוחלט של קובץ ה-ZIP המכיל את קובץ הפרופיל, קובץ גולמי מסוג LLVM או קובץ שנוסף לאינדקס.
תגים:affects_outputs
- ברירת מחדל של
--cs_fdo_instrument=<a string>
: תיאור -
יצירת קבצים בינאריים עם אינסטרומנטציה של FDO רגישה להקשר. עם המהדר Clang/LLVM, הוא מקבל גם את שם הספרייה שמתחתיו יושלכו קובצי הפרופיל הגולמי בזמן הריצה.
תגים:affects_outputs
- ברירת מחדל של
--cs_fdo_profile=<a build target label>
: תיאור -
cs_fdo_profile המייצג את הפרופיל הרגיש של ההקשר שישמש לאופטימיזציה.
תגים:affects_outputs
- נצברו
--cxxopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc כשעורכים קובצי מקור ב-C++.
תגים:action_command_lines
,affects_outputs
- נצברו
--define=<a 'name=value' assignment>
שימושים מרובים -
כל אפשרות --הגדרה מציינת מטלה למשתנה build.
תגים:changes_inputs
,affects_outputs
- ברירת מחדל של
--dynamic_mode=<off, default or fully>
: "default" -
ההגדרה קובעת אם הקבצים הבינאריים מסוג C++ יקושרו באופן דינמי. 'default' פירושו ש-Bazel תבחר אם לקשר באופן דינמי. 'ly' כלומר כל הספריות יקושרו באופן דינמי. 'off' פירושו שכל הספריות יקושרו במצב סטטי ברובו.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--[no]enable_fdo_profile_absolute_path
: "true" -
אם המדיניות מוגדרת, שימוש ב-fdo_lbolute_profile_path יגדיל את השגיאה.
תגים:affects_outputs
- ברירת מחדל של
--[no]enable_runfiles
: "auto" -
הפעלה של עץ קישור סימולטני (runfiles); כברירת מחדל, התכונה מושבתת ב-Windows, בפלטפורמות אחרות.
תגים:affects_outputs
- נצברו
--experimental_action_listener=<a build target label>
שימושים מרובים -
הוצא משימוש לטובת היבטים. אפשר להשתמש ב-action_listener כדי לצרף action_action לביצוע פעולות build קיימות.
תגים:execution
,experimental
- ברירת מחדל של
--[no]experimental_android_compress_java_resources
: "false" -
דחיסת משאבים של Java ב-APK
תגים:affects_outputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_android_databinding_v2
: "false" -
שימוש בגרסה 2 של קישור ל-Android
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--[no]experimental_android_resource_shrinking
: "false" -
הפעלת כיווץ משאבים ל-APK_android_binary שמשתמשים ב-ProGuard
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_android_rewrite_dexes_with_rex
: "false" -
להשתמש בכלי Rex כדי לכתוב מחדש קובצי Dex
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--experimental_objc_fastbuild_options=<comma-separated list of options>
: "-O0,-DDEBUG=1" -
יש להשתמש במחרוזות האלה כאפשרויות מהדר dataLayer של objc Builder.
תגים:action_command_lines
- ברירת מחדל של
--[no]experimental_omitfp
: "false" -
אם המדיניות מוגדרת כ-True, יש להשתמש ב-libunhost עבור שחרור מחסניות (stackunack) ולהידור באמצעות -fomit-frame-pointer ו- -fסינכרוני-un Wind-tables.
תגים:action_command_lines
,affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_platform_in_output_dir
: "false" -
אם הערך הוא True, פלטפורמת היעד תשמש בשם של ספריית הפלט במקום ביחידת העיבוד המרכזית (CPU).
תגים:affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_use_llvm_covmap
: "false" -
אם צוין, Bazel תיצור פרטי מפה של llvm-cov במקום gcov כש-collect_code_coverage מופעל.
תגים:changes_inputs
,affects_outputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--fat_apk_cpu=<comma-separated list of options>
: "armeabi-v7a" -
הגדרת האפשרות הזו מאפשרת חבילות APK בעלות שומן, המכילות קבצים בינאריים מקומיים לכל ארכיטקטורת היעד שצוינה, לדוגמה, --fat_APK_cpu=x86,armeabi-v7a. אם הדגל הזה צוין, המערכת תתעלם מ-android_cpu בהתאם לתלויים בכללי android_binary.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]fat_apk_hwasan
: "false" -
אם רוצים ליצור פיצולים מסוג HWASAN.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--fdo_instrument=<a string>
: תיאור -
יצירת קבצים בינאריים עם אינסטרומנטציה של FDO. עם המהדר Clang/LLVM, הוא מקבל גם את שם הספרייה שמתחתיו יושלכו קובצי הפרופיל הגולמי בזמן הריצה.
תגים:affects_outputs
- ברירת מחדל של
--fdo_optimize=<a string>
: תיאור -
יש לך אפשרות להשתמש בפרטי הפרופיל ב-FDO כדי לבצע אופטימיזציה של האוסף. יש לציין את השם של קובץ ZIP המכיל עץ קבצים עם הסיומת .gcda, קובץ afdo המכיל פרופיל אוטומטי או קובץ פרופיל LLVM. סימון זה מקבל גם קבצים שצוינו כתוויות (למשל `//foo/bar:file.afdo` – ייתכן שיהיה עליך להוסיף הנחיית ’exports_files’ לחבילה המתאימה) ותוויות המפנות ליעדים ’fdo_profile’. סימון זה יוחלף על ידי הכלל 'fdo_profile'.
תגים:affects_outputs
- ברירת מחדל של
--fdo_prefetch_hints=<a build target label>
: תיאור -
להשתמש ברמזים למטמון מראש.
תגים:affects_outputs
- ברירת מחדל של
--fdo_profile=<a build target label>
: תיאור -
פרופיל העסק fdo_profile משמש לאופטימיזציה של הפרופיל.
תגים:affects_outputs
- נצברו
--features=<a string>
שימושים מרובים -
כברירת מחדל, כל התכונות יופעלו או יושבתו. ציון -<feature> ישבית את התכונה באופן גלובלי. תכונות שליליות תמיד מבטלות תכונות חיוביות. הסימון הזה משמש להשקת שינויי ברירת מחדל בתכונות ללא גרסת Bazel.
תגים:changes_inputs
,affects_outputs
- ברירת מחדל של
--[no]force_pic
: "false" -
אם המדיניות מופעלת, כל האוספים של C++ מייצרים קוד עצמאי למיקום ("-fPIC"), קישורים מעדיפים ספריות מוגדרות מראש של PIC על פני ספריות שאינן מסוג PIC, וקישורים מייצרים קובצי הפעלה שאינם תלויי מיקום ("-Pie").
תגים:loading_and_analysis
,affects_outputs
- נצברו
--host_action_env=<a 'name=value' assignment with an optional value part>
שימושים מרובים -
קביעת קבוצת משתני הסביבה הזמינים לפעולות עם תצורות מארח או ביצוע. אפשר לציין משתנים לפי שם. במקרה כזה, הערך יילקח מסביבת ההפעלה, או מצמד name=value שקובע את הערך בלי קשר לסביבת ההפעלה. ניתן להשתמש באפשרות זו כמה פעמים. לאפשרויות המוגדרות לאותו משתנה, המנצחים האחרונים, האפשרויות המצטברות למשתנים שונים.
תגים:action_command_lines
- ברירת מחדל של
--host_compilation_mode=<fastbuild, dbg or opt>
: "opt" -
ציון המצב שבו ייעשה שימוש בכלים ששימשו ליצירת ה-build. ערכים: 'speedbuild', 'dbg', 'opt'.
תגים:affects_outputs
,action_command_lines
- נצברו
--host_conlyopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc במהלך הידור קובצי המקור של C עבור כלי מארח.
תגים:action_command_lines
,affects_outputs
- נצברו
--host_copt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-cc עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_cpu=<a string>
: "" -
המעבד (CPU) המארח.
תגים:changes_inputs
,affects_outputs
- נצברו
--host_cxxopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-cc עבור כלי אירוח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_force_python=<PY2 or PY3>
: תיאור -
עוקפת את הגרסה ב-Python של תצורת המארח. יכול להיות "PY2" או "PY3".
תגים:loading_and_analysis
,affects_outputs
- נצברו
--host_linkopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc בעת קישור כלים למארח.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--host_macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת macOS תואמת מינימלית ליעדים של מארח. אם לא צוין, נעשה שימוש ב-'macos_sdk_version'.
תגים:loses_incremental_state
- נצברו
--host_swiftcopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-swiftc עבור כלים למארחים.
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--[no]incompatible_avoid_conflict_dlls
: "true" -
אם אפשרות זו מופעלת, כל הספריות המקושרות מסוג C++ (DLL) שנוצרו על ידי cc_library ב-Windows יעברו שינוי שם ל-name_{Hash}.dll, שם הגיבוב מחושב על סמך ה-RepositoryName ונתיב החבילה DLL'. האפשרות הזו שימושית כשיש חבילה אחת שתלויה בכמה cc_library עם אותו שם (לדוגמה //foo/bar1:utils ו-//foo/bar2:utils).
תגים:loading_and_analysis
,affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_merge_genfiles_directory
: "true" -
אם המדיניות מוגדרת כ-True, ספריית הגנרטורים מקופלת בספריית bin.
תגים:affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_use_platforms_repo_for_constraints
: "true" -
אם הערך מקבל את הערך True, הגדרות אילוץ של @bazel_tools יוסרו.
תגים:affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]instrument_test_targets
: "false" -
כשהאפשרות 'כיסוי' מופעלת, המדיניות הזו קובעת אם לשקול כללים להגדרת אינסטרומנטציה. במהלך ההגדרה, המערכת מוסיפה אמצעי בדיקה שכוללים --instrumentation_filter. אחרת, כללי הבדיקה תמיד לא ייכללו באינסטרומנטציה של הכיסוי.
תגים:affects_outputs
- ברירת מחדל
--instrumentation_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-/Javatests[/:],- /test/Java[/:]" -
אם מפעילים את הכיסוי, המערכת מחילה רק כללים שהשמות שלהם נכללים במסנן שצוין לפי ביטוי רגולרי. כללים עם קידומת '-' אינם נכללים במקום זאת. לתשומת ליבכם: רק כללים שאינם בדיקות נמשכים לאינדקס, אלא אם מפעילים את --instrument_test_targets.
תגים:affects_outputs
- ברירת מחדל של
--ios_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסה מינימלית של iOS שתואמת לסימולטורים ולסימולטורים מבוססי יעד. אם לא צוין, נעשה שימוש ב-'ios_sdk_version'.
תגים:loses_incremental_state
- נצברו
--ios_multi_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה מופרדת בפסיקים של ארכיטקטורה שאפשר לבנות באמצעותה ios_application. התוצאה היא קובץ בינארי אוניברסלי המכיל את כל הארכיטקטורה שצוינה.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--[no]legacy_whole_archive
: "true" -
הוצאה משימוש, הוחלפה על ידי --incompatible_remove_Legacy_whole_archive (לפרטים נוספים: https://github.com/bazelbuild/bazel/issues/7362). במצב מופעל, יש להשתמש ב-allall-archive כדי להשתמש בכללים של cc_binary שיש להם linkshared=True וב-linkstatic=True או '-static' ב-linkopts. הערך הזה מיועד לתאימות לאחור בלבד. במקום זאת, עדיף להשתמש תמיד ב-linklink=1, היכן שנדרש.
תגים:action_command_lines
,affects_outputs
,deprecated
- נצברו
--linkopt=<a string>
שימושים מרובים -
אפשרות נוספת להעברה ל-cc בזמן הקישור.
תגים:action_command_lines
,affects_outputs
- נצברו
--ltobackendopt=<a string>
שימושים מרובים -
אפשרות נוספת למעבר לשלב הקצה העורפי של LTO (בקטע --features=thin_lto).
תגים:action_command_lines
,affects_outputs
- נצברו
--ltoindexopt=<a string>
שימושים מרובים -
אפשרות נוספת למעבר לשלב ההוספה לאינדקס של LTO (בקטע --features=thin_lto).
תגים:action_command_lines
,affects_outputs
- נצברו
--macos_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה של ארכיטקטורה שמופרדת בפסיקים שבשבילה צריך ליצור קבצים בינאריים של Apple macOS.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--macos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת macOS תואמת מינימלית ליעדים. אם לא צוין, נעשה שימוש ב-'macos_sdk_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--[no]objc_debug_with_GLIBCXX
: "false" -
אם המדיניות מוגדרת, ומצב העריכה מוגדר כך: 'dbg', GLIBCXX_DEBUG, GLIBCXX_DEBUG_PEDANTIC ו-GLIBCPP_CONCEPT_CHECKS.
תגים:action_command_lines
- ברירת מחדל של
--[no]objc_enable_binary_stripping
: "false" -
האם לבצע רצועות של סימנים וקוד לא פעיל בבינאריים מקושרים. אם בוחרים את הסימון הזה וגם את הסימון 'compilation_mode=opt', המערכת תסיר מחרוזות בינאריות.
תגים:action_command_lines
- נצברו
--objccopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה ל-cc במהלך הידור קובצי המקור 'יעד-C/C++'.
תגים:action_command_lines
- נצברו
--per_file_copt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
שימושים מרובים -
אפשרויות נוספות להעברה סלקטיבית ל-cc כשעורכים קבצים מסוימים. ניתן להעביר את האפשרות הזו כמה פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. המונח regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (יש לעיין גם ב-(instrumentation_filter). האפשרות_1 עד Option_n מתייחסת לאפשרויות שרירותיות של שורות פקודה. אם אפשרות מכילה פסיק, צריך לצטט לוכסן הפוך. האפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --for
תגים:action_command_lines
,affects_outputs
- נצברו
--per_file_ltobackendopt=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths followed by an @ and a comma separated list of options>
שימושים מרובים - אפשרויות נוספות להעברה סלקטיבית לקצה העורפי של LTO (בקטע --features=thin_lto) כשעורכים אובייקטים בקצה העורפי. ניתן להעביר את האפשרות הזו כמה פעמים. תחביר: regex_filter@option_1,option_2,...,option_n. כאשר regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים, Option_1 עד Option_n מתייחסת לאפשרויות שרירותיות של שורות פקודה. אם אפשרות מכילה פסיק, צריך לצטט לוכסן הפוך. האפשרויות יכולות להכיל @. רק הסימן @ הראשון משמש לפיצול המחרוזת. דוגמה: --per
- ברירת מחדל של
--platform_suffix=<a string>
: תיאור -
קביעת סיומת שתתווסף לספריית התצורה.
תגים:loses_incremental_state
,affects_outputs
,loading_and_analysis
- ברירת מחדל של
--propeller_optimize=<a build target label>
: תיאור -
יש להשתמש בפרטי פרופיל ה-Proproler כדי לבצע אופטימיזציה של יעד ה-build.פרופיל דו-שיח חייב להכיל לפחות אחד משני קבצים, פרופיל ב-cc ופרופיל ישן. הדגל הזה מקבל תווית build שחייבת להפנות לקובצי הקלט של פרופיל המדחף. לדוגמה, קובץ ה-BUILD שמגדיר את התווית, ב-a/b/BUILD:propeller_optimize( name = "propeller_profile", cc_profile = "propeller_cc_profile.txt", ld_profile = "propeller_ld_profile.txt",) הוראה יכולה להיות זמינה כדי להוסיף את הקבצים הבאים יש להשתמש באפשרות הזו באופן הבא: --propeller_optimize=//a/b:propeller_profile
תגים:action_command_lines
,affects_outputs
- ברירת מחדל של
--propeller_optimize_absolute_cc_profile=<a string>
: תיאור -
שם הנתיב המוחלט של קובץ cc_profile עבור גרסאות build שעברו אופטימיזציה של Profeler.
תגים:affects_outputs
- ברירת מחדל של
--propeller_optimize_absolute_ld_profile=<a string>
: תיאור -
שם הנתיב המוחלט של קובץ ld_profile עבור גרסאות build שעברו אופטימיזציה ל-Propleler.
תגים:affects_outputs
- ברירת מחדל של
--run_under=<a prefix in front of command>
: תיאור -
קידומת שצריך להוסיף לפני קובצי ההפעלה עבור הפקודות 'test' &'run' אם הערך הוא 'foo -bar' ושורת הפקודה היא 'test_binary -baz' , שורת הפקודה הסופית היא 'foo -bar test_binary -baz'. . היא יכולה להיות גם תווית ליעד הפעלה. לדוגמה: 'valgrind', 'strace', 'strace -c', 'valgrind --quiet --num-callers=20', '//package:target', '//package:target', '//package:target #
תגים:action_command_lines
-
אם True, ספריות מקוריות שמכילות פונקציונליות זהה ישותפו בין היעדים השונים
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--[no]stamp
: "false" -
פריטים בינאריים בחותמת עם התאריך, שם המשתמש, שם המארח, פרטי סביבת העבודה וכו'
תגים:affects_outputs
- ברירת מחדל של
--strip=<always, sometimes or never>
: "sometimes" -
ההגדרה קובעת אם להסיר בינאריים וספריות משותפות (באמצעות "-Wl,--strip-debug"). ערך ברירת המחדל של 'sometimes' פירושו רצועת אם if- --compilation_mode=fastbuild.
תגים:affects_outputs
- נצברו
--stripopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה כאשר יוצרים קובץ בינארי של '<name>.stripped'
תגים:action_command_lines
,affects_outputs
- נצברו
--swiftcopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה לאוסף של Swift.
תגים:action_command_lines
- נצברו
--tvos_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה של ארכיטקטורה שמופרדת בפסיקים שבשבילה צריך לבנות קבצים בינאריים של Apple TV.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--tvos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת ה-TVOS תואמת מינימלית לסימולטורים וליעדים של היעד. אם לא צוין, נעשה שימוש ב-'tvos_sdk_version'.
תגים:loses_incremental_state
- נצברו
--watchos_cpus=<comma-separated list of options>
שימושים מרובים -
רשימה של ארכיטקטורה המופרדת בפסיקים שבשבילה לבנות קבצים בינאריים של AppleOS.
תגים:loses_incremental_state
,loading_and_analysis
- ברירת מחדל של
--watchos_minimum_os=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסה מינימלית של WatchOS תואמת לסימולטורים ולסימולטורים מבוססי יעד. אם לא צוין, נעשה שימוש ב-'watchos_sdk_version'.
תגים:loses_incremental_state
- ברירת מחדל של
--xbinary_fdo=<a build target label>
: תיאור -
יש לך אפשרות להשתמש בפרטי הפרופיל ב-XbinaryFDO כדי לבצע אופטימיזציה של האוסף. קביעת השם של פרופיל בינארי כברירת מחדל. אם משתמשים באפשרות הזו יחד עם --fdo_instrument/--fdo_optimize/--fdo_profile, האפשרויות האלה תמיד יקבלו את הערך כאילו xbinary_fdo לא צוין.
תגים:affects_outputs
- אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
- ברירת מחדל של
--auto_cpu_environment_group=<a build target label>
: "" -
מציינים את המאפייןEnvironment_group [קבוצת_סביבה] שישמש למיפוי אוטומטי של ערכי pu לערכי target_environment.
תגים:changes_inputs
,loading_and_analysis
,experimental
- ברירת מחדל של
--[no]check_licenses
: "false" -
צריך לוודא שמגבלות הרישוי שנקבעות על ידי חבילות תלויות לא מתנגשות עם מצבי ההפצה של היעדים שאתם יוצרים. כברירת מחדל, הרישיונות לא נבדקים.
תגים:build_file_semantics
- ברירת מחדל של
--[no]check_visibility
: "true" -
אם המדיניות מושבתת, שגיאות חשיפה בתלויות יעד יורדו לאזהרות.
תגים:build_file_semantics
- ברירת מחדל של
--[no]desugar_for_android
: "true" -
האם לבצע פענוח קוד בייט 8 של סוכר לפני פענוח הקוד?
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]desugar_java8_libs
: "false" -
האם לכלול ספריות Java 8 נתמכות באפליקציות למכשירים מדור קודם.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
,experimental
- ברירת מחדל של
--[no]enforce_constraints
: "true" -
לבדוק את הסביבות שבהן כל יעד תואם, ומדווח על שגיאות אם לכל יעד יש יחסי תלות שלא תומכים באותן סביבות
תגים:build_file_semantics
- ברירת מחדל של
--[no]experimental_allow_android_library_deps_without_srcs
: "false" -
סימון כדי לעזור במעבר מהמדיניות של אי-אפשר להשתמש בכללי android_library ללא כינויים באמצעות נקודות שפל. יש לנקות את המאגר כדי שההוצאה תתבצע כברירת מחדל.
תגים:eagerness_to_exit
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_check_desugar_deps
: "true" -
האם כדאי לבדוק שוב את ניפוי הבאגים הנכון ברמה הבינארית של Android.
תגים:eagerness_to_exit
,loading_and_analysis
,experimental
- ברירת מחדל של
--experimental_import_deps_checking=<off, warning or error>
: "OFF" -
כשהאפשרות מופעלת, בודקים אם התלות של aar_import הסתיימו. האכיפה הזו עלולה לפרוץ את הבנייה, או להוביל רק לאזהרות.
תגים:loading_and_analysis
- ברירת מחדל של
--experimental_strict_java_deps=<off, warn, error, strict or default>
: "default" -
אם הערך הוא true, המערכת בודקת שיעד של Java מצהיר במפורש על כל היעדים שנעשה בהם שימוש ישיר כתלויות.
תגים:build_file_semantics
,eagerness_to_exit
- ברירת מחדל של
--[no]incompatible_check_testonly_for_output_files
: "false" -
אם האפשרות הזו מופעלת, יש לבדוק רק את היעדים הנדרשים שהם קובצי פלט, על ידי חיפוש הבדיקה בלבד של כלל היצירה. ההגדרה הזו תואמת לבדיקת הניראות.
תגים:build_file_semantics
,incompatible_change
- ברירת מחדל של
--[no]incompatible_disable_native_android_rules
: "false" -
אם המדיניות מופעלת, השימוש הישיר בכללי Android המקוריים מושבת. יש להשתמש בכללי Starlark ל-Android בכתובת https://github.com/bazelbuild/rules_android
תגים:eagerness_to_exit
,incompatible_change
- ברירת מחדל של
--[no]incompatible_disable_native_apple_binary_rule
: "false" -
לא צריך להשתמש בהגדרה הזו. אפשר לשמור כאן לצורך תאימות לאחור.
תגים:eagerness_to_exit
,incompatible_change
- ברירת מחדל של
--[no]incompatible_force_strict_header_check_from_starlark
: "true" -
אם האפשרות מופעלת, ניתן להגדיר בדיקת כותרות מחמירה ב-Starlark API
תגים:loading_and_analysis
,changes_inputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_validate_top_level_header_inclusions
: "true" -
אם הדבר נכון, Bazel תוודא גם שההכללה של הספרייה היא ברמה העליונה (מידע נוסף זמין בכתובת https://github.com/bazelbuild/bazel/issues/10047).
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]strict_filesets
: "false" -
אם האפשרות הזו מופעלת, קבצים שחוצים את גבולות החבילה מדווחים כשגיאות. הוא לא פועל כאשר Check_fileset_dependencies_recursively מושבת.
תגים:build_file_semantics
,eagerness_to_exit
- ברירת מחדל של
--strict_proto_deps=<off, warn, error, strict or default>
: "error" -
אלא אם האפשרות מושבתת, המערכת בודקת שיעד Proto_library מצהיר באופן מפורש על כל היעדים שנעשה בהם שימוש ישיר כתלויות.
תגים:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ברירת מחדל של
--strict_public_imports=<off, warn, error, strict or default>
: "off" -
אלא אם האפשרות מושבתת, המערכת בודקת שיעד Proto_library מצהיר באופן מפורש על כל היעדים שנעשה בהם שימוש ב 'ייבוא ציבורי'.
תגים:build_file_semantics
,eagerness_to_exit
,incompatible_change
- ברירת מחדל של
--[no]strict_system_includes
: "false" -
אם הערך הוא True, צריך להצהיר גם על כותרות שנמצאות דרך נתיבים (-isystem).
תגים:loading_and_analysis
,eagerness_to_exit
- נצברו
--target_environment=<a build target label>
שימושים מרובים -
מצהירה על סביבת היעד הזו. הערך חייב להיות תווית של כלל "enrinoment" אם צוין, כל היעדים ברמה העליונה חייבים להתאים לסביבה הזו.
תגים:changes_inputs
- אפשרויות שמשפיעות על הפלט של החתימה של גרסת build:
- ברירת מחדל של
--apk_signing_method=<v1, v2, v1_v2 or v4>
: "v1_v2" -
הטמעה שתשמש לחתימה על חבילות APK
תגים:action_command_lines
,affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]device_debug_entitlements
: "true" -
אם המדיניות מוגדרת ומצב האוסף לא 'opt' אפליקציות objc יכללו הרשאות לניפוי באגים בזמן החתימה.
תגים:changes_inputs
- ברירת מחדל של
--ios_signing_cert_name=<a string>
: תיאור -
שם האישור לשימוש בחתימת iOS. אם המדיניות לא מוגדרת, תוחזר לפרופיל ניהול התצורה. יכול להיות העדפת הזהות של אישור המפתח או מחרוזת המשנה של השם הנפוץ באישור, בהתאם לדף האדם של ה-Codesign ' (מפתח רישום).
תגים:action_command_lines
- האפשרות הזו משפיעה על סמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו בקובצי BUILD, קובצי .bzl או קובצי WORKSPACE.:
- ברירת מחדל של
--[no]incompatible_disallow_legacy_py_provider
: "true" -
לא, המערכת תסיר אותה בקרוב.
תגים:loading_and_analysis
,incompatible_change
- אפשרויות שקובעות את אופן הפעולה של סביבת הבדיקה או של אופרטור הבדיקה:
- ברירת מחדל של
--[no]allow_analysis_failures
: "false" -
אם הערך מקבל את הערך 'true', כשל בניתוח של יעד הוא מפיץ את המופע של target&ailureInfo המכיל את תיאור השגיאה, במקום לגרום לכשל ב-build.
תגים:loading_and_analysis
,experimental
- ברירת מחדל של
--analysis_testing_deps_limit=<an integer>
: "2000" -
מגדיר את המספר המקסימלי של יחסי תלות זמניים באמצעות מאפיין של כלל עם מעבר לתצורה for_analysis_testing. חריגה מהמגבלה תגרום לשגיאה בכלל.
תגים:loading_and_analysis
- ברירת מחדל של
--[no]break_build_on_parallel_dex2oat_failure
: "false" -
אם כשלים אמיתיים בפעולת dex2oat יגרמו לקריסה של המודל במקום לבצע Dex2oat בזמן ריצה של הבדיקה.
תגים:loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_android_use_parallel_dex2oat
: "false" -
משתמשים ב-dex2oat במקביל כדי להאיץ את android_test.
תגים:loading_and_analysis
,host_machine_resource_optimizations
,experimental
- ברירת מחדל של
--[no]ios_memleaks
: "false" -
הפעלה של בדיקת דליפות זיכרון ביעדי ios_test.
תגים:action_command_lines
- ברירת מחדל של
--ios_simulator_device=<a string>
: תיאור -
המכשיר להדמיית הפעלה של אפליקציה ל-iOS בסימולטור, לדוגמה 'iPhone 6'. ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים:test_runner
- ברירת מחדל של
--ios_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת ה-iOS שצריך להפעיל בסימולטור בזמן ההפעלה או הבדיקה. המערכת תתעלם מהמדיניות הזו עבור כללי ios_test אם מכשיר היעד צוין בכלל.
תגים:test_runner
- נצברו
--runs_per_test=<a positive integer or test_regex@runs. This flag may be passed more than once>
שימושים מרובים - ההגדרה קובעת את מספר הפעמים שיש להריץ כל בדיקה. אם אחד מהניסיונות נכשל מסיבה כלשהי, הבדיקה כולה תיחשב כושלת. בדרך כלל, הערך שצוין הוא מספר שלם בלבד. דוגמה: -runs_per_test=3 יפעיל את כל הבדיקות 3 פעמים. תחביר חלופי: regex_filter@runs_per_test. כאשר Run_per_test הוא ערך של מספר שלם ו-regex_filter מייצג רשימה של הכללה והחרגה של דפוסי ביטויים רגולריים (ראו גם --instrumentation_filter). דוגמה: --runs_per_test=//foo/.*,-//foo/bar/.*@3 מריץ את כל הבדיקות ב-//foo/ אבל לא מתחת ל-foo/bar שלוש פעמים. ניתן להעביר את האפשרות הזו כמה פעמים. הארגומנט האחרון שהועבר תואם לעדיפות. אם אין תוצאות תואמות, הבדיקה תופעל פעם אחת בלבד.
- נצברו
--test_env=<a 'name=value' assignment with an optional value part>
שימושים מרובים -
ההגדרה קובעת משתני סביבה נוספים שיוחדרו לסביבת הרצה של הבדיקה. אפשר לציין משתנים לפי שם. במקרה כזה, הערך שלהם ייקרא מסביבת הלקוח ב-Bazel או באמצעות צמד name=value. אפשר להשתמש באפשרות הזו כמה פעמים כדי לציין כמה משתנים. בשימוש רק באמצעות הפקודה 'bazel' .
תגים:test_runner
- ברירת מחדל של
--test_timeout=<a single integer or comma-separated list of 4 integers>
: "-1" - כדאי לשנות את ערכי ברירת המחדל של הזמן הקצוב לתפוגה של בדיקות (בדקות) אם יצוין ערך חיובי אחד שלם, הוא יחליף את כל הקטגוריות. אם ציינתם 4 מספרים שלמים המופרדים בפסיקים, הם יחליפו את הזמן הקצוב לתפוגה עבור קצר, בינוני, ארוך ותמידי (בסדר הזה). בכל אחד מהפורמטים, הערך 1- מורה ל-blaze להשתמש בברירות המחדל של הזמן הקצוב לתפוגה עבור קטגוריה זו.
- ברירת מחדל של
--tvos_simulator_device=<a string>
: תיאור -
המכשיר להדמיית הפעלה של אפליקציית tvOS בסימולטור, למשל 'Apple TV 1080p' ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים:test_runner
- ברירת מחדל של
--tvos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת ה-tvOS שפועלת בסימולטור בזמן הפעלה או בדיקה.
תגים:test_runner
- ברירת מחדל של
--watchos_simulator_device=<a string>
: תיאור -
המכשיר להדמיית הפעלה של אפליקציית WatchOS בסימולטור, למשל 'Apple Watch – 38mm' ניתן לקבל רשימת מכשירים על ידי הרצת 'xcrun simctl list devicetypes' במחשב שבו יופעל הסימולטור.
תגים:test_runner
- ברירת מחדל של
--watchos_simulator_version=<a dotted version (for example '2.3' or '3.3alpha2.4')>
: תיאור -
גרסת ה-watchOS שמופעלת בסימולטור כשמריצים או בודקים.
תגים:test_runner
- ברירת מחדל של
--[no]zip_undeclared_test_outputs
: "true" -
אם הערך הוא True, פלט של בדיקות לא מוצהרות יועברו לארכיון בקובץ ZIP.
תגים:test_runner
- אפשרויות הקשורות לפלט שאילתות וסמנטיקה:
- ברירת מחדל של
--aspect_deps=<off, conservative or precise>
: "conservative" -
איך לפתור בעיה של יחסי גובה-רוחב כאשר פורמט הפלט הוא בפורמט {xml,proto,record}. 'off' פירוש הדבר שלא נפתרים יחסי תלות ו'שמרני' (ברירת המחדל) מוסיפים את כל יחסי הגובה-רוחב המוצהרים, בין אם הם קיבלו את רמת התלויות הישירות ובין אם לא. חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, כך שהוא איטי יותר מהמצבים האחרים. כמו כן, אפילו מצב מדויק אינו מדויק לחלוטין: ההחלטה אם לחשב היבט מסוים נקבעת בשלב הניתוח, שאינו פועל במהלך &b3Query;'
תגים:build_file_semantics
- ברירת מחדל של
--[no]graph:factored
: "true" -
אם הערך הוא True, התרשים ייקרא 'fact האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים:terminal_output
- ברירת מחדל של
--graph:node_limit=<an integer>
: "512" -
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; הערך 1- יגרום לכך שלא ייחתך. האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים:terminal_output
- ברירת מחדל של
--[no]implicit_deps
: "true" -
אם האפשרות הזאת מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלות שבו השאילתה פועלת. תלות משתמעת היא זו שלא צוינה במפורש בקובץ BUILD, אך נוספה על ידי ה-bazel. עבור שאילתה, אפשרות זו שולטת בסינון ערכות כלים שנפתרו.
תגים:build_file_semantics
- ברירת מחדל של
--[no]include_aspects
: "true" -
aquery, שאילתה: האם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: no-op (מאפיינים תמיד במעקב).
תגים:terminal_output
- ברירת מחדל של
--[no]incompatible_display_source_file_location
: "true" -
True, כברירת מחדל, יוצג היעד של קובץ המקור. אם True, מציג את המיקום של שורה 1 של קובצי מקור בפלטי מיקום. הסימון הזה קיים רק למטרות העברה.
תגים:terminal_output
,incompatible_change
- ברירת מחדל של
--[no]incompatible_package_group_includes_double_slash
: "true" -
אם האפשרות הזו מופעלת, בעת הפקת המאפיין 'packs' של package_group&, הסימן '//' הראשי לא יושמט.
תגים:terminal_output
,incompatible_change
- ברירת מחדל של
--[no]infer_universe_scope
: "false" -
אם המדיניות set ו- לתשומת ליבכם, הערך של uniuni_scope כפי שהוסק עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, allalleps) הוא לא מה שאתם רוצים, לכן עליכם להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים ודוגמאות זמינים בכתובת https://bazel.build/reference/query#sky-query. אם --univers_scope מוגדר, המערכת מתעלמת מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'שאילתה' (כלומר, לא 'cquery').
תגים:loading_and_analysis
- ברירת מחדל של
--[no]line_terminator_null
: "false" -
אם כל פורמט יסתיים ב-\0 במקום בפורמט חדש.
תגים:terminal_output
- ברירת מחדל של
--[no]nodep_deps
: "true" -
אם המדיניות מופעלת, נקודות שפל מתוך "nodep" ייכללו בתרשים התלות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep". היא "visible". מריצים ומנתחים את הפלט של 'info Build-language' כדי ללמוד על כל המאפיינים "nodep"בשפת ה-build.
תגים:build_file_semantics
- ברירת מחדל של
--output=<a string>
: "label" -
הפורמט שבו יש להדפיס את תוצאות השאילתה. הערכים המותרים ל-cquery הם: label, label_kind, textproto, passs, proto, jsonproto. אם בוחרים 'transitions' צריך גם לציין את האפשרות --transitions=(lite|full).
תגים:terminal_output
- ברירת מחדל של
--[no]proto:default_values
: "true" -
אם מוגדר כ-True, נכללים מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- --פלט=פרוטו
תגים:terminal_output
- ברירת מחדל של
--[no]proto:definition_stack
: "false" -
מאכלס את השדה Proto-stack, שמתעד כל מופע של כלל ה-Starstark שבו מוגדרת המחלקה בכלל.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:flatten_selects
: "true" -
אם המדיניות מופעלת, מאפיינים ניתנים להגדרה שנוצרו על ידי Select() שטוחים. עבור סוגי רשימות, הייצוג השטוח הוא רשימה המכילה כל ערך של המפה שנבחרה פעם אחת בלבד. סוגי הפיגועים שטוחים איזה null.
תגים:build_file_semantics
- ברירת מחדל של
--[no]proto:include_configurations
: "true" -
כשהפרוטוקול מופעל, פלט אב יכלול מידע על ההגדרות. כאשר המדיניות מושבתת,פורמט הפלט אב השאילתה דומה לפורמט פלט שאילתה.
תגים:affects_outputs
- ברירת מחדל של
--[no]proto:include_synthetic_attribute_hash
: "false" -
אם רוצים לחשב ולאכלס את המאפיין $internal_attr_Hash.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:instantiation_stack
: "false" -
אכלוס מחסנית קריאות של כל הנחיה. כדי לעשות זאת, יש צורך במקבץ סטאק
תגים:terminal_output
- ברירת מחדל של
--[no]proto:locations
: "true" -
אם בכלל, כדאי לשלוח פרטי מיקום בפלט אב.
תגים:terminal_output
- ברירת מחדל של
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
רשימת מאפיינים המופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להוציא פלט. האפשרות הזו רלוונטית ל--פלט=פרוטו.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:rule_inputs_and_outputs
: "true" -
אפשר גם לאכלס את השדותכללי_קלט וכלל_פלט.
תגים:terminal_output
- ברירת מחדל של
--[no]relative_locations
: "false" -
אם הערך הוא TRUE, המיקום של קובצי BUILD ב-XML ובפלטי אב יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא יהיה עקבי בין מחשבים. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במכשירים שונים.
תגים:terminal_output
- ברירת מחדל של
--show_config_fragments=<off, direct or transitive>
: "off" -
הצגת קטעי התצורה הנדרשים על ידי כלל והתלות העקיפות שלו. אפשרות זו יכולה לעזור לכם להעריך עד כמה אפשר לחתוך תרשים יעד שהוגדר.
תגים:affects_outputs
- ברירת מחדל של
--starlark:expr=<a string>
: "" -
ביטוי Starlark לעיצוב של כל יעד שמוגדר במצב cquery's --pla=starlark. היעד שהוגדר מוגבל ל-'target' אם לא צוין --starlar:expr or --starlark:file, האפשרות הזו תוגדר כברירת מחדל ל-'str(target.label)' אירעה שגיאה לציון גם -starstark:expr וגם --starlark:file.
תגים:terminal_output
- ברירת מחדל של
--starlark:file=<a string>
: "" -
שם של קובץ שמגדיר פונקציית Starlark שנקראת 'format', מתוך ארגומנט אחד, שחל על כל יעד מוגדר כדי לעצב אותו כמחרוזת. אירעה שגיאה לציון גם -starstark:expr וגם --starlark:file. לקבלת עזרה נוספת --
תגים:terminal_output
- ברירת מחדל של
--[no]tool_deps
: "true" -
שאילתה: אם היא מושבתת, יחסי תלות ב-'מארח הגדרה' או 'execution' יעדים לא ייכללו בתרשים התלות שעליו פועלת השאילתה. קצה 'הגדרת תצורה למארחים' כזה מהכלל של #&39;proto_library' מפנה בדרך כלל למהדר הפרוטוקול, בדרך כלל מצביע על כלי שהופעל במהלך ה-build במקום על חלק מאותה תוכנית 'target'
שאילתה: אם היא מושבתת, היא מסננת את כל היעדים שהוגדרו שחוצים מעבר של מארח או ביצוע, מהיעד שהוגדר ברמה העליונה שגילו את היעד שהוגדר. כלומר, אם היעד ברמה העליונה נמצא בתצורת היעד, יוחזרו רק יעדים שהוגדרו בתצורת היעד. אם היעד ברמה העליונה נמצא בתצורת המארח, יוחזרו רק יעדים שהוגדרו על ידי המארח. אפשרות זו לא תכלול שרשראות כלים שנפתרו.
תגים:build_file_semantics
- ברירת מחדל של
--transitions=<full, lite or none>
: "none" -
הפורמט שבו השאילתה תדפיס את פרטי המעבר.
תגים:affects_outputs
- ברירת מחדל של
--universe_scope=<comma-separated list of options>
: "" -
קבוצה של דפוסי יעד (מופרדים באמצעות פסיקים) המופרדים בפסיקים. השאילתה עשויה להתבצע ביקום שהוגדר על ידי הסגירה העקיפה של היעדים שצוינו. האפשרות הזו משמשת לפקודות השאילתה ושאילתת השאילתה.
עבור השאילתה, הקלט לאפשרות הזו הוא היעדים שבנו כל התשובות, ולכן האפשרות הזו עשויה להשפיע על התצורות והמעברים. אם אפשרות זו אינה מוגדרת, ההנחה היא שהיעדים ברמה העליונה הם היעדים המנותחים מביטוי השאילתה. הערה לגבי שאילתה: אם לא מציינים את האפשרות הזו, ייתכן שה-build לא יפעל אם לא ניתן ליצור יעדים מביטוי השאילתה עם האפשרויות ברמה העליונה.
תגים:loading_and_analysis
- אפשרויות שגורמות לאופטימיזציה של זמן ה-build:
- ברירת מחדל של
--[no]collapse_duplicate_defines
: "false" -
כשהאפשרות מופעלת, ההגדרות המיותרות יוסרו בשלב מוקדם. כדי למנוע אובדן מיותר של מטמון הניתוח לסוגים מסוימים של גרסאות build מקבילות.
תגים:loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]experimental_filter_library_jar_with_program_jar
: "false" -
יש לסנן את ProGuard ProgramJar כדי להסיר את כל הכיתות שנמצאות גם ב-LibraryJar.
תגים:action_command_lines
- ברירת מחדל של
--[no]experimental_inmemory_dotd_files
: "true" -
כשהאפשרות מופעלת, קובצי C++ .d יועברו בזיכרון ישירות מצומתי ה-build המרוחק במקום להיכתב לדיסק.
תגים:loading_and_analysis
,execution
,affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_inmemory_jdeps_files
: "true" -
אם האפשרות מופעלת, קובצי התלויות (.jdeps) שנוצרו מהאוספים של Java יועברו בזיכרון ישירות מצומתי ה-build המרוחק במקום להיכתב לדיסק.
תגים:loading_and_analysis
,execution
,affects_outputs
,experimental
- ברירת מחדל של
--[no]experimental_objc_include_scanning
: "false" -
האם לבצע סריקה עבור אובייקט C/C+ אובייקטיבי.
תגים:loading_and_analysis
,execution
,changes_inputs
- ברירת מחדל של
--[no]experimental_parse_headers_skipped_if_corresponding_srcs_found
: "false" -
אם התכונה parse_headers מופעלת, אם לא קיים מקור באותו שם יעד, היא לא יוצרת פעולת רינדור נפרדת של כותרת.
תגים:loading_and_analysis
,affects_outputs
- ברירת מחדל של
--[no]experimental_retain_test_configuration_across_testonly
: "false" -
כשהאפשרות מופעלת, --trim_test_Configuration לא יקטע את תצורת הבדיקה של כללים שסומנו לבדיקה בלבד=1. כך אנחנו מצמצמים את הבעיות של התנגשות בין פעולות כאשר כללים שאינם בדיקות תלויים בכללים של cc_test. אין השפעה אם --trim_test_ Configuration היא FALSE.
תגים:loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]experimental_starlark_cc_import
: "false" -
אם ההגדרה מופעלת, אפשר להשתמש בגרסת Starlark של cc_import.
תגים:loading_and_analysis
,experimental
- ברירת מחדל של
--[no]experimental_unsupported_and_brittle_include_scanning
: "false" -
כדי לצמצם את קלט הקלט לאוסף C/C++ , יש לנתח #include שורות מקובצי קלט. כך אפשר לשפר את הביצועים ואת הצבירה על ידי הקטנת הגודל של עצי ההזנה של האוסף. עם זאת, היא עלולה לשבור גרסאות build כי הסורק של כלי העריכה לא מטמיע באופן מלא את הסמנטיקה של מעבד המידע (CPU) לפני העיבוד. באופן ספציפי, הוא לא מבין הוראות #include דינמיות ומתעלם מלוגיקה מותנית של עיבוד מראש. השימוש הוא באחריותך בלבד. כל בעיה הנוגעת לסימון זה ייסגר.
תגים:loading_and_analysis
,execution
,changes_inputs
- ברירת מחדל של
--[no]incremental_dexing
: "true" -
רוב העבודה על דקס נפתחת בנפרד בכל קובץ ב-Jar.
תגים:affects_outputs
,loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]objc_use_dotd_pruning
: "true" -
אם המדיניות מוגדרת, קובצי .d שנוצרו על ידי ה-Clang ישמשו לגיזום קבוצת הקלט הנכנסת מהדרים objc.
תגים:changes_inputs
,loading_and_analysis
- ברירת מחדל של
--[no]process_headers_in_dependencies
: "false" -
כשיוצרים יעד //a:a, צריך לעבד כותרות בכל היעדים ש //a:a תלויים בהם (אם עיבוד הכותרת מופעל עבור Toolchain).
תגים:execution
- ברירת מחדל של
--[no]trim_test_configuration
: "true" -
כשהאפשרות מופעלת, האפשרויות שקשורות לבדיקה יימחקו מתחת לרמה העליונה של ה-build. כשהסימון הזה פעיל, לא ניתן ליצור בדיקות כתלויות של כללים שאינם בדיקות, אבל שינויים באפשרויות הקשורות לבדיקה לא יגרמו לניתוח מחדש של כללים שאינם בדיקות.
תגים:loading_and_analysis
,loses_incremental_state
- ברירת מחדל של
--[no]use_singlejar_apkbuilder
: "true" -
האפשרות הזו הוצאה משימוש. לא חייבים להשתמש בה והיא תוסר בקרוב.
תגים:loading_and_analysis
- אפשרויות שמשפיעות על המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--toolchain_resolution_debug=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: "-.*" -
הדפסת מידע על תוצאות ניפוי באגים במהלך רזולוציה של הכלי. בסימון נעשה שימוש בביטוי רגולרי, שנבדק ביחס לסוגי כלי עבודה ויעדים ספציפיים, כדי לראות באיזה ניפוי באגים. אפשר להפריד בין ביטויים רגולריים באמצעות ביטויים רגולריים, ולאחר מכן כל ביטוי רגולרי מסומן בנפרד. הערה: הפלט של הדגל הזה מורכב מאוד וככל הנראה יועיל רק למומחים בפתרון בעיות בכלי.
תגים:terminal_output
- אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
- נצברו
--flag_alias=<a 'name=value' flag alias>
שימושים מרובים -
מגדירים שם מקוצר לסימון Starlark. הוא צריך להזין צמד יחיד של מפתח-ערך בפורמט "<key>=<value>" כארגומנט.
תגים:changes_inputs
- ברירת מחדל של
--[no]incompatible_default_to_explicit_init_py
: "false" -
סימון זה משנה את התנהגות ברירת המחדל כך שקובצי __init__.py כבר לא נוצרים באופן אוטומטי בקבצים פועלים של יעדים ב-Python. באופן מדויק, אם יעד py_binary או py_test מוגדר מדור קודם, play_create_init מוגדר ל-"auto" (ברירת המחדל), הוא נחשב כ-false אם רק הסימון הזה מוגדר. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/10076.
תגים:affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_py2_outputs_are_suffixed
: "true" -
אם הדבר נכון, יעדים שנוצרו בתצורת Python 2 יופיעו בתוך שורש פלט שכולל את הסיומת ' -py2' בעוד שיעדים שנוצרו עבור Python 3 יופיעו בשורש ללא סיומת הקשורה ל-Python. כלומר, סימולציית הנוחות 'bazel-bin' תצביע על יעדים ב-Python 3 ולא על Python 2. אם האפשרות הזו מופעלת, מומלץ להפעיל גם את `--incompatible_py3_is_default`.
תגים:affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_py3_is_default
: "true" -
אם הערך הוא TRUE, היעדים 'py_binary' ו-'py_test' שלא מגדירים את המאפיינים 'python_version' (או 'default_python_version') יוגדרו כברירת מחדל ל-PY3 במקום ל-PY2. אם הדגל הזה מוגדר, מומלץ גם להגדיר את `--incompatible_py2_פלטs_are_suffixed`.
תגים:loading_and_analysis
,affects_outputs
,incompatible_change
- ברירת מחדל של
--[no]incompatible_use_python_toolchains
: "true" -
אם המדיניות מוגדרת כ-True, כללי ההפעלה של Python יפעלו לפי זמן הריצה של Python שצוין על ידי כלי הכלים של Python, ולא לפי זמן הריצה שנקבע על ידי דגלים מדור קודם כמו --python_top.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--python_version=<PY2 or PY3>
: תיאור -
מצב הגרסה הראשית של Python, 'PY2' או 'PY3'. חשוב לשים לב שמצב זה מבטל את היעדים 'py_binary' ו-'py_test' (גם אם הם לא מציינים במפורש גרסה), כך שאין בדרך כלל סיבה לספק את הדגל הזה.
תגים:loading_and_analysis
,affects_outputs
,explicit_in_output_path
- אפשרויות שונות, ללא סיווג אחר.
--[no]cache_test_results
[-t
] ברירת מחדל: "auto"- אם מוגדר כ-'auto', Bazel מריץ בדיקה מחדש אם ורק: (1) בזל מזהה שינויים בבדיקה או בתלויות שלה, (2) הבדיקה מסומנת כחיצונית, (3) התבקשו מספר ריצות בדיקה עם -runs_per_test או(4) הבדיקה נכשלה בעבר. אם הכתובת היא 'yes' , Bazel שומרת במטמון את כל תוצאות הבדיקה, מלבד בדיקות שסומנו כחיצוניות. אם הכתובת היא 'no', Bazel לא שומרת תוצאות בדיקה.
- ברירת מחדל של
--[no]experimental_cancel_concurrent_tests
: "false" -
True האפשרות הזו שימושית רק בשילוב עם --runs_per_test_detects_flakes.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_fetch_all_coverage_outputs
: "false" -
אם הערך הוא True, מערכת Bazel מאחזרת את כל ספריית נתוני הכיסוי עבור כל בדיקה במהלך תקופת כיסוי.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_generate_llvm_lcov
: "false" -
אם זה יהיה נכון, כיסוי לגבי קלנג ייצור דוח LCOV.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--[no]experimental_j2objc_header_map
: "true" - האם ליצור מפת כותרת של J2ObjC במקביל לתעתוק J2ObjC?
- ברירת מחדל של
--[no]experimental_j2objc_shorter_header_path
: "false" -
אם צריך ליצור עם נתיב כותרת קצר יותר (משתמשים ב-"_ios" במקום "_j2objc").
תגים:affects_outputs
--experimental_java_classpath=<off, javabuilder or bazel>
כברירת מחדל: "Javabuilder"- הפעלת ערכי נתיב מופחתים לאוספים של Java.
- ברירת מחדל של
--[no]experimental_limit_android_lint_to_android_constrained_java
: "false" -
מגבילים --experimental_run_android_lint_on_Java_rules לספריות תואמות ל-Android.
תגים:affects_outputs
- ברירת מחדל של
--[no]experimental_run_android_lint_on_java_rules
: "false" -
האם לאמת את מקורות Java_*?
תגים:affects_outputs
- ברירת מחדל של
--[no]explicit_java_test_deps
: "false" - יש לציין באופן מפורש את התלות ב-JUnit או Hacrest ב-Java_test במקום לקבל בטעות נקודות דירוג מ-TestRunner'. בשלב זה מתאים לשימוש ב-Bazall.
- ברירת מחדל של
--host_java_launcher=<a build target label>
: תיאור - מרכז האפליקציות של Java שמשמש את הכלים להפעלה במהלך build.
- נצברו
--host_javacopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-Java בעת יצירת כלים המופעלים במהלך build.
- נצברו
--host_jvmopt=<a string>
שימושים מרובים - אפשרויות נוספות למעבר ל-Java VM במהלך בניית כלים שמופעלים במהלך ה-build. האפשרויות האלה יתווספו לאפשרויות ההפעלה של VM בכל יעד Java_binary.
- ברירת מחדל של
--[no]incompatible_exclusive_test_sandboxed
: "false" -
אם הערך הוא נכון, יופעלו בדיקות בלעדיות עם שיטת בידינג בארגז חול. מוסיפים תג 'local' כדי לאלץ הרצת בדיקה בלעדית באופן מקומי
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_strict_action_env
: "false" -
אם הערך true, Bazel משתמשת בסביבה עם ערך סטטי של Path ולא יורשת את LD_LIBRARI_Path. משתמשים בפונקציה --action_env=ENV_VARIABLE אם רוצים לרשת בירושה משתני סביבה ספציפיים מהלקוח, אך חשוב לזכור שפעולה זו יכולה למנוע שמירה במטמון של משתמשים שונים אם נעשה שימוש במטמון משותף.
תגים:loading_and_analysis
,incompatible_change
- נצברו
--j2objc_translation_flags=<comma-separated list of options>
שימושים מרובים - אפשרויות נוספות למעבר לכלי J2ObjC.
--java_debug
-
המכונה הווירטואלית של Java בבדיקת Java ממתינה לחיבור לכלי ניפוי באגים התואם ל-JDWP (כגון jdb) לפני התחלת הבדיקה. משתמע -test_פלט=שידור.
הרחבה אל:
--test_arg=--wrapper_script_flag=--debug
--test_output=streamed
--test_strategy=exclusive
--test_timeout=9999
--nocache_test_results
- ברירת מחדל של
--[no]java_deps
: "true" - יצירת פרטי תלות (כרגע, סוג ה-path של זמן הביצוע) לכל יעד Java.
- ברירת מחדל של
--[no]java_header_compilation
: "true" - להיעזר באיג'רים ישירות מהמקור.
- ברירת מחדל של
--java_language_version=<a string>
: "8" - גרסת השפה ב-Java
- ברירת מחדל של
--java_launcher=<a build target label>
: תיאור - מרכז האפליקציות של Java לשימוש כשיוצרים קבצים בינאריים של Java. אם הדגל הזה מוגדר כמחרוזת ריקה, המערכת תשתמש במפעיל JDK. המאפיין "מרכז האפליקציות" מבטל את הסימון הזה.
- ברירת מחדל של
--java_runtime_version=<a string>
: "local_jdk" - גרסת זמן הריצה של Java
- נצברו
--javacopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-Java.
- נצברו
--jvmopt=<a string>
שימושים מרובים - אפשרויות נוספות להעברה ל-Java VM. האפשרויות האלה יתווספו לאפשרויות ההפעלה של VM בכל יעד Java_binary.
- ברירת מחדל של
--legacy_main_dex_list_generator=<a build target label>
: תיאור - קביעת הקובץ הבינארי שבו יש להשתמש כדי ליצור את רשימת הכיתות שחייבות להיות בשרת ה-proxy הראשי במהלך הידור ה-Multiplexex הקודם.
- נצברו
--plugin=<a build target label>
שימושים מרובים - יישומי פלאגין לשימוש ב-build. פועלים כרגע עם Java_plugins.
- ברירת מחדל של
--proguard_top=<a build target label>
: תיאור - ההגדרה של ProGuard היא הגרסה שבה יש להסיר קוד בינארי של Java.
--proto_compiler=<a build target label>
ברירת מחדל: "@bazel_tools//tools/proto:protoc"-
התווית של המהדר לאבות.
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_cc=<a build target label>
: "@bazel_tools//tools/proto:cc_toolchain" -
תווית של Proto_lang_toolchain() שמתארת איך להדר Cto++ Proto
תגים:
affects_outputs
,loading_and_analysis
--proto_toolchain_for_j2objc=<a build target label>
ברירת מחדל: "@bazel_tools//tools/j2objc:j2objc_proto_toolchain"-
תווית של proto_lang_toolchain() שמתארת איך להדר j2objc Protos
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_java=<a build target label>
: "@bazel_tools//tools/proto:Java_toolchain" -
תווית של proto_lang_toolchain() שמתארת איך להדר פרוטאורה של Java
תגים:affects_outputs
,loading_and_analysis
- ברירת מחדל של
--proto_toolchain_for_javalite=<a build target label>
: "@bazel_tools//tools/proto:Javalite_toolchain" -
תווית Proto_lang_toolchain() שמתארת איך להדר פרוטומות של JavaLite
תגים:affects_outputs
,loading_and_analysis
- נצברו
--protocopt=<a string>
שימושים מרובים -
אפשרויות נוספות להעברה אל מהדר הפרוטוקול.
תגים:affects_outputs
- ברירת מחדל של
--[no]runs_per_test_detects_flakes
: "false" - אם הערך מקבל את הערך True, כל פיצול שבו עובר ניסיון ריצה/ניסיון אחד לפחות ולפחות ניסיון ריצה אחד/ניסיון אחד נכשל, מקבל את הסטטוס FLAKY.
- ברירת מחדל של
--shell_executable=<a path>
: תיאור -
נתיב מוחלט להפעלה של קונכיות לשימוש בבזל. אם האפשרות הזו לא מוגדרת, המשתנה של סביבת BAZEL_SH מוגדר בהפעלה הראשונה של Bazel (שמפעילה שרת Bazel), ה-Bazel משתמש באפשרות הזו. אם אף אחד מהם לא מוגדר, Bazel משתמשת בנתיב ברירת מחדל בתוך הקוד בהתאם למערכת ההפעלה שבה היא פועלת (Windows: c:/tools/msys64/usr/bin/bash.exe, FreeBSD: /usr/local/bin/bash, כל השאר: /bin/bash). שימו לב שהשימוש במעטפת שלא תואם ל-Bash עלול לגרום לכשל בבנייה או לכשלים בזמן ריצה של הקבצים הבינאריים שנוצרו.
תגים:loading_and_analysis
- נצברו
--test_arg=<a string>
שימושים מרובים - קביעת אפשרויות וארגומנטים נוספים שצריך להעביר לקובץ ההפעלה של הבדיקה. ניתן להשתמש מספר פעמים כדי לציין כמה ארגומנטים. אם יבוצעו כמה בדיקות, כל אחת מהן תקבל ארגומנטים זהים. בשימוש רק באמצעות הפקודה 'bazel' .
- ברירת מחדל של
--test_filter=<a string>
: תיאור - קביעת מסנן להעברת למסגרת הבדיקה. משמש להגבלת הבדיקות. לתשומת ליבכם: אין לכך השפעה על היעדים המובנים.
- ברירת מחדל של
--test_result_expiration=<an integer>
: "-1" - האפשרות הזו הוצאה משימוש ואין לה השפעה.
- ברירת מחדל של
--[no]test_runner_fail_fast
: "false" - אם ההרצה לא תתבצע מהר, אפשר יהיה להריץ אותה. הרצת הבדיקה צריכה להפסיק את הביצוע אחרי הכשל הראשון.
- ברירת מחדל של
--test_sharding_strategy=<explicit or disabled>
: "explicit" - יש לציין את השיטה לפיצול הבדיקה: 'explicit' כדי להשתמש בפיצול רק אם קיים המאפיין 'shard_count' 'disabled' לעולם לא להשתמש בפיצול בדיקה.
- ברירת מחדל של
--tool_java_language_version=<a string>
: "8" - גרסת השפה של Java המשמשת לביצוע הכלים הנחוצים במהלך גרסת ה-build
- ברירת מחדל של
--tool_java_runtime_version=<a string>
: "remotejdk_11" - גרסת זמן הריצה של Java המשמשת לביצוע כלים במהלך ה-build
- ברירת מחדל של
--[no]use_ijars
: "true" - כשהאפשרות הזו מופעלת, הידור ה-Java משתמש בקונטיינרים של ממשק. כתוצאה מכך, האוסף המצטבר יהיה מהיר יותר, אבל הודעות השגיאה עשויות להיות שונות.
אפשרויות Dump
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בפלט של הפקודה:
- ברירת מחדל של
--[no]action_cache
: "false" -
תגים:bazel_monitoring
- ברירת מחדל של
--[no]packages
: "false" -
שלילה של תוכן מטמון החבילה.
תגים:bazel_monitoring
- ברירת מחדל של
--[no]rule_classes
: "false" -
מחלקת מחלקות כללים.
תגים:bazel_monitoring
- ברירת מחדל של
--[no]rules
: "false" -
להשליך כללים, כולל ספירה ושימוש בזיכרון (אם מתבצע מעקב אחר הזיכרון).
תגים:bazel_monitoring
- ברירת מחדל של
--skyframe=<off, summary, count, deps or rdeps>
: "off" -
תגים:bazel_monitoring
- ברירת מחדל של
--skykey_filter=<a comma-separated list of regex expressions with prefix '-' specifying excluded paths>
: ".*" -
מסנן Regex של שמות SkyKey לפלט. בשימוש רק עם --skyframe=deps, epps.
תגים:bazel_monitoring
- ברירת מחדל של
--skylark_memory=<a string>
: תיאור -
נתיב Dump של הזיכרון תואם לפרופיל שצוין. מידע נוסף זמין בכתובת https://github.com/google/pprof.
תגים:bazel_monitoring
- אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות אחזור
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בהפעלה של גרסת build:
- ברירת מחדל של
--[no]incompatible_remote_dangling_symlinks
: "true" -
אם המדיניות מוגדרת כ-True ו- --incompatible_remote_symlinks הוא גם נכון, קישורים מסולסלים בפלטי פעולה מורשים להתנתק.
תגים:execution
,incompatible_change
- ברירת מחדל של
--[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", "HOST_CPUS", "HOST_RAM"), ובדרך כלל מוסיפים פעולה ([-|*]<float>) למשל. "auto", "HOST_CPUS*.5". "auto" מגדיר ברירת מחדל סבירה על סמך משאבים למארחים. הערך חייב להיות לפחות 1.
תגים:bazel_internal_configuration
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לקיומו:
- ברירת מחדל של
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
המספר המקסימלי של קבצים פתוחים מותר במהלך העלאת תוכן של BEP.
תגים:affects_outputs
--remote_download_minimal
-
לא תתבצע הורדה של פלטי build מרוחקים אל המכונה המקומית. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=minimal.
הרחבה אל:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=minimal
תגים:affects_outputs
- ברירת מחדל של
--remote_download_outputs=<all, minimal or toplevel>
: "all" -
אם המדיניות מוגדרת כ-'minimal' לא מורידה פלט של build מרחוק אל המכונה המקומית, חוץ מאלה הנדרשות על ידי פעולות מקומיות. אם המדיניות מוגדרת כ-'toplevel' היא פועלת כך'minimal' מלבד זאת, מתבצעת הורדה של פלט של יעדים ברמה העליונה למחשב המקומי. שתי האפשרויות יכולות לקצר משמעותית את זמני הבנייה אם רוחב הפס של הרשת הוא צוואר בקבוק.
תגים:affects_outputs
- ברירת מחדל של
--remote_download_symlink_template=<a string>
: "" -
במקום להוריד פלט של build מרחוק, אפשר ליצור קישורים סימבוליים. ניתן לציין את יעד הקישורים המסמלים בצורת מחרוזת תבנית. מחרוזת התבנית הזו עשויה להכיל {hash} ו-{size_bytes} שמתרחבים לאובייקט ולגודל בבייטים, בהתאמה. הקישורים הסמליים האלה עשויים, למשל, להפנות למערכת קבצים של FUSE שטוענת אובייקטים מ-CAS לפי דרישה.
תגים:affects_outputs
--remote_download_toplevel
-
רק מכונה מקומית יכולה להוריד פלט מרחוק של יעדים ברמה העליונה. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=toplevel.
מתרחבת אל:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel
תגים:affects_outputs
- אפשרויות שמשפיעות על רמת האכיפה התקינה של Bazel על קלט קלט (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- ברירת מחדל של
--[no]incompatible_config_setting_private_default_visibility
: "false" -
אם לא תואם_enforce_config_setting_visible=false, זו שגיאה. אחרת, אם הסימון הזה הוא false, כל הגדרת config_ללא מאפיין חשיפה בוטה היא //visible:public. אם הסימון הזה נכון, המאפיין config_setting תואם ללוגיקה של הרשאות הגישה שדומה לכל הכללים האחרים. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12933.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enforce_config_setting_visibility
: "true" -
אם המדיניות מוגדרת כ-True, יש לאכוף את הרשאות הגישה מסוג config_setting. אם הערך הוא False, כל config_setting גלויה לכל יעד. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים:loading_and_analysis
,incompatible_change
- אפשרויות שקשורות לפלט Bzlmod וסמנטיקה:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- ברירת מחדל של
--experimental_repository_resolved_file=<a string>
: "" -
אם לא ריק, כותבים ערך של Starlark עם הפרטים שנפתרו לגבי כל כללי המאגר של Starlark שבוצעו.
תגים:affects_outputs
- ברירת מחדל של
--remote_print_execution_messages=<failure, success or all>
: "failure" -
אתם יכולים לבחור מתי תרצו להדפיס הודעות של ביצוע מרחוק. הערכים התקינים הם 'כשל', כדי להדפיס רק כשלים, 'הצלחה' כדי להדפיס רק את ההצלחות, ו'הכול' כדי להדפיס תמיד.
תגים:terminal_output
- אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- ברירת מחדל של
--[no]experimental_guard_against_concurrent_changes
: "false" - כדי להשבית את הבדיקה של קובצי קלט עבור פעולה מסוימת לפני שמעלים אותה למטמון מרוחק, יש להשבית את הזמן. ייתכנו מקרים שבהם הליבה של Linux מעכבת כתיבה של קבצים, מה שעלול לגרום לתוצאות חיוביות שקריות.
- ברירת מחדל של
--experimental_remote_build_event_upload=<all or minimal>
: "all" - אם המדיניות מוגדרת כ-'all' כל הפלט המקומי שאליו מפנה BEP מועלה למטמון מרוחק. אם המדיניות מוגדרת כ-'minimal' פלטים מקומיים ש-BEP מפנה אליהם לא מועלים למטמון המרוחק, מלבד קבצים שחשובים לצרכנים של BEP (למשל יומני בדיקה ופרופיל תזמון). סכימת //:file משמשת לנתיבים של קבצים מקומיים וסכימת בייטstream:// משמשת לנתיבים של קבצים שהועלו (כבר). ברירת המחדל היא 'all'.
- ברירת מחדל של
--[no]experimental_remote_cache_async
: "false" - אם הערך הוא TRUE, מטמון I/O מרוחק יתרחש ברקע במקום להיווצר כחלק מ-S מדויקת.
- ברירת מחדל של
--[no]experimental_remote_cache_compression
: "false" - אם האפשרות מופעלת, אפשר לדחוס או לפרוס בועות של מטמון עם zstd.
- ברירת מחדל של
--experimental_remote_capture_corrupted_outputs=<a path>
: תיאור - נתיב לספרייה שבה יילכו פלטים פגומים.
- ברירת מחדל של
--experimental_remote_downloader=<a string>
: תיאור - URI של נקודת קצה ל-API של נכס מרוחק, שישמש כשרת proxy להורדה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. בכתובת: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- ברירת מחדל של
--[no]experimental_remote_downloader_local_fallback
: "false" - אם אתם רוצים לחזור לכלי ההורדה המקומי, אם ההורדה מרחוק נכשלה.
- ברירת מחדל של
--[no]experimental_remote_execution_keepalive
: "false" - האם להשתמש ב-Keepalive בשיחות ביצוע מרחוק?
- ברירת מחדל של
--experimental_remote_grpc_log=<a path>
: תיאור - אם צוין, נתיב לקובץ שבו יתבצע רישום של פרטים הקשורים לשיחת gRPC. היומן הזה מורכב מרצף של com.google.devtools.build.lib.remote.logging.remoteExecutionLog.LogEntry Protobufs עם כל הודעה המסומנת ב-varint המציין את גודל ההודעה הבאה עם פסיק.
- ברירת מחדל של
--[no]experimental_remote_mark_tool_inputs
: "false" - אם היא מוגדרת כ-True, ה-Bazel יסמן את הקלט בתור קלט לכלי הפעולה מרחוק. אפשר להשתמש באפשרות הזאת כדי להטמיע עובדים קבועים מרחוק.
- ברירת מחדל של
--[no]experimental_remote_merkle_tree_cache
: "false" - אם המדיניות מוגדרת כ-True, החישובים של עץ ה-Merkle יסונכרנו כדי לשפר את מהירות הבדיקה של ההיט המרוחק. ביצועי טביעת הרגל בזיכרון של המטמון נקבעים על ידי -experimental_remote_merkle_tree_cache_size.
- ברירת מחדל של
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - מספר עצי ה-Merkle שיש לזכור כדי לשפר את מהירות הבדיקה של ההיט המרוחק. אף על פי שהמטמון נחתך באופן אוטומטי בהתאם לטיפול בהפניות רכות של Java', יכול להיות ששגיאות "חסרות זיכרון" עלולות להיווצר אם הן גבוהות מדי. אם המדיניות מוגדרת כ-0, גודל המטמון הוא בלתי מוגבל. הערך האופטימלי משתנה בהתאם לגודל הפרויקט. ערך ברירת המחדל הוא 1,000.
- ברירת מחדל של
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - אם המדיניות מוגדרת כ-True, פלטים שאליהם מפנה BEP לא יועלו למטמון מרוחק אם לא ניתן יהיה לשמור במטמון את פעולת היצירה מרחוק.
- ברירת מחדל של
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
האם לשלוח את כל הערכים של כותרת רבת-ערך להורדה מרחוק ולא רק הראשונה.
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
אם המדיניות מוגדרת כ-True, נתיבי הפלט הם יחסיים לשורש הקלט במקום לספרייה הפעילה.
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_remote_results_ignore_disk
: "true" -
אם המדיניות מוגדרת כ-True, --noremote_upload_local_results ו--noremote_Accept_cached לא יחולו על מטמון הדיסק. אם נעשה שימוש במטמון משולב:
--noremote_upload_local_results יגרום לכתיבה של תוצאות במטמון הדיסק, אבל לא להעלאה למטמון המרוחק.
--noremote_confirm_cached יוביל לבדיקה של Bazel בתוצאות החיפוש במטמון הדיסק, אבל לא במטמון המרוחק.
פעולות ללא הפעלה מרחוק יכולות לפגוע במטמון הדיסק.
פרטים נוספים זמינים בדף #8216.
תגים:incompatible_change
- ברירת מחדל של
--[no]remote_accept_cached
: "true" - האם לקבל תוצאות של פעולות שנשמרו במטמון מרחוק?
- ברירת מחדל של
--remote_bytestream_uri_prefix=<a string>
: תיאור - שם המארח ושם המופע לשימוש ב-URI של בייט-בייט שכתובים במקורות נתונים של אירועים. אפשר להגדיר את האפשרות הזו כשמבצעים גרסאות build באמצעות שרת proxy. כתוצאה מכך, הערכים של -remote_executor ו--remote_instance_name לא תואמים יותר לשם הקנוני של שירות הביצוע מרחוק. אם היא לא מוגדרת, ברירת המחדל היא "${hostname}/${instance_name}".
- ברירת מחדל של
--remote_cache=<a string>
: תיאור - URI של נקודת קצה לשמירה במטמון. הסכימות הנתמכות הן http, https, grpc, grpcs (grpc עם TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. מציינים grpc://, http:// או Unix: כדי להשבית TLS. כדאי לעיין בכתובת https://bazel.build/remote/caching
- נצברו
--remote_cache_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות שנשמרו במטמון: --remote_cache_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- נצברו
--remote_default_exec_properties=<a 'name=value' assignment>
שימושים מרובים -
מגדירים את מאפייני ברירת המחדל של exe שישמשו כפלטפורמת הביצוע מרחוק, אם פלטפורמת ביצוע עדיין לא הגדירה exec_properties.
תגים:affects_outputs
- ברירת מחדל של
--remote_default_platform_properties=<a string>
: "" - מגדירים את מאפייני הפלטפורמה שמוגדרים כברירת מחדל ל-API לביצוע מרחוק, אם פלטפורמת הביצוע לא מוגדרת עדיין Remote_execution_property. המערכת תשתמש בערך הזה גם אם פלטפורמת המארח נבחרה כפלטפורמת ההפעלה לביצוע מרחוק.
- נצברו
--remote_downloader_header=<a 'name=value' assignment>
שימושים מרובים - יש לקבוע כותרת שתיכלל בבקשות להורדה מרחוק: --remote_downloader_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- נצברו
--remote_exec_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות ביצוע: --remote_exec_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- ברירת מחדל של
--remote_execution_priority=<an integer>
: "0" - העדיפות היחסית של הפעולות שיש לבצע מרחוק. הסמנטיקה של ערכי העדיפות הספציפית היא תלויה בשרת.
- ברירת מחדל של
--remote_executor=<a string>
: תיאור - מארח או מתארח:יציאה של נקודת קצה להפעלה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. צריך לציין grpc:// או Unix: כדי להשבית TLS.
- נצברו
--remote_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות: --remote_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- ברירת מחדל של
--remote_instance_name=<a string>
: "" - הערך שמועבר כ-Instance_name ב-API לביצוע מרחוק.
- ברירת מחדל של
--[no]remote_local_fallback
: "false" - האם לחזור לשיטה עצמאית של הפעלה מקומית אם ביצוע ההעברה מרחוק נכשל?
- ברירת מחדל של
--remote_local_fallback_strategy=<a string>
: "local" - לא, הוצא משימוש. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/7480.
- ברירת מחדל של
--remote_max_connections=<an integer>
: "100" -
הגבלת המספר המקסימלי של חיבורים בו-זמנית למטמון/קובץ הפעלה מרחוק. כברירת מחדל, הערך הוא 100. אם מגדירים את הערך כ-0, אין הגבלה.
עבור מטמון של HTTP מרחוק, חיבור TCP אחד יכול לטפל בבקשה אחת בכל פעם, כך ש-Bazel יכול לבצע בקשות בו-זמנית עד ל-remote_max_connections.
ב-gRPC מרוחק, יכול להיות שערוץ אחד בשם gRPC יוכל לטפל ביותר מ-100 בקשות בו-זמנית. לכן, Bazel יכולה לשלוח בקשות '--remote_max_connections * 100' בו-זמנית.
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--remote_proxy=<a string>
: תיאור - מתחברים למטמון המרוחק דרך שרת proxy. כרגע אפשר להשתמש בסימון הזה רק כדי להגדיר שקע דומיין (Unix:/path/to/socket) ב-Unix:
- ברירת מחדל של
--remote_result_cache_priority=<an integer>
: "0" - העדיפות היחסית של פעולות מרוחקות שנשמרו במטמון מרוחק. הסמנטיקה של ערכי העדיפות הספציפית היא תלויה בשרת.
- ברירת מחדל של
--remote_retries=<an integer>
: "5" - מספר הניסיונות המקסימלי לנסות שוב שגיאה זמנית. אם המדיניות מוגדרת כ-0, ניסיונות חוזרים מושבתים.
- ברירת מחדל של
--remote_timeout=<An immutable length of time.>
: "60s" - משך הזמן המרבי להמתנה לביצוע מרחוק ולשיחות במטמון. למטמון REST, זהו גם החיבור וגם הזמן הקצוב לתפוגה של קריאה. אפשר להשתמש ביחידות הבאות: ימים (d), שעות (h), דקות (m), שניות (s) ואלפיות שנייה (אלפיות השנייה). אם משמיטים את היחידה, הערך מפורש כשניות.
- ברירת מחדל של
--[no]remote_upload_local_results
: "true" - האם להעלות למטמון המרוחק תוצאות של פעולות שבוצעו באופן מקומי?
- ברירת מחדל של
--[no]remote_verify_downloads
: "true" - אם היא מוגדרת כ-true, Bazel תחשב את סכום הגיבוב של כל ההורדות המרוחקות ותשליך את הערכים השמורים במטמון מרחוק אם הם לא תואמים לערך הצפוי.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- ברירת מחדל של
--deleted_packages=<comma-separated list of package names>
: "" - רשימה של שמות של חבילות, מופרדים בפסיקים, שמערכת ה-build תתייחס אליהם שאינם קיימים, גם אם הם מוצגים במקום כלשהו בנתיב החבילה. כדאי להשתמש באפשרות הזו כשמוחקים חבילת משנה 'x/y' של חבילה קיימת 'x' לדוגמה, לאחר מחיקת x/y/BUILD בלקוח, מערכת ה-build עשויה להתלונן אם היא תיתקל בתווית '//x:y/z' אם היא עדיין מסופקת על ידי ערך package_path אחר. ציון [delete_packs x/y] מונע את הבעיה הזו.
- ברירת מחדל של
--disk_cache=<a path>
: תיאור - נתיב לספרייה שבה Bazel יכולה לקרוא ולכתוב פעולות ופלטי פעולות. אם הספרייה לא קיימת, היא תיווצר.
- נצברו
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
שימושים מרובים - הגדרת עזרה לגבי פרטי כניסה לשימוש באחזור פרטי הכניסה של ההיקף (דומיין). פרטי כניסה מ-credentials Credentials מקבלים קדימות על פני פרטי כניסה מ-<code>--google_default_credentials</code>, `--google_credentials' או <code>.netrc</code>. אפשר לראות אותם בכתובת https://github.com/bazelbuild/proposs22sper-help-credential-credential-credential-credential-login-s
- ברירת מחדל של
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30m" - ההגדרה קובעת את משך הזמן שבו פרטי הכניסה ששמורים ב'פרטי כניסה' יישמרו במטמון.
- ברירת מחדל של
--experimental_credential_helper_timeout=<An immutable length of time.>
: "5s" - הגדרת הזמן הקצוב לתפוגה עבור 'פרטי הכניסה'. עוזרי הכניסה שלא יגיבו בזמן הקצוב לתפוגה ייכשלו.
- ברירת מחדל של
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - רשימה של היקפי אימות ב-Google Cloud, המופרדים באמצעות פסיקים.
- ברירת מחדל של
--google_credentials=<a string>
: תיאור - ההגדרה קובעת את הקובץ שממנו יתקבלו פרטי הכניסה לאימות. פרטים נוספים זמינים בכתובת https://cloud.google.com/docs/authentication.
- ברירת מחדל של
--[no]google_default_credentials
: "false" - אם צריך להשתמש ב 'פרטי הכניסה שמוגדרים כברירת מחדל באפליקציית Google' לאימות. פרטים נוספים זמינים בכתובת https://cloud.google.com/docs/authentication. מושבת כברירת מחדל.
- ברירת מחדל של
--grpc_keepalive_time=<An immutable length of time.>
: תיאור - הגדרת פינגים בשידור חי עבור חיבורי gRPC יוצאים. אם המדיניות הזו מוגדרת, Bazel שולחת פינגים אחרי פרק הזמן הזה ללא פעולות קריאה בחיבור, אבל רק אם יש לפחות קריאה אחת אחת מסוג gRPC בהמתנה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. פינגים בשידור חי מושבתים כברירת מחדל. עליך לתאם עם בעל השירות לפני הפעלת ההגדרה הזו. לדוגמה, כדי להגדיר ערך של 30 שניות לסימון הזה, צריך לעשות זאת כך: grpc_keepalive_time=30s
- ברירת מחדל של
--grpc_keepalive_timeout=<An immutable length of time.>
: "20s" - הגדרת זמן קצוב לתפוגה של שמירת נתונים פעילה עבור חיבורי gRPC יוצאים. אם פינגים מסוג keep-alive מופעלים באמצעות --grpc_keepalive_time, תם הזמן הקצוב (Bazel) של Bazel אם לא מתקבלת פינג אחרי פרק הזמן הזה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. אם פינגים פעילים נשארים מושבתים, המערכת מתעלמת מההגדרה הזו.
- נצברו
--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 להדפיס הודעות &&;טעינת חבילה:".
- ברירת מחדל של
--tls_certificate=<a string>
: תיאור - יש לציין נתיב לאישור TLS שהוא מהימן לחתימה על אישורי שרת.
- ברירת מחדל של
--tls_client_certificate=<a string>
: תיאור - ציון אישור הלקוח של TLS (אבטחת שכבת התעבורה) לשימוש. צריך גם לספק מפתח לקוח כדי להפעיל אימות לקוח.
- ברירת מחדל של
--tls_client_key=<a string>
: תיאור - צריך לציין את מפתח הלקוח ב-TLS שבו רוצים להשתמש. צריך גם לספק אישור לקוח כדי להפעיל את אימות הלקוח.
אפשרויות עזרה
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות שמשפיעות בצורה מדויקת על האופן שבו Bazel אוכפת קלטי build תקינים (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- ברירת מחדל של
--help_verbosity=<long, medium or short>
: "medium" -
בחירת דרגת המלל שמופיעה בפקודת העזרה.
תגים:affects_outputs
,terminal_output
- [
-l
]--long
-
יש להציג את התיאור המלא של כל אפשרות, במקום את השם שלה.
מתרחבת אל:
--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' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות מידע
העברה בירושה את כל האפשרויות מיצירה.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות שמשפיעות בצורה מדויקת על האופן שבו Bazel אוכפת קלטי build תקינים (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- ברירת מחדל של
--[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' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות רישיון
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות שמשפיעות בצורה מדויקת על האופן שבו Bazel אוכפת קלטי build תקינים (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות להתקנה בנייד
העברה בירושה את כל האפשרויות מיצירה.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בהפעלה של גרסת build:
- ברירת מחדל של
--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" -
האם להשתמש בקובצי פיצול מפוצלים כדי להתקין ולעדכן את האפליקציה במכשיר. פועלת רק במכשירים עם 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
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- ברירת מחדל של
--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' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות Modquery
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בהפעלה של גרסת build:
--[no]keep_going
[-k
] ברירת מחדל: "false"-
אפשר להמשיך כמה שיותר אחרי השגיאה. לא ניתן לנתח את היעד שנכשל או את היעד שתלוי בו, אבל יש דרישות מוקדמות נוספות ליעדים האלה.
תגים:eagerness_to_exit
- ברירת מחדל של
--loading_phase_threads=<an integer, or a keyword ("auto", "HOST_CPUS", "HOST_RAM"), optionally followed by an operation ([-|*]<float>) eg. "auto", "HOST_CPUS*.5">
: "auto" -
מספר השרשורים המקבילים שיש להשתמש בהם בשלב הטעינה/הניתוח.נלקחים מספר שלם, או מילת מפתח ("auto", "HOST_CPUS", "HOST_RAM"), ובדרך כלל מוסיפים פעולה ([-|*]<float>) למשל. "auto", "HOST_CPUS*.5". "auto" מגדיר ברירת מחדל סבירה על סמך משאבים למארחים. הערך חייב להיות לפחות 1.
תגים:bazel_internal_configuration
- אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- ברירת מחדל של
--[no]incompatible_config_setting_private_default_visibility
: "false" -
אם לא תואם_enforce_config_setting_visible=false, זו שגיאה. אחרת, אם הסימון הזה הוא false, כל הגדרת config_ללא מאפיין חשיפה בוטה היא //visible:public. אם הסימון הזה נכון, המאפיין config_setting תואם ללוגיקה של הרשאות הגישה שדומה לכל הכללים האחרים. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12933.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enforce_config_setting_visibility
: "true" -
אם המדיניות מוגדרת כ-True, יש לאכוף את הרשאות הגישה מסוג config_setting. אם הערך הוא False, כל config_setting גלויה לכל יעד. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים:loading_and_analysis
,incompatible_change
- אפשרויות שקשורות לפלט של מודולי שאילתה וסמנטיקה:
- ברירת מחדל של
--charset=<utf8 or ascii>
: "utf8" -
בחירת קבוצת התווים שתשמש לעץ. משפיעה רק על פלט טקסט. הערכים החוקיים הם "utf8" או "ascii". ברירת המחדל היא "utf8"
תגים:terminal_output
- ברירת מחדל של
--[no]cycles
: "false" -
אפשרות זו מצביעה על מחזורי תלות בתוך העץ המוצג. בדרך כלל, המערכת מתעלמת מהם כברירת מחדל.
תגים:execution
- ברירת מחדל של
--depth=<an integer>
: "-1" -
עומק התצוגה המקסימלי של עץ התלות. למשל, עומק 1 מציג את התלות הישירות. בשדה 'עץ', 'נתיב' ו'כל_הנתיבים', ברירת המחדל היא 'מספר שלם'.MAX_VALUE, עבור דלות והסברים, ברירת המחדל היא 1 (מוצג רק תעלות ישירות של השורש מלבד עליות היעד וההורים).
תגים:execution
- ברירת מחדל של
--[no]extra
: "false" -
השאילתות יציגו גם את הסיבה שבגללה המודולים נפתרו בגרסה הנוכחית שלהם (אם היא שונתה). ברירת המחדל היא TRUE רק לשאילתת ההסבר.
תגים:execution
- ברירת מחדל של
--from=<a list of <module>s separated by comma>
: "root" -
המודולים שמהם תתחיל שאילתת התרשים התלויה. בודקים את התיאור המדויק של כל שאילתה. כברירת מחדל, המערכת מקבלת את הערך root.
תגים:execution
- ברירת מחדל של
--[no]include_unused
: "false" -
השאילתות יביאו בחשבון גם את המודולים שאינם בשימוש, שאינם מוצגים בתרשים רזולוציית המודולים לאחר הבחירה (בגלל בחירות הגרסה המינימלית או כללי הביטול). פעולה זו יכולה להשפיע באופן שונה על כל אחד מסוגי השאילתות, כלומר לכלול נתיבים חדשים בפקודה All_paths או תלויים נוספים בפקודת ההסבר.
תגים:execution
- ברירת מחדל של
--output=<text, json or graph>
: "text" -
הפורמט שבו יש להדפיס את תוצאות השאילתה. הערכים המותרים לשאילתה הם: טקסט, json, תרשים
תגים:terminal_output
- אפשרויות הקשורות לפלט Bzlmod וסמנטיקה:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- ברירת מחדל של
--deleted_packages=<comma-separated list of package names>
: "" - רשימה של שמות של חבילות, מופרדים בפסיקים, שמערכת ה-build תתייחס אליהם שאינם קיימים, גם אם הם מוצגים במקום כלשהו בנתיב החבילה. כדאי להשתמש באפשרות הזו כשמוחקים חבילת משנה 'x/y' של חבילה קיימת 'x' לדוגמה, לאחר מחיקת x/y/BUILD בלקוח, מערכת ה-build עשויה להתלונן אם היא תיתקל בתווית '//x:y/z' אם היא עדיין מסופקת על ידי ערך package_path אחר. ציון [delete_packs x/y] מונע את הבעיה הזו.
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
- ברירת מחדל של
--package_path=<colon-separated list of options>
: "%workspace%" - רשימה מופרדת בנקודתיים של מיקומים לחיפוש חבילות. רכיבים שמתחילים ב-'%workspace%' הם יחסיים לסביבת העבודה המקיפה. אם לא מופיעה או ריקה, ברירת המחדל היא הפלט של 'bazel information default-package-path'.
- ברירת מחדל של
--[no]show_loading_progress
: "true" - אם מופעל, גורם ל-Bazel להדפיס הודעות &&;טעינת חבילה:".
אפשרויות Print_action
העברה בירושה את כל האפשרויות מיצירה.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות שמשפיעות בצורה מדויקת על האופן שבו Bazel אוכפת קלטי build תקינים (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
- נצברו
--print_action_mnemonics=<a string>
שימושים מרובים - רשימות של המנינים שבאמצעותן מסננים נתוני Print_action, ולא מתבצע סינון כשהם ריקים.
אפשרויות שאילתה
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בהפעלה של גרסת build:
- ברירת מחדל של
--[no]incompatible_remote_dangling_symlinks
: "true" -
אם המדיניות מוגדרת כ-True ו- --incompatible_remote_symlinks הוא גם נכון, קישורים מסולסלים בפלטי פעולה מורשים להתנתק.
תגים:execution
,incompatible_change
- ברירת מחדל של
--[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", "HOST_CPUS", "HOST_RAM"), ובדרך כלל מוסיפים פעולה ([-|*]<float>) למשל. "auto", "HOST_CPUS*.5". "auto" מגדיר ברירת מחדל סבירה על סמך משאבים למארחים. הערך חייב להיות לפחות 1.
תגים:bazel_internal_configuration
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לקיומו:
- ברירת מחדל של
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
המספר המקסימלי של קבצים פתוחים מותר במהלך העלאת תוכן של BEP.
תגים:affects_outputs
--remote_download_minimal
-
לא תתבצע הורדה של פלטי build מרוחקים אל המכונה המקומית. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=minimal.
הרחבה אל:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=minimal
תגים:affects_outputs
- ברירת מחדל של
--remote_download_outputs=<all, minimal or toplevel>
: "all" -
אם המדיניות מוגדרת כ-'minimal' לא מורידה פלט של build מרחוק אל המכונה המקומית, חוץ מאלה הנדרשות על ידי פעולות מקומיות. אם המדיניות מוגדרת כ-'toplevel' היא פועלת כך'minimal' מלבד זאת, מתבצעת הורדה של פלט של יעדים ברמה העליונה למחשב המקומי. שתי האפשרויות יכולות לקצר משמעותית את זמני הבנייה אם רוחב הפס של הרשת הוא צוואר בקבוק.
תגים:affects_outputs
- ברירת מחדל של
--remote_download_symlink_template=<a string>
: "" -
במקום להוריד פלט של build מרחוק, אפשר ליצור קישורים סימבוליים. ניתן לציין את יעד הקישורים המסמלים בצורת מחרוזת תבנית. מחרוזת התבנית הזו עשויה להכיל {hash} ו-{size_bytes} שמתרחבים לאובייקט ולגודל בבייטים, בהתאמה. הקישורים הסמליים האלה עשויים, למשל, להפנות למערכת קבצים של FUSE שטוענת אובייקטים מ-CAS לפי דרישה.
תגים:affects_outputs
--remote_download_toplevel
-
רק מכונה מקומית יכולה להוריד פלט מרחוק של יעדים ברמה העליונה. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=toplevel.
מתרחבת אל:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel
תגים:affects_outputs
- אפשרויות שמשפיעות על רמת האכיפה התקינה של Bazel על קלט קלט (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- ברירת מחדל של
--[no]incompatible_config_setting_private_default_visibility
: "false" -
אם לא תואם_enforce_config_setting_visible=false, זו שגיאה. אחרת, אם הסימון הזה הוא false, כל הגדרת config_ללא מאפיין חשיפה בוטה היא //visible:public. אם הסימון הזה נכון, המאפיין config_setting תואם ללוגיקה של הרשאות הגישה שדומה לכל הכללים האחרים. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12933.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enforce_config_setting_visibility
: "true" -
אם המדיניות מוגדרת כ-True, יש לאכוף את הרשאות הגישה מסוג config_setting. אם הערך הוא False, כל config_setting גלויה לכל יעד. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים:loading_and_analysis
,incompatible_change
- אפשרויות שקשורות לפלט שאילתות וסמנטיקה:
- ברירת מחדל של
--aspect_deps=<off, conservative or precise>
: "conservative" -
איך לפתור בעיה של יחסי גובה-רוחב כאשר פורמט הפלט הוא בפורמט {xml,proto,record}. 'off' פירוש הדבר שלא נפתרים יחסי תלות ו'שמרני' (ברירת המחדל) מוסיפים את כל יחסי הגובה-רוחב המוצהרים, בין אם הם קיבלו את רמת התלויות הישירות ובין אם לא. חשוב לדעת שמצב מדויק מחייב טעינת חבילות אחרות כדי להעריך יעד יחיד, כך שהוא איטי יותר מהמצבים האחרים. כמו כן, אפילו מצב מדויק אינו מדויק לחלוטין: ההחלטה אם לחשב היבט מסוים נקבעת בשלב הניתוח, שאינו פועל במהלך &b3Query;'
תגים:build_file_semantics
- ברירת מחדל של
--[no]experimental_graphless_query
: "auto" -
אם הערך הוא True, המערכת משתמשת בהטמעה של שאילתה שלא יוצרת עותק של התרשים. ההטמעה החדשה תומכת רק ב- --order_put=no, וכן רק בקבוצת משנה של פורמטים של פלט.
תגים:build_file_semantics
,eagerness_to_exit
- ברירת מחדל של
--graph:conditional_edges_limit=<an integer>
: "4" -
המספר המקסימלי של תוויות תנאים להצגה. -1 פירושו שאי אפשר לחתוך אותו ו-0 פירושו הערה. האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים:terminal_output
- ברירת מחדל של
--[no]graph:factored
: "true" -
אם הערך הוא True, התרשים ייקרא 'fact האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים:terminal_output
- ברירת מחדל של
--graph:node_limit=<an integer>
: "512" -
האורך המקסימלי של מחרוזת התווית עבור צומת תרשים בפלט. תוויות ארוכות יותר יקוצרו; הערך 1- יגרום לכך שלא ייחתך. האפשרות הזו רלוונטית רק ל- --פלט=תרשים.
תגים:terminal_output
- ברירת מחדל של
--[no]implicit_deps
: "true" -
אם האפשרות הזאת מופעלת, יחסי תלות מרומזים ייכללו בתרשים התלות שבו השאילתה פועלת. תלות משתמעת היא זו שלא צוינה במפורש בקובץ BUILD, אך נוספה על ידי ה-bazel. עבור שאילתה, אפשרות זו שולטת בסינון ערכות כלים שנפתרו.
תגים:build_file_semantics
- ברירת מחדל של
--[no]include_aspects
: "true" -
aquery, שאילתה: האם לכלול פעולות שנוצרו על ידי היבט בפלט. שאילתה: no-op (מאפיינים תמיד במעקב).
תגים:terminal_output
- ברירת מחדל של
--[no]incompatible_display_source_file_location
: "true" -
True, כברירת מחדל, יוצג היעד של קובץ המקור. אם True, מציג את המיקום של שורה 1 של קובצי מקור בפלטי מיקום. הסימון הזה קיים רק למטרות העברה.
תגים:terminal_output
,incompatible_change
- ברירת מחדל של
--[no]incompatible_lexicographical_output
: "true" -
אם האפשרות הזו מוגדרת, ממיינת --order_פלט=אוטומטי בסדר לקסיקוגרפי.
תגים:terminal_output
,incompatible_change
- ברירת מחדל של
--[no]incompatible_package_group_includes_double_slash
: "true" -
אם האפשרות הזו מופעלת, בעת הפקת המאפיין 'packs' של package_group&, הסימן '//' הראשי לא יושמט.
תגים:terminal_output
,incompatible_change
- ברירת מחדל של
--[no]infer_universe_scope
: "false" -
אם המדיניות set ו- לתשומת ליבכם, הערך של uniuni_scope כפי שהוסק עבור ביטוי שאילתה שמשתמש בפונקציות ברמת היקום (למשל, allalleps) הוא לא מה שאתם רוצים, לכן עליכם להשתמש באפשרות הזו רק אם אתם יודעים מה אתם עושים. פרטים ודוגמאות זמינים בכתובת https://bazel.build/reference/query#sky-query. אם --univers_scope מוגדר, המערכת מתעלמת מהערך של אפשרות זו. הערה: האפשרות הזו חלה רק על 'שאילתה' (כלומר, לא 'cquery').
תגים:loading_and_analysis
- ברירת מחדל של
--[no]line_terminator_null
: "false" -
אם כל פורמט יסתיים ב-\0 במקום בפורמט חדש.
תגים:terminal_output
- ברירת מחדל של
--[no]nodep_deps
: "true" -
אם המדיניות מופעלת, נקודות שפל מתוך "nodep" ייכללו בתרשים התלות שבו השאילתה פועלת. דוגמה נפוצה למאפיין "nodep". היא "visible". מריצים ומנתחים את הפלט של 'info Build-language' כדי ללמוד על כל המאפיינים "nodep"בשפת ה-build.
תגים:build_file_semantics
--noorder_results
-
פלט התוצאות נקבע לפי סדר התלות (ברירת מחדל) או ללא סדר. הפלט הלא מסודר מהיר יותר, אבל הוא נתמך רק כאשר - הפלט לא מיננק, או למיקסום או לגרף.
מתרחב אל:
--order_output=no
תגים:terminal_output
--null
-
אם כל פורמט יסתיים ב-\0 במקום בפורמט חדש.
מתרחב אל:
--line_terminator_null=true
תגים:terminal_output
- ברירת מחדל של
--order_output=<no, deps, auto or full>
: "auto" -
פלטו את התוצאות ללא סדר (לא), מסודרות לפי תלות (Deps) או סדר מלא (מלא). ברירת המחדל היא 'auto' כלומר, התוצאות ממוינות לפי סדר יחסי או לפי סדר, בהתאם לפורמט הפלט (לפי סדר תלות של אב-טיפוס, מינרל, דירוג ותרשים, ממוינות לחלוטין בשביל כל האחרות). כשהפלט מסודר במלואו, הצמתים מודפסים בסדר דטרמיניסטי (סה"כ) באופן מלא. קודם כל, כל הצמתים ממוינים בסדר אלפביתי. לאחר מכן, כל צומת ברשימה משמש כהתחלה של חיפוש תחילה של עומק ההזמנה, שבו הקצוות היוצאים לצמתים שלא ביקרו בהם יוצגו בסדר אלפביתי של הצמתים שממשיכים ברצף. בסיום, הצמתים מודפסים בסדר הפוך שבו הם ביקרו בהם.
תגים:terminal_output
--order_results
-
פלט התוצאות נקבע לפי סדר התלות (ברירת מחדל) או ללא סדר. הפלט הלא מסודר מהיר יותר, אבל הוא נתמך רק כאשר - הפלט לא מיננק, או למיקסום או לגרף.
מתרחב אל:
--order_output=auto
תגים:terminal_output
- ברירת מחדל של
--output=<a string>
: "label" -
הפורמט שבו יש להדפיס את תוצאות השאילתה. הערכים המותרים לשאילתה הם: build, תרשים, תווית, label_kind, מיקום, maxrank, minrank, חבילה, Proto, xml.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:default_values
: "true" -
אם מוגדר כ-True, נכללים מאפיינים שהערך שלהם לא צוין במפורש בקובץ BUILD. אחרת, הם יושמטו. האפשרות הזו רלוונטית ל- --פלט=פרוטו
תגים:terminal_output
- ברירת מחדל של
--[no]proto:definition_stack
: "false" -
מאכלס את השדה Proto-stack, שמתעד כל מופע של כלל ה-Starstark שבו מוגדרת המחלקה בכלל.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:flatten_selects
: "true" -
אם המדיניות מופעלת, מאפיינים ניתנים להגדרה שנוצרו על ידי Select() שטוחים. עבור סוגי רשימות, הייצוג השטוח הוא רשימה המכילה כל ערך של המפה שנבחרה פעם אחת בלבד. סוגי הפיגועים שטוחים איזה null.
תגים:build_file_semantics
- ברירת מחדל של
--[no]proto:include_synthetic_attribute_hash
: "false" -
אם רוצים לחשב ולאכלס את המאפיין $internal_attr_Hash.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:instantiation_stack
: "false" -
אכלוס מחסנית קריאות של כל הנחיה. כדי לעשות זאת, יש צורך במקבץ סטאק
תגים:terminal_output
- ברירת מחדל של
--[no]proto:locations
: "true" -
אם בכלל, כדאי לשלוח פרטי מיקום בפלט אב.
תגים:terminal_output
- ברירת מחדל של
--proto:output_rule_attrs=<comma-separated list of options>
: "all" -
רשימת מאפיינים המופרדים בפסיקים שצריך לכלול בפלט. ברירת המחדל היא כל המאפיינים. יש להגדיר את המחרוזת כמחרוזת ריקה כדי לא להוציא פלט. האפשרות הזו רלוונטית ל--פלט=פרוטו.
תגים:terminal_output
- ברירת מחדל של
--[no]proto:rule_inputs_and_outputs
: "true" -
אפשר גם לאכלס את השדותכללי_קלט וכלל_פלט.
תגים:terminal_output
- ברירת מחדל של
--query_file=<a string>
: "" -
אם היא מוגדרת, השאילתה תקרא את השאילתה מהקובץ שכאן, במקום בשורת הפקודה. שגיאה לציין קובץ כאן וגם שאילתת שורת פקודה.
תגים:changes_inputs
- ברירת מחדל של
--[no]relative_locations
: "false" -
אם הערך הוא TRUE, המיקום של קובצי BUILD ב-XML ובפלטי אב יהיה יחסי. כברירת מחדל, פלט המיקום הוא נתיב מוחלט ולא יהיה עקבי בין מחשבים. אפשר להגדיר את האפשרות הזו כ-True כדי לקבל תוצאה עקבית במכשירים שונים.
תגים:terminal_output
- ברירת מחדל של
--[no]strict_test_suite
: "false" -
אם הערך הוא true, הביטוי test() מקבל שגיאה אם הוא נתקל ב-test_Suite שמכיל יעדים שאינם בדיקות.
תגים:build_file_semantics
,eagerness_to_exit
- ברירת מחדל של
--[no]tool_deps
: "true" -
שאילתה: אם היא מושבתת, יחסי תלות ב-'מארח הגדרה' או 'execution' יעדים לא ייכללו בתרשים התלות שעליו פועלת השאילתה. קצה 'הגדרת תצורה למארחים' כזה מהכלל של #&39;proto_library' מפנה בדרך כלל למהדר הפרוטוקול, בדרך כלל מצביע על כלי שהופעל במהלך ה-build במקום על חלק מאותה תוכנית 'target'
שאילתה: אם היא מושבתת, היא מסננת את כל היעדים שהוגדרו שחוצים מעבר של מארח או ביצוע, מהיעד שהוגדר ברמה העליונה שגילו את היעד שהוגדר. כלומר, אם היעד ברמה העליונה נמצא בתצורת היעד, יוחזרו רק יעדים שהוגדרו בתצורת היעד. אם היעד ברמה העליונה נמצא בתצורת המארח, יוחזרו רק יעדים שהוגדרו על ידי המארח. אפשרות זו לא תכלול שרשראות כלים שנפתרו.
תגים:build_file_semantics
- ברירת מחדל של
--universe_scope=<comma-separated list of options>
: "" -
קבוצה של דפוסי יעד (מופרדים באמצעות פסיקים) המופרדים בפסיקים. השאילתה עשויה להתבצע ביקום שהוגדר על ידי הסגירה העקיפה של היעדים שצוינו. האפשרות הזו משמשת לפקודות השאילתה ושאילתת השאילתה.
עבור השאילתה, הקלט לאפשרות הזו הוא היעדים שבנו כל התשובות, ולכן האפשרות הזו עשויה להשפיע על התצורות והמעברים. אם אפשרות זו אינה מוגדרת, ההנחה היא שהיעדים ברמה העליונה הם היעדים המנותחים מביטוי השאילתה. הערה לגבי שאילתה: אם לא מציינים את האפשרות הזו, ייתכן שה-build לא יפעל אם לא ניתן ליצור יעדים מביטוי השאילתה עם האפשרויות ברמה העליונה.
תגים:loading_and_analysis
- ברירת מחדל של
--[no]xml:default_values
: "false" -
אם הערך הוא True, מאפייני הדפסה שהערך שלהם לא צוין במפורש בקובץ BUILD יודפסו. אחרת, הם יושמטו.
תגים:terminal_output
- ברירת מחדל של
--[no]xml:line_numbers
: "true" -
אם הערך הוא true, פלט ה-XML מכיל מספרי שורה. השבתת האפשרות הזו עשויה להקל על הקריאה. האפשרות הזו רלוונטית רק ל--פלט=xml.
תגים:terminal_output
- אפשרויות הקשורות לפלט Bzlmod וסמנטיקה:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- ברירת מחדל של
--experimental_repository_resolved_file=<a string>
: "" -
אם לא ריק, כותבים ערך של Starlark עם הפרטים שנפתרו לגבי כל כללי המאגר של Starlark שבוצעו.
תגים:affects_outputs
- ברירת מחדל של
--remote_print_execution_messages=<failure, success or all>
: "failure" -
אתם יכולים לבחור מתי תרצו להדפיס הודעות של ביצוע מרחוק. הערכים התקינים הם 'כשל', כדי להדפיס רק כשלים, 'הצלחה' כדי להדפיס רק את ההצלחות, ו'הכול' כדי להדפיס תמיד.
תגים:terminal_output
- אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- ברירת מחדל של
--[no]experimental_guard_against_concurrent_changes
: "false" - כדי להשבית את הבדיקה של קובצי קלט עבור פעולה מסוימת לפני שמעלים אותה למטמון מרוחק, יש להשבית את הזמן. ייתכנו מקרים שבהם הליבה של Linux מעכבת כתיבה של קבצים, מה שעלול לגרום לתוצאות חיוביות שקריות.
- ברירת מחדל של
--experimental_remote_build_event_upload=<all or minimal>
: "all" - אם המדיניות מוגדרת כ-'all' כל הפלט המקומי שאליו מפנה BEP מועלה למטמון מרוחק. אם המדיניות מוגדרת כ-'minimal' פלטים מקומיים ש-BEP מפנה אליהם לא מועלים למטמון המרוחק, מלבד קבצים שחשובים לצרכנים של BEP (למשל יומני בדיקה ופרופיל תזמון). סכימת //:file משמשת לנתיבים של קבצים מקומיים וסכימת בייטstream:// משמשת לנתיבים של קבצים שהועלו (כבר). ברירת המחדל היא 'all'.
- ברירת מחדל של
--[no]experimental_remote_cache_async
: "false" - אם הערך הוא TRUE, מטמון I/O מרוחק יתרחש ברקע במקום להיווצר כחלק מ-S מדויקת.
- ברירת מחדל של
--[no]experimental_remote_cache_compression
: "false" - אם האפשרות מופעלת, אפשר לדחוס או לפרוס בועות של מטמון עם zstd.
- ברירת מחדל של
--experimental_remote_capture_corrupted_outputs=<a path>
: תיאור - נתיב לספרייה שבה יילכו פלטים פגומים.
- ברירת מחדל של
--experimental_remote_downloader=<a string>
: תיאור - URI של נקודת קצה ל-API של נכס מרוחק, שישמש כשרת proxy להורדה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. בכתובת: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- ברירת מחדל של
--[no]experimental_remote_downloader_local_fallback
: "false" - אם אתם רוצים לחזור לכלי ההורדה המקומי, אם ההורדה מרחוק נכשלה.
- ברירת מחדל של
--[no]experimental_remote_execution_keepalive
: "false" - האם להשתמש ב-Keepalive בשיחות ביצוע מרחוק?
- ברירת מחדל של
--experimental_remote_grpc_log=<a path>
: תיאור - אם צוין, נתיב לקובץ שבו יתבצע רישום של פרטים הקשורים לשיחת gRPC. היומן הזה מורכב מרצף של com.google.devtools.build.lib.remote.logging.remoteExecutionLog.LogEntry Protobufs עם כל הודעה המסומנת ב-varint המציין את גודל ההודעה הבאה עם פסיק.
- ברירת מחדל של
--[no]experimental_remote_mark_tool_inputs
: "false" - אם היא מוגדרת כ-True, ה-Bazel יסמן את הקלט בתור קלט לכלי הפעולה מרחוק. אפשר להשתמש באפשרות הזאת כדי להטמיע עובדים קבועים מרחוק.
- ברירת מחדל של
--[no]experimental_remote_merkle_tree_cache
: "false" - אם המדיניות מוגדרת כ-True, החישובים של עץ ה-Merkle יסונכרנו כדי לשפר את מהירות הבדיקה של ההיט המרוחק. ביצועי טביעת הרגל בזיכרון של המטמון נקבעים על ידי -experimental_remote_merkle_tree_cache_size.
- ברירת מחדל של
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - מספר עצי ה-Merkle שיש לזכור כדי לשפר את מהירות הבדיקה של ההיט המרוחק. אף על פי שהמטמון נחתך באופן אוטומטי בהתאם לטיפול בהפניות רכות של Java', יכול להיות ששגיאות "חסרות זיכרון" עלולות להיווצר אם הן גבוהות מדי. אם המדיניות מוגדרת כ-0, גודל המטמון הוא בלתי מוגבל. הערך האופטימלי משתנה בהתאם לגודל הפרויקט. ערך ברירת המחדל הוא 1,000.
- ברירת מחדל של
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - אם המדיניות מוגדרת כ-True, פלטים שאליהם מפנה BEP לא יועלו למטמון מרוחק אם לא ניתן יהיה לשמור במטמון את פעולת היצירה מרחוק.
- ברירת מחדל של
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
האם לשלוח את כל הערכים של כותרת רבת-ערך להורדה מרחוק ולא רק הראשונה.
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
אם המדיניות מוגדרת כ-True, נתיבי הפלט הם יחסיים לשורש הקלט במקום לספרייה הפעילה.
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_remote_results_ignore_disk
: "true" -
אם המדיניות מוגדרת כ-True, --noremote_upload_local_results ו--noremote_Accept_cached לא יחולו על מטמון הדיסק. אם נעשה שימוש במטמון משולב:
--noremote_upload_local_results יגרום לכתיבה של תוצאות במטמון הדיסק, אבל לא להעלאה למטמון המרוחק.
--noremote_confirm_cached יוביל לבדיקה של Bazel בתוצאות החיפוש במטמון הדיסק, אבל לא במטמון המרוחק.
פעולות ללא הפעלה מרחוק יכולות לפגוע במטמון הדיסק.
פרטים נוספים זמינים בדף #8216.
תגים:incompatible_change
- ברירת מחדל של
--[no]remote_accept_cached
: "true" - האם לקבל תוצאות של פעולות שנשמרו במטמון מרחוק?
- ברירת מחדל של
--remote_bytestream_uri_prefix=<a string>
: תיאור - שם המארח ושם המופע לשימוש ב-URI של בייט-בייט שכתובים במקורות נתונים של אירועים. אפשר להגדיר את האפשרות הזו כשמבצעים גרסאות build באמצעות שרת proxy. כתוצאה מכך, הערכים של -remote_executor ו--remote_instance_name לא תואמים יותר לשם הקנוני של שירות הביצוע מרחוק. אם היא לא מוגדרת, ברירת המחדל היא "${hostname}/${instance_name}".
- ברירת מחדל של
--remote_cache=<a string>
: תיאור - URI של נקודת קצה לשמירה במטמון. הסכימות הנתמכות הן http, https, grpc, grpcs (grpc עם TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. מציינים grpc://, http:// או Unix: כדי להשבית TLS. כדאי לעיין בכתובת https://bazel.build/remote/caching
- נצברו
--remote_cache_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות שנשמרו במטמון: --remote_cache_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- נצברו
--remote_default_exec_properties=<a 'name=value' assignment>
שימושים מרובים -
מגדירים את מאפייני ברירת המחדל של exe שישמשו כפלטפורמת הביצוע מרחוק, אם פלטפורמת ביצוע עדיין לא הגדירה exec_properties.
תגים:affects_outputs
- ברירת מחדל של
--remote_default_platform_properties=<a string>
: "" - מגדירים את מאפייני הפלטפורמה שמוגדרים כברירת מחדל ל-API לביצוע מרחוק, אם פלטפורמת הביצוע לא מוגדרת עדיין Remote_execution_property. המערכת תשתמש בערך הזה גם אם פלטפורמת המארח נבחרה כפלטפורמת ההפעלה לביצוע מרחוק.
- נצברו
--remote_downloader_header=<a 'name=value' assignment>
שימושים מרובים - יש לקבוע כותרת שתיכלל בבקשות להורדה מרחוק: --remote_downloader_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- נצברו
--remote_exec_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות ביצוע: --remote_exec_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- ברירת מחדל של
--remote_execution_priority=<an integer>
: "0" - העדיפות היחסית של הפעולות שיש לבצע מרחוק. הסמנטיקה של ערכי העדיפות הספציפית היא תלויה בשרת.
- ברירת מחדל של
--remote_executor=<a string>
: תיאור - מארח או מתארח:יציאה של נקודת קצה להפעלה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. צריך לציין grpc:// או Unix: כדי להשבית TLS.
- נצברו
--remote_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות: --remote_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- ברירת מחדל של
--remote_instance_name=<a string>
: "" - הערך שמועבר כ-Instance_name ב-API לביצוע מרחוק.
- ברירת מחדל של
--[no]remote_local_fallback
: "false" - האם לחזור לשיטה עצמאית של הפעלה מקומית אם ביצוע ההעברה מרחוק נכשל?
- ברירת מחדל של
--remote_local_fallback_strategy=<a string>
: "local" - לא, הוצא משימוש. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/7480.
- ברירת מחדל של
--remote_max_connections=<an integer>
: "100" -
הגבלת המספר המקסימלי של חיבורים בו-זמנית למטמון/קובץ הפעלה מרחוק. כברירת מחדל, הערך הוא 100. אם מגדירים את הערך כ-0, אין הגבלה.
עבור מטמון של HTTP מרחוק, חיבור TCP אחד יכול לטפל בבקשה אחת בכל פעם, כך ש-Bazel יכול לבצע בקשות בו-זמנית עד ל-remote_max_connections.
ב-gRPC מרוחק, יכול להיות שערוץ אחד בשם gRPC יוכל לטפל ביותר מ-100 בקשות בו-זמנית. לכן, Bazel יכולה לשלוח בקשות '--remote_max_connections * 100' בו-זמנית.
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--remote_proxy=<a string>
: תיאור - מתחברים למטמון המרוחק דרך שרת proxy. כרגע אפשר להשתמש בסימון הזה רק כדי להגדיר שקע דומיין (Unix:/path/to/socket) ב-Unix:
- ברירת מחדל של
--remote_result_cache_priority=<an integer>
: "0" - העדיפות היחסית של פעולות מרוחקות שנשמרו במטמון מרוחק. הסמנטיקה של ערכי העדיפות הספציפית היא תלויה בשרת.
- ברירת מחדל של
--remote_retries=<an integer>
: "5" - מספר הניסיונות המקסימלי לנסות שוב שגיאה זמנית. אם המדיניות מוגדרת כ-0, ניסיונות חוזרים מושבתים.
- ברירת מחדל של
--remote_timeout=<An immutable length of time.>
: "60s" - משך הזמן המרבי להמתנה לביצוע מרחוק ולשיחות במטמון. למטמון REST, זהו גם החיבור וגם הזמן הקצוב לתפוגה של קריאה. אפשר להשתמש ביחידות הבאות: ימים (d), שעות (h), דקות (m), שניות (s) ואלפיות שנייה (אלפיות השנייה). אם משמיטים את היחידה, הערך מפורש כשניות.
- ברירת מחדל של
--[no]remote_upload_local_results
: "true" - האם להעלות למטמון המרוחק תוצאות של פעולות שבוצעו באופן מקומי?
- ברירת מחדל של
--[no]remote_verify_downloads
: "true" - אם היא מוגדרת כ-true, Bazel תחשב את סכום הגיבוב של כל ההורדות המרוחקות ותשליך את הערכים השמורים במטמון מרחוק אם הם לא תואמים לערך הצפוי.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- ברירת מחדל של
--deleted_packages=<comma-separated list of package names>
: "" - רשימה של שמות של חבילות, מופרדים בפסיקים, שמערכת ה-build תתייחס אליהם שאינם קיימים, גם אם הם מוצגים במקום כלשהו בנתיב החבילה. כדאי להשתמש באפשרות הזו כשמוחקים חבילת משנה 'x/y' של חבילה קיימת 'x' לדוגמה, לאחר מחיקת x/y/BUILD בלקוח, מערכת ה-build עשויה להתלונן אם היא תיתקל בתווית '//x:y/z' אם היא עדיין מסופקת על ידי ערך package_path אחר. ציון [delete_packs x/y] מונע את הבעיה הזו.
- ברירת מחדל של
--disk_cache=<a path>
: תיאור - נתיב לספרייה שבה Bazel יכולה לקרוא ולכתוב פעולות ופלטי פעולות. אם הספרייה לא קיימת, היא תיווצר.
- נצברו
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
שימושים מרובים - הגדרת עזרה לגבי פרטי כניסה לשימוש באחזור פרטי הכניסה של ההיקף (דומיין). פרטי כניסה מ-credentials Credentials מקבלים עדיפות על פני פרטי כניסה מ-<code>--google_default_credentials</code>, `--google_credentials` או <code>.netrc</code>. אפשר לראות אותם בכתובת https://github.com/bazelbuild/proposs22-z
- ברירת מחדל של
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30m" - ההגדרה קובעת את משך הזמן שבו פרטי הכניסה ששמורים ב'פרטי כניסה' יישמרו במטמון.
- ברירת מחדל של
--experimental_credential_helper_timeout=<An immutable length of time.>
: "5s" - הגדרת הזמן הקצוב לתפוגה עבור 'פרטי הכניסה'. עוזרי הכניסה שלא יגיבו בזמן הקצוב לתפוגה ייכשלו.
- ברירת מחדל של
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - רשימה של היקפי אימות ב-Google Cloud, המופרדים באמצעות פסיקים.
- ברירת מחדל של
--google_credentials=<a string>
: תיאור - ההגדרה קובעת את הקובץ שממנו יתקבלו פרטי הכניסה לאימות. פרטים נוספים זמינים בכתובת https://cloud.google.com/docs/authentication.
- ברירת מחדל של
--[no]google_default_credentials
: "false" - אם צריך להשתמש ב 'פרטי הכניסה שמוגדרים כברירת מחדל באפליקציית Google' לאימות. פרטים נוספים זמינים בכתובת https://cloud.google.com/docs/authentication. מושבת כברירת מחדל.
- ברירת מחדל של
--grpc_keepalive_time=<An immutable length of time.>
: תיאור - הגדרת פינגים בשידור חי עבור חיבורי gRPC יוצאים. אם המדיניות הזו מוגדרת, Bazel שולחת פינגים אחרי פרק הזמן הזה ללא פעולות קריאה בחיבור, אבל רק אם יש לפחות קריאה אחת אחת מסוג gRPC בהמתנה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. פינגים בשידור חי מושבתים כברירת מחדל. עליך לתאם עם בעל השירות לפני הפעלת ההגדרה הזו. לדוגמה, כדי להגדיר ערך של 30 שניות לסימון הזה, צריך לעשות זאת כך: grpc_keepalive_time=30s
- ברירת מחדל של
--grpc_keepalive_timeout=<An immutable length of time.>
: "20s" - הגדרת זמן קצוב לתפוגה של שמירת נתונים פעילה עבור חיבורי gRPC יוצאים. אם פינגים מסוג keep-alive מופעלים באמצעות --grpc_keepalive_time, תם הזמן הקצוב (Bazel) של Bazel אם לא מתקבלת פינג אחרי פרק הזמן הזה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. אם פינגים פעילים נשארים מושבתים, המערכת מתעלמת מההגדרה הזו.
- נצברו
--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 להדפיס הודעות &&;טעינת חבילה:".
- ברירת מחדל של
--tls_certificate=<a string>
: תיאור - יש לציין נתיב לאישור TLS שהוא מהימן לחתימה על אישורי שרת.
- ברירת מחדל של
--tls_client_certificate=<a string>
: תיאור - ציון אישור הלקוח של TLS (אבטחת שכבת התעבורה) לשימוש. צריך גם לספק מפתח לקוח כדי להפעיל אימות לקוח.
- ברירת מחדל של
--tls_client_key=<a string>
: תיאור - צריך לציין את מפתח הלקוח ב-TLS שבו רוצים להשתמש. צריך גם לספק אישור לקוח כדי להפעיל את אימות הלקוח.
אפשרויות הפעלה
העברה בירושה את כל האפשרויות מיצירה.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לקיומו:
- ברירת מחדל של
--script_path=<a path>
: תיאור -
אם המדיניות מוגדרת, כותבים סקריפט של מעטפת בקובץ הנתון, שמפעיל את היעד. אם האפשרות הזו מוגדרת, היעד לא מופעל מה-bazel. 'bazel run --script_path=foo //foo&& ./foo' כדי להפעיל את היעד '//foo' זה שונה מ- 'bazel run //foo' בכך שנעילת הבסיס פתוחה, וקובץ ההפעלה מחובר למסוף...
תגים:affects_outputs
,execution
- אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות כיבוי
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בפלט של הפקודה:
- ברירת מחדל של
--iff_heap_size_greater_than=<an integer>
: "0" -
אם הערך הוא אפס, ההשבתה תכבה את השרת רק אם הנפח הכולל (ב-MB) שצורף ל-JVM יחרוג מהערך הזה.
תגים:loses_incremental_state
,eagerness_to_exit
- אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
אפשרויות סנכרון
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בהפעלה של גרסת build:
- ברירת מחדל של
--[no]configure
: "False" -
מאגרי סנכרון מסומנים רק כ-'configure' למטרות הגדרת המערכת.
תגים:changes_inputs
- ברירת מחדל של
--[no]incompatible_remote_dangling_symlinks
: "true" -
אם המדיניות מוגדרת כ-True ו- --incompatible_remote_symlinks הוא גם נכון, קישורים מסולסלים בפלטי פעולה מורשים להתנתק.
תגים:execution
,incompatible_change
- ברירת מחדל של
--[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", "HOST_CPUS", "HOST_RAM"), ובדרך כלל מוסיפים פעולה ([-|*]<float>) למשל. "auto", "HOST_CPUS*.5". "auto" מגדיר ברירת מחדל סבירה על סמך משאבים למארחים. הערך חייב להיות לפחות 1.
תגים:bazel_internal_configuration
- נצברו
--only=<a string>
שימושים מרובים -
אם האפשרות הזו ניתנת, יש לסנכרן רק את המאגרים שצוינו עם האפשרות הזו. עדיין לשקול את כל האפשרויות (או את כולן, כמו בתצורה - הגדרת).
תגים:changes_inputs
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לקיומו:
- ברירת מחדל של
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
המספר המקסימלי של קבצים פתוחים מותר במהלך העלאת תוכן של BEP.
תגים:affects_outputs
--remote_download_minimal
-
לא תתבצע הורדה של פלטי build מרוחקים אל המכונה המקומית. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=minimal.
הרחבה אל:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=minimal
תגים:affects_outputs
- ברירת מחדל של
--remote_download_outputs=<all, minimal or toplevel>
: "all" -
אם המדיניות מוגדרת כ-'minimal' לא מורידה פלט של build מרחוק אל המכונה המקומית, חוץ מאלה הנדרשות על ידי פעולות מקומיות. אם המדיניות מוגדרת כ-'toplevel' היא פועלת כך'minimal' מלבד זאת, מתבצעת הורדה של פלט של יעדים ברמה העליונה למחשב המקומי. שתי האפשרויות יכולות לקצר משמעותית את זמני הבנייה אם רוחב הפס של הרשת הוא צוואר בקבוק.
תגים:affects_outputs
- ברירת מחדל של
--remote_download_symlink_template=<a string>
: "" -
במקום להוריד פלט של build מרחוק, אפשר ליצור קישורים סימבוליים. ניתן לציין את יעד הקישורים המסמלים בצורת מחרוזת תבנית. מחרוזת התבנית הזו עשויה להכיל {hash} ו-{size_bytes} שמתרחבים לאובייקט ולגודל בבייטים, בהתאמה. הקישורים הסמליים האלה עשויים, למשל, להפנות למערכת קבצים של FUSE שטוענת אובייקטים מ-CAS לפי דרישה.
תגים:affects_outputs
--remote_download_toplevel
-
רק מכונה מקומית יכולה להוריד פלט מרחוק של יעדים ברמה העליונה. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=toplevel.
מתרחבת אל:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel
תגים:affects_outputs
- אפשרויות שמשפיעות על רמת האכיפה התקינה של Bazel על קלט קלט (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- ברירת מחדל של
--[no]incompatible_config_setting_private_default_visibility
: "false" -
אם לא תואם_enforce_config_setting_visible=false, זו שגיאה. אחרת, אם הסימון הזה הוא false, כל הגדרת config_ללא מאפיין חשיפה בוטה היא //visible:public. אם הסימון הזה נכון, המאפיין config_setting תואם ללוגיקה של הרשאות הגישה שדומה לכל הכללים האחרים. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12933.
תגים:loading_and_analysis
,incompatible_change
- ברירת מחדל של
--[no]incompatible_enforce_config_setting_visibility
: "true" -
אם המדיניות מוגדרת כ-True, יש לאכוף את הרשאות הגישה מסוג config_setting. אם הערך הוא False, כל config_setting גלויה לכל יעד. הסבר זמין בכתובת https://github.com/bazelbuild/bazel/issues/12932.
תגים:loading_and_analysis
,incompatible_change
- אפשרויות שקשורות לפלט Bzlmod וסמנטיקה:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- ברירת מחדל של
--experimental_repository_resolved_file=<a string>
: "" -
אם לא ריק, כותבים ערך של Starlark עם הפרטים שנפתרו לגבי כל כללי המאגר של Starlark שבוצעו.
תגים:affects_outputs
- ברירת מחדל של
--remote_print_execution_messages=<failure, success or all>
: "failure" -
אתם יכולים לבחור מתי תרצו להדפיס הודעות של ביצוע מרחוק. הערכים התקינים הם 'כשל', כדי להדפיס רק כשלים, 'הצלחה' כדי להדפיס רק את ההצלחות, ו'הכול' כדי להדפיס תמיד.
תגים:terminal_output
- אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- ברירת מחדל של
--[no]experimental_guard_against_concurrent_changes
: "false" - כדי להשבית את הבדיקה של קובצי קלט עבור פעולה מסוימת לפני שמעלים אותה למטמון מרוחק, יש להשבית את הזמן. ייתכנו מקרים שבהם הליבה של Linux מעכבת כתיבה של קבצים, מה שעלול לגרום לתוצאות חיוביות שקריות.
- ברירת מחדל של
--experimental_remote_build_event_upload=<all or minimal>
: "all" - אם המדיניות מוגדרת כ-'all' כל הפלט המקומי שאליו מפנה BEP מועלה למטמון מרוחק. אם המדיניות מוגדרת כ-'minimal' פלטים מקומיים ש-BEP מפנה אליהם לא מועלים למטמון המרוחק, מלבד קבצים שחשובים לצרכנים של BEP (למשל יומני בדיקה ופרופיל תזמון). סכימת //:file משמשת לנתיבים של קבצים מקומיים וסכימת בייטstream:// משמשת לנתיבים של קבצים שהועלו (כבר). ברירת המחדל היא 'all'.
- ברירת מחדל של
--[no]experimental_remote_cache_async
: "false" - אם הערך הוא TRUE, מטמון I/O מרוחק יתרחש ברקע במקום להיווצר כחלק מ-S מדויקת.
- ברירת מחדל של
--[no]experimental_remote_cache_compression
: "false" - אם האפשרות מופעלת, אפשר לדחוס או לפרוס בועות של מטמון עם zstd.
- ברירת מחדל של
--experimental_remote_capture_corrupted_outputs=<a path>
: תיאור - נתיב לספרייה שבה יילכו פלטים פגומים.
- ברירת מחדל של
--experimental_remote_downloader=<a string>
: תיאור - URI של נקודת קצה ל-API של נכס מרוחק, שישמש כשרת proxy להורדה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. בכתובת: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- ברירת מחדל של
--[no]experimental_remote_downloader_local_fallback
: "false" - אם אתם רוצים לחזור לכלי ההורדה המקומי, אם ההורדה מרחוק נכשלה.
- ברירת מחדל של
--[no]experimental_remote_execution_keepalive
: "false" - האם להשתמש ב-Keepalive בשיחות ביצוע מרחוק?
- ברירת מחדל של
--experimental_remote_grpc_log=<a path>
: תיאור - אם צוין, נתיב לקובץ שבו יתבצע רישום של פרטים הקשורים לשיחת gRPC. היומן הזה מורכב מרצף של com.google.devtools.build.lib.remote.logging.remoteExecutionLog.LogEntry Protobufs עם כל הודעה המסומנת ב-varint המציין את גודל ההודעה הבאה עם פסיק.
- ברירת מחדל של
--[no]experimental_remote_mark_tool_inputs
: "false" - אם היא מוגדרת כ-True, ה-Bazel יסמן את הקלט בתור קלט לכלי הפעולה מרחוק. אפשר להשתמש באפשרות הזאת כדי להטמיע עובדים קבועים מרחוק.
- ברירת מחדל של
--[no]experimental_remote_merkle_tree_cache
: "false" - אם המדיניות מוגדרת כ-True, החישובים של עץ ה-Merkle יסונכרנו כדי לשפר את מהירות הבדיקה של ההיט המרוחק. ביצועי טביעת הרגל בזיכרון של המטמון נקבעים על ידי -experimental_remote_merkle_tree_cache_size.
- ברירת מחדל של
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - מספר עצי ה-Merkle שיש לזכור כדי לשפר את מהירות הבדיקה של ההיט המרוחק. אף על פי שהמטמון נחתך באופן אוטומטי בהתאם לטיפול בהפניות רכות של Java', יכול להיות ששגיאות "חסרות זיכרון" עלולות להיווצר אם הן גבוהות מדי. אם המדיניות מוגדרת כ-0, גודל המטמון הוא בלתי מוגבל. הערך האופטימלי משתנה בהתאם לגודל הפרויקט. ערך ברירת המחדל הוא 1,000.
- ברירת מחדל של
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - אם המדיניות מוגדרת כ-True, פלטים שאליהם מפנה BEP לא יועלו למטמון מרוחק אם לא ניתן יהיה לשמור במטמון את פעולת היצירה מרחוק.
- ברירת מחדל של
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
האם לשלוח את כל הערכים של כותרת רבת-ערך להורדה מרחוק ולא רק הראשונה.
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
אם המדיניות מוגדרת כ-True, נתיבי הפלט הם יחסיים לשורש הקלט במקום לספרייה הפעילה.
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_remote_results_ignore_disk
: "true" -
אם המדיניות מוגדרת כ-True, --noremote_upload_local_results ו--noremote_Accept_cached לא יחולו על מטמון הדיסק. אם נעשה שימוש במטמון משולב:
--noremote_upload_local_results יגרום לכתיבה של תוצאות במטמון הדיסק, אבל לא להעלאה למטמון המרוחק.
--noremote_confirm_cached יוביל לבדיקה של Bazel בתוצאות החיפוש במטמון הדיסק, אבל לא במטמון המרוחק.
פעולות ללא הפעלה מרחוק יכולות לפגוע במטמון הדיסק.
פרטים נוספים זמינים בדף #8216.
תגים:incompatible_change
- ברירת מחדל של
--[no]remote_accept_cached
: "true" - האם לקבל תוצאות של פעולות שנשמרו במטמון מרחוק?
- ברירת מחדל של
--remote_bytestream_uri_prefix=<a string>
: תיאור - שם המארח ושם המופע לשימוש ב-URI של בייט-בייט שכתובים במקורות נתונים של אירועים. אפשר להגדיר את האפשרות הזו כשמבצעים גרסאות build באמצעות שרת proxy. כתוצאה מכך, הערכים של -remote_executor ו--remote_instance_name לא תואמים יותר לשם הקנוני של שירות הביצוע מרחוק. אם היא לא מוגדרת, ברירת המחדל היא "${hostname}/${instance_name}".
- ברירת מחדל של
--remote_cache=<a string>
: תיאור - URI של נקודת קצה לשמירה במטמון. הסכימות הנתמכות הן http, https, grpc, grpcs (grpc עם TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. מציינים grpc://, http:// או Unix: כדי להשבית TLS. כדאי לעיין בכתובת https://bazel.build/remote/caching
- נצברו
--remote_cache_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות שנשמרו במטמון: --remote_cache_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- נצברו
--remote_default_exec_properties=<a 'name=value' assignment>
שימושים מרובים -
מגדירים את מאפייני ברירת המחדל של exe שישמשו כפלטפורמת הביצוע מרחוק, אם פלטפורמת ביצוע עדיין לא הגדירה exec_properties.
תגים:affects_outputs
- ברירת מחדל של
--remote_default_platform_properties=<a string>
: "" - מגדירים את מאפייני הפלטפורמה שמוגדרים כברירת מחדל ל-API לביצוע מרחוק, אם פלטפורמת הביצוע לא מוגדרת עדיין Remote_execution_property. המערכת תשתמש בערך הזה גם אם פלטפורמת המארח נבחרה כפלטפורמת ההפעלה לביצוע מרחוק.
- נצברו
--remote_downloader_header=<a 'name=value' assignment>
שימושים מרובים - יש לקבוע כותרת שתיכלל בבקשות להורדה מרחוק: --remote_downloader_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- נצברו
--remote_exec_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות ביצוע: --remote_exec_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- ברירת מחדל של
--remote_execution_priority=<an integer>
: "0" - העדיפות היחסית של הפעולות שיש לבצע מרחוק. הסמנטיקה של ערכי העדיפות הספציפית היא תלויה בשרת.
- ברירת מחדל של
--remote_executor=<a string>
: תיאור - מארח או מתארח:יציאה של נקודת קצה להפעלה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. צריך לציין grpc:// או Unix: כדי להשבית TLS.
- נצברו
--remote_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות: --remote_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- ברירת מחדל של
--remote_instance_name=<a string>
: "" - הערך שמועבר כ-Instance_name ב-API לביצוע מרחוק.
- ברירת מחדל של
--[no]remote_local_fallback
: "false" - האם לחזור לשיטה עצמאית של הפעלה מקומית אם ביצוע ההעברה מרחוק נכשל?
- ברירת מחדל של
--remote_local_fallback_strategy=<a string>
: "local" - לא, הוצא משימוש. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/7480.
- ברירת מחדל של
--remote_max_connections=<an integer>
: "100" -
הגבלת המספר המקסימלי של חיבורים בו-זמנית למטמון/קובץ הפעלה מרחוק. כברירת מחדל, הערך הוא 100. אם מגדירים את הערך כ-0, אין הגבלה.
עבור מטמון של HTTP מרחוק, חיבור TCP אחד יכול לטפל בבקשה אחת בכל פעם, כך ש-Bazel יכול לבצע בקשות בו-זמנית עד ל-remote_max_connections.
ב-gRPC מרוחק, יכול להיות שערוץ אחד בשם gRPC יוכל לטפל ביותר מ-100 בקשות בו-זמנית. לכן, Bazel יכולה לשלוח בקשות '--remote_max_connections * 100' בו-זמנית.
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--remote_proxy=<a string>
: תיאור - מתחברים למטמון המרוחק דרך שרת proxy. כרגע אפשר להשתמש בסימון הזה רק כדי להגדיר שקע דומיין (Unix:/path/to/socket) ב-Unix:
- ברירת מחדל של
--remote_result_cache_priority=<an integer>
: "0" - העדיפות היחסית של פעולות מרוחקות שנשמרו במטמון מרוחק. הסמנטיקה של ערכי העדיפות הספציפית היא תלויה בשרת.
- ברירת מחדל של
--remote_retries=<an integer>
: "5" - מספר הניסיונות המקסימלי לנסות שוב שגיאה זמנית. אם המדיניות מוגדרת כ-0, ניסיונות חוזרים מושבתים.
- ברירת מחדל של
--remote_timeout=<An immutable length of time.>
: "60s" - משך הזמן המרבי להמתנה לביצוע מרחוק ולשיחות במטמון. למטמון REST, זהו גם החיבור וגם הזמן הקצוב לתפוגה של קריאה. אפשר להשתמש ביחידות הבאות: ימים (d), שעות (h), דקות (m), שניות (s) ואלפיות שנייה (אלפיות השנייה). אם משמיטים את היחידה, הערך מפורש כשניות.
- ברירת מחדל של
--[no]remote_upload_local_results
: "true" - האם להעלות למטמון המרוחק תוצאות של פעולות שבוצעו באופן מקומי?
- ברירת מחדל של
--[no]remote_verify_downloads
: "true" - אם היא מוגדרת כ-true, Bazel תחשב את סכום הגיבוב של כל ההורדות המרוחקות ותשליך את הערכים השמורים במטמון מרחוק אם הם לא תואמים לערך הצפוי.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- ברירת מחדל של
--deleted_packages=<comma-separated list of package names>
: "" - רשימה של שמות של חבילות, מופרדים בפסיקים, שמערכת ה-build תתייחס אליהם שאינם קיימים, גם אם הם מוצגים במקום כלשהו בנתיב החבילה. כדאי להשתמש באפשרות הזו כשמוחקים חבילת משנה 'x/y' של חבילה קיימת 'x' לדוגמה, לאחר מחיקת x/y/BUILD בלקוח, מערכת ה-build עשויה להתלונן אם היא תיתקל בתווית '//x:y/z' אם היא עדיין מסופקת על ידי ערך package_path אחר. ציון [delete_packs x/y] מונע את הבעיה הזו.
- ברירת מחדל של
--disk_cache=<a path>
: תיאור - נתיב לספרייה שבה Bazel יכולה לקרוא ולכתוב פעולות ופלטי פעולות. אם הספרייה לא קיימת, היא תיווצר.
- נצברו
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
שימושים מרובים - הגדרת עזרה לגבי פרטי כניסה לשימוש באחזור פרטי הכניסה של ההיקף (דומיין). פרטי כניסה מ-credentials Credentials מקבלים עדיפות על פני פרטי כניסה מ-<code>--google_default_credentials</code>, `--google_credentials` או <code>.netrc</code>. אפשר לראות אותם בכתובת https://github.com/bazelbuild/proposs22-z
- ברירת מחדל של
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30m" - ההגדרה קובעת את משך הזמן שבו פרטי הכניסה ששמורים ב'פרטי כניסה' יישמרו במטמון.
- ברירת מחדל של
--experimental_credential_helper_timeout=<An immutable length of time.>
: "5s" - הגדרת הזמן הקצוב לתפוגה עבור 'פרטי הכניסה'. עוזרי הכניסה שלא יגיבו בזמן הקצוב לתפוגה ייכשלו.
- ברירת מחדל של
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - רשימה של היקפי אימות ב-Google Cloud, המופרדים באמצעות פסיקים.
- ברירת מחדל של
--google_credentials=<a string>
: תיאור - ההגדרה קובעת את הקובץ שממנו יתקבלו פרטי הכניסה לאימות. פרטים נוספים זמינים בכתובת https://cloud.google.com/docs/authentication.
- ברירת מחדל של
--[no]google_default_credentials
: "false" - אם צריך להשתמש ב 'פרטי הכניסה שמוגדרים כברירת מחדל באפליקציית Google' לאימות. פרטים נוספים זמינים בכתובת https://cloud.google.com/docs/authentication. מושבת כברירת מחדל.
- ברירת מחדל של
--grpc_keepalive_time=<An immutable length of time.>
: תיאור - הגדרת פינגים בשידור חי עבור חיבורי gRPC יוצאים. אם המדיניות הזו מוגדרת, Bazel שולחת פינגים אחרי פרק הזמן הזה ללא פעולות קריאה בחיבור, אבל רק אם יש לפחות קריאה אחת אחת מסוג gRPC בהמתנה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. פינגים בשידור חי מושבתים כברירת מחדל. עליך לתאם עם בעל השירות לפני הפעלת ההגדרה הזו. לדוגמה, כדי להגדיר ערך של 30 שניות לסימון הזה, צריך לעשות זאת כך: grpc_keepalive_time=30s
- ברירת מחדל של
--grpc_keepalive_timeout=<An immutable length of time.>
: "20s" - הגדרת זמן קצוב לתפוגה של שמירת נתונים פעילה עבור חיבורי gRPC יוצאים. אם פינגים מסוג keep-alive מופעלים באמצעות --grpc_keepalive_time, תם הזמן הקצוב (Bazel) של Bazel אם לא מתקבלת פינג אחרי פרק הזמן הזה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. אם פינגים פעילים נשארים מושבתים, המערכת מתעלמת מההגדרה הזו.
- נצברו
--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 להדפיס הודעות &&;טעינת חבילה:".
- ברירת מחדל של
--tls_certificate=<a string>
: תיאור - יש לציין נתיב לאישור TLS שהוא מהימן לחתימה על אישורי שרת.
- ברירת מחדל של
--tls_client_certificate=<a string>
: תיאור - ציון אישור הלקוח של TLS (אבטחת שכבת התעבורה) לשימוש. צריך גם לספק מפתח לקוח כדי להפעיל אימות לקוח.
- ברירת מחדל של
--tls_client_key=<a string>
: תיאור - צריך לציין את מפתח הלקוח ב-TLS שבו רוצים להשתמש. צריך גם לספק אישור לקוח כדי להפעיל את אימות הלקוח.
אפשרויות בדיקה
העברה בירושה את כל האפשרויות מיצירה.
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות ששולטות בהפעלה של גרסת build:
- ברירת מחדל של
--[no]incompatible_remote_dangling_symlinks
: "true" -
אם המדיניות מוגדרת כ-True ו- --incompatible_remote_symlinks הוא גם נכון, קישורים מסולסלים בפלטי פעולה מורשים להתנתק.
תגים:execution
,incompatible_change
- ברירת מחדל של
--[no]incompatible_remote_symlinks
: "true" -
אם המדיניות מוגדרת כ-TRUE, Bazel תייצג קישורים סימבוליים בפלטי פעולות בפרוטוקול השמירה במטמון/הביצוע מרחוק. אחרת, יתבצע מעקב אחר קישורים סימבוליים ויוצגו כקבצים או כספריות. פרטים נוספים זמינים בדף #6631.
תגים:execution
,incompatible_change
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך, בניגוד לקיומו:
- ברירת מחדל של
--bep_maximum_open_remote_upload_files=<an integer>
: "-1" -
המספר המקסימלי של קבצים פתוחים מותר במהלך העלאת תוכן של BEP.
תגים:affects_outputs
--remote_download_minimal
-
לא תתבצע הורדה של פלטי build מרוחקים אל המכונה המקומית. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=minimal.
הרחבה אל:
--nobuild_runfile_links
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=minimal
תגים:affects_outputs
- ברירת מחדל של
--remote_download_outputs=<all, minimal or toplevel>
: "all" -
אם המדיניות מוגדרת כ-'minimal' לא מורידה פלט של build מרחוק אל המכונה המקומית, חוץ מאלה הנדרשות על ידי פעולות מקומיות. אם המדיניות מוגדרת כ-'toplevel' היא פועלת כך'minimal' מלבד זאת, מתבצעת הורדה של פלט של יעדים ברמה העליונה למחשב המקומי. שתי האפשרויות יכולות לקצר משמעותית את זמני הבנייה אם רוחב הפס של הרשת הוא צוואר בקבוק.
תגים:affects_outputs
- ברירת מחדל של
--remote_download_symlink_template=<a string>
: "" -
במקום להוריד פלט של build מרחוק, אפשר ליצור קישורים סימבוליים. ניתן לציין את יעד הקישורים המסמלים בצורת מחרוזת תבנית. מחרוזת התבנית הזו עשויה להכיל {hash} ו-{size_bytes} שמתרחבים לאובייקט ולגודל בבייטים, בהתאמה. הקישורים הסמליים האלה עשויים, למשל, להפנות למערכת קבצים של FUSE שטוענת אובייקטים מ-CAS לפי דרישה.
תגים:affects_outputs
--remote_download_toplevel
-
רק מכונה מקומית יכולה להוריד פלט מרחוק של יעדים ברמה העליונה. הדגל הזה הוא קיצור דרך לשלושה סימונים: --experimental_inmemory_jdeps_files, --experimental_inmemory_dotd_files ו--remote_download_פלטs=toplevel.
מתרחבת אל:
--experimental_inmemory_jdeps_files
--experimental_inmemory_dotd_files
--remote_download_outputs=toplevel
תגים:affects_outputs
- אפשרויות שמשפיעות על רמת האכיפה התקינה של Bazel על קלט קלט (הגדרות של כללים, שילובי דגל וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- ברירת מחדל של
--[no]print_relative_test_log_paths
: "false" -
אם הערך הוא true, כשמדפיסים את הנתיב ליומן בדיקה, צריך להשתמש בנתיב יחסי שעושה שימוש בקישור העומק 'testlogs' . N.B. - התקנה נוספת של 'build'/'test'/etc
תגים:affects_outputs
- ברירת מחדל של
--remote_print_execution_messages=<failure, success or all>
: "failure" -
אתם יכולים לבחור מתי תרצו להדפיס הודעות של ביצוע מרחוק. הערכים התקינים הם 'כשל', כדי להדפיס רק כשלים, 'הצלחה' כדי להדפיס רק את ההצלחות, ו'הכול' כדי להדפיס תמיד.
תגים:terminal_output
- ברירת מחדל של
--[no]test_verbose_timeout_warnings
: "false" -
אם הערך הוא true, יש להדפיס אזהרות נוספות כאשר זמן הביצוע של הבדיקה בפועל לא תואם לזמן הקצוב לתפוגה שהוגדר על ידי הבדיקה (בין אם הוא מפורש או מפורש).
תגים:affects_outputs
- ברירת מחדל של
--[no]verbose_test_summary
: "true" -
אם הערך הוא true, יש להדפיס מידע נוסף (תזמון, מספר הפעלות שנכשלו וכו') בסיכום הבדיקה.
תגים:affects_outputs
- אפשרויות שמגדירות או משנות קלט כללי לפקודה Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- ברירת מחדל של
--[no]experimental_guard_against_concurrent_changes
: "false" - כדי להשבית את הבדיקה של קובצי קלט עבור פעולה מסוימת לפני שמעלים אותה למטמון מרוחק, יש להשבית את הזמן. ייתכנו מקרים שבהם הליבה של Linux מעכבת כתיבה של קבצים, מה שעלול לגרום לתוצאות חיוביות שקריות.
- ברירת מחדל של
--experimental_remote_build_event_upload=<all or minimal>
: "all" - אם המדיניות מוגדרת כ-'all' כל הפלט המקומי שאליו מפנה BEP מועלה למטמון מרוחק. אם המדיניות מוגדרת כ-'minimal' פלטים מקומיים ש-BEP מפנה אליהם לא מועלים למטמון המרוחק, מלבד קבצים שחשובים לצרכנים של BEP (למשל יומני בדיקה ופרופיל תזמון). סכימת //:file משמשת לנתיבים של קבצים מקומיים וסכימת בייטstream:// משמשת לנתיבים של קבצים שהועלו (כבר). ברירת המחדל היא 'all'.
- ברירת מחדל של
--[no]experimental_remote_cache_async
: "false" - אם הערך הוא TRUE, מטמון I/O מרוחק יתרחש ברקע במקום להיווצר כחלק מ-S מדויקת.
- ברירת מחדל של
--[no]experimental_remote_cache_compression
: "false" - אם האפשרות מופעלת, אפשר לדחוס או לפרוס בועות של מטמון עם zstd.
- ברירת מחדל של
--experimental_remote_capture_corrupted_outputs=<a path>
: תיאור - נתיב לספרייה שבה יילכו פלטים פגומים.
- ברירת מחדל של
--experimental_remote_downloader=<a string>
: תיאור - URI של נקודת קצה ל-API של נכס מרוחק, שישמש כשרת proxy להורדה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. בכתובת: https://github.com/bazelbuild/remote-apis/blob/master/build/bazel/remote/asset/v1/remote_asset.proto
- ברירת מחדל של
--[no]experimental_remote_downloader_local_fallback
: "false" - אם אתם רוצים לחזור לכלי ההורדה המקומי, אם ההורדה מרחוק נכשלה.
- ברירת מחדל של
--[no]experimental_remote_execution_keepalive
: "false" - האם להשתמש ב-Keepalive בשיחות ביצוע מרחוק?
- ברירת מחדל של
--experimental_remote_grpc_log=<a path>
: תיאור - אם צוין, נתיב לקובץ שבו יתבצע רישום של פרטים הקשורים לשיחת gRPC. היומן הזה מורכב מרצף של com.google.devtools.build.lib.remote.logging.remoteExecutionLog.LogEntry Protobufs עם כל הודעה המסומנת ב-varint המציין את גודל ההודעה הבאה עם פסיק.
- ברירת מחדל של
--[no]experimental_remote_mark_tool_inputs
: "false" - אם היא מוגדרת כ-True, ה-Bazel יסמן את הקלט בתור קלט לכלי הפעולה מרחוק. אפשר להשתמש באפשרות הזאת כדי להטמיע עובדים קבועים מרחוק.
- ברירת מחדל של
--[no]experimental_remote_merkle_tree_cache
: "false" - אם המדיניות מוגדרת כ-True, החישובים של עץ ה-Merkle יסונכרנו כדי לשפר את מהירות הבדיקה של ההיט המרוחק. ביצועי טביעת הרגל בזיכרון של המטמון נקבעים על ידי -experimental_remote_merkle_tree_cache_size.
- ברירת מחדל של
--experimental_remote_merkle_tree_cache_size=<a long integer>
: "1000" - מספר עצי ה-Merkle שיש לזכור כדי לשפר את מהירות הבדיקה של ההיט המרוחק. אף על פי שהמטמון נחתך באופן אוטומטי בהתאם לטיפול בהפניות רכות של Java', יכול להיות ששגיאות "חסרות זיכרון" עלולות להיווצר אם הן גבוהות מדי. אם המדיניות מוגדרת כ-0, גודל המטמון הוא בלתי מוגבל. הערך האופטימלי משתנה בהתאם לגודל הפרויקט. ערך ברירת המחדל הוא 1,000.
- ברירת מחדל של
--[no]incompatible_remote_build_event_upload_respect_no_cache
: "false" - אם המדיניות מוגדרת כ-True, פלטים שאליהם מפנה BEP לא יועלו למטמון מרוחק אם לא ניתן יהיה לשמור במטמון את פעולת היצירה מרחוק.
- ברירת מחדל של
--[no]incompatible_remote_downloader_send_all_headers
: "true" -
האם לשלוח את כל הערכים של כותרת רבת-ערך להורדה מרחוק ולא רק הראשונה.
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_remote_output_paths_relative_to_input_root
: "false" -
אם המדיניות מוגדרת כ-True, נתיבי הפלט הם יחסיים לשורש הקלט במקום לספרייה הפעילה.
תגים:incompatible_change
- ברירת מחדל של
--[no]incompatible_remote_results_ignore_disk
: "true" -
אם המדיניות מוגדרת כ-True, --noremote_upload_local_results ו--noremote_Accept_cached לא יחולו על מטמון הדיסק. אם נעשה שימוש במטמון משולב:
--noremote_upload_local_results יגרום לכתיבה של תוצאות במטמון הדיסק, אבל לא להעלאה למטמון המרוחק.
--noremote_confirm_cached יוביל לבדיקה של Bazel בתוצאות החיפוש במטמון הדיסק, אבל לא במטמון המרוחק.
פעולות ללא הפעלה מרחוק יכולות לפגוע במטמון הדיסק.
פרטים נוספים זמינים בדף #8216.
תגים:incompatible_change
- ברירת מחדל של
--[no]remote_accept_cached
: "true" - האם לקבל תוצאות של פעולות שנשמרו במטמון מרחוק?
- ברירת מחדל של
--remote_bytestream_uri_prefix=<a string>
: תיאור - שם המארח ושם המופע לשימוש ב-URI של בייט-בייט שכתובים במקורות נתונים של אירועים. אפשר להגדיר את האפשרות הזו כשמבצעים גרסאות build באמצעות שרת proxy. כתוצאה מכך, הערכים של -remote_executor ו--remote_instance_name לא תואמים יותר לשם הקנוני של שירות הביצוע מרחוק. אם היא לא מוגדרת, ברירת המחדל היא "${hostname}/${instance_name}".
- ברירת מחדל של
--remote_cache=<a string>
: תיאור - URI של נקודת קצה לשמירה במטמון. הסכימות הנתמכות הן http, https, grpc, grpcs (grpc עם TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. מציינים grpc://, http:// או Unix: כדי להשבית TLS. כדאי לעיין בכתובת https://bazel.build/remote/caching
- נצברו
--remote_cache_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות שנשמרו במטמון: --remote_cache_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- נצברו
--remote_default_exec_properties=<a 'name=value' assignment>
שימושים מרובים -
מגדירים את מאפייני ברירת המחדל של exe שישמשו כפלטפורמת הביצוע מרחוק, אם פלטפורמת ביצוע עדיין לא הגדירה exec_properties.
תגים:affects_outputs
- ברירת מחדל של
--remote_default_platform_properties=<a string>
: "" - מגדירים את מאפייני הפלטפורמה שמוגדרים כברירת מחדל ל-API לביצוע מרחוק, אם פלטפורמת הביצוע לא מוגדרת עדיין Remote_execution_property. המערכת תשתמש בערך הזה גם אם פלטפורמת המארח נבחרה כפלטפורמת ההפעלה לביצוע מרחוק.
- נצברו
--remote_downloader_header=<a 'name=value' assignment>
שימושים מרובים - יש לקבוע כותרת שתיכלל בבקשות להורדה מרחוק: --remote_downloader_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- נצברו
--remote_exec_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות ביצוע: --remote_exec_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- ברירת מחדל של
--remote_execution_priority=<an integer>
: "0" - העדיפות היחסית של הפעולות שיש לבצע מרחוק. הסמנטיקה של ערכי העדיפות הספציפית היא תלויה בשרת.
- ברירת מחדל של
--remote_executor=<a string>
: תיאור - מארח או מתארח:יציאה של נקודת קצה להפעלה מרחוק. הסכימות הנתמכות הן grpc, grpcs (grpc כאשר TLS מופעל) ו-unis (שקעי UNIX מקומיים). אם לא סופקה סכימה, Bazel תוגדר כברירת מחדל כ-grpcs. צריך לציין grpc:// או Unix: כדי להשבית TLS.
- נצברו
--remote_header=<a 'name=value' assignment>
שימושים מרובים - יש לציין כותרת שתיכלל בבקשות: --remote_header=Name=Value. ניתן להעביר כותרות מרובות על ידי ציון הדגל מספר פעמים. ערכים מרובים עבור אותו שם יומרו לרשימה המופרדת בפסיקים.
- ברירת מחדל של
--remote_instance_name=<a string>
: "" - הערך שמועבר כ-Instance_name ב-API לביצוע מרחוק.
- ברירת מחדל של
--[no]remote_local_fallback
: "false" - האם לחזור לשיטה עצמאית של הפעלה מקומית אם ביצוע ההעברה מרחוק נכשל?
- ברירת מחדל של
--remote_local_fallback_strategy=<a string>
: "local" - לא, הוצא משימוש. פרטים נוספים זמינים בכתובת https://github.com/bazelbuild/bazel/issues/7480.
- ברירת מחדל של
--remote_max_connections=<an integer>
: "100" -
הגבלת המספר המקסימלי של חיבורים בו-זמנית למטמון/קובץ הפעלה מרחוק. כברירת מחדל, הערך הוא 100. אם מגדירים את הערך כ-0, אין הגבלה.
עבור מטמון של HTTP מרחוק, חיבור TCP אחד יכול לטפל בבקשה אחת בכל פעם, כך ש-Bazel יכול לבצע בקשות בו-זמנית עד ל-remote_max_connections.
ב-gRPC מרוחק, יכול להיות שערוץ אחד בשם gRPC יוכל לטפל ביותר מ-100 בקשות בו-זמנית. לכן, Bazel יכולה לשלוח בקשות '--remote_max_connections * 100' בו-זמנית.
תגים:host_machine_resource_optimizations
- ברירת מחדל של
--remote_proxy=<a string>
: תיאור - מתחברים למטמון המרוחק דרך שרת proxy. כרגע אפשר להשתמש בסימון הזה רק כדי להגדיר שקע דומיין (Unix:/path/to/socket) ב-Unix:
- ברירת מחדל של
--remote_result_cache_priority=<an integer>
: "0" - העדיפות היחסית של פעולות מרוחקות שנשמרו במטמון מרוחק. הסמנטיקה של ערכי העדיפות הספציפית היא תלויה בשרת.
- ברירת מחדל של
--remote_retries=<an integer>
: "5" - מספר הניסיונות המקסימלי לנסות שוב שגיאה זמנית. אם המדיניות מוגדרת כ-0, ניסיונות חוזרים מושבתים.
- ברירת מחדל של
--remote_timeout=<An immutable length of time.>
: "60s" - משך הזמן המרבי להמתנה לביצוע מרחוק ולשיחות במטמון. למטמון REST, זהו גם החיבור וגם הזמן הקצוב לתפוגה של קריאה. אפשר להשתמש ביחידות הבאות: ימים (d), שעות (h), דקות (m), שניות (s) ואלפיות שנייה (אלפיות השנייה). אם משמיטים את היחידה, הערך מפורש כשניות.
- ברירת מחדל של
--[no]remote_upload_local_results
: "true" - האם להעלות למטמון המרוחק תוצאות של פעולות שבוצעו באופן מקומי?
- ברירת מחדל של
--[no]remote_verify_downloads
: "true" - אם היא מוגדרת כ-true, Bazel תחשב את סכום הגיבוב של כל ההורדות המרוחקות ותשליך את הערכים השמורים במטמון מרחוק אם הם לא תואמים לערך הצפוי.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- ברירת מחדל של
--disk_cache=<a path>
: תיאור - נתיב לספרייה שבה Bazel יכולה לקרוא ולכתוב פעולות ופלטי פעולות. אם הספרייה לא קיימת, היא תיווצר.
- נצברו
--experimental_credential_helper=<An (unresolved) path to a credential helper for a scope.>
שימושים מרובים - הגדרת עזרה לגבי פרטי כניסה לשימוש באחזור פרטי הכניסה של ההיקף (דומיין). פרטי כניסה מ-credentials Credentials מקבלים עדיפות על פני פרטי כניסה מ-<code>--google_default_credentials</code>, `--google_credentials` או <code>.netrc</code>. אפשר לראות אותם בכתובת https://github.com/bazelbuild/proposs22-z
- ברירת מחדל של
--experimental_credential_helper_cache_duration=<An immutable length of time.>
: "30m" - ההגדרה קובעת את משך הזמן שבו פרטי הכניסה ששמורים ב'פרטי כניסה' יישמרו במטמון.
- ברירת מחדל של
--experimental_credential_helper_timeout=<An immutable length of time.>
: "5s" - הגדרת הזמן הקצוב לתפוגה עבור 'פרטי הכניסה'. עוזרי הכניסה שלא יגיבו בזמן הקצוב לתפוגה ייכשלו.
- ברירת מחדל של
--google_auth_scopes=<comma-separated list of options>
: "https://www.googleapis.com/auth/cloud-platform" - רשימה של היקפי אימות ב-Google Cloud, המופרדים באמצעות פסיקים.
- ברירת מחדל של
--google_credentials=<a string>
: תיאור - ההגדרה קובעת את הקובץ שממנו יתקבלו פרטי הכניסה לאימות. פרטים נוספים זמינים בכתובת https://cloud.google.com/docs/authentication.
- ברירת מחדל של
--[no]google_default_credentials
: "false" - אם צריך להשתמש ב 'פרטי הכניסה שמוגדרים כברירת מחדל באפליקציית Google' לאימות. פרטים נוספים זמינים בכתובת https://cloud.google.com/docs/authentication. מושבת כברירת מחדל.
- ברירת מחדל של
--grpc_keepalive_time=<An immutable length of time.>
: תיאור - הגדרת פינגים בשידור חי עבור חיבורי gRPC יוצאים. אם המדיניות הזו מוגדרת, Bazel שולחת פינגים אחרי פרק הזמן הזה ללא פעולות קריאה בחיבור, אבל רק אם יש לפחות קריאה אחת אחת מסוג gRPC בהמתנה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. פינגים בשידור חי מושבתים כברירת מחדל. עליך לתאם עם בעל השירות לפני הפעלת ההגדרה הזו. לדוגמה, כדי להגדיר ערך של 30 שניות לסימון הזה, צריך לעשות זאת כך: grpc_keepalive_time=30s
- ברירת מחדל של
--grpc_keepalive_timeout=<An immutable length of time.>
: "20s" - הגדרת זמן קצוב לתפוגה של שמירת נתונים פעילה עבור חיבורי gRPC יוצאים. אם פינגים מסוג keep-alive מופעלים באמצעות --grpc_keepalive_time, תם הזמן הקצוב (Bazel) של Bazel אם לא מתקבלת פינג אחרי פרק הזמן הזה. זמנים נחשבים לרמת פירוט שנייה. זו שגיאה בהגדרת ערך של פחות משנייה אחת. אם פינגים פעילים נשארים מושבתים, המערכת מתעלמת מההגדרה הזו.
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
- ברירת מחדל של
--tls_certificate=<a string>
: תיאור - יש לציין נתיב לאישור TLS שהוא מהימן לחתימה על אישורי שרת.
- ברירת מחדל של
--tls_client_certificate=<a string>
: תיאור - ציון אישור הלקוח של TLS (אבטחת שכבת התעבורה) לשימוש. צריך גם לספק מפתח לקוח כדי להפעיל אימות לקוח.
- ברירת מחדל של
--tls_client_key=<a string>
: תיאור - צריך לציין את מפתח הלקוח ב-TLS שבו רוצים להשתמש. צריך גם לספק אישור לקוח כדי להפעיל את אימות הלקוח.
אפשרויות גרסה
- אפשרויות שמופיעות לפני הפקודה ומנותחות על ידי הלקוח:
- נצברו
--distdir=<a path>
שימושים מרובים -
מקומות נוספים שבהם אפשר לחפש ארכיונים לפני גישה לרשת כדי להוריד אותם.
תגים:bazel_internal_configuration
- ברירת מחדל של
--[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
- ברירת מחדל של
--repository_cache=<a path>
: תיאור -
ההגדרה קובעת את מיקום המטמון של הערכים שהורדו במהלך האחזור של מאגרים חיצוניים. מחרוזת ריקה כארגומנט שיש להשבית את המטמון.
תגים:bazel_internal_configuration
- אפשרויות שמאפשרות למשתמש להגדיר את הפלט הרצוי, שמשפיעות על הערך שלו, בניגוד לקיומו:
- ברירת מחדל של
--[no]gnu_format
: "false" -
אם המדיניות מוגדרת, כותבים את ה-stdout לפי המוסכמות המתוארות בסטנדרטים של GNU.
תגים:affects_outputs
,execution
- אפשרויות שמשפיעות על מידת האכיפה הספציפית של Bazel על קלט חוקי (הגדרות של כללים, שילובי דגלים וכו'):
- ברירת מחדל של
--experimental_repository_hash_file=<a string>
: "" -
אם הקובץ לא ריק, המדיניות מציינת קובץ שמכיל ערך שהסתיים, עם אימות של גיבובי המאגרים במאגר
תגים:affects_outputs
,experimental
- נצברו
--experimental_verify_repository_rules=<a string>
שימושים מרובים -
אם רשימה של כללי מאגר שעבורם צריך לאמת את הגיבוב של ספריית הפלט, יש לציין קובץ בשם --experimental_repository_hash_file.
תגים:affects_outputs
,experimental
- האפשרות הזו משפיעה על הסמנטיקה של שפת Starlark או על ה-API של Build שניתן לגשת אליו מקובצי BUILD, קובצי bzl או WORKSPACE.:
- ברירת מחדל של
--[no]experimental_allow_top_level_aspects_parameters
: "true" -
לא:
תגים:no_op
,deprecated
,experimental
- אפשרויות שקשורות לפלט ובסמנטיקה של Bzlmod:
- נצברו
--allow_yanked_versions=<a string>
שימושים מרובים -
יש לציין את גרסאות המודול בפורמט `<module1>@<version1>,ltlt;module2>@<version2>` שיאושרו בתרשים התלות שנפתר גם אם הן הוצהרו כדפים שנחתמו במרשם (שמקורם בו) שאינם מרשם. אחרת, גרסאות משובשות יגרמו לכשל בפתרון. אפשר גם להגדיר גרסה מורשית של ג'אז עם המשתנה 'BZLMOD_ALLOW_YANKED_ versionS'. אפשר להשבית את הבדיקה הזו באמצעות מילת המפתח 'all' (לא מומלץ).
תגים:loading_and_analysis
- ברירת מחדל של
--check_bazel_compatibility=<error, warning or off>
: "error" -
עליך לבדוק את התאימות של גרסת ה-Bazel. הערכים החוקיים הם 'error' כדי להעביר את הבקשה לטיפול ברמה גבוהה יותר, 'off' כדי להשבית את הבדיקה או 'אזהרה' כדי להדפיס אזהרה לאחר זיהוי חוסר התאמה.
תגים:loading_and_analysis
- ברירת מחדל של
--check_direct_dependencies=<off, warning or error>
: "warning" -
יש לבדוק אם התלות הישירות מסוג 'bazel_dep` במודול הבסיס הן אותן גרסאות שמתקבלות בתרשים התלות שנפתר. הערכים החוקיים מושבתים
תגים:loading_and_analysis
- ברירת מחדל של
--[no]ignore_dev_dependency
: "false" -
אם הערך true, Bazel מתעלם מ-'bazel_dep' ומ-'use_extensions' המוצהר כ-'dev_dependency' ב-MODULE.bazel של המודול הבסיסי. שימו לב שתלויות כל תלות ב-dev ב-MODULE.bazel אם לא מדובר במודול הבסיס, ללא קשר לערך של הסימון הזה.
תגים:loading_and_analysis
- נצברו
--override_module=<an equals-separated mapping of module name to path>
שימושים מרובים - עוקפת מודול עם ספרייה מקומית.
- נצברו
--registry=<a string>
שימושים מרובים -
קביעת המרשמים שיש להשתמש בהם כדי לאתר יחסי תלות של מודול Bazel. הסדר חשוב: המודולים ייבדקו קודם לגבי מרשמים קודמים, והם ייחזרו למרשמים מאוחרים יותר רק אם חסרים בהם.
תגים:changes_inputs
- אפשרויות שמשפיעות על דרגת המלל, הפורמט או המיקום של הרישום:
- ברירת מחדל של
--[no]experimental_record_metrics_for_all_mnemonics
: "false" - כברירת מחדל, מספר סוגי הפעולות מוגבל ל-20 המנונים עם המספר הגדול ביותר של פעולות שבוצעו. הגדרת האפשרות הזו תכתוב נתונים סטטיסטיים עבור כל ה תיעודים.
- אפשרויות המציינים או משנים קלט כללי בפקודת Bazel שלא שייכת לקטגוריות אחרות.:
- ברירת מחדל של
--experimental_resolved_file_instead_of_workspace=<a string>
: "" -
אם הקובץ לא ריק, יש לקרוא את הקובץ שצוין במקום את קובץ ה-WORKSPACE
תגים:changes_inputs
- אפשרויות שמירה במטמון והפעלה:
- ברירת מחדל של
--experimental_downloader_config=<a string>
: תיאור - מציינים קובץ להגדרה של ההורדה מרחוק. הקובץ הזה מורכב משורות, וכל אחת מהן מתחילה בהוראה ('allow', 'block' או 're המיקום'), ואחריה שם מארח (עבור 'allow' ו-'block'), או שני דפוסים, שאחד מהם ישמש להתאמה, ואחד מהם משמש ככתובת אתר חלופית, עם הפניות חלופיות שמתחילות ב-'$1'. ניתן לשלוח מספר הוראות 'recreate' עבור אותה כתובת URL כאשר תוחזר כתובת URL אחת עבור אותה כתובת URL.
- אפשרויות שונות, שלא משויכות לקטגוריה אחרת.:
- נצברו
--override_repository=<an equals-separated mapping of repository name to path>
שימושים מרובים - עוקפת מאגר עם ספרייה מקומית.
תגי אפקט
unknown |
לאפשרות הזו יש אפקט לא ידוע או לא מתועד. |
no_op |
לאפשרות הזו אין כל השפעה. |
loses_incremental_state |
שינוי הערך של האפשרות הזו עלול לגרום לאובדן משמעותי של מצב מצטבר, מה שמאט את פעילות ה-build. המצב עלול ללכת לאיבוד עקב הפעלה מחדש של השרת או ביטול תוקף של חלק גדול מתרשים התלות. |
changes_inputs |
אפשרות זו משנה באופן פעיל את הקלט ש-Bazel לוקח בחשבון בתור גרסת ה-build, כמו הגבלות של מערכת קבצים, גרסאות מאגר או אפשרויות אחרות. |
affects_outputs |
האפשרות הזו משפיעה על הפלט של הבזלת. התג הזה רחב במכוון, יכול לכלול השפעות חולפות ולא מציין את סוג הפלט שמשפיע עליו. |
build_file_semantics |
האפשרות הזו משפיעה על הסמנטיקה של קובצי BUILD או .bzl |
bazel_internal_configuration |
האפשרות הזו משפיעה על ההגדרות של מכונות Bazel Internal. תג זה לא אומר בעצמו שפריטי מידע שנוצרו בתהליך פיתוח (Artifact) מושפעים. |
loading_and_analysis |
האפשרות הזו משפיעה על הטעינה והניתוח של יחסי תלות, ועל בניית התרשים התלוי. |
execution |
האפשרות הזו משפיעה על שלב הביצוע, כמו ארגז חול או אפשרויות הקשורות להפעלה מרחוק. |
host_machine_resource_optimizations |
אפשרות זו מפעילה אופטימיזציה שעשויה להיות ספציפית למכונה ולא מובטח שהיא תפעל בכל המכונות. האופטימיזציה יכולה לכלול יתרונות עם היבטים אחרים של ביצועים, כגון זיכרון או עלות מעבד. |
eagerness_to_exit |
האפשרות הזו משנה את מידת הבזבוּת הגבוהה ביותר של הכישלון, ומהאפשרות לבחור בין ההמשך למרות הכשל לבין סיום ההפעלה. |
bazel_monitoring |
האפשרות הזו משמשת למעקב אחר ההתנהגות והביצועים של הבזלת. |
terminal_output |
האפשרות הזו משפיעה על הפלט של המסוף. |
action_command_lines |
האפשרות הזו משנה את הארגומנטים של שורת הפקודה של פעולת build אחת או יותר. |
test_runner |
האפשרות הזו משנה את סביבת ה-builder של גרסת ה-build. |
תגי מטא-נתונים אופציונליים
experimental |
אפשרות זו מפעילה תכונה ניסיונית ללא כל הבטחה לפונקציונליות. |
incompatible_change |
אפשרות זו גורמת לשינוי התוכנה. אפשר להשתמש באפשרות הזו כדי לבדוק את המוכנות של ההעברה או לקבל גישה מוקדמת לתכונה החדשה |
deprecated |
האפשרות הזו הוצאה משימוש. יכול להיות שהתכונה שמשפיעה על האפליקציה הוצאה משימוש או שעדיף להשתמש בשיטה אחרת שמספקת את המידע. |
explicit_in_output_path |
האפשרות הזו מוזכרת במפורש בספריית הפלט. |