Посібник з налаштування локального середовища розробки Solana. Дізнайтеся, як встановити Rust, Solana CLI та Anchor Framework на Windows (WSL), Linux та Mac. Використовуйте цей посібник, якщо ви віддаєте перевагу встановленню кожної залежності окремо, або якщо швидке встановлення з якоїсь причини не спрацювало.
Передумови
Встановлення Rust
Розробники створюють програми Solana, використовуючи мову програмування Rust.
- Встановіть Rust за допомогою rustup, ввівши наступну команду у вашому терміналі:
$curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
Після успішного встановлення ви побачите таке повідомлення:
- Перезавантажте змінну середовища PATH, щоб включити директорію bin Cargo:
$. "$HOME/.cargo/env"
- Переконайтеся, що встановлення пройшло успішно.
$rustc --version
Ви побачите вивід, схожий на такий:
rustc 1.86.0 (05f9846f8 2025-03-31)
Встановлення Solana CLI
Solana CLI надає всі інструменти, необхідні для створення та розгортання програм Solana.
- Встановіть набір інструментів Solana CLI за допомогою офіційної команди встановлення:
$sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
Ви можете замінити stable на тег релізу, що відповідає версії програмного
забезпечення бажаного релізу (наприклад, v2.0.3), або використати одну з
трьох символічних назв каналів: stable, beta або edge.
- Додайте змінну середовища PATH
Під час першого встановлення Solana CLI може з'явитися запит на додавання
змінної середовища PATH. Для цього закрийте та знову відкрийте термінал або
виконайте наступну команду у вашій оболонці:
export PATH="/Users/test/.local/share/solana/install/active_release/bin:$PATH"
- Оновіть змінну середовища PATH
Якщо ви використовуєте Linux або WSL, вам потрібно додати бінарний файл Solana CLI до вашого PATH, щоб команда була доступна у вашому терміналі. Для цього виконайте наступні кроки:
a. Перевірте, яку оболонку ви використовуєте:
$echo $SHELL
- Якщо вивід містить
/bash, використовуйте.bashrc. - Якщо вивід містить
/zsh, використовуйте.zshrc.
б. Виконайте відповідну команду залежно від вашої оболонки.
Для Bash (bashrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc$source ~/.bashrc
Для Zsh (zshrc):
$echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.zshrc$source ~/.zshrc
- Перезапустіть термінал або виконайте наступну команду, щоб оновити сесію терміналу:
$source ~/.bashrc # If using Bash$source ~/.zshrc # If using Zsh
- Переконайтеся, що встановлення пройшло успішно, перевіривши версію Solana CLI:
$solana --version
Ви побачите вивід, схожий на наступний:
solana-cli 2.2.12 (src:0315eb6a; feat:1522022101, client:Agave)
Ви можете переглянути всі доступні версії в репозиторії Agave на Github. Agave — це клієнт validator від Anza, раніше відомий як клієнт validator Solana Labs.
- Оновіть Solana CLI до останньої версії за потреби (Опціонально)
$agave-install update
Встановлення Anchor CLI
Anchor — це фреймворк для розробки програм Solana. Фреймворк Anchor використовує макроси Rust для спрощення процесу написання програм Solana.
Передумови
Стандартний тестовий файл проєкту Anchor (TypeScript), створений командою
anchor init, потребує Node.js та Yarn. (Шаблон тестів Rust доступний за
допомогою anchor init --test-template rust)
Встановлення
Ви можете встановити Anchor CLI та інструменти двома способами:
- Anchor Version Manager (AVM) — рекомендований спосіб встановлення
- Без AVM — встановлення безпосередньо з GitHub
Anchor Version Manager (AVM) дозволяє встановлювати та керувати різними версіями Anchor у вашій системі та легко оновлювати версії Anchor у майбутньому. Щоб встановити Anchor за допомогою AVM, виконайте наступні кроки:
- Встановіть AVM за допомогою наступної команди:
$cargo install --git https://github.com/solana-foundation/anchor avm --force
- Підтвердьте успішне встановлення AVM:
$avm --version
- Встановіть Anchor CLI за допомогою AVM:
Щоб встановити останню версію:
$avm install latest$avm use latest
Щоб встановити конкретну версію, вкажіть номер версії:
$avm install 0.30.1$avm use 0.30.1
Під час встановлення Anchor CLI на Linux або WSL ви можете зіткнутися з цією помилкою:
error: could not exec the linker cc = note: Permission denied (os error 13)
Якщо ви бачите це повідомлення про помилку, виконайте наступні кроки:
- Встановіть залежності, перелічені в розділі Linux на початку цієї сторінки.
- Повторіть спробу встановлення Anchor CLI.
- Перевірте успішність встановлення, перевіривши версію Anchor CLI:
$anchor --version
Ви побачите вивід, схожий на наступний:
anchor-cli 0.31.1
Не забудьте виконати команду avm use, щоб оголосити версію Anchor CLI,
яка буде запускатися у вашій системі.
- Якщо ви встановили версію
latest, виконайтеavm use latest. - Якщо ви встановили версію
0.30.1, виконайтеavm use 0.30.1.
Встановлення Surfpool CLI
Surfpool — це інструмент для локальної розробки та
покращена заміна solana-test-validator. Дізнайтеся більше про можливості
Surfpool у документації Surfpool.
- Встановіть Surfpool за допомогою наступної команди:
$curl -sL https://run.surfpool.run/ | bash
- Перевірте, що встановлення пройшло успішно, перевіривши версію Surfpool CLI:
$surfpool --version
Ви побачите вивід, схожий на наступний:
surfpool 0.12.0
Налаштування AI-інструментів для розробки на Solana
У цьому розділі описано опціональне налаштування AI-інструментів, які можна використовувати для прискорення розробки на Solana.
| Інструмент | Опис | Посилання |
|---|---|---|
| MCP | MCP-сервер, до якого можна підключитися через Cursor для покращення AI-асистованої розробки на Solana. | https://mcp.solana.com/ |
| LLMs.txt | Оптимізована для LLM документація, яку можна використовувати для навчання LLM на документації Solana. | https://solana.com/llms.txt |
Is this page helpful?