Aptos CLI 软件
这个 @aptos-labs/aptos-cli 软件包允许您使用 Aptos CLI Nodejs 项目.
下载
要安装 Aptos CLI, 您需要在您的系统中安装节点和npm 。 然后,你可以使用:
npm install @aptos-labs/aptos-cli
该命令将下载 Aptos CLI 并创建一个节点本文件,使其可用于节点环境.
安装
一旦安装了软件包和节点本文件,您就可以在您的项目环境中运行以下命令,以便在您的项目中安装 Aptos CLI :
npx aptos --install
或者,你可以简单地使用 npx aptos 命令。 这将安装 Aptos CLI 在您的项目中, 如果它还没有安装的话 .
npx aptos
使用量
在您的项目环境中使用 Aptos CLI 运行 npx aptos 命令,以查看可用的命令.
npx aptos
折叠器专用旗等 --install, (中文(简体) ), --update, (中文(简体) ), --binary-path,以及 --direct-download 由节点CLI包装器处理。 其他参数被转发到Aptos CLI 二进制,当二进制需要作为同一引用的一部分被安装时,此二进制也起作用. 例如:
npx aptos --help
npx aptos move compile --package-dir ./my-move-package
使用自定义二进制
如果您的系统中已经安装了 Aptos CLI 二进制, 您可以指定其路径直接使用 :
npx aptos --binary-path /path/to/aptos <command>
安装特定版本
您可以通过设置 Aptos 的 CLI 安装特定版本 APTOS_CLI_VERSION 环境变量 :
# Install version 4.5.0
APTOS_CLI_VERSION=4.5.0 npx aptos --install
# Or with the v prefix
APTOS_CLI_VERSION=v4.5.0 npx aptos --install
何时 APTOS_CLI_VERSION 设置为:
- 指定的版本直接从 GitHub 版本下载( 包管理器被绕过)
- 该版本经过验证以确保在下载前存在
- 这对双方都有用
--install财务报告和审定财务报表--update命令
这对于:
- 连接到已知的工作版本
- 对照特定CLI版本进行测试
- CI/CD管道的可复制建筑
更新 Aptos 的 CLI
要更新 Aptos CLI, 您可以在您的工程环境中运行以下命令 :
npx aptos --update
发展
设立发展项目:
- 清除仓库
- 安装依赖性 :
npm install - 运行开发服务器 :
npm run dev
这将构建项目并运行CLI.
大楼
为建设该项目:
npm run build
移动 CI/CD 中的艺术
Aptos CLI可用于CI/CD管道来构建Move套件并生成部署有效载荷. 这对于自动化部署和多步骤工作流程是有用的.
示例: 构建发布有效载荷
# In your GitHub Actions workflow
# Prerequisites: Set up Node.js first
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: "22"
- name: Install Aptos CLI npm package
run: npm install @aptos-labs/aptos-cli
- name: Install Aptos CLI
run: npx aptos --install
- name: Build Move package
working-directory: your-move-project
run: |
~/.local/bin/aptos move compile \
--named-addresses your_module=0x1 \
--save-metadata
- name: Generate publish payload
working-directory: your-move-project
run: |
~/.local/bin/aptos move build-publish-payload \
--named-addresses your_module=0x1 \
--json-output-file publish-payload.json \
--assume-yes
- name: Upload artifact for later steps
uses: actions/upload-artifact@v4
with:
name: move-artifacts
path: your-move-project/publish-payload.json
实例:建筑物升级有效载荷(目标代码部署)
为更新现有标的物合同:
- name: Generate upgrade payload
working-directory: your-move-project
run: |
~/.local/bin/aptos move build-upgrade-payload \
--named-addresses your_module=0x1 \
--object-address 0xYOUR_OBJECT_ADDRESS \
--json-output-file upgrade-payload.json \
--assume-yes
在以后的作业中使用艺术
jobs:
build:
runs-on: 4cpu-gh-ubuntu24-x64
steps:
# ... build steps above ...
- uses: actions/upload-artifact@v4
with:
name: move-artifacts
path: your-move-project/publish-payload.json
deploy:
needs: build
runs-on: 4cpu-gh-ubuntu24-x64
steps:
- uses: actions/download-artifact@v4
with:
name: move-artifacts
- name: Use the payload
run: |
# The payload JSON can be used for deployment
cat publish-payload.json
见 建设-移动-艺术. yaml 完整工作实例的工作流程.