Sau đây là phần 2 của bài viết về chủ đề triển khai dự án Solana với Anchor. Các bạn có thể theo dõi phần 1 của bài viết ở đây nhé: Thiết lập môi trường Solana cục bộ (P1)
Bài viết này sẽ tiếp nối hướng dẫn trước về việc thiết lập môi trường phát triển Solana cục bộ. Chúng ta đã thiết lập xong môi trường, giờ hãy cùng chạy dự án Solana đầu tiên bằng mã Anchor mặc định.
Bước 1: Cài đặt Visual Studio Code (VS Code)
VS Code là một trong những trình soạn thảo tốt nhất để phát triển Solana. Nếu bạn chưa cài đặt, hãy tải xuống và cài đặt từ trang web chính thức của Visual Studio Code: https://code.visualstudio.com/
Bước 2: Cài đặt Tiện ích mở rộng Remote - WSL
Tiện ích mở rộng Remote - WSL cho phép bạn làm việc liền mạch với các tệp và thư mục bên trong môi trường WSL Ubuntu của bạn.
- Mở VS Code.
- Truy cập chế độ xem Tiện ích mở rộng bằng cách nhấp vào biểu tượng Tiện ích mở rộng ở phía bên tay trái hoặc nhấn Ctrl+Shift+X.
- Tìm kiếm Remote - WSL và nhấp vào Cài đặt.
Bước 3: Kết nối VS Code với WSL Ubuntu
Sau khi cài đặt tiện ích mở rộng, hãy kết nối với môi trường Ubuntu mà chúng ta đã tạo trong hướng dẫn trước:
- Mở Bảng lệnh (Ctrl+Shift+P) trong VS Code.
- Tìm kiếm và chọn Remote-WSL: Cửa sổ mới.
- Thao tác này sẽ mở một cửa sổ VS Code mới được kết nối với môi trường WSL của bạn.
Bước 4: Cài đặt Tiện ích mở rộng Rust Analyzer
Rust Analyzer cung cấp các tính năng mạnh mẽ như tô sáng cú pháp, tự động hoàn thành và tài liệu nội tuyến cho các dự án Rust.
- Trong chế độ xem Tiện ích mở rộng (Ctrl+Shift+X), hãy tìm kiếm Rust Analyzer.
- Nhấp vào Cài đặt.
Bước 5: Tạo dự án Anchor mặc định
Anchor cung cấp một dự án mẫu để giúp bạn bắt đầu viết mã nhanh chóng. Hãy làm theo các bước sau để tạo chương trình Solana đầu tiên của bạn:
- Mở terminal WSL trong VS Code hoặc khởi chạy nó từ môi trường Ubuntu của bạn.
- Chạy các lệnh sau để khởi tạo một dự án mới:
anchor init my_solana_project cd my_solana_project
Điều này tạo một thư mục mới với khung chương trình Solana cơ bản.
Bước 6: Xây dựng dự án Anchor
Trước khi triển khai, chúng ta cần xây dựng chương trình:
Điều hướng đến thư mục dự án nếu bạn chưa ở đó:
cd my_solana_project
Xây dựng dự án:
anchor build
Điều này biên dịch mã Rust thành một chương trình tương thích với Solana.
Bước 7: Chạy Solana Test Validator
solana-test-validator khởi động một mạng Solana cục bộ trên máy của bạn, cho phép bạn triển khai và kiểm tra chương trình Anchor mà không cần dựa vào devnet hoặc mainnet của Solana.
Chúng ta sẽ chạy lệnh dưới đây:
solana-test-validator
Nếu bạn gặp lỗi với lệnh trên, hãy chạy:
solana-test-validator --log
Nếu bạn gặp lỗi như "AVX2 not supported", hãy tham khảo kho lưu trữ Solana GitHub để biết hướng dẫn về cách xây dựng Solana từ nguồn.
Bước 8: Nhận SOL cho phí Gas
Để triển khai chương trình của bạn, bạn sẽ cần một ít SOL để trang trải phí giao dịch. Hãy yêu cầu SOL từ vòi Devnet:
Đặt Solana CLI của bạn để sử dụng Devnet:
solana config set --url https://api.devnet.solana.com
Tạo một ví Solana mới:
solana-keygen new --outfile ~/.config/solana/id.json
Nạp tiền vào ví của bạn bằng Devnet SOL:
solana airdrop 2
Xác nhận số dư của bạn:
solana balance
Bước 9: Triển khai chương trình Anchor
Bây giờ mọi thứ đã sẵn sàng, hãy triển khai chương trình lên Devnet:
Chạy lệnh triển khai:
anchor deploy
Sau khi triển khai thành công, bạn sẽ thấy ID chương trình trong kết quả đầu ra. Lưu ID này để sử dụng sau.
Bước 10: Tương tác với chương trình đã Triển khai của bạn
Anchor cung cấp một bộ thử nghiệm để tương tác với chương trình của bạn. Để kiểm tra mã mặc định:
Chạy lệnh kiểm tra:
anchor test
Điều này thực thi logic chương trình mặc định trên Devnet và trả về kết quả.
Mẹo bổ sung:
- Sử dụng Tệp .env: Lưu trữ ID chương trình, URL RPC và các bí mật khác của bạn trong tệp .env để giữ cho dự án của bạn được tổ chức.
- Gỡ lỗi: Nếu bạn gặp lỗi, hãy kiểm tra thư mục target/deploy để tìm các tạo tác và nhật ký đã biên dịch.
- Đọc Tài liệu: Khám phá tài liệu chính thức của Anchor để biết các chủ đề nâng cao như trạng thái chương trình và các lời gọi chương trình chéo.
- Xử lý Lỗi: Nếu bạn gặp lỗi triển khai, hãy kiểm tra nhật ký trong thư mục target/deploy/.
- Cục bộ so với Devnet: Sử dụng solana-test-validator để kiểm tra cục bộ. Chuyển sang Devnet khi tương tác với ví thực hoặc người dùng bên ngoài.
- Tài liệu: Khám phá tài liệu chính thức của Anchor để biết các tính năng nâng cao như trạng thái chương trình và các lời gọi chương trình chéo.
Kết luận
Xin chúc mừng! Bạn đã chạy thành công dự án Solana đầu tiên của mình bằng Anchor. Từ việc thiết lập VS Code đến triển khai trên Devnet, bạn đã hoàn thành các bước cần thiết để bắt đầu phát triển Solana.