Dokumentation Fehlerbehebung

Fehlerbehebung

Lösungen für häufige Fehler und Probleme bei der Verwendung der i1n CLI, des SDK und des Dashboards.

Befehl „i1n“ nicht gefunden

Dieser Fehler bedeutet, dass die i1n CLI nicht global installiert ist oder sich nicht in Ihrem PATH befindet. Führen Sie npm install -g i1n aus, um sie zu installieren. Wenn Sie einen Versionsmanager (nvm, fnm) verwenden, stellen Sie sicher, dass das globale Binärverzeichnis in Ihrem PATH enthalten ist.

Unter macOS/Linux können Sie den Installationspfad mit "which i1n" überprüfen. Wenn Sie bun verwenden, führen Sie stattdessen "bun install -g i1n" aus.

Ungültiger API-Schlüssel oder Authentifizierungsfehler

Dies tritt auf, wenn der API-Schlüssel in i1n.config.json fehlt, abgelaufen oder ungültig ist. Generieren Sie einen neuen Schlüssel in Ihren Organisationseinstellungen unter dashboard.i1n.ai und führen Sie i1n init aus, um die Konfiguration neu zu starten.

Stellen Sie sicher, dass Sie den korrekten API-Schlüssel für die Organisation verwenden, der das Projekt gehört. Jede Organisation hat ihre eigenen Schlüssel – ein Schlüssel einer Organisation kann nicht auf Projekte einer anderen zugreifen.

i1n Push schlägt fehl oder überspringt Schlüssel

Wenn i1n push keine Schlüssel meldet oder Dateien überspringt, stellen Sie sicher, dass Ihr Locales-Verzeichnis und das Dateiformat mit der Konfiguration in i1n.config.json übereinstimmen. Führen Sie i1n init aus, um bei Bedarf neu zu konfigurieren.

Häufige Ursachen sind falsche Glob-Muster, inkompatible Dateiformate (z. B. flaches JSON, wenn verschachteltes JSON konfiguriert ist) oder leere Übersetzungsdateien.

i1n pull generiert leere Dateien

Dies bedeutet normalerweise, dass das Projekt keine Übersetzungen auf dem Server hat. Führen Sie zuerst i1n push aus, um Ihre Quellschlüssel hochzuladen, und dann i1n pull, um Übersetzungen herunterzuladen.

Wenn Sie Schlüssel gesendet, aber beim Abrufen leere Dateien erhalten, stellen Sie sicher, dass die Zielsprachen Ihrem Projekt mithilfe von i1n add-language oder über das Dashboard hinzugefügt wurden.

TypeScript-Fehler nach i1n-Pull

Wenn Ihre IDE nach dem Pull Fehler anzeigt, stellen Sie sicher, dass i1n.d.ts in Ihre TypeScript-Kompilierung einbezogen wird. Die CLI aktualisiert tsconfig.json automatisch, aber manuelle Konfigurationen müssen möglicherweise angepasst werden.

Ändern Sie i1n.d.ts niemals direkt – es wird bei jedem i1n-Pull neu generiert. Wenn die Datei beschädigt zu sein scheint, löschen Sie sie und führen Sie i1n pull erneut aus.

Verwandt