> For the complete documentation index, see [llms.txt](https://gushi10546.gitbook.io/aptos-kai-fa-zhe-wen-dang/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gushi10546.gitbook.io/aptos-kai-fa-zhe-wen-dang/aptos-cli/an-zhuang-aptos-cli.md).

# 安装 Aptos CLI

Aptos 工具是一个命令行界面（CLI），用来在 Aptos 区块链上进行开发，进行智能合约 debug，以及节点运营。此份文档描述了如何安装 Aptos CLI。查看[使用 Aptos CLI](/aptos-kai-fa-zhe-wen-dang/aptos-cli/shi-yong-aptos-cli.md)。

在你的平台上，下载预编译二进制文件来安装 CLI，如下文所述：

{% hint style="info" %}
💡 **MOVE prover 依赖项** 

如果你想使用 Move prover，在安装 CLI libary 之后，安装[MOVE prover依赖](#ke-xuan-an-zhuang-move-prover-yi-lai)项
{% endhint %}

## 下载预编译二进制文件

1. 进入 [Aptos CLI 发布页面](https://github.com/aptos-labs/aptos-core/releases?q=cli\&expanded=true)
2. 在最新发布的部分中，你可以看到有这样格式文件名的压缩文档：`aptos-cli-<version>-<platform>`。这些是基于平台的预编译二进制文件。下载他们。
3. 解压缩这些文件，将把 aptos CLI 二进制文件压缩至你的默认下载文件夹。例如，在 MacOS 中是 `~/Downloads` 文件夹
4. 将这个解压后的文件放到你常用的本地文件夹中。例如，在 Linux 或者 MacOS 中，放在`~/bin/aptos` 文件夹中

   💡 **升级？记得查看默认下载文件夹：** 当你更新 CLI 二进制文件到最新版本，新的版本会下载至默认文件夹。记得把它移动到`~/bin/aptos`，覆盖旧版本
5. 运行下面的命令来执行 `~/bin/aptos`：
   * Linux 和 MacOS：`chmod +x ~/bin/aptos`
   * 在 MacOS 上，当你第一次尝试运行 aptos 工具，将会被提示“来自未知开发者”，这属于正常情况，依照 Apple 支持中心的简单几个步骤，来解除这个阻止：[从未知开发者处打开 Mac 应用程序](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unidentified-developer-mh40616/mac)
6. 输入 `~/bin/aptos help` 来阅读帮助指南
7. 在`.bashrc`或者 `.zshrc`文件中增加 `~/bin` 路径，以备未来用到

## （可选）安装 Move Prover 依赖

依照下列步骤安装 Move Prover：

{% hint style="info" %}
💡 **Windows 系统不支持 Move Prover**
{% endhint %}

1. 确保你已经安装了git：<https://git-scm.com/book/en/v2/Getting-Started-Installing-Git>
2. 克隆 Aptos 核心仓库：`git clone <https://github.com/aptos-labs/aptos-core.git`>
3. 把路径改为 aptos-core 路径：`cd aptos-core`
4. 执行开发设置脚本来准备环境：`./scripts/dev_setup.sh -yp`
5. 对配置文件执行 source 指令： `source ~/.profile`

   \<aside> 💡 **信息** 注意你需要在 `~/.profile` 中包含环境变量定义，根据你的设置，`~/.profile` 可能已经自动地加载到每个登录 shell，也可能没有，你需要在 `~/.bash_profile` 中增加 `. ~/.profile`，或者在其他 shell 的配置中手动增加。

   \</aside>
6. 执行 Move Prover 来验证一个示例：

   ```
   aptos move prove --package-dir aptos-move/move-examples/hello_prover/
   ```

* （仅限高级用户）从源代码构建 CLI 二进制文件

  如果您是高级用户并且想通过下载源代码来构建 CLI 二进制文件，请按照以下步骤操作。 **不建议这样做。**

  1. 确保您已安装 git[https://git-scm.com/book/en/v2/Getting-Started-Installing-Git。](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git%E3%80%82)
  2. 克隆 Aptos 核心仓库：`git clone [<https://github.com/aptos-labs/aptos-core.git`。>]\([https://github.com/aptos-labs/aptos-core.git](https://github.com/aptos-labs/aptos-core.git%E3%80%82))。
  3. 将目录更改为 `aptos-core` 目录：`cd aptos-core`。
  4. 运行开发设置脚本以准备您的环境：`./scripts/dev_setup.sh`。
  5. 更新你当前的 shell 环境：`source ~/.cargo/env`。
  6. 签出正确的分支 `git checkout --track origin/<branch>`，其中 `<branch>` 是：
     * devnet 用于在 Aptos devnet 上构建。
     * testnet 用于在 Aptos 测试网上构建。
     * main 用于当前的开发分支。
  7. 构建 CLI 工具：`cargo build --package aptos --release`。
  8. 二进制文件将在 `target/release/aptos` 文件夹中可用。
  9. （可选）将此可执行文件移动到路径上的某个位置，例如 `~/bin/aptos`.