openharmony_ci
63b4efa5c5
bindgen新增bundle.json部件化 Created-by: dragonswordy Commit-by: ljy9810 Merged-by: openharmony_ci Description: ### 一、内容说明（相关的Issue） https://gitcode.com/openharmony/third_party_rust_autocfg/issues/3 ### 二、建议测试周期和提测地址 建议测试完成时间：xxxx.xx.xx 投产上线时间：xxxx.xx.xx 提测地址：CI环境/压测环境 测试账号： ### 三、变更内容 * 3.1 关联PR列表 * 3.2 数据库和部署说明 1. 常规更新 2. 重启unicorn 3. 重启sidekiq 4. 迁移任务：是否有迁移任务，没有写 "无" 5. rake脚本：`bundle exec xxx RAILS_ENV = production`；没有写 "无" * 3.4 其他技术优化内容（做了什么，变更了什么） - 重构了 xxxx 代码 - xxxx 算法优化 * 3.5 废弃通知（什么字段、方法弃用？） * 3.6 后向不兼容变更（是否有无法向后兼容的变更？） ### 四、研发自测点（自测哪些？冒烟用例全部自测？） 自测测试结论： ### 五、测试关注点（需要提醒QA重点关注的、可能会忽略的地方） 检查点： | 需求名称 | 是否影响xx公共模块 | 是否需要xx功能 | 需求升级是否依赖其他子产品 | |------|------------|----------|---------------| | xxx | 否 | 需要 | 不需要 | | | | | | 接口测试： 性能测试： 并发测试： 其他： See merge request: openharmony/third_party_rust_bindgen!18
bindgen
bindgen automatically generates Rust FFI bindings to C (and some C++) libraries.
For example, given the C header doggo.h:
typedef struct Doggo {
int many;
char wow;
} Doggo;
void eleven_out_of_ten_majestic_af(Doggo* pupper);
bindgen produces Rust FFI code allowing you to call into the doggo library's
functions and use its types:
/* automatically generated by rust-bindgen 0.99.9 */
#[repr(C)]
pub struct Doggo {
pub many: ::std::os::raw::c_int,
pub wow: ::std::os::raw::c_char,
}
extern "C" {
pub fn eleven_out_of_ten_majestic_af(pupper: *mut Doggo);
}
Users Guide
📚 Read the bindgen users guide here! 📚
MSRV
The bindgen minimum supported Rust version is 1.70.0.
The bindgen-cli minimum supported Rust version is 1.70.0.
No MSRV bump policy has been established yet, so MSRV may increase in any release.
The MSRV is the minimum Rust version that can be used to compile each crate. However, bindgen and bindgen-cli can generate bindings that are compatible with Rust versions below the current MSRV.
Most of the time, the bindgen-cli crate will have a more recent MSRV than bindgen as crates such as clap require it.
API Reference
API reference documentation is on docs.rs
Environment Variables
In addition to the library API and executable command-line API,
bindgen can be controlled through environment variables.
End-users should set these environment variables to modify bindgen's behavior without modifying the source code of direct consumers of bindgen.
BINDGEN_EXTRA_CLANG_ARGS: extra arguments to pass toclang- Arguments are whitespace-separated
- Use shell-style quoting to pass through whitespace
- Examples:
- Specify alternate sysroot:
--sysroot=/path/to/sysroot - Add include search path with spaces:
-I"/path/with spaces"
- Specify alternate sysroot:
BINDGEN_EXTRA_CLANG_ARGS_<TARGET>: similar toBINDGEN_EXTRA_CLANG_ARGS, but used to set per-target arguments to pass to clang. Useful to set system include directories in a target-specific way in cross-compilation environments with multiple targets. Has precedence overBINDGEN_EXTRA_CLANG_ARGS.
Additionally, bindgen uses libclang to parse C and C++ header files.
To modify how bindgen searches for libclang, see the clang-sys documentation.
For more details on how bindgen uses libclang, see the bindgen users guide.
Releases
We don't follow a specific release calendar, but if you need a release please
file an issue requesting that (ping @emilio for increased effectiveness).