skia2/modules/canvaskit/Makefile
Kevin Lubick 1f8c31b101 [infra] Add initial Bazel rules and files
These rules can be used to build our GMs on WASM+WebGL and
libskia.a with just the CPU backend (and most other features
turned off).

This can be done with the following commands:
  - bazel build //modules/canvaskit:gm-bindings-wasm --gpu_backend=gl_backend --with_gl_standard=webgl_standard
  - bazel build :skia-core --config clang

This pivots slightly from http://review.skia.org/463517
by using config_settings [1] instead of platforms for
the optional features that we control. This pivot was
suggested in [2]

We have BUILD.bazel files in many of the subdirectories
that specify filegroups for the appropriate files. In
an effort to make //BUILD.bazel more readable, it is
the responsibility of these subfolders to deal with
conditionally including certain .h or .cpp files.
This is done using select statements and config_settings
or platform constraints as necessary.

For example, src/gpu/BUILD.bazel will different private
filegroups for each of the supported gpu backends [3]
and a more-visible filegroup called "srcs" that has
the right selection of the private files to be used
for compilation.

An effort has been made to avoid using glob() in our
BUILD.bazel files. These file lists were made by using
`ls -1` and some regex to add in quotes. We might want
to make a helper script to assist with that, if necessary.

To specify which options we have, the settings in
//bazel/common_config_settings/BUILD.bazel have been
redesigned. They make use of a macro `string_flag_with_values`
that removes the boilerplate. Patchset 36 shows what the
file looks like w/o the macro.

The top level BUILD.bazel file will still need to use
some logic to handle defines, because local_defines is
a list of strings, not a list of labels [4].

