為了在 Fluence 平台上開發,我們推薦使用 Fluence CLI。
確保版本相容性
為了確保 Fluence 協議的所有組件無縫工作,維護各部分版本匹配至關重要。你使用的 Fluence CLI 版本必須與要連接的 Nox 版本相容。
保持 Fluence CLI 的最新
更新 Fluence CLI 是確保版本相容性的第一步也是最重要的一步。使用 fluence update 命令來更新 Fluence CLI。此命令的允許參數包括:
dar - 與當前 dar 環境相容的版本
kras - 與當前 kras 環境相容的版本
stage - 與當前 stage 環境相容的版本
main - 主分支的最新構建
例如,如果你在使用 dar 環境,請先運行 fluence update dar。還需要使用 --env 標誌選擇環境,或在 Fluence 項目內運行 fluence default env dar 以將環境設置為項目的默認環境。
確保依賴項的相容性
Fluence CLI 包含所有經過測試可以一起正常工作的 Fluence 協議部分的硬編碼版本。一般來說,如果你在使用本地 Fluence 網絡,一切應該都能正常工作。但是,你可能在項目的 fluence.yaml 配置中指定了與當前 CLI 版本不匹配的依賴項。要將這些依賴項重置為默認版本,請運行:
bash
複製代碼
fluence dep r
雖然不是必需的,但每次更新 CLI 時運行此命令是個好習慣,以確保相容性。高級用戶可以運行 fluence dep v 查看所有這些版本。
管理 Fluence CLI 依賴項
Aqua
要安裝項目的 Aqua 依賴項,請運行:
bash
複製代碼
fluence dep i
你可以安裝特定的 Aqua 依賴項:
bash
複製代碼
fluence dep i @fluencelabs/aqua-lib@0.9.1
要卸載特定的 Aqua 依賴項,請運行:
bash
複製代碼
fluence dep un @fluencelabs/aqua-lib
你也可以直接編輯 fluence.yaml,然後運行 fluence dep i。
高級用戶請注意,Aqua 編譯器目前依賴 npm 作為其包管理器。如果遇到任何問題,請參閱 npm 文檔。Fluence CLI 管理其自己的 npm 版本,因此不需要單獨安裝 npm。
Rust
Fluence CLI 會嘗試在 Linux 和 macOS 上為你安裝 Rust。如果你使用 Windows 或者 CLI 無法安裝 Rust,請參考 Rust 官方文檔進行安裝。
Fluence CLI 還會安裝所需的 Rust 工具鏈並添加 wasm32-wasi 目標。如果遇到與 Rust 相關的問題,請嘗試以下操作:
確保你沒有兩個 Rust 安裝(例如,通過 rustup 和 brew 在 macOS 上安裝)。
手動安裝 wasm32-wasi:
bash
複製代碼
rustup target add wasm32-wasi
rustup target add wasm32-wasi --toolchain nightly
rustup update
必要時重新安裝 Rust。
Marine 和 Mrepl
為了創建和編譯你的 Rust 代碼到 WASI 並測試生成的 Wasm 模塊,你需要 Marine CLI 和 Marine REPL。兩個組件都由 Fluence CLI 包裝,並從各自的 GitHub 發布版本懶加載。要強制下載,請運行:
bash
複製代碼
fluence dep i
高級用戶可以在項目中使用 marineVersion 和 mreplVersion 屬性覆蓋 marine 和 mrepl 版本。如果下載失敗,Fluence CLI 將嘗試使用 cargo 從源碼構建 marine 和 mrepl。
Docker
如果你想使用本地 Fluence 網絡,Docker 是必需的,這在將代碼部署到遠程 dar 或 kras 環境之前測試代碼非常有用。使用官方 Docker 文檔為你的操作系統安裝 Docker Desktop。安裝後,在嘗試使用以下命令設置本地 Fluence 網絡之前,記得運行 Docker:
bash
複製代碼
fluence local up
通過遵循這些步驟和指南,你可以為 Fluence 設置並維護一個相容且高效的開發環境。