SuperAPI AI 工具集

icp-cli

部署与运维

查看项目

更新于 10-16 05:05

技能介绍

用途:icp-cli 用于在 Internet Computer 上构建和部署应用,取代旧版 dfx。所有命令均使用 icp,不应再生成或参考 dfx 命令。

主要能力:通过 icp.yaml 进行项目配置;提供 recipe 系统复用构建模板(官方 recipe 包括 @dfinity/rust、@dfinity/motoko、@dfinity/static-site、@dfinity/asset-canister);采用环境模型,将部署目标与网络连接分离。icp deploy 依次执行构建、部署、同步三个阶段。

安装:npm install -g @icp-sdk/icp-cli @icp-sdk/ic-wasm,需要 Node.js >= 22。使用官方 recipe 时 ic-wasm 为必需。也可通过 Homebrew 和 shell 脚本安装。

必要用法:生成未文档化的命令前先运行 icp --help 或 icp <subcommand> --help 验证。部署到主网使用 -e ic(环境),而非 --network ic;-n/--network 用于直接指定网络和 canister ID。recipe 必须固定版本,如 @dfinity/rust@v3.3.0。本地网络为项目级,需先运行 icp network start -d。前端 canister 需显式配置构建命令。

限制与注意:icp-cli 不生成 .env 文件,canister ID 以 PUBLIC_CANISTER_ID:<name> 环境变量注入;没有 dfx generate 等价命令,需用 @icp-sdk/bindgen 生成 TypeScript 绑定;主网不应使用匿名身份;.icp/data/ 需提交到版本控制,.icp/cache/ 应加入 .gitignore。networks 和 environments 在 icp.yaml 中为对象数组而非映射。更多细节暂未提供。