skia2/bazel/user/README.md

If you wish to define custom Bazel configurations (e.g. custom builds), make a text file in this
folder called buildrc. It should follow the
[.bazelrc conventions](https://bazel.build/docs/bazelrc#config).

Users are free to put their custom builds in the $HOME/.bazelrc file as per usual, but if they
wish to avoid conflicts with other Bazel projects, this is a safer place to store them.
[infra] Add BazelBuild task to build CanvasKit on the CI with Bazel For additional context, see "Codifying Certain Build Options" and "Building on the CI" in the design doc go/skia-bazel Suggested review order: - builder_name_schema.json to see the three required and one optional part of BazelBuild jobs. - jobs.json to see one new BazelBuild job added. In an ideal world, this job would have been named BazelBuild-//modules/canvaskit:canvaskit_wasm-debug-linux_x64 but Buildbucket (?) requires jobs match the regex ^[a-zA-Z0-9\\-_.\\(\\) ]{1,128}$ so we use spaces instead of slashes or colons. - gen_tasks_logic.go; noting the makeBazelLabel function expands most of the spaces to / and the last one to a colon to make a single-target label. If there are three dots, then it is a multi-target label, and we do not need to add a colon. - bazel_build.go; This is a very simple task driver, and I do not anticipate getting too much more complex. The place where we decide which args to augment a build with depend on the host platform and thus should be set in gen_tasks_logic.go. - bazel/buildrc to see some initial configurations set, one of which, "debug", is used by the new job. The "release" version of CanvasKit probably works on 3.1.10 which had a bugfix, but we are still on 3.1.9 - .bazelrc to see a rename of the linux-rbe config to linux_rbe (our configs should have no dashes if we want to specify them verbatim in our Job names). It also imports the Skia-specified build configs from //bazel/buildrc and supports the user-specified //bazel/user/buildrc file if it exists. - All other files in any order. Change-Id: Ib954dd6045100eadcbbf4ffee0888f6fbce65fa7 Reviewed-on: https://skia-review.googlesource.com/c/skia/+/537797 Reviewed-by: Eric Boren <borenet@google.com> Reviewed-by: Jorge Betancourt <jmbetancourt@google.com> 2022-05-06 17:20:12 +00:00			`If you wish to define custom Bazel configurations (e.g. custom builds), make a text file in this`
			`folder called buildrc. It should follow the`
			`[.bazelrc conventions](https://bazel.build/docs/bazelrc#config).`

			`Users are free to put their custom builds in the $HOME/.bazelrc file as per usual, but if they`
			`wish to avoid conflicts with other Bazel projects, this is a safer place to store them.`