mirror of
https://github.com/bitsycore/skiko.git
synced 2026-10-05 14:37:26 +00:00
53 lines
2.6 KiB
Markdown
53 lines
2.6 KiB
Markdown
### Building JVM bindings
|
|
|
|
* Prepare the system
|
|
* `macOs` Install Xcode Command Line Tools
|
|
* `macOs` Install LLVM — its `llvm-objcopy` is needed to patch symbols when building iOS/tvOS targets:
|
|
```
|
|
brew install llvm
|
|
```
|
|
* `Linux` Install these tools:
|
|
```
|
|
sudo apt-get install ninja-build fontconfig libfontconfig1-dev libglu1-mesa-dev libxrandr-dev libdbus-1-dev zip multistrap libx11-dev
|
|
```
|
|
* `Windows`
|
|
1. Download [Visual Studio Build Tools 2022](https://aka.ms/vs/17/release/vs_buildtools.exe).
|
|
2. During the installation, select "Desktop development with C++"
|
|
3. Add an environment variable `SKIKO_VSBT_PATH=C:\Program Files (x86)\Microsoft Visual Studio\2022\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\2022\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
|
|
* Skiko follows the Emscripten version used by the underlying Skia build. While other versions may work, we recommend using the same version that is currently used in the project to avoid compatibility issues.
|
|
* The current version used by Skiko is `4.0.7`
|
|
* 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 :skiko: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`
|