Pular para o conteúdo principal

Erro de inicialização do software

Solução de erros comuns de inicialização​

Etapa 1: Verificar os requisitos do sistema​

  1. Certifique-se de que seu sistema atende aos requisitos mínimos:
    • Windows 10 ou posterior
    • Pelo menos 4 GB de RAM
    • Pelo menos 1 GB de espaço livre em disco

Etapa 2: Verificar o Microsoft Visual C++ Redistributable​

Se aparecerem erros como vcruntime140.dll not found ou The application was unable to start correctly (0xc000007b), talvez esteja faltando o Microsoft Visual C++ Redistributable.

  1. Pressione Windows + R, digite cmd e pressione Enter.
  2. Execute: dir "C:\Windows\System32\vcruntime*.dll"
  3. Se aparecer alguma saída, o redistributable está instalado. O nome do arquivo (por exemplo, vcruntime140.dll) indica a versão.
  4. Se não aparecer nada, baixe e instale a versão mais recente: Microsoft Visual C++ Redistributable

Link de download 1 Link de download 2

Etapa 3: Verificar a hora do sistema​

Uma hora incorreta no sistema pode causar erros de "Agent Start Timeout":

  1. Clique com o botão direito na hora exibida no canto inferior direito da tela
  2. Selecione "Ajustar data/hora"
  3. Ative "Definir hora automaticamente", se ainda não estiver ativado
  4. Se a hora continuar incorreta, clique em "Sincronizar agora" ou defina manualmente a data e a hora corretas
  5. Reinicie o TikMatrix depois de corrigir a hora

Etapa 4: Verificar os logs do aplicativo​

  1. No TikMatrix, clique em Configurações > Abrir Diretório do App.
  2. Acesse a pasta logs.
  3. Verifique o arquivo de log mais recente em busca de mensagens de erro.

Se o aplicativo não abrir até chegar a Configurações, abra diretamente a pasta logs:

  • Windows: %APPDATA%\com.tikmatrix.pro\logs (cole na barra de endereços do File Explorer)
  • macOS: ~/Library/Application Support/com.tikmatrix.pro/logs (no Finder, Ir > Ir para a Pasta...)

Para o TikMatrix, a pasta é com.tikmatrix; para o IgMatrix, com.igmatrix. Se você mudou o diretório de dados em Configurações, a pasta logs está no novo local.

Etapa 5: macOS — Agent InvalidStateError​

Em algumas máquinas macOS, o agent pode não iniciar e exibir um erro como:

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

Possível causa:

  • Isso costuma ser causado por uma incompatibilidade entre o aplicativo e a versão do macOS, ou por hardware ou firmware específico em máquinas mais antigas.

Soluções e alternativas:

  1. Atualize o macOS para a versão mais recente disponível em Ajustes do Sistema > Geral > Atualização de Software. Depois de atualizar, reinicie o Mac e tente iniciar o TikMatrix novamente.
  2. Se não for possível atualizar ou se o erro persistir, tente executar o aplicativo em outro Mac com uma versão mais recente do macOS.

Se o erro continuar depois de tentar as soluções acima, envie um e-mail para support@tikmatrix.com com a sua versão do macOS e os arquivos de log da etapa 4.

Etapa 6: AppImage do Linux — tela branca ou EGL_BAD_PARAMETER​

No Linux, as compilações AppImage podem mostrar uma janela branca em sessões Wayland, especialmente em sistemas NVIDIA, e os logs podem conter:

Could not create default EGL display: EGL_BAD_PARAMETER

Se isso acontecer, inicie o AppImage uma vez com:

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

As versões recentes ativam automaticamente a mesma solução alternativa do WebKit quando o aplicativo detecta um AppImage em execução no Wayland, então o comando manual só deve ser necessário em pacotes mais antigos. Se preferir um pacote Linux nativo, a versão para Linux também inclui um arquivo .deb.

Se o problema persistir​

Se o aplicativo abrir, crie um ticket em Suporte > Criar Ticket: a versão do aplicativo e os logs são anexados automaticamente.

Se ele não abrir, envie um e-mail para support@tikmatrix.com com:

  • A versão do seu sistema operacional
  • A versão do aplicativo instalada
  • Os arquivos de log mais recentes da pasta logs (veja a etapa 4)
  • As etapas que você já tentou