README.md
1Docker
2======
3
4Docker files for building different Skia targets.
5
6skia-release
7------
8
9This image is used to build Skia at TOT with SwiftShader.
10
11There is a continuous process that builds this docker image, but if you
12need to manually push a verison, then run the following commands:
13
14 docker build -t skia-release ./docker/skia-release/
15 docker tag skia-release gcr.io/skia-public/skia-release:prod
16 docker push gcr.io/skia-public/skia-release:prod
17
18skia-wasm-release
19------
20
21This image is used to build the Web Assembly (WASM) libraries of Skia
22at TOT.
23
24There is a continuous process that builds this docker image, but if you
25need to manually push a verison, then run the following commands:
26
27 docker build -t skia-wasm-release ./docker/skia-wasm-release/
28 docker tag skia-wasm-release gcr.io/skia-public/skia-wasm-release:prod
29 docker push gcr.io/skia-public/skia-wasm-release:prod
30
31
32skia-with-swift-shader-base
33------
34
35This image is used to build a local checkout of Skia with SwiftShader and run the built
36executables without requiring the SwiftShader be installed on the host.
37
38For example (see build-with-swift-shader-and-run for more info), to reproduce a
39fuzzer bug in SwiftShader:
40
41 # First, copy the test case into $SKIA_ROOT, say $SKIA_ROOT/skbug_1234
42 build-with-swift-shader-and-run "out/with-swift-shader/fuzz -t filter_fuzz -b /skia/skbug_1234"
43
44There is a continuous process that builds this docker image (which only really changes
45if SwiftShader is updated), but if you need to manually push a version, then run the
46following commands:
47
48 docker build -t skia-with-swift-shader-base ./docker/skia-with-swift-shader-base/
49 docker tag skia-with-swift-shader-base gcr.io/skia-public/skia-with-swift-shader-base:prod
50 docker push gcr.io/skia-public/skia-with-swift-shader-base:prod
51
52cmake-release
53------
54
55This image is used to build Skia using CMake.
56
57It gets manually pushed anytime there's an update to the Dockerfile or relevant
58installed libraries. To push:
59
60 docker build -t cmake-release ./cmake-release/
61 docker tag cmake-release gcr.io/skia-public/cmake-release:3.13.1_v2
62 docker push gcr.io/skia-public/cmake-release:3.13.1_v2
63
64For testing the image locally, the following flow can be helpful:
65
66 docker build -t cmake-release ./cmake-release/
67 # Run bash in it to poke around and make sure things are properly
68 # installed and configured. Also useful to get version of CMake.
69 docker run -it cmake-release /bin/bash
70 # Compile Skia in a local checkout with the local image
71 docker run -v $SKIA_ROOT:/SRC -v /tmp/output:/OUT cmake-release /SRC/infra/docker/cmake/build_skia.sh
72