Встановлення залежностей
Посібник з налаштування локального середовища розробки 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 (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.
Налаштування інструментів ШІ для розробки на Solana
Цей розділ описує додаткові інструменти штучного інтелекту, які ви можете використовувати для прискорення розробки на Solana.
| Інструмент | Опис | Посилання |
|---|---|---|
| MCP | MCP сервер, до якого можна підключитися через cursor для покращення розробки на Solana з допомогою ШІ. | https://mcp.solana.com/ |
| LLMs.txt | Оптимізована для LLM документація, яку можна використовувати для навчання LLM на основі документації Solana. | https://solana.com/llms.txt |
Is this page helpful?