Xử Lý Sự Cố: Cài Đặt & Build

Sửa vấn đề cài đặt 1DevTool hoặc khởi chạy lần đầu.

macOS: "Cannot Be Opened Because Developer Cannot Be Verified"

macOS chặn các apps tải từ ngoài App Store theo mặc định. Đây là cảnh báo Gatekeeper, không phải dấu hiệu có gì sai với 1DevTool.

Sửa bằng System Settings:

  1. Mở System Settings → Privacy & Security
  2. Scroll xuống phần Security
  3. Bạn sẽ thấy thông báo "1DevTool was blocked from use because it is not from an identified developer"
  4. Click Open Anyway
  5. Xác nhận trong dialog hiện ra

Cách sửa thay thế dùng Terminal:

bash
xattr -d com.apple.quarantine /Applications/1DevTool.app

Chạy lệnh này một lần trong Terminal, rồi khởi chạy 1DevTool bình thường. Bạn sẽ không được nhắc lại.

Windows: Antivirus Chặn Cài Đặt

Một số chương trình antivirus đánh dấu installers mới hoặc chưa ký là đáng ngờ và chặn chúng trong quá trình cài đặt.

Cách sửa:

  1. Tạm thời tắt real-time protection trong phần mềm antivirus.
  2. Chạy installer 1DevTool.
  3. Bật lại real-time protection sau khi cài đặt hoàn tất.

Để tránh tắt protection hoàn toàn, bạn có thể thêm exception cho file installer 1DevTool (thường là 1DevTool-Setup.exe) hoặc cho thư mục cài đặt (C:\Users\<you>\AppData\Local\1DevTool). Các bước chính xác khác nhau tùy antivirus — tìm "Exclusions" hoặc "Exceptions" trong settings antivirus.

Linux: AppImage Không Khởi Chạy

Nếu double-click AppImage không làm gì, hoặc nó đóng ngay lập tức, thử các cách sửa sau theo thứ tự:

Làm file có thể thực thi. AppImages cần execute permission trước khi chạy:

bash
chmod +x 1DevTool-*.AppImage

Cài FUSE. AppImages dùng FUSE (Filesystem in Userspace) để tự mount. Nhiều cài đặt Linux tối giản không bao gồm nó:

bash
sudo apt install libfuse2

Trên Fedora/RHEL: sudo dnf install fuse.

Chạy từ Terminal để xem error output. Nếu vẫn thất bại, khởi chạy từ terminal để đọc thông báo lỗi:

bash
./1DevTool-*.AppImage --no-sandbox

Flag --no-sandbox đôi khi cần thiết trong môi trường hạn chế như một số setup Linux doanh nghiệp hoặc containers.

App Mở Nhưng Ở Màn Hình Trống

Triệu chứng: 1DevTool khởi chạy và cửa sổ hiện ra, nhưng giao diện không bao giờ load — chỉ màn hình trắng hoặc xám trống.

Nguyên nhân: file cache app bị hỏng từ cài đặt trước đó hoặc update thất bại.

Cách sửa — xóa cache:

  • macOS:
    bash
    rm -rf ~/Library/Application\ Support/1DevTool/Cache
  • Windows: điều hướng đến %APPDATA%\1DevTool\Cache trong File Explorer và xóa thư mục Cache.
  • Linux: rm -rf ~/.config/1DevTool/Cache

Sau khi xóa cache, restart 1DevTool. Cache tự rebuild lại.

tmux Không Tìm Thấy Khi Khởi Động

1DevTool dùng tmux để giữ terminal sessions sống khi bạn chuyển panels hoặc minimize app. Nếu tmux chưa cài, bạn sẽ thấy cảnh báo khi khởi động và terminals sẽ không persist.

Cài tmux:

  • macOS: brew install tmux
  • Linux (Debian/Ubuntu): sudo apt install tmux
  • Linux (Fedora/RHEL): sudo yum install tmux hoặc sudo dnf install tmux

Sau khi cài, thoát 1DevTool hoàn toàn và khởi chạy lại. Nếu bạn dùng shell tùy chỉnh hoặc PATH không chuẩn, đảm bảo thư mục chứa tmux (thường là /usr/local/bin hoặc /usr/bin) được bao gồm trong biến PATH của shell.