✓ Uses Rust 2018 edition
|0.14.4||Aug 10, 2019|
|0.14.2||Aug 9, 2019|
|0.14.1||Aug 5, 2019|
#68 in Graphics APIs
Used in 1 crate
Safe Rust bindings to the Skia Graphics Library.
Skia Submodule Status: chrome/m76 (pending changes).
This project attempts to provide up to date safe bindings that bridge idiomatic Rust with Skia's C++ API on all major desktop, mobile, and WebAssembly platforms, including GPU rendering support for Vulkan, Metal, and OpenGL.
Currently we recommend to use the git repository because the prerelease on crates.io is a bit flaky at the moment.
- Linux Ubuntu 16 (18 should work, too).
- Android (macOS | Linux -> aarch64, contributed by @DenisKolodin)
- WebAssembly: #42 (help wanted).
The supported bindings and Skia features are desribed in the skia-safe package's readme.
Note that the information in this section is preliminary. Please open an issue for any build problem.
This project requires LLVM, Python 2, and git to build.
To see which version of LLVM/Clang is available, use
We recommend version 8, but also had successes to build Skia with 6.0.1 and 7.0.1, and - on macOS - Apple LLVM version 10. So it's probably best to use the preinstalled version or install version 8 if LLVM is not available on your platform by default.
Python version 2.7 should be available. The build script probes for
python --version and
python2 --version and uses the first one that looks like a version 2 executable.
Install the XCode command line developer tools with
macOS Mojave Version 10.14: install the SDK headers:
sudo open /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg
otherwise the Skia build may fail to build
SkJpegUtility.cppand the binding generation will fail with
'TargetConditionals.h' file not found. Also note that the command line developer tools and SDK headers should be reinstalled after an update of XCode.
As an alternative to Apple LLVM 10, install LLVM via
brew install llvmor
brew install llvm@7and then set
- Be sure the
gitcommand line tool is installed.
- Install the official LLVM 8 distribution.
- Install one of the Python2 packages, for example
- LLVM is always picked up from
C:/Program Files/LLVM, so be sure it's available from there.
- Install one of the Python2 packages, for example
- without msys:
- Download and install Python version 2 from python.org.
- LLVM should be installed out of the box, if not, install version 8.
cargo build -vv
On Linux, OpenGL libraries may be missing, if that is the case, install OpenGL drivers for you graphics card, or install a mesa OpenGL package like
Please share your build experience so that we can try to automate the build and get to the point where
cargo build is sufficient to build the bindings including Skia, and if that is not possible, clearly prompts to what's missing.
Cross compilation to Android is supported for targeting 64 bit ARM and Intel x86 architectures (
For example, to compile for
- Install the rust target:
rustup target install aarch64-linux-android.
- Download the r18b NDK from: https://developer.android.com/ndk/downloads/older_releases.html
- Create a toolchain for the compilation:
build/tools/make_standalone_toolchain.py --arch arm64 --install-dir /tmp/ndk
- Compile your package for the
On macOS & Linux:
ANDROID_NDK=~/path/to/android-ndk-r18b PATH=$PATH:/tmp/ndk/bin cargo build --target aarch64-linux-android -vv
On Windows it's a bit more complicated, because the Android NDK clang executable must be invoked through .cmd scripts:
ANDROID_NDK=~/path/to/android-ndk-r18b PATH=$PATH:/tmp/ndk/bin CC_aarch64_linux_android=aarch64-linux-android-clang.cmd CXX_aarch64_linux_android=aarch64-linux-android-clang++.cmd CARGO_TARGET_aarch64_linux_android_LINKER=aarch64-linux-android-clang.cmd cargo build --target aarch64-linux-android -vv
- It doesn't work for the latest NDK, because Skia doesn't support it yet.
- Rebuilding skia-bindings with a different target may cause linker errors, in that case
touch skia-bindings/build.rswill force a rebuild (#10).
Compilation to iOS is supported on macOS targeting the iOS simulator (
--target x86_64-apple-ios) and 64 bit ARM devices (
For situations in which Skia does not build or needs to be configured differently, we support some customization support in
skia-bindings/build.rs. For more details about how to customize Skia builds, take a look at the README of the skia-bindings package.
Note that crate packages will try to download prebuilt binaries from skia-binaries if the platform matches with one of the binaries build on the CI. If the download fails, a full build of Skia is triggered.
If you were able to build the project, run
cargo run --example skia-org -- [OUTPUT_DIR]
to generate some Skia drawn PNG images in the directory
OUTPUT_DIR. To render with OpenGL, use
cargo run --example skia-org -- [OUTPUT_DIR] --driver opengl
cargo run --example skia-org -- --help shows the drivers that are supported.
Fill, Stroke, Text:
Dash Path Effect:
For more, you may take a look at the rust-skia.github.io repository.
If you'd like to help with the bindings, take a look at the Wiki to get started and create an issue to avoid duplicate work. For smaller tasks, grep for "TODO" in the source code. And for heroic work, check out the label help wanted. And if you like to help making the Rust API nicer to use, look out for open issues with the label api ergonomics.