#api-bindings #open-harmony #harmony-os #ffi

ohos-sys

Bindings to the native API of OpenHarmony OS

10 releases

0.3.1 Sep 5, 2024
0.3.0 Aug 29, 2024
0.2.2 Aug 18, 2024
0.2.1 Jul 23, 2024
0.1.0 Apr 29, 2024

#95 in Graphics APIs

Download history 5/week @ 2024-06-19 20/week @ 2024-06-26 10/week @ 2024-07-03 14/week @ 2024-07-10 156/week @ 2024-07-17 655/week @ 2024-07-24 763/week @ 2024-07-31 825/week @ 2024-08-07 1720/week @ 2024-08-14 944/week @ 2024-08-21 1148/week @ 2024-08-28 1176/week @ 2024-09-04 912/week @ 2024-09-11 518/week @ 2024-09-18 760/week @ 2024-09-25 598/week @ 2024-10-02

2,940 downloads per month
Used in 2 crates

Apache-2.0

310KB
5K SLoC

ohos-sys

FFI-bindings for the native API of OpenHarmony OS. See the documentation for a list of supported components. This crate is under active development, and not officially affiliated with OpenHarmony OS.

Development

The current bindings are generated with bindgen using scripts/generate_bindings.sh. A separate file is generated for each API version, and (assuming no breaking changes) the new additions are manually copied to an apiXX_additions.rs file, which is included as a module if feature = api-XX is selected. The generated file drawing_apiXX.rs should be committed to version control, so we can easily rerun the script on a patch-release for a given API-level and see what changed. The file itself is however not needed, and will be excluded from crates.io releases.

Contributing

There are still quite a few OpenHarmony APIs missing. Feel free to contribute missing APIs, but be sure to adapt the script, so your bindings are reproducible! Please also check the following:

  • Ensure that opaque struct definitions do not derive Copy, Clone and Debug.
  • Blocklist all unnecessary type definitions, e.g. from the C standard library.
  • Preferably generate the bindings with libclang in C mode. However, if a header file is not C-compliant due to an issue of the OpenHarmony SDK, then setting libclang to C++ mode is fine.
  • Be sure to guard the new component behind a cargo feature and document the feature in Cargo.toml.
  • If you did not generate the bindings with API-level 10, specify which API-level you generated the bindings with and guard the generated module behind the corresponding api-level feature flag.
  • Installing bindgen: We require at least bindgen 0.70.0, with the prettyplease feature enabled. You can install it by running cargo install bindgen-cli --features prettyplease

License

This crate is licensed under the Apache-2.0 license, matching the OpenHarmony OS SDK.

Dependencies