Suggested Review Order:
  - WORKSPACE.bazel to see the new dependencies on the
    emsdk toolchain and bazel_skylib
  - bazel/common_config_settings/* to see the few settings
    defined (we have more to define, see BUILD.gn and
    //gn/skia.gni for ideas)
  - BUILD.bazel to see the "skia-core" cc_library rule.
    See also "gms" and "tests"
  - modules/canvaskit/BUILD.bazel to see the use of
    the emscripten "wasm_cc_binary" rule, which depends
    on the "skia-core", "gms", and "tests" rule. Note that
    it only builds some of the gms as a proof of concept.
  - The other BUILD.bazel files. Some of these are not
    platform or feature dependent (e.g. pathops). Others
    are (e.g. gpu).
  - All other files.

[1] https://docs.bazel.build/versions/4.2.1/skylark/config.html#user-defined-build-settings
[2] https://github.com/emscripten-core/emsdk/pull/920
[3] In this CL, that's just the webgl one.
[4] https://docs.bazel.build/versions/main/be/c-cpp.html#cc_library.local_defines

Change-Id: Ieecf9c106d5e3a6ae97d13d66be06b4b3c207089
Reviewed-on: https://skia-review.googlesource.com/c/skia/+/458637
Reviewed-by: Ben Wagner <bungeman@google.com>
Reviewed-by: Leandro Lovisolo <lovisolo@google.com>
Owners-Override: Kevin Lubick <kjlubick@google.com>
2021-11-09 12:32:25 +00:00

157 lines
5.9 KiB
Makefile

clean:
rm -rf ../../out/canvaskit_wasm
rm -rf ./npm_build/bin
$(MAKE) release
release:
# Does an incremental build where possible.
./compile.sh
mkdir -p ./npm_build/bin
cp ../../out/canvaskit_wasm/canvaskit.js ./npm_build/bin
cp ../../out/canvaskit_wasm/canvaskit.wasm ./npm_build/bin
release_cpu:
# Does an incremental build where possible.
./compile.sh cpu_only
mkdir -p ./npm_build/bin
cp ../../out/canvaskit_wasm/canvaskit.js ./npm_build/bin
cp ../../out/canvaskit_wasm/canvaskit.wasm ./npm_build/bin
release_viewer:
# Does an incremental build where possible.
./compile.sh viewer
mkdir -p ./npm_build/bin
cp ../../out/canvaskit_wasm/canvaskit.js ./npm_build/bin
cp ../../out/canvaskit_wasm/canvaskit.wasm ./npm_build/bin
debug:
# Does an incremental build where possible.
./compile.sh debug
mkdir -p ./npm_build/bin
cp ../../out/canvaskit_wasm_debug/canvaskit.js ./npm_build/bin
cp ../../out/canvaskit_wasm_debug/canvaskit.wasm ./npm_build/bin
#cp ../../out/canvaskit_wasm_debug/canvaskit.wasm.map ./npm_build/bin
debug_cpu:
# Does an incremental build where possible.
./compile.sh debug cpu_only
mkdir -p ./npm_build/bin
cp ../../out/canvaskit_wasm_debug/canvaskit.js ./npm_build/bin
cp ../../out/canvaskit_wasm_debug/canvaskit.wasm ./npm_build/bin
#cp ../../out/canvaskit_wasm_debug/canvaskit.wasm.map ./npm_build/bin
experimental_simd:
# Does an incremental build where possible.
./compile.sh simd
mkdir -p ./npm_build/bin
cp ../../out/canvaskit_wasm_experimental_simd/canvaskit.js ./npm_build/bin
cp ../../out/canvaskit_wasm_experimental_simd/canvaskit.wasm ./npm_build/bin
debug_viewer:
# Does an incremental build where possible.
./compile.sh debug viewer
mkdir -p ./npm_build/bin
cp ../../out/canvaskit_wasm_debug/canvaskit.js ./npm_build/bin
cp ../../out/canvaskit_wasm_debug/canvaskit.wasm ./npm_build/bin
profile:
./compile.sh profiling
mkdir -p ./npm_build/bin
cp ../../out/canvaskit_wasm_profile/canvaskit.js ./npm_build/bin
cp ../../out/canvaskit_wasm_profile/canvaskit.wasm ./npm_build/bin
npm:
rm -rf ./npm_build/bin
mkdir -p ./npm_build/bin
cp ./CHANGELOG.md ./npm_build/
mkdir -p ./npm_build/bin/full
./compile.sh release
cp ../../out/canvaskit_wasm/canvaskit.js ./npm_build/bin/full
cp ../../out/canvaskit_wasm/canvaskit.wasm ./npm_build/bin/full
# These features are turned off to keep code size smaller for the
# general use case.
./compile.sh release no_skottie no_particles no_rt_shader no_alias_font no_effects_deserialization
cp ../../out/canvaskit_wasm/canvaskit.js ./npm_build/bin
cp ../../out/canvaskit_wasm/canvaskit.wasm ./npm_build/bin
mkdir -p ./npm_build/bin/profiling
./compile.sh profiling
cp ../../out/canvaskit_wasm_profile/canvaskit.js ./npm_build/bin/profiling
cp ../../out/canvaskit_wasm_profile/canvaskit.wasm ./npm_build/bin/profiling
gm_tests_debug:
./compile_gm.sh debug
mkdir -p ./out
cp ../../out/wasm_gm_tests_debug/wasm_gm_tests.js ./out
cp ../../out/wasm_gm_tests_debug/wasm_gm_tests.wasm ./out
gm_tests:
./compile_gm.sh
mkdir -p ./out
cp ../../out/wasm_gm_tests/wasm_gm_tests.js ./out
cp ../../out/wasm_gm_tests/wasm_gm_tests.wasm ./out
local-example:
rm -rf node_modules/canvaskit
mkdir -p node_modules
ln -s ../npm_build node_modules/canvaskit
echo "Go check out http://localhost:8000/npm_build/example.html"
python3 ../../tools/serve_wasm.py
test-continuous:
echo "Assuming npm ci has been run by user"
echo "Also assuming make debug or release has also been run by a user (if needed)"
npx karma start ./karma.conf.js --no-single-run --watch-poll
test-continuous-headless:
npx karma start ./karma.conf.js --no-single-run --watch-poll --headless
node-example:
node ./npm_build/node.example.js --expose-wasm
docker-compile:
mkdir -p ${SKIA_ROOT}/out/canvaskit_wasm_docker
docker run --rm --volume ${SKIA_ROOT}:/SRC \
--volume ${SKIA_ROOT}/out/canvaskit_wasm_docker:/OUT \
gcr.io/skia-public/canvaskit-emsdk:2.0.0_v1 \
/SRC/infra/canvaskit/build_canvaskit.sh
typecheck:
echo "Make sure you've run cd npm_build && npm ci recently"
cd npm_build && npm run dtslint
bazel_gms_sandboxed:
# Because emscripten does a lot of extra work, we need to limit the number of jobs or it
# can overwhelm even a powerful build system.
bazel build :gm-bindings-wasm --compilation_mode opt --cpu=wasm --jobs 8
- rm -rf build/
mkdir build
cp ../../bazel-bin/modules/canvaskit/gm-bindings-wasm/gm-bindings.js build/gm-bindings.js
cp ../../bazel-bin/modules/canvaskit/gm-bindings-wasm/gm-bindings.wasm build/gm-bindings.wasm
bazel_gms_release:
# We use spawn_strategy=local for "everyday" builds because emscripten assumes there
# is a cache in the home directory that it needs to fill with compiled versions of libc etc.
# https://emscripten.org/docs/tools_reference/emcc.html
# By setting spawn_strategy=local, we can avoid recompiling all of this for every compilation
# unit, by letting the cache be used (and not dropped from the sandbox), which gets expensive.
# Local testing showed using the local strategy sped up a clean build from 9.5 minutes
# to 1 minute. https://docs.bazel.build/versions/main/user-manual.html#strategy-options
bazel build :gm-bindings-wasm --compilation_mode opt --spawn_strategy=local \
--gpu_backend=gl_backend --with_gl_standard=webgl_standard
- rm -rf build/
mkdir build
cp ../../bazel-bin/modules/canvaskit/gm-bindings-wasm/gm-bindings.js build/gm-bindings.js
cp ../../bazel-bin/modules/canvaskit/gm-bindings-wasm/gm-bindings.wasm build/gm-bindings.wasm
bazel_gms_debug:
# See above note about spawn_strategy
bazel build :gm-bindings-wasm --compilation_mode dbg --spawn_strategy=local \
--gpu_backend=gl_backend --with_gl_standard=webgl_standard
- rm -rf build/
mkdir build
cp ../../bazel-bin/modules/canvaskit/gm-bindings-wasm/gm-bindings.js build/gm-bindings.js
cp ../../bazel-bin/modules/canvaskit/gm-bindings-wasm/gm-bindings.wasm build/gm-bindings.wasm