🚀 Hướng Dẫn Cài Đặt Ứng Dụng
AMBA được phân phối dưới dạng ứng dụng desktop hoàn chỉnh, độc lập và tối ưu hiệu năng cho hệ điều hành macOS, Windows và Linux.
🍏 Cài Đặt Trên macOS
1. Tải Gói Cài Đặt (.dmg)
Tải bản cài đặt macOS chính thức từ Cổng Tải Về:
- Apple Silicon (M1/M2/M3/M4): Dành cho tất cả máy Mac đời mới (MacBook Air/Pro, Mac mini, iMac từ năm 2020 trở lại đây).
- Intel x64: Dành cho các dòng máy Mac sử dụng chip Intel trước đây.
2. Kéo Thả Vào Thư Mục Applications
- Nhấp đúp vào file
.dmgvừa tải về. - Trong cửa sổ cài đặt hiện ra, kéo biểu tượng AMBA thả vào phím tắt thư mục Applications.
- Đẩy ổ đĩa ảo (Eject) ra khỏi Finder sau khi cài xong.
3. Khởi Động Lần Đầu & Xác Thực macOS Gatekeeper
Vì AMBA đang trong giai đoạn triển khai bản thí điểm doanh nghiệp (pilot distribution), tính năng bảo vệ Gatekeeper của macOS có thể hiển thị thông báo chưa xác minh nhà phát triển trong lần mở đầu tiên:
Cách mở ứng dụng nhanh chóng trong lần đầu
- Mở Finder và truy cập vào thư mục Applications (Ứng dụng).
- Nhấp chuột phải (hoặc giữ phím Control rồi nhấp chuột) vào biểu tượng AMBA, sau đó chọn Open (Mở).
- Trong hộp thoại cảnh báo hiện ra, bấm nút Open một lần nữa để xác nhận.
- Thao tác này chỉ cần thực hiện duy nhất 1 lần đầu. Từ những lần sau, bạn có thể mở ứng dụng bình thường từ Launchpad, Spotlight hoặc thanh Dock.
🪟 Cài Đặt Trên Windows
1. Tải Bộ Cài Đặt
Tải bộ cài đặt Windows 64-bit (.exe hoặc .msi) từ Cổng Tải Về.
2. Chạy Trình Cài Đặt
- Nhấp đúp vào file cài đặt để khởi động.
- Nếu màn hình Windows SmartScreen hiển thị thông báo "Windows protected your PC":
- Bấm vào dòng chữ More info (Thông tin khác).
- Bấm nút Run anyway (Vẫn chạy).
- Làm theo các bước hướng dẫn đơn giản trên màn hình để hoàn tất. Lối tắt ứng dụng sẽ tự động xuất hiện trên Desktop của bạn.
🐧 Cài Đặt Trên Linux
AMBA hỗ trợ đầy đủ các bản phân phối Linux phổ biến thông qua gói Debian (.deb) và gói chạy độc lập .AppImage.
1. Cài đặt trên Debian / Ubuntu (.deb)
- Tải gói cài đặt
.debmới nhất (AMBA_<version>_amd64.deb) từ Cổng Tải Về. - Cài đặt gói; apt tự động cài các thư viện hệ thống mà gói phụ thuộc:bashGói đề xuất cài
sudo apt-get update sudo apt install ./AMBA_*_amd64.debgnome-keyring(hoặc KWallet trên KDE), là thành phần AMBA cần để lưu API key. Nếu bạn cài với--no-install-recommendshoặc dùng môi trường desktop tối giản, hãy tự cài:sudo apt install gnome-keyring.
2. Định dạng AppImage độc lập (Fedora / Arch / RHEL / Mọi bản phân phối)
- Tải file
.AppImage(AMBA_<version>_amd64.AppImage) từ Cổng Tải Về. - Đảm bảo các thư viện phụ thuộc đã sẵn sàng:
- Debian / Ubuntu:
sudo apt install libwebkit2gtk-4.1-0 libayatana-appindicator3-1 gnome-keyring - Fedora / RHEL:
sudo dnf install webkit2gtk4.1 gnome-keyring - Arch Linux:
sudo pacman -S webkit2gtk-4.1 gnome-keyring
- Debian / Ubuntu:
- Cấp quyền thực thi và khởi chạy ứng dụng:bash
chmod +x AMBA_*_amd64.AppImage ./AMBA_*_amd64.AppImage
3. Lưu API Key trên Linux (Cần Keyring)
AMBA chỉ lưu API key và thông tin xác thực kết nối trong keyring Secret Service qua D-Bus. Không có cơ chế lưu dự phòng dạng văn bản thô hay trong cơ sở dữ liệu.
- GNOME, KDE Plasma, XFCE, Cinnamon: GNOME Keyring hoặc KWallet (5.97 trở lên) thường đã chạy sẵn.
- Window Manager tối giản (i3, sway, bspwm, Hyprland) hoặc KeePassXC: hãy khởi động một dịch vụ Secret Service trong phiên làm việc, ví dụ
gnome-keyring-daemon --start --components=secrets, hoặc bật tích hợp Secret Service trong KeePassXC. - Không có keyring đang chạy: AMBA vẫn khởi động, nhưng việc lưu key sẽ thất bại với thông báo "Không có keychain hệ thống…" và Cài đặt → Chẩn đoán Hệ thống hiển thị keychain không khả dụng. Hãy cài đặt hoặc bật GNOME Keyring hay KWallet rồi khởi động lại AMBA.
- Cập nhật từ bản 0.5.8 trở về trước: key do phiên bản cũ lưu sẽ tự động chuyển vào keyring ở lần khởi động đầu tiên. Khi chưa có keyring, key được giữ trong cơ sở dữ liệu cục bộ cho đến khi keyring khả dụng.
🔄 Tự Động Cập Nhật Phiên Bản Mới
AMBA tích hợp sẵn cơ chế cập nhật tự động mượt mà. Khi có phiên bản mới:
- Biểu tượng thông báo nhẹ nhàng xuất hiện ở thanh trạng thái phía dưới ứng dụng.
- Bạn có thể xem nhanh các cải tiến mới và bấm cập nhật chỉ với 1 cú nhấp chuột.
- Toàn bộ gói cập nhật được xác thực chữ ký điện tử an toàn trước khi áp dụng.