Chuyển tới nội dung chính

Cài đặt Aiken

Bài học này hướng dẫn bạn thiết lập môi trường phát triển Aiken từ đầu.

Mục tiêu học tập​

  • Cài đặt Aiken CLI trên các hệ điều hành khác nhau
  • Xác minh cài đặt thành công
  • Thiết lập editor hỗ trợ Aiken

Aikup - Công cụ quản lý phiên bản​

Aikup là công cụ được khuyến nghị để cài đặt và quản lý các phiên bản Aiken.

Cài đặt trên macOS​

# Sử dụng Homebrew
brew install aiken-lang/tap/aikup

# Hoặc sử dụng curl
curl --proto '=https' --tlsv1.2 -LsSf https://install.aiken-lang.org | sh

Cài đặt trên Linux​

curl --proto '=https' --tlsv1.2 -LsSf https://install.aiken-lang.org | sh

Cài đặt trên Windows​

powershell -c "irm https://windows.aiken-lang.org | iex"

Hoặc tải MSI installer từ GitHub releases.

Cài đặt qua npm​

npm install -g @aiken-lang/aikup

Cài đặt Aiken​

Sau khi có aikup, chạy lệnh:

aikup

Lệnh này sẽ tự động tải và cài đặt phiên bản Aiken mới nhất.

Xác minh cài đặt​

aiken --version

Output mẫu:

aiken v1.1.0

Các lệnh CLI cơ bản​

Kiểm tra danh sách lệnh có sẵn:

aiken --help
Usage: aiken <COMMAND>

Commands:
  new        Tạo dự án Aiken mới
  build      Biên dịch dự án
  check      Chạy kiểm thử
  docs       Tạo tài liệu
  fmt        Format mã nguồn
  lsp        Khởi động Language Server
  completion Tạo shell completions

Thiết lập Editor​

Visual Studio Code​

  1. Cài đặt extension Aiken từ marketplace
  2. Extension tự động sử dụng Aiken LSP

Vim/Neovim​

Thêm vào config:

-- Neovim với nvim-lspconfig
require('lspconfig').aiken.setup{}

Shell Completions​

# Bash
aiken completion bash --install

# Zsh
aiken completion zsh --install

# Fish
aiken completion fish --install

Kiểm tra môi trường​

Tạo dự án thử nghiệm để xác nhận mọi thứ hoạt động:

aiken new my-org/hello-aiken
cd hello-aiken
aiken check

Output thành công:

    Compiling my-org/hello-aiken 0.0.0
    Finished compilation in 0.12s
Summary
    0 errors, 0 warnings

Cấu trúc thư mục sau cài đặt​

~/.aiken/
├── bin/
│   └── aiken          # Aiken binary
└── versions/
    └── 1.1.0/         # Phiên bản đã cài

Xử lý lỗi thường gặp​

Lỗi "command not found"​

Thêm đường dẫn vào PATH:

# Thêm vào ~/.bashrc hoặc ~/.zshrc
export PATH="$HOME/.aiken/bin:$PATH"

Lỗi quyền truy cập trên Linux/macOS​

chmod +x ~/.aiken/bin/aiken

Tóm tắt​

BướcLệnh
Cài aikupbrew install aiken-lang/tap/aikup
Cài Aikenaikup
Xác minhaiken --version
Kiểm traaiken new test && cd test && aiken check

Bước tiếp theo​

Trong bài tiếp theo, chúng ta sẽ tìm hiểu tổng quan về ngôn ngữ Aiken và lý do nó phù hợp cho phát triển smart contract trên Cardano.