Skip to main content

Hướng Dẫn Cài Đặt

Tài liệu này cung cấp hướng dẫn từng bước để cài đặt, cấu hình đường dẫn (PATH) và xác thực tài khoản cho công cụ dòng lệnh Tasco CLI (tasco).

tip

Tasco CLI được viết hoàn toàn bằng Dart, sử dụng mô hình published-packages. Công cụ này sẽ tự động tải các gói thư viện chuẩn của Tasco từ Private Registry và tạo khung mã nguồn (scaffolding) trực tiếp trong dự án của bạn.

1. Yêu Cầu Hệ Thống​

Trước khi bắt đầu, hãy đảm bảo máy tính của bạn đã cài đặt đầy đủ môi trường phát triển Flutter & Dart:

  1. Dart SDK: Phiên bản 3.0.0 trở lên. Kiểm tra bằng lệnh: 
    dart --version
  2. Flutter SDK: Phiên bản 3.0.0 trở lên. Kiểm tra bằng lệnh: 
    flutter --version

2. Xác Thực Private Registry​

Do các gói thư viện và bản thân CLI của Tasco được lưu trữ trên Private Pub Registry (https://pub.vtii.vn), bạn cần cấu hình mã xác thực (Access Token) trên thiết bị của mình trước khi cài đặt.

important

Vì lúc này Tasco CLI chưa được cài đặt, bạn phải sử dụng trực tiếp lệnh xác thực tích hợp sẵn của Dart SDK.

Thực hiện lệnh sau trong Terminal và dán mã token được cấp bởi quản trị viên hệ thống khi được yêu cầu:

dart pub token add https://pub.vtii.vn

3. Cài Đặt Tasco CLI​

Sau khi hoàn tất bước xác thực registry, tiến hành cài đặt Tasco CLI globally bằng lệnh sau:

dart pub global activate tasco_cli --hosted-url=https://pub.vtii.vn

Sau khi cài đặt thành công, gói package sẽ là tasco_cli nhưng tên lệnh chạy chính thức trên Terminal là tasco.

4. Cấu Hình Đường Dẫn Hệ Thống (PATH)​

Để có thể chạy lệnh tasco từ bất kỳ thư mục nào trong terminal, bạn cần khai báo thư mục chứa file thực thi (bin) của Dart Pub Cache vào biến môi trường hệ thống.

Trên macOS / Linux​

Mở file cấu hình Shell của bạn (ví dụ: ~/.zshrc, ~/.bashrc hoặc ~/.bash_profile) và thêm dòng sau vào cuối file:

export PATH="$PATH":"$HOME/.pub-cache/bin"

Sau đó chạy lệnh sau để áp dụng thay đổi cho phiên Terminal hiện tại:

source ~/.zshrc # Hoặc source ~/.bashrc tùy shell đang sử dụng

Trên Windows​

Thêm đường dẫn sau vào biến môi trường Path của tài khoản User:

%USERPROFILE%\AppData\Local\Pub\Cache\bin

Lưu ý: Bạn có thể cần khởi động lại Terminal hoặc Command Prompt để hệ thống nhận diện đường dẫn mới.

5. Kiểm Tra Phiên Bản​

Kiểm tra việc cài đặt bằng cách gọi lệnh:

tasco --version

Nếu cài đặt thành công, màn hình sẽ hiển thị thông tin phiên bản CLI hiện tại, ví dụ:

Tasco CLI v4.1.0

6. Cài Đặt Từ Mã Nguồn (Dành cho Nhà Phát Triển CLI)​

Nếu bạn là thành viên đội Core Framework phát triển các tính năng mới cho Tasco CLI, bạn có thể kích hoạt trực tiếp từ mã nguồn local trong repo:

# 1. Truy cập thư mục CLI trong Workspace
cd packages/tasco_cli

# 2. Kích hoạt global trỏ về thư mục hiện tại
dart pub global activate --source path .

Sau lệnh này, khi bạn gõ tasco, hệ thống sẽ thực thi mã nguồn trực tiếp tại thư mục packages/tasco_cli của bạn. Bạn cũng có thể chạy trực tiếp mà không cần kích hoạt global:

dart run bin/tasco.dart <command>