Lines Matching +full:build +full:- +full:docs

2 ---
6 ---
10 Skia is currently migrating towards using [Bazel](https://bazel.build/) as a build system, due to
14 [Bazel label notation](https://bazel.build/concepts/labels), so to refer the file located at
15 `$SKIA_ROOT/docs/examples/Arc.cpp`, we would say `//docs/examples/Arc.cpp`.
18 The Bazel docs are quite good. Suggested reading order if you are new to Bazel:
19  - [Getting Started with Bazel and C++](https://bazel.build/tutorials/cpp)
20  - [WORKSPACE.bazel and external deps](https://bazel.build/docs/external)
21  - [Targets and Labels](https://bazel.build/concepts/labels)
22  - [Understanding a build](https://bazel.build/docs/build)
23  - [Configuration with .bazelrc files](https://bazel.build/docs/bazelrc)
25 Googlers, check out [go/bazel-bites](http://go/bazel-bites) for more tips.
29 All this assumes you have [downloaded Skia](/docs/user/download), especially having synced the
30 third_party deps using `./tools/git-sync-deps`.
35 bazel build //example:hello_world_gl
40 `//examples/BUILD.bazel` named "hello_world_gl", which uses the `sk_app` framework
43 Bazel will put this executable in `//bazel-bin/example/hello_world_gl` and tell you it did so in
50 If you want to pass one or more flags to `bazel run`, add them on the end after a `--` like:
52 bazel run //example:hello_world_gl -- --flag_one=apple --flag_two=cherry
58 bazel build //example:bazel_test_exe
62 use system headers and Mac-specific includes when compiling. Googlers, as per usual, follow the
63 instructions at [go/skia-corp-xcode](http://go/skia-corp-xcode) to install Xcode.
65 Our Bazel toolchain assumes you have `xcode-select` in your path so that we may symlink the
66 user's current Xcode directory in the toolchain's cache. Make sure `xcode-select -p`
70 You should make a [.bazelrc file](https://bazel.build/docs/bazelrc) in your home directory where
74 Skia defines some [configs](https://bazel.build/docs/bazelrc#config), that is, group of settings
78 If you want to define Skia-specific configs (and options which do not conflict with other Bazel
85 ### Build Skia faster locally
86 … disk mounted at /dev/shm](https://www.cyberciti.biz/tips/what-is-devshm-and-its-practical-usage.h…
88 [sandboxing](https://bazel.build/docs/sandboxing) has been observed to be I/O intensive.
92 build --sandbox_base=/dev/shm
97 build --spawn_strategy=local
101 We are in the process of setting up Remote Build Execution (RBE) for Bazel. Some users have reported
102 errors when trying to use RBE (via `--config=linux_rbe`) on Linux VMs such as:
110 For instances where it is not possible to set the `cloud-platform` scope
111 [on the VM](https://skia-review.googlesource.com/c/skia/+/525577), one can directly link to their
115 build:remote --google_credentials=/usr/local/google/home/<user>/.config/gcloud/application_default_…
120 share cached build results between things you build locally and build with `--config=linux_rbe`.
122 build --host_platform=//bazel/platform:linux_x64_hermetic
124 For example, if you are on a laptop, using `--config=linux_rbe` will speed up builds when you have
125 access to Internet, but then if you need to go offline, you can still build locally and use the
126 previous build results from the remote builds.