Rust与C的FFI示例项目指南

Rust与C#的FFI示例项目指南

rust-csharp-ffiAn example Rust + C# hybrid application项目地址:https://gitcode.com/gh_mirrors/ru/rust-csharp-ffi

本指南将详细介绍如何理解和操作GitHub上的开源项目KodrAus/rust-csharp-ffi，该项目展示了如何在Rust和C#之间通过FFI（Foreign Function Interface）进行交互。我们将分为三个主要部分进行探索：项目的目录结构、启动文件以及配置文件。

1. 项目的目录结构及介绍

项目整体架构：

本项目采用典型的双语言结构，包含Rust代码和C#代码两个主要组件。结构布局确保了语言间的良好隔离，同时也便于双方的调用和数据交换。

• root
  • dotnet: 包含C#相关的源码与配置，用于执行和调用Rust库。
    • DbApi: 包含C#应用程序的入口点。
    • DbStorage: 示例存储逻辑，展示如何通过FFI与Rust交互。
  • rust: Rust代码存放位置，编译后提供给C#调用的库。
    • src: 实际的Rust源代码文件。
  • Cargo.toml: Rust项目的主要配置文件，定义依赖与构建指令。
  • .csproj: C#项目的配置文件，控制C#项目的编译与依赖。

关键文件简介:

• Cargo.toml: Rust的元数据文件，指定项目名称、版本、作者、依赖项等。
• 任意.rs文件（如src/lib.rs）: Rust库的主入口，实现对外的函数接口。
• .csproj（例如 dotnet/DbStorage/DbStorage.csproj 和 dotnet/DbApi/DbApi.csproj）: 定义C#项目属性、引用和编译选项。

2. 项目的启动文件介绍

C#启动文件: 位于dotnet/DbApi/Program.cs，是C#应用的起点。它负责初始化并调用由Rust提供的功能。通常包含调用FFI绑定的逻辑，以激活Rust代码的功能。

Rust启动逻辑: 虽然Rust本身作为库时没有“启动文件”，但其lib.rs或特定的库入口点函数是C#通过FFI访问的核心，如其中定义的外部函数接口(extern)。

3. 项目的配置文件介绍

• Cargo.toml: 这是Rust项目的生命线，描述了项目的结构、版本、依赖关系和构建脚本。重要配置包括[lib]部分，用于标记这是一个库而非可执行程序，以及dependencies列出的所有外部Rust库。

• .csproj: 在C#世界中，这些文件控制着项目编译过程，包括哪些文件应被编译、附加的引用以及构建目标等。例如，通过<Reference>标签添加对Rust生成的DLL的引用，使C#能够调用Rust代码。

综上所述，这个项目通过精心设计的目录结构、明确的启动文件和详尽的配置，实现了Rust与C#之间的无缝交互，为跨语言开发提供了实用范例。开发者可以通过研究这些组成部分来学习如何有效地利用FFI进行混合编程。

rust-csharp-ffiAn example Rust + C# hybrid application项目地址:https://gitcode.com/gh_mirrors/ru/rust-csharp-ffi