Passa al contenuto principale

Errore di avvio del software

Risoluzione dei comuni errori di avvio​

Passaggio 1: Verifica i requisiti di sistema​

  1. Assicurati che il sistema soddisfi i requisiti minimi:
    • Windows 10 o successivo
    • Almeno 4 GB di RAM
    • Almeno 1 GB di spazio libero su disco

Passaggio 2: Verifica Microsoft Visual C++ Redistributable​

Se vedi errori come vcruntime140.dll not found o The application was unable to start correctly (0xc000007b), potrebbe mancare Microsoft Visual C++ Redistributable.

  1. Premi Windows + R, digita cmd e premi Invio.
  2. Esegui: dir "C:\Windows\System32\vcruntime*.dll"
  3. Se vedi un output, il redistributable è installato. Il nome del file (ad esempio vcruntime140.dll) indica la versione.
  4. In caso contrario, scarica e installa l'ultima versione: Microsoft Visual C++ Redistributable

Link di download 1 Link di download 2

Passaggio 3: Verifica l'ora di sistema​

Un'ora di sistema errata può causare errori "Agent Start Timeout":

  1. Fai clic con il pulsante destro sull'orario nell'angolo in basso a destra dello schermo
  2. Seleziona "Modifica data/ora"
  3. Attiva "Imposta ora automaticamente" se non è già attiva
  4. Se l'ora è ancora errata, fai clic su "Sincronizza ora" oppure imposta manualmente la data e l'ora corrette
  5. Riavvia TikMatrix dopo aver corretto l'ora

Passaggio 4: Controlla i log dell'applicazione​

  1. In TikMatrix, fai clic su Impostazioni > Apri directory app.
  2. Vai alla cartella logs.
  3. Controlla il file di log più recente per individuare eventuali messaggi di errore.

Se l'applicazione non riesce ad aprire Impostazioni, apri direttamente la cartella logs:

  • Windows: %APPDATA%\com.tikmatrix.pro\logs (incollala nella barra degli indirizzi di File Explorer)
  • macOS: ~/Library/Application Support/com.tikmatrix.pro/logs (in Finder, Vai > Vai alla cartella...)

Per TikMatrix la cartella è com.tikmatrix; per IgMatrix, com.igmatrix. Se hai spostato la directory dei dati in Impostazioni, la cartella logs si trova nella nuova posizione.

Passaggio 5: macOS — Agent InvalidStateError​

Su alcuni Mac l'agent potrebbe non avviarsi e mostrare un errore come:

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

Possibile causa:

  • Spesso è dovuto a un'incompatibilità tra l'applicazione e la versione di macOS, oppure a hardware o firmware specifici di Mac più datati.

Soluzioni e workaround:

  1. Aggiorna macOS all'ultima versione disponibile tramite Impostazioni di Sistema > Generali > Aggiornamento software. Dopo l'aggiornamento, riavvia il Mac e prova di nuovo ad avviare TikMatrix.
  2. Se non è possibile aggiornare o l'errore persiste, prova a eseguire l'applicazione su un altro Mac con una versione più recente di macOS.

Se l'errore continua a comparire dopo aver provato quanto sopra, invia un'e-mail a support@tikmatrix.com indicando la versione di macOS e allegando i file di log del passaggio 4.

Passaggio 6: AppImage Linux — schermo bianco o EGL_BAD_PARAMETER​

Su Linux, le build AppImage possono mostrare una finestra bianca nelle sessioni Wayland, soprattutto sui sistemi NVIDIA, e i log possono contenere:

Could not create default EGL display: EGL_BAD_PARAMETER

In tal caso, avvia una volta l'AppImage con:

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

Le build recenti attivano automaticamente la stessa soluzione alternativa di WebKit quando l'app rileva un AppImage in esecuzione su Wayland, quindi il comando manuale serve solo per i pacchetti più vecchi. Se preferisci un pacchetto Linux nativo, la build Linux include anche un file .deb.

Se il problema persiste​

Se l'app si apre, crea un ticket da Supporto > Crea ticket: la versione dell'app e i log vengono allegati automaticamente.

Se non si apre, invia un'e-mail a support@tikmatrix.com con:

  • La versione del tuo sistema operativo
  • La versione dell'app installata
  • I file di log più recenti della cartella logs (vedi il passaggio 4)
  • I passaggi che hai già provato