| 1 |
# This file contains the build configurations of Skia that we use for testing on the CI. |
| 2 |
# These allow a short-form reference for our supported combinations of build features. |
| 3 |
# https://bazel.build/docs/bazelrc#config |
| 4 |
# |
| 5 |
# For most build configurations, we will want to set the --cc_output_directory_tag [1] |
| 6 |
# with a unique identifier per configuration name. |
| 7 |
# |
| 8 |
# By default, Bazel's "unique target BuildConfiguration" [2] incorporates the compilation_mode, |
| 9 |
# the target platform, and some suffixes to avoid Bazel-caused and user-caused conflicts. [3] [4] |
| 10 |
# For example, a default output directory might look like "k8-fastbuild-ST-6a54c1377847". |
| 11 |
# Inside this output directory is a subfolder for the target (e.g. executable) name. |
| 12 |
# |
| 13 |
# Note that multiple definitions of a config are allowed - in this event, they are added together. |
| 14 |
# This is handy if we need to comment on why certain settings are necessary. Otherwise, escaping |
| 15 |
# the trailing newline (and thus having a multi-line definition) is preferred for brevity. |
| 16 |
# |
| 17 |
# Notably, the flags that we turn on and off via //bazel/common_config_settings do not affect |
| 18 |
# the output directory. The output directory is used to store compiled object files (.o files) |
| 19 |
# and generated dependency files (e.g. the output of clang --write-dependencies [5]), so having |
| 20 |
# these be overwritten unnecessarily will slow down incremental rebuilds when switching between |
| 21 |
# building different configurations of the same targets. |
| 22 |
# |
| 23 |
# [1] https://bazel.build/reference/command-line-reference#flag--cc_output_directory_tag |
| 24 |
# [2] https://bazel.build/docs/output_directories#layout-diagram |
| 25 |
# [3] https://github.com/bazelbuild/bazel/blob/ad37a3748c78e0ee903b56366322c70ab8b22187/CODEBASE.md#the-structure-of-the-output-directory |
| 26 |
# [4] https://github.com/bazelbuild/bazel/blob/e0e589658463beb9605030b4820dcc97e6a36f48/src/main/java/com/google/devtools/build/lib/analysis/config/OutputDirectories.java#L198-L236 |
| 27 |
# [5] https://clang.llvm.org/docs/ClangCommandLineReference.html#dependency-file-generation |
| 28 |
|
| 29 |
# ============================================================================= |
| 30 |
# Targets (what to build for) |
| 31 |
# ============================================================================= |
| 32 |
|
| 33 |
# --platforms refers to the target for which we are compiling. By setting the target to be a |
| 34 |
# platform which has our own custom constraint_setting and constraint_value |
| 35 |
# (skia_hermetic_toolchain=use_hermetic_toolchain), this causes Bazel to resolve the toolchain |
| 36 |
# to be our hermetic one because our hermetic toolchains have that same constraint set in their |
| 37 |
# target_compatible_with list. |
| 38 |
build:for_linux_x64_debug --platforms=//bazel/platform:linux_x64_hermetic \ |
| 39 |
--compilation_mode=dbg \ |
| 40 |
--cc_output_directory_tag=linux_x64_debug |
| 41 |
build:for_linux_x64_release --platforms=//bazel/platform:linux_x64_hermetic \ |
| 42 |
--compilation_mode=opt \ |
| 43 |
--cc_output_directory_tag=linux_x64_release |
| 44 |
build:for_linux_x64_fastbuild --platforms=//bazel/platform:linux_x64_hermetic \ |
| 45 |
--compilation_mode=fastbuild \ |
| 46 |
--cc_output_directory_tag=linux_x64_fastbuild |
| 47 |
|
| 48 |
build:for_linux_x64_debug_with_rbe --config=for_linux_x64_debug --config=linux_rbe |
| 49 |
build:for_linux_x64_release_with_rbe --config=for_linux_x64_release --config=linux_rbe |
| 50 |
build:for_linux_x64_fastbuild_with_rbe --config=for_linux_x64_fastbuild --config=linux_rbe |
| 51 |
|
| 52 |
# Shorter config names defaulting to fastbuild (same default as --compilation_mode, see |
| 53 |
# https://bazel.build/docs/user-manual#compilation-mode). |
| 54 |
build:for_linux_x64 --config=for_linux_x64_fastbuild |
| 55 |
build:for_linux_x64_with_rbe --config=for_linux_x64_fastbuild_with_rbe |
| 56 |
|
| 57 |
build:for_mac_arm64_debug --platforms=//bazel/platform:mac_arm64_hermetic \ |
| 58 |
--compilation_mode=dbg \ |
| 59 |
--cc_output_directory_tag=mac_arm64_debug |
| 60 |
build:for_mac_arm64_release --platforms=//bazel/platform:mac_arm64_hermetic \ |
| 61 |
--compilation_mode=opt \ |
| 62 |
--cc_output_directory_tag=mac_arm64_release |
| 63 |
build:for_mac_arm64_fastbuild --platforms=//bazel/platform:mac_arm64_hermetic \ |
| 64 |
--compilation_mode=fastbuild \ |
| 65 |
--cc_output_directory_tag=mac_arm64_fastbuild |
| 66 |
|
| 67 |
build:for_mac_x64_debug --platforms=//bazel/platform:mac_x64_hermetic \ |
| 68 |
--compilation_mode=dbg \ |
| 69 |
--cc_output_directory_tag=mac_x64_debug |
| 70 |
build:for_mac_x64_release --platforms=//bazel/platform:mac_x64_hermetic \ |
| 71 |
--compilation_mode=opt \ |
| 72 |
--cc_output_directory_tag=mac_x64_release |
| 73 |
build:for_mac_x64_fastbuild --platforms=//bazel/platform:mac_x64_hermetic \ |
| 74 |
--compilation_mode=fastbuild \ |
| 75 |
--cc_output_directory_tag=mac_x64_fastbuild |
| 76 |
|
| 77 |
build:for_windows_x64_debug --platforms=//bazel/platform:windows_x64_hermetic \ |
| 78 |
--compilation_mode=dbg \ |
| 79 |
--cc_output_directory_tag=windows_x64_debug |
| 80 |
build:for_windows_x64_release --platforms=//bazel/platform:windows_x64_hermetic \ |
| 81 |
--compilation_mode=opt \ |
| 82 |
--cc_output_directory_tag=windows_x64_release |
| 83 |
build:for_windows_x64_fastbuild --platforms=//bazel/platform:windows_x64_hermetic \ |
| 84 |
--compilation_mode=fastbuild \ |
| 85 |
--cc_output_directory_tag=windows_x64_fastbuild |
| 86 |
|
| 87 |
# Shorter config names defaulting to fastbuild (same default as --compilation_mode, see |
| 88 |
# https://bazel.build/docs/user-manual#compilation-mode). |
| 89 |
build:for_mac_arm64 --config=for_mac_arm64_fastbuild |
| 90 |
build:for_mac_x64 --config=for_mac_x64_fastbuild |
| 91 |
|
| 92 |
# Some aliases using more common lingo. |
| 93 |
build:for_mac_m1 --config=for_mac_arm64 |
| 94 |
build:for_mac_intel --config=for_mac_x64 |
| 95 |
|
| 96 |
# Android configuration for 32-bit ARM (armeabi-v7a ABI). |
| 97 |
build:for_android_arm32_debug --platforms=//bazel/platform:android_arm32 \ |
| 98 |
--compilation_mode=dbg \ |
| 99 |
--cc_output_directory_tag=android_arm32_debug |
| 100 |
build:for_android_arm32_release --platforms=//bazel/platform:android_arm32 \ |
| 101 |
--compilation_mode=opt \ |
| 102 |
--cc_output_directory_tag=android_arm32_release |
| 103 |
build:for_android_arm32_fastbuild --platforms=//bazel/platform:android_arm32 \ |
| 104 |
--compilation_mode=fastbuild \ |
| 105 |
--cc_output_directory_tag=android_arm32_fastbuild |
| 106 |
|
| 107 |
build:for_android_arm32_debug_with_rbe --config=for_android_arm32_debug --config=linux_rbe |
| 108 |
build:for_android_arm32_release_with_rbe --config=for_android_arm32_release --config=linux_rbe |
| 109 |
build:for_android_arm32_fastbuild_with_rbe --config=for_android_arm32_fastbuild --config=linux_rbe |
| 110 |
|
| 111 |
# Shorter config names defaulting to fastbuild (same default as --compilation_mode, see |
| 112 |
# https://bazel.build/docs/user-manual#compilation-mode). |
| 113 |
build:for_android_arm32 --config=for_android_arm32_fastbuild |
| 114 |
build:for_android_arm32_with_rbe --config=for_android_arm32_fastbuild_with_rbe |
| 115 |
build:android_arm32_rbe --config=for_android_arm32_fastbuild_with_rbe |
| 116 |
|
| 117 |
# Android configuration for 64-bit ARM (arm64-v8a ABI). |
| 118 |
build:for_android_arm64_debug --platforms=//bazel/platform:android_arm64 \ |
| 119 |
--compilation_mode=dbg \ |
| 120 |
--cc_output_directory_tag=android_arm64_debug |
| 121 |
build:for_android_arm64_release --platforms=//bazel/platform:android_arm64 \ |
| 122 |
--compilation_mode=opt \ |
| 123 |
--cc_output_directory_tag=android_arm64_release |
| 124 |
build:for_android_arm64_fastbuild --platforms=//bazel/platform:android_arm64 \ |
| 125 |
--compilation_mode=fastbuild \ |
| 126 |
--cc_output_directory_tag=android_arm64_fastbuild |
| 127 |
|
| 128 |
build:for_android_arm64_debug_with_rbe --config=for_android_arm64_debug --config=linux_rbe |
| 129 |
build:for_android_arm64_release_with_rbe --config=for_android_arm64_release --config=linux_rbe |
| 130 |
build:for_android_arm64_fastbuild_with_rbe --config=for_android_arm64_fastbuild --config=linux_rbe |
| 131 |
|
| 132 |
# Shorter config names defaulting to fastbuild (same default as --compilation_mode, see |
| 133 |
# https://bazel.build/docs/user-manual#compilation-mode). |
| 134 |
build:for_android_arm64 --config=for_android_arm64_fastbuild |
| 135 |
build:for_android_arm64_with_rbe --config=for_android_arm64_fastbuild_with_rbe |
| 136 |
build:android_rbe --config=for_android_arm64_fastbuild_with_rbe |
| 137 |
|
| 138 |
#IOS configs |
| 139 |
build:for_ios --platforms=//bazel/platform:ios --compilation_mode=dbg --cc_output_directory_tag=ios_arm64_fastbuild |
| 140 |
|
| 141 |
# ============================================================================= |
| 142 |
# Configurations (what features we want on) |
| 143 |
# ============================================================================= |
| 144 |
# These are examples of the syntax to create build configurations. As of May 2022, our |
| 145 |
# Bazel configurations are still being made. |
| 146 |
build:release --compilation_mode=opt |
| 147 |
build:debug --compilation_mode=dbg |
| 148 |
|
| 149 |
# See also https://github.com/emscripten-core/emsdk/issues/984 for disabling cc_toolchain_resolution |
| 150 |
build:canvaskit_full --noincompatible_enable_cc_toolchain_resolution \ |
| 151 |
--ck_enable_fonts --ck_enable_embedded_font \ |
| 152 |
\ |
| 153 |
--ck_enable_canvas_polyfill --ck_enable_skp_serialization --ck_enable_skottie \ |
| 154 |
--ck_enable_runtime_effect --ck_enable_matrix_js \ |
| 155 |
--cxxopt=-w --cxxopt=-std=c++20 |
| 156 |
|
| 157 |
build:ck_webgl2 --ck_enable_webgl |
| 158 |
|
| 159 |
build:ck_full_webgl2_release --config=canvaskit_full --config=ck_webgl2 --config=release |
| 160 |
build:ck_full_webgl2_debug --config=canvaskit_full --config=ck_webgl2 --config=debug |
| 161 |
build:ck_full_cpu_release --config=canvaskit_full --config=release |
| 162 |
build:ck_full_cpu_debug --config=canvaskit_full --config=debug |
| 163 |
build:ck_full_webgl2_release_debugger --config=canvaskit_full --config=ck_webgl2 \ |
| 164 |
--config=release --ck_include_debugger |
| 165 |
# TODO(kjlubick) We should be able to configure testing on Chrome or Firefox with this. |
| 166 |
build:ck_full_webgl2_release_chrome --config=ck_full_webgl2_release |
| 167 |
build:ck_full_cpu_release_chrome --config=ck_full_cpu_release |
| 168 |
|
| 169 |
build:use_linux_rbe_pool --config=linux_rbe --remote_download_minimal |
| 170 |
|
| 171 |
build:cpu_only --cc_output_directory_tag=cpu_tests |
| 172 |
build:cpu_only_debug --config=cpu --config=debug |
| 173 |
build:cpu_only_release --config=cpu --config=release |
| 174 |
build:cpu_only_debug_rbe --config=cpu_only_debug --config=use_linux_rbe_pool |
| 175 |
build:cpu_only_release_rbe --config=cpu_only_release --config=use_linux_rbe_pool |
| 176 |
|
| 177 |
build:gl_ganesh --enable_gpu_test_utils --gpu_backend=gl_ganesh \ |
| 178 |
--cc_output_directory_tag=gl_ganesh |
| 179 |
# We need to have this environment variable set when testing our Ganesh GL backend on Unix, |
| 180 |
# otherwise, we get "Failed to open X display." and connect make a GL context for testing. |
| 181 |
build:gl_ganesh --action_env=DISPLAY=:1 |
| 182 |
|
| 183 |
build:vulkan_ganesh --enable_gpu_test_utils --gpu_backend=vulkan_ganesh \ |
| 184 |
--cc_output_directory_tag=vulkan_ganesh |
| 185 |
|
| 186 |
build:metal_ganesh --enable_gpu_test_utils --gpu_backend=metal_ganesh\ |
| 187 |
--cc_output_directory_tag=metal_ganesh |
| 188 |
|
| 189 |
# Short-hand aliases |
| 190 |
build:cpu --config=cpu_only |
| 191 |
build:gl --config=gl_ganesh |
| 192 |
build:vk --config=vulkan_ganesh |
| 193 |
|
| 194 |
# We would ideally like to remove the SKSL_STANDALONE define one day, |
| 195 |
# but it is needed by SkRasterPipelineBuilder when being compiled for GN |
| 196 |
build:compile_sksl --cc_output_directory_tag=compile_sksl \ |
| 197 |
--compilation_mode=opt --//src/core:load_sksl_from_disk --copt="-DSKSL_STANDALONE=1" \ |