Skip to content

建立新專案 ​

Pumpkin 插件使用 Cargo 建構系統。

此插件的完整程式碼可在 GitHub 上的模板中找到。

安裝工具鏈 ​

在編譯插件之前,我們必須安裝 wasm32-wasip3 目標。你可以透過執行以下指令來安裝該目標:

bash
rustup target add wasm32-wasip3

初始化新的 crate ​

首先,我們需要建立一個新的專案資料夾。你可以在已建立的資料夾中執行以下指令:

bash
cargo new <project-name> --lib

完成後,我們要建立一個名為 .cargo 的新目錄,並在其中新增一個 config.toml 檔案,內容如下:

toml
[build]
target = "wasm32-wasip3"

最終,新資料夾的結構應如下所示:

bash
├── .cargo/
│   └── config.toml
├── src/
│   └── lib.rs
├── Cargo.toml
└── Cargo.lock

設定 crate ​

由於 Pumpkin 插件在執行時作為動態程式庫載入,我們需要告訴 Cargo 將此 crate 建構為動態程式庫。

toml
[package]
name = "hello-pumpkin-wasm"
version = "0.1.0"
edition = "2024"

[lib] 
crate-type = ["cdylib"]

[dependencies]

接下來,我們需要從 crates.io 新增一些基本依賴項:

toml
[package]
name = "hello-pumpkin"
version = "0.1.0"
edition = "2024"

[lib]
crate-type = ["cdylib"]

[dependencies]
# 這是讓插件建立更簡單的 API crate,其中包含 WIT 定義
pumpkin-plugin-api = "0.2.1+26.3-26.51"
# 可選:用於市集授權和更新檢查的實用工具
pumpkin-plugin-utils = "0.1.0-dev+26.2-26.45"
tracing = "0.1"

為了提高效能並減小檔案體積,我們建議啟用連結時最佳化(Link-Time Optimization,LTO)。 請注意,這會增加編譯時間。

toml
[profile.release] 
lto = true

僅為 release 建構啟用 LTO。

基於 MIT 授權條款釋出。