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

Lỗi khởi động phần mềm

Khắc phục các lỗi khởi động thường gặp​

Bước 1: Kiểm tra yêu cầu hệ thống​

  1. Đảm bảo hệ thống của bạn đáp ứng yêu cầu tối thiểu:
    • Windows 10 trở lên
    • Tối thiểu 4GB RAM
    • Tối thiểu 1GB dung lượng ổ đĩa trống

Bước 2: Kiểm tra Microsoft Visual C++ Redistributable​

Nếu bạn thấy lỗi như vcruntime140.dll not found hoặc The application was unable to start correctly (0xc000007b), bạn có thể chưa cài đặt Microsoft Visual C++ Redistributable.

  1. Nhấn Windows + R, nhập cmd rồi nhấn Enter.
  2. Chạy lệnh: dir "C:\Windows\System32\vcruntime*.dll"
  3. Nếu có kết quả hiển thị, Redistributable đã được cài đặt. Tên tệp (ví dụ vcruntime140.dll) cho biết phiên bản.
  4. Nếu chưa có, hãy tải và cài đặt phiên bản mới nhất: Microsoft Visual C++ Redistributable

Download Link1 Download Link2

Bước 3: Kiểm tra thời gian hệ thống​

Thời gian hệ thống không chính xác có thể gây ra lỗi "Agent Start Timeout":

  1. Nhấp chuột phải vào hiển thị thời gian ở góc dưới bên phải màn hình
  2. Chọn "Điều chỉnh ngày/giờ"
  3. Bật "Tự động đặt thời gian" nếu chưa bật
  4. Nếu thời gian vẫn chưa đúng, nhấp "Đồng bộ ngay" hoặc tự đặt ngày và giờ chính xác
  5. Khởi động lại TikMatrix sau khi đã sửa thời gian

Bước 4: Kiểm tra nhật ký ứng dụng​

  1. Nhấp Cài đặt > Mở thư mục ứng dụng trong TikMatrix.
  2. Vào thư mục logs.
  3. Kiểm tra tệp nhật ký mới nhất để tìm thông báo lỗi.

Nếu ứng dụng không mở đủ xa để vào Cài đặt, hãy mở trực tiếp thư mục logs:

  • Windows: %APPDATA%\com.tikmatrix.pro\logs (dán vào thanh địa chỉ của File Explorer)
  • macOS: ~/Library/Application Support/com.tikmatrix.pro/logs (trong Finder, chọn Đi > Chuyển đến Thư mục)

Với TikMatrix, thư mục là com.tikmatrix, còn với IgMatrix là com.igmatrix. Nếu bạn đã chuyển thư mục dữ liệu trong Cài đặt, thư mục logs nằm ở vị trí mới.

Bước 5: macOS — Agent InvalidStateError​

Trên một số máy macOS, agent có thể không khởi động được và hiển thị lỗi như sau:

Agent start error InvalidStateError: The object is in an invalid state.

Nguyên nhân có thể:

  • Thường do ứng dụng không tương thích với phiên bản macOS hoặc phần cứng/firmware cụ thể trên các máy đời cũ.

Cách khắc phục:

  1. Cập nhật macOS lên phiên bản mới nhất có sẵn trong Cài đặt hệ thống > Cài đặt chung > Cập nhật phần mềm. Sau khi cập nhật, khởi động lại Mac và thử mở TikMatrix lại.
  2. Nếu không thể cập nhật hoặc lỗi vẫn còn, hãy thử chạy ứng dụng trên một máy Mac khác có phiên bản macOS mới hơn.

Nếu vẫn gặp lỗi sau khi thử các cách trên, hãy gửi email đến support@tikmatrix.com kèm phiên bản macOS và các tệp nhật ký từ Bước 4.

Bước 6: AppImage trên Linux - màn hình trắng hoặc EGL_BAD_PARAMETER​

Trên Linux, bản build AppImage có thể hiển thị cửa sổ trắng trong phiên Wayland, đặc biệt trên hệ thống NVIDIA, và nhật ký có thể chứa dòng sau:

Could not create default EGL display: EGL_BAD_PARAMETER

Nếu gặp trường hợp này, hãy chạy AppImage một lần với lệnh:

WEBKIT_DISABLE_COMPOSITING_MODE=1 \
WEBKIT_DISABLE_DMABUF_RENDERER=1 \
./TikMatrix.AppImage

Các bản build gần đây tự động bật cùng giải pháp WebKit khi ứng dụng phát hiện AppImage đang chạy trên Wayland, vì vậy lệnh thủ công chỉ cần thiết với các gói cũ hơn. Nếu bạn muốn dùng gói Linux gốc, bản build Linux cũng có sẵn tệp .deb.

Nếu vấn đề vẫn tiếp diễn​

Nếu ứng dụng mở được, hãy tạo ticket từ Hỗ trợ > Tạo ticket: phiên bản ứng dụng và nhật ký sẽ được đính kèm tự động.

Nếu ứng dụng không mở được, hãy gửi email đến support@tikmatrix.com kèm theo:

  • Phiên bản hệ điều hành của bạn
  • Phiên bản ứng dụng bạn đã cài đặt
  • Các tệp nhật ký mới nhất trong thư mục logs (xem Bước 4)
  • Các bước bạn đã thử