mirror of
https://github.com/bitsycore/skiko.git
synced 2026-10-05 14:37:26 +00:00
Alovchin91
60f1df81dc
Official Skia documentation suggests that it's [_highly recommended_](https://skia.org/docs/user/build/#highly-recommended-build-with-clang-cl) to build Skia with Clang-CL on Windows, and that this dramatically improves Skia performance with Software rendering and in other areas. This corresponds with my experience, so here it is. Related Skia-pack PR: https://github.com/JetBrains/skia-pack/pull/64 Prerequisite: #1024
47 lines
2.2 KiB
Markdown
47 lines
2.2 KiB
Markdown
### Building JVM bindings
|
|
|
|
* Prepare the system
|
|
* `macOs` Install Xcode Command Line Tools
|
|
* `Linux` Install these tools:
|
|
```
|
|
sudo apt-get install ninja-build fontconfig libfontconfig1-dev libglu1-mesa-dev libxrandr-dev libdbus-1-dev zip libx11-dev
|
|
```
|
|
* `Windows`
|
|
1. Download [Visual Studio Build Tools 2019](https://learn.microsoft.com/en-us/visualstudio/releases/2019/history) (search "BuildTools" on the page).
|
|
2. During the installation, select "Desktop development with C++"
|
|
3. Add an environment variable SKIKO_VSBT_PATH=C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools
|
|
```
|
|
Control Panel|All Control Panel Items|System|Advanced system settings|Environment variables
|
|
```
|
|
or by running `cmd` as administrator:
|
|
```
|
|
setx /M SKIKO_VSBT_PATH "C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools"
|
|
```
|
|
4. Skiko is built using Clang-cl. Clang-cl is a part of LLVM and can be downloaded from the [LLVM project's website](https://releases.llvm.org/). Please also make sure that Clang-cl.exe is available in %PATH%.
|
|
|
|
* Install Emscripten
|
|
* Set `JAVA_HOME` to location of JDK, at least version 11
|
|
* `./gradlew :skiko:publishToMavenLocal` will build the artifact and publish it to local Maven repo
|
|
|
|
To build with debug symbols and debug Skia build use `-Pskiko.debug=true` Gradle argument.
|
|
|
|
#### Working with Skia sources
|
|
|
|
Gradle build downloads the necessary version of Skia by default.
|
|
However, if downloaded sources are modified, changes are discarded (Gradle
|
|
re-evaluates tasks, when outputs are changed).
|
|
To use custom version of the dependencies, specify `SKIA_DIR` environment variable.
|
|
|
|
#### Running UI tests
|
|
Add `-Dskiko.test.ui.enabled=true` to enable UI tests (integration tests, which run in the native window). Each UI test will be run on every available Graphics API of the current target.
|
|
|
|
For example, if we want to include UI tests when we test JVM target, call this:
|
|
```
|
|
./gradlew awtTest -Dskiko.test.ui.enabled=true
|
|
```
|
|
Don't run any background tasks, click mouse, or press keys during the tests. Otherwise, they probably fail.
|
|
|
|
#### Run samples
|
|
- First follow the instruction here: [Building JVM bindings](#building-jvm-bindings)
|
|
- `./gradlew :SkiaAwtSample:run`
|