Руководство по установке Aptos CLI

Утилита aptos - это интерфейс командной строки (CLI) для разработки на блокчейне Aptos, отслеживания контрактов Move и операций с нодами. В этом документе описано, как установить инструмент aptos CLI. О том, как использовать CLI, читайте в разделе Руководство по использованию Aptos CLI.

Установите CLI, загрузив предварительно скомпилированный двоичный файл для вашей платформы, как описано ниже.

ЗАВИСИМОСТИ MOVE PROVER Если вы хотите использовать Move Prover, то установите зависимости Move Prover после установки двоичного файла CLI.

Загрузить предварительно скомпилированный двоичный файл

1. Перейдите на страницу выпуска Aptos CLI.

2. В разделе последних релизов вы увидите zip-файлы с именем формата: aptos-cli--<version><platform>. Это предварительно скомпилированные двоичные файлы CLI для конкретной платформы. Скачайте zip-файл для вашей платформы.

3. Распакуйте загруженный файл. В результате двоичный файл aptos CLI будет извлечен в папку загрузок по умолчанию. Например, на MacOS это папка ~/Downloads.

4. Поместите извлеченный файл aptos в то место, где вы сможете его запустить. Например, поместите его в ~/bin/aptos в Linux или MacOS.

ОБНОВЛЯЕТЕСЬ? НЕ ЗАБЫВАЙТЕ ИСКАТЬ В ПАПКЕ ЗАГРУЗОК ПО УМОЛЧАНИЮ Когда вы обновляете двоичный файл CLI до последней версии, обратите внимание, что двоичный файл новой версии будет загружен в папку Downloads по умолчанию. Не забудьте переместить этот двоичный файл новой версии из папки Downloads в папку ~/bin/aptos (перезаписав старую версию).

5. В Linux и Mac сделайте ~/bin/aptos исполняемым файлом, выполнив следующую команду:

• В Linux и MacOS: chmod +x ~/bin/aptos.

• На MacOS при первой попытке запустить утилиту aptos, macOS заблокирует вас, сообщив, что это приложение от "неизвестного разработчика". Это нормально. Выполните простые действия, рекомендованные службой поддержки Apple в статье Open a Mac app from an unidentified developer, чтобы снять эту блокировку.

6. Введите ~/bin/aptos help, чтобы прочитать инструкции.

7. Добавьте ~/bin к вашему пути в соответствующих .bashrc или .zshrc для дальнейшего использования.

(Необязательно) Установите зависимости Move Prover

Если вы хотите использовать Move Prover, установите зависимости, выполнив следующие шаги:

WINDOWS НЕ ПОДДЕРЖИВАЕТСЯ Move Prover не поддерживается в Windows.

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. Запустите скрипт dev setup для подготовки среды: ./scripts/dev_setup.sh -yp.

5. Создайте файл профиля: source ~/.profile

ИНФОРМАЦИЯ Обратите внимание, что вы должны включить определения переменных среды в ~/.profile в вашу среду оболочки. В зависимости от вашей конфигурации, ~/.profile может автоматически загружаться при каждом входе в оболочку, а может и нет. Если нет, вам может потребоваться добавить . ~/.profile в ваш ~/.bash_profile или другую конфигурацию оболочки вручную.

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.

2. Клонируйте репозиторий Aptos core: git clone https://github.com/aptos-labs/aptos-core.git.

3. Измените каталог на каталог aptos-core: cd aptos-core.

4. Запустите скрипт dev setup для подготовки среды: ./scripts/dev_setup.sh.

5. Обновите текущую среду оболочки: source ~/.cargo/env.

6. Проверьте правильность выбора ветки git checkout --track origin/<branch>, где <branch> это:

   • devnet для сборки в сети Aptos devnet.

   • testnet для сборки в сети Aptos testnet.

   • main для текущей ветки разработки.

7. Создайте инструмент CLI: cargo build --package aptos --release.

8. Бинарный файл будет доступен в target/release/aptos folder.

9. (Необязательно) Переместите этот исполняемый файл в другое место вашего пути, например ~/bin/aptos.