SDK 与执行模式#
MuduDB 提供 Rust、AssemblyScript、Python、C#、Go 和 C 六种语言绑定。使用时需明确选择执行模式:
模式 |
业务逻辑执行位置 |
要求 |
|---|---|---|
MPK guest |
|
构建并安装 |
本地适配器 |
本地应用进程中 |
通过语言 API 选择 adapter,并加载单独构建的本地运行库。 |
MUDU_CONNECTION 选择适配器的数据库后端,不会将本地应用切换为服务端过程。本地模式支持 SQLite、PostgreSQL、MySQL 和远程 Mudud,SQL 能力与事务行为取决于后端。Wallet 示例用于演示调用,不代表生产账务系统的并发保证。
各语言入口#
下列路径相对于 MuduDB 源码仓库。
语言 |
MPK 示例 |
本地适配器入口 |
|---|---|---|
AssemblyScript |
|
|
Python |
|
|
C# |
|
|
Go |
|
|
C |
|
|
Rust |
|
独立 SDK 的 |
仓库内的 Rust mududb facade 与导出的 mudu_api_rust SDK 是不同的包;消费者可以在 Cargo 中将后者重命名为 mududb。C 与 Go 的类型/编解码绑定本身不是完整的 guest 数据库 facade,MPK 示例还提供宿主调用桥接。各语言 API 覆盖范围并不完全相同。
构建 SDK 分发包#
在 MuduDB 仓库根目录执行:
cargo make build-sdk
SDK_LANGS=py,go cargo make build-sdk
cargo make build-sdk --with-adapter-runtime
SDK_LANGS=py,go cargo make build-sdk --with-examples
cargo make build-sdk --with-examples --example-mode adapter
默认构建全部六种 SDK,需要安装所选语言的全部工具链。公共依赖为 Python 3.11+、Git、仓库固定的 Rust 工具链、cargo-make 和本地 C/C++ 编译器。语言依赖包括 Node.js 22/npm(AS)、Python build(Python)、.NET 8 SDK 与运行时(C# SDK 测试)、Go 1.24+(Go)、Clang/Clang++(C)及 wasm32-wasip2(Rust)。
默认输出为 target/sdk-dist/;可用 SDK_OUTPUT_DIR、SDK_PYTHON 和 CARGO_TARGET_DIR 指定输出目录、解释器与 Cargo 构建目录。每种语言包含 repo/ 与 artifacts/;整批成功后写入含源码版本和验证结果的 manifest.json。该命令只构建分发包,发布使用独立的手动工作流。
每个导出 SDK 都包含 examples/wallet/mpk/ 和 examples/wallet/adapter/。在导出的 Wallet 目录执行 mpm build,读取 mpm.toml 并生成 target/wallet-<language>.mpk;这与仓库内 Rust Wallet 的 cargo make package 路径不同。mpm build --manifest-path PATH --python PYTHON 可指定清单与解释器。
示例的额外工具链#
组件 |
工具要求 |
|---|---|
本地适配器运行库 |
Rust、本地 C/C++、CMake、Node.js、Clang |
MPK guest |
|
Python guest |
|
Go guest |
TinyGo 0.42.0 与兼容的 Go |
C guest |
wasi-sdk 29,通过 |
C# guest |
.NET 10;完整 guest 测试矩阵目前面向 Linux x64 |
C# 本地适配器 |
.NET 8 |
Go 本地适配器 |
cgo 与 C 编译器 |
解压匹配宿主平台的 adapter runtime 包,将 MUDU_ADAPTER_LIBRARY 设置为运行库的绝对路径。AS 还需将 mudu_adapter.node 放在运行库旁。普通 SDK 源码导出不包含本地运行库二进制。进程启动前设置连接,例如:
export MUDU_CONNECTION='sqlite://wallet.db'
# 本地应用连接到已有的 Mudud 应用/schema:
export MUDU_CONNECTION='mudud://127.0.0.1:9527/wallet-py?http_addr=127.0.0.1:8300'
Mudud Wallet adapter 需先构建并安装 MPK 以建立 schema,再跳过 adapter 的 init,运行 scenario。验证不同执行模式时应使用各自独立的数据库。
实现和完整构建要求见 MuduDB 仓库中的 doc/dev/sdk_distribution.md、script/sdk/config.json、script/sdk/sdk_build.py 及各语言示例。