These are the bindings to use AccessKit from other languages through FFI such as in C.
Decompress an accesskit-c release and place the resulting folder somewhere either:
- already known by CMake,
- listed in your
CMAKE_PREFIX_PATH
, - indicated by the
ACCESSKIT_DIR
option.
You can then require AccessKit as a dependency by adding this to your CMakeLists.txt
:
find_package(ACCESSKIT REQUIRED)
Finally, link the library to your executable:
target_link_libraries(hello_world PUBLIC accesskit)
See the examples
directory for project integration examples.
Prerequisites:
In the root directory of this repository, CMake can be used like this to build the project:
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
cmake --install build
On Windows, you will need to pass the -A
flag when configuring the project. For instance, to target ARM64:
cmake -S . -B build -A ARM64
On other platforms you will have to specify which Rust target to use, as well as tell CMake for which architecture to compile. Here is how you would cross-compile for Linux X86 from Linux AMD64:
cmake -S . -B build -DCMAKE_SYSTEM_NAME=Linux -DCMAKE_SYSTEM_PROCESSOR=x86 -DRust_CARGO_TARGET=i686-unknown-linux-gnu
If you modify the C bindings, you need to regenerate the header file and commit it. To do this, in addition to the above requirements, you will need:
- A nightly Rust toolchain:
rustup install nightly
- cbindgen:
cargo install cbindgen
- clang-format, version 14 or higher
Once you have these requirements, the process of regenerating the header file is similar to building and installing from source with CMake, but using different configuration options:
cmake -S . -B build -DACCESSKIT_BUILD_HEADERS=ON -DACCESSKIT_BUILD_LIBRARIES=OFF
cmake --build build
cmake --install build
AccessKit is licensed under the Apache License, Version 2.0 or the MIT license, at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in AccessKit by you, as defined in the Apache License, shall be dual-licensed as above, without any additional terms or conditions.
The list of authors for copyright purposes is in the AUTHORS file.
Significant portions of AccessKit are derived from Chromium and are covered by its BSD-style license.
The Meson build system for accesskit-c is licensed under the GNU Lesser General Public License, Version 2.1. Note that this license applies only to the build system, not to the accesskit-c library itself.