swift-bridge

swift-bridge 促进 Rust 和 Swift 之间的互操作性。

swift-bridge 使得在 Rust 和 Swift 之间传递和共享高级类型变得简单，例如 String、Option<T>、Result<T, E>、struct、class 等更多类型。

它还帮助您桥接高级语言特性，如异步函数和泛型。

使用 swift-bridge 应该比手动管理 Rust 和 Swift FFI 更安全、性能更高、更易于使用。

安装

# In your Cargo.toml

[build-dependencies]
swift-bridge-build = "0.1"

[dependencies]
swift-bridge = "0.1"

书籍

您可以在 swift-bridge 书籍 中找到关于如何使用 Rust 和 Swift 一起使用的相关信息。

快速预览

您通过在 "桥接模块" 中声明您想要导入和导出的类型和函数来使用 swift-bridge，然后使用 #[swift_bridge::bridge] 宏来注释该桥接模块。

然后，在构建时，您可以使用 swift-bridge-build API 或 swift-bridge-cli CLI 来解析您的注释桥接模块，并生成 FFI 层的 Swift 和 C 代码。

以下是如何使用桥接模块描述 Swift 和 Rust 之间 FFI 边界的快速预览。

// We use the `swift_bridge::bridge` macro to declare a bridge module.
// Then at build time the `swift-bridge-build` crate is used to generate
// the corresponding Swift and C FFI glue code.
#[swift_bridge::bridge]
mod ffi {
    // Create "transparent" structs where both Rust and Swift can directly access the fields.
    struct AppConfig {
        file_manager: CustomFileManager,
    }

    // Transparent enums are also supported.
    enum UserLookup {
        ById(UserId),
        ByName(String),
    }

    // Export opaque Rust types, functions and methods for Swift to use.
    extern "Rust" {
        type RustApp;

        #[swift_bridge(init)]
        fn new(config: AppConfig) -> RustApp;
        
        fn get_user(&self, lookup: UserLookup) -> Option<&User>;
    }

    extern "Rust" {
        type User;
        type MessageBoard;

        #[swift_bridge(get(&nickname))]
        fn informal_name(self: &User) -> &str;
    }

    // Import opaque Swift classes and functions for Rust to use.
    extern "Swift" {
        type CustomFileManager;
        fn save_file(&self, name: &str, contents: &[u8]);
    }
}

struct User {
    nickname: String
}

快速入门

swift-bridge 仓库包含 示例应用程序，您可以使用这些应用程序快速尝试库，或作为您自己的基于 Swift + Rust 的应用程序的起点。

例如，以下是如何在本地运行 codegen-visualizer 示例项目的步骤。

git clone https://github.com/chinedufn/swift-bridge
cd swift-bridge/examples/codegen-visualizer

open CodegenVisualizer/CodegenVisualizer.xcodeproj
# *** Click the "Run" button at the top left of Xcode ***

您可以在 swift-bridge 书籍 中找到关于如何使用 Rust 和 Swift 一起使用的相关信息。

内置类型

除了允许您在 Rust 和 Swift 之间共享自己的自定义结构体、枚举和类之外，swift-bridge 还支持一系列 Rust 和 Swift 标准库类型。

性能

swift-bridge 致力于在性能关键的环境中发挥作用。

其生成的 FFI 代码没有使用对象序列化、克隆、同步或其他任何形式的不必要开销。

测试

运行测试套件。

# Clone the repository
git clone [email protected]:chinedufn/swift-bridge.git
cd swift-bridge

# Run tests
cargo test --all && ./test-swift-rust-integration.sh && ./test-swift-packages.sh 

贡献

如果您有兴趣为 swift-bridge 贡献，请查看 贡献者指南。

熟悉贡献流程后，尝试查看一些 良好入门 issue，看看是否有任何问题引起您的兴趣。

这些问题附带逐步说明，应有助于引导您实施第一个补丁。

致谢

• cxx 启发了使用桥接模块来描述 FFI 边界的想法。

许可证

根据 MIT 或 Apache-2.0 许可。

lib.rs:

swift-bridge 命令行界面。