Risoluzione dei problemi

Questo errore indica che la CLI di i1n non è installata globalmente o non è presente nel tuo PATH. Esegui npm install -g i1n per installarla. Se utilizzi un gestore di versioni (nvm, fnm), assicurati che la directory bin globale sia nel tuo PATH.

Su macOS/Linux, puoi verificare il percorso di installazione con which i1n. Se usi bun, esegui invece bun install -g i1n.

Ciò si verifica quando la chiave API in i1n.config.json è mancante, scaduta o non valida. Genera una nuova chiave dalle impostazioni della tua organizzazione su dashboard.i1n.ai ed esegui i1n init per riconfigurare.

Assicurati di utilizzare la chiave API corretta per l'organizzazione proprietaria del progetto. Ogni organizzazione ha le proprie chiavi: una chiave di un'organizzazione non può accedere ai progetti di un'altra.

Se i1n push segnala zero chiavi o salta file, verifica che la tua directory delle localizzazioni e il formato del file corrispondano alla configurazione in i1n.config.json. Esegui i1n init per riconfigurare se necessario.

Le cause comuni includono pattern glob errati, formati di file non corrispondenti (ad esempio, JSON piatto quando è configurato JSON nidificato) o file di traduzione vuoti.

Ciò significa solitamente che il progetto non ha traduzioni sul server. Esegui prima i1n push per caricare le tue chiavi sorgente, poi i1n pull per scaricare le traduzioni.

Se hai inviato chiavi ma il recupero restituisce file vuoti, verifica che le lingue di destinazione siano state aggiunte al tuo progetto utilizzando i1n add-language o tramite la dashboard.

Se il tuo IDE mostra errori dopo il pull, assicurati che i1n.d.ts sia incluso nella compilazione TypeScript. La CLI aggiorna automaticamente tsconfig.json, ma le configurazioni manuali potrebbero richiedere aggiustamenti.

Non modificare mai direttamente i1n.d.ts: viene rigenerato a ogni pull di i1n. Se il file sembra corrotto, eliminalo ed esegui nuovamente i1n pull.