Cài đặt các phụ thuộc

Cài đặt từng phần phụ thuộc riêng lẻ khi bạn cần một phiên bản cụ thể hoặc khi cài đặt nhanh không hoàn tất thành công. Hãy làm theo các phần theo thứ tự nếu bạn đang thiết lập môi trường mới, hoặc chuyển thẳng đến công cụ bạn cần cài đặt hoặc khắc phục sự cố.

Điều kiện tiên quyết

Cài đặt Rust

Các nhà phát triển xây dựng chương trình Solana bằng ngôn ngữ lập trình Rust.

  1. Cài đặt Rust bằng rustup bằng cách nhập lệnh sau vào terminal của bạn:
Terminal
$
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y

Sau khi cài đặt thành công, bạn sẽ thấy thông báo sau:

  1. Tải lại biến môi trường PATH của bạn để bao gồm thư mục bin của Cargo:
Terminal
$
. "$HOME/.cargo/env"
  1. Xác minh rằng quá trình cài đặt đã thành công.
Terminal
$
rustc --version

Lệnh sẽ in ra phiên bản Rust đã cài đặt, ví dụ:

rustc x.y.z (...)

Cài đặt Solana CLI

Solana CLI cung cấp tất cả các công cụ cần thiết để xây dựng và triển khai các chương trình Solana.

  1. Cài đặt bộ công cụ Solana CLI bằng cách sử dụng lệnh cài đặt chính thức:
Terminal
$
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"

Bạn có thể thay thế stable bằng một thẻ phát hành Agave cụ thể hoặc bằng kênh phát hành beta hoặc edge.

  1. Làm cho Solana CLI khả dụng trong terminal hiện tại của bạn.

Trình cài đặt sẽ cập nhật cấu hình shell của bạn và in ra lệnh cần thiết để cập nhật phiên làm việc hiện tại. Lệnh này thường là:

Terminal
$
export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"

Nếu solana vẫn không khả dụng, hãy khởi động lại terminal của bạn. Để xác nhận tệp cấu hình shell nào đã được trình cài đặt cập nhật, hãy kiểm tra shell hiện tại của bạn:

Terminal
$
echo $SHELL
  • Nếu kết quả chứa /bash, hãy khởi động lại terminal hoặc chạy source ~/.bashrc.
  • Nếu kết quả chứa /zsh, hãy khởi động lại terminal hoặc chạy source ~/.zshrc.
  1. Xác minh rằng quá trình cài đặt đã thành công:
Terminal
$
solana --version

Lệnh sẽ in ra phiên bản Solana CLI đã cài đặt, ví dụ:

solana-cli x.y.z (..., client:Agave)

Bạn có thể xem tất cả các phiên bản khả dụng trên kho GitHub của Agave. Agave là validator client của Anza, trước đây được gọi là Solana Labs validator client.

  1. Để cập nhật Solana CLI sau này, hãy chạy:
Terminal
$
agave-install update

Cài đặt Anchor CLI

Anchor là một framework để phát triển các chương trình Solana. Framework Anchor tận dụng các macro của Rust để đơn giản hóa quá trình viết các chương trình Solana.

Điều kiện tiên quyết

Node.js và một trình quản lý gói JavaScript chỉ cần thiết khi bạn chọn một mẫu kiểm thử TypeScript như Mocha hoặc Jest. Mẫu kiểm thử LiteSVM mặc định chạy bằng Rust và không yêu cầu công cụ Node.js.

Cài đặt

Bạn có thể cài đặt Anchor CLI và các công cụ theo hai cách:

  • Anchor Version Manager (AVM) — Phương pháp cài đặt được khuyến nghị
  • Không dùng AVM — Cài đặt trực tiếp từ GitHub

Anchor Version Manager (AVM) cho phép bạn cài đặt và quản lý các phiên bản Anchor khác nhau trên hệ thống của bạn và dễ dàng cập nhật phiên bản Anchor trong tương lai. Để cài đặt Anchor bằng AVM, hãy làm theo các bước dưới đây:

  1. Cài đặt AVM bằng lệnh sau:
Terminal
$
curl -sSfL https://raw.githubusercontent.com/otter-sec/anchor/master/avm/install | sh
  1. Xác nhận rằng AVM đã được cài đặt thành công:
Terminal
$
avm --version
  1. Cài đặt Anchor CLI bằng AVM:

Để cài đặt phiên bản mới nhất:

Terminal
$
avm install latest
$
avm use latest

Để cài đặt một phiên bản cụ thể, hãy chỉ định số phiên bản:

Terminal
$
avm install 1.1.2
$
avm use 1.1.2

Khi cài đặt Anchor CLI trên Linux hoặc WSL, bạn có thể gặp lỗi sau:

error: could not exec the linker cc = note: Permission denied (os error 13)

Nếu bạn thấy thông báo lỗi này, hãy làm theo các bước sau:

  1. Cài đặt các gói phụ thuộc được liệt kê trong phần Linux ở đầu trang này.
  2. Thử cài đặt lại Anchor CLI.
  1. Xác minh rằng việc cài đặt đã thành công bằng cách kiểm tra phiên bản Anchor CLI:
Terminal
$
anchor --version

Lệnh sẽ in ra phiên bản Anchor CLI đang được sử dụng, ví dụ:

anchor-cli 1.1.2

Chạy avm use để chọn phiên bản Anchor CLI cho hệ thống của bạn.

  • Nếu bạn đã cài đặt phiên bản mới nhất, hãy chạy avm use latest.
  • Nếu bạn đã cài đặt phiên bản 1.1.2, hãy chạy avm use 1.1.2.

Cài đặt Surfpool CLI

Surfpool là một công cụ dành cho phát triển cục bộ và là sự thay thế cải tiến cho solana-test-validator.

  1. Cài đặt Surfpool bằng lệnh sau:
Terminal
$
curl --proto '=https' --tlsv1.2 -sSfL https://run.surfpool.run/ | bash
  1. Xác minh rằng việc cài đặt đã thành công bằng cách kiểm tra phiên bản Surfpool CLI:
Terminal
$
surfpool --version

Lệnh sẽ in ra phiên bản Surfpool CLI đã cài đặt, ví dụ:

surfpool x.y.z

Is this page helpful?

Mục lục

Chỉnh sửa trang