Zum Hauptinhalt springen

​
Unterstützte Versionen

Version 2022.3 oder höher.
  • JetBrains Fleet oder ReSharper werden nicht unterstützt
  • Remote-SSH wird nicht unterstützt.

​
Erweiterungs-Logs erfassen

Ab Version 1.10.0 der Erweiterung gibt es im Chat-Panel auf der Einstellungsseite die Schaltfläche „Extension Diagnostics“. Diese Schaltfläche sammelt automatisch relevante Logs und Parameter in einer Textdatei, die heruntergeladen werden kann. Für ältere Versionen der Erweiterung:
  1. Die Logs werden in die Datei idea.log geschrieben. Um diese Datei zu finden, wähle im Menü Help > Show Log in Finder/Explorer.
  2. Exportiere oder kopiere die Logs.

​
Bekannte IDE-Probleme und Lösungen

​
Cascade wird nicht angezeigt

Normalerweise sehen Sie den folgenden Fehler in den Logs: 
JCEF wird in dieser Umgebung nicht unterstützt oder die Initialisierung ist fehlgeschlagen
oder 
Internes JCEF nicht unterstützt, verwende externes JCEF
JCEF ist die Browser‑Komponente, die zur Anzeige von Cascade benötigt wird. Um das Problem zu beheben, gehe zu Help > Find Actions > Choose Java Boot Runtime und wähle eine Runtime mit gebündeltem JCEF. Wenn JCEF bereits in deiner Runtime enthalten ist, ist JCEF möglicherweise in deiner Registry bzw. den Eigenschaften deaktiviert. Bearbeite deine Eigenschaften: Help > Edit Custom Properties, füge das folgende Flag hinzu und starte dein IDE neu: 
ide.browser.jcef.enabled=true

​
Zertifikatsprobleme

Wenn Sie auf die folgenden Fehler stoßen: 
Fehler beim Abrufen der Erweiterungs-Basis-URL unter <YourDomainURL>

PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: 
unable to find valid certification path to requested target
Dies deutet darauf hin, dass die Codeium-Erweiterung der TLS-Verbindung zu Ihrem Enterprise-Portal bzw. API-Server nicht vertrauen kann, weil sie dem vorgelegten Zertifikat nicht vertraut. Das bedeutet entweder, dass das von der Codeium-Bereitstellung vorgelegte Zertifikat nicht vertrauenswürdig ist oder dass ein von einem Unternehmens-Proxy vorgelegtes Zertifikat, der die Anfrage abfängt, nicht vertrauenswürdig ist. In beiden Fällen besteht die bevorzugte Lösung darin sicherzustellen, dass das Root-Zertifikat, das dieses Zertifikat signiert hat, auf den Endnutzer-Rechnern an der richtigen Stelle installiert ist. JetBrains-IDEs und die meisten anderen IDEs laden Zertifikate aus dem Standardpfad des Betriebssystems. Ihr Zertifikat wird von Ihrem lokalen IT- oder Admin-Team ausgestellt und verwaltet. Wenden Sie sich bitte an dieses Team, um Unterstützung bei der Installation der notwendigen Zertifikate auf Ihrem System zu erhalten. Es ist wichtig, dass die vollständige Zertifikatskette von der Stelle vorgelegt wird, an der TLS terminiert wird. Häufig können JetBrains-IDEs und andere IDEs die Authentizität nicht überprüfen, wenn nur das Leaf-Zertifikat (Endzertifikat) vorgelegt wird, da ihnen das Zwischenzertifikat nicht bekannt ist, das das Leaf-Zertifikat validiert und seinerseits vom Root-Zertifikat validiert wird. Browser können dieses Problem oft umgehen, da Nutzende wahrscheinlich bereits eine andere Website aufgerufen haben, die die vollständige Zertifikatskette präsentiert. Dadurch wird das Zwischenzertifikat erkannt und zwischengespeichert, aber Anwendungen wie JetBrains-IDEs haben diesen Vorteil nicht. Hinweis: In Produkten der JetBrains-Familie der Version 2024.3 wurde ein Fehler eingeführt, durch den die IDE die Betriebssystemzertifikate nicht akzeptiert (JetBrains-Issue-Report). Zur Behebung des Problems können Nutzende Folgendes tun:
  • JetBrains-Produkte auf frühere Versionen downgraden
  • Die 2024.3.1-Preview-Version (Beta-Version) verwenden
  • -Djavax.net.ssl.trustStoreType=Windows-ROOT als benutzerdefinierte JVM-Option hinzufügen

​
Benutzerdefinierte Workspaces

Wenn bei der Verwendung von Cascade der folgende Fehler angezeigt wird: 
Cascade kann ohne einen aktiven Workspace nicht auf Pfade zugreifen
Dies bedeutet, dass Cascade Zugriff auf einen Custom Workspace benötigt, um ordnungsgemäß zu funktionieren. Gehen Sie zur Behebung wie folgt vor:
  1. Öffnen Sie die Einstellungen Ihrer JetBrains-IDE, indem Sie zu File > Settings gehen (oder IntelliJ IDEA > Preferences auf macOS)
  2. Navigieren Sie zu Tools > Windsurf Settings
  3. Suchen Sie im Windsurf Settings-Panel den Abschnitt “Custom Workspaces” am unteren Rand
  4. Klicken Sie auf die Schaltfläche “Add Workspace”, um Ihren Projekt-Workspace hinzuzufügen
  5. Wählen Sie das passende Workspace-Verzeichnis für Ihr Projekt aus
  6. Klicken Sie auf “OK”, um die Einstellungen zu übernehmen
  7. Starten Sie Ihre IDE neu, damit die Änderungen wirksam werden

​
Verhalten bei Enterprise- vs. Non-Enterprise-Nutzern

Das Verhalten von Custom Workspaces unterscheidet sich je nach Ihrem Benutzertyp:

​
Enterprise-Benutzer

Enterprise-Benutzer haben gezielte Kontrolle über die Workspace-Indizierung:
  • Beim Hinzufügen von Workspaces sehen Sie eine Checkbox-Option, um die Indizierung für jeden Workspace zu aktivieren
  • Nur Workspaces mit aktivierter Checkbox werden indiziert und stehen in Cascade zur Verfügung
  • So können Sie steuern, welche Workspaces Indizierungsressourcen verbrauchen
  • Tool-Aufrufe sind aus Sicherheitsgründen auf den aktiven Workspace beschränkt

​
Nicht-Enterprise-Nutzer

Nicht-Enterprise-Nutzer erhalten eine automatische Workspace-Indizierung:
  • Jeder hinzugefügte Workspace wird automatisch indiziert, ohne dass ein Kontrollkästchen gesetzt werden muss
  • Alle hinzugefügten Workspaces sind sofort in Cascade verfügbar
  • Tool-Aufrufe werden außerhalb des aktiven Workspaces nie blockiert
  • Die selektive Indizierung ist in diesem Modell nicht relevant
Nachdem Sie die oben genannten Einrichtungsschritte abgeschlossen haben, sollte Cascade auf Ihren Workspace zugreifen und normal funktionieren.

​
Tastenkombinationen funktionieren in Rider unter Windows nicht

Wenn du JetBrains Rider unter Windows verwendest und Probleme auftreten, bei denen Shift+Enter in Cascade keine neue Zeile erzeugt oder die Entfernen-Taste nicht funktioniert, wird dies durch einen Konflikt der Tastenzuweisungen mit dem Unit Test Tool Window von Rider verursacht. Dies ist ein bekanntes Problem, das KI-Plugins in Rider betrifft. Um es zu beheben:
  1. Öffne die Einstellungen deiner JetBrains-IDE über File > Settings
  2. Navigiere zu Keymap
  3. Suche nach „Unit Test Tool Window Action“
  4. Deaktiviere oder weise die in Konflikt stehenden Tastenzuweisungen (Shift+Enter und Delete) neu zu
  5. Starte deine IDE neu, damit die Änderungen wirksam werden