> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dépannage JetBrains

> Dépanner le plugin JetBrains : erreurs JCEF, problèmes de certificats, workspaces personnalisés et diagnostic des extensions.

<div id="supported-versions">
  # Versions prises en charge
</div>

Version 2022.3 ou ultérieure.

* JetBrains Fleet ou ReSharper ne sont pas pris en charge
* La connexion SSH à distance n'est pas prise en charge.

<div id="gathering-extension-logs">
  # Collecte des logs de l’extension
</div>

À partir de la version 1.10.0 de l’extension, le panneau Chat inclut un bouton Diagnostics de l’extension sur la page Paramètres. Ce bouton collecte automatiquement les logs et les paramètres pertinents dans un fichier texte téléchargeable.

Pour les versions antérieures de l’extension :

1. Les logs sont écrits dans le fichier idea.log. Pour localiser ce fichier, allez dans le menu `Help > Show Log in Finder/Explorer`

2. Exportez ou copiez les logs

<div id="known-ide-issues-and-solutions">
  # Problèmes connus de l’IDE et solutions
</div>

<div id="cascade-not-being-displayed">
  ## Cascade ne s’affiche pas
</div>

En général, vous verrez l’erreur suivante dans les logs :

```
JCEF n'est pas pris en charge dans cet environnement ou l'initialisation a échoué
```

ou

```
JCEF interne non pris en charge, tentative avec JCEF externe
```

JCEF est le composant navigateur nécessaire pour afficher Cascade. Pour corriger ce problème, allez dans `Help > Find Actions > Choose Java Boot Runtime` et choisissez un runtime incluant JCEF.
Si JCEF est déjà inclus dans votre runtime, il se peut qu’il soit désactivé dans votre registre/propriétés.
Modifiez vos propriétés : Help > Edit Custom Properties, ajoutez l’indicateur suivant et redémarrez votre IDE :

```
ide.browser.jcef.enabled=true
```

<div id="certificate-issues">
  ## Problèmes de certificats
</div>

Si vous rencontrez les erreurs suivantes :

```
Failed to fetch extension base URL at <YourDomainURL>
```

```
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: 
unable to find valid certification path to requested target
```

Cela suggère que l’extension Codeium ne parvient pas à faire confiance à la connexion TLS à votre portail Enterprise ou à votre serveur d’API, car elle ne fait pas confiance au certificat présenté. Cela signifie soit que le certificat présenté par le déploiement Codeium n’est pas approuvé, soit qu’un certificat présenté par un proxy d’entreprise interceptant la requête n’est pas approuvé.

Dans les deux cas, la solution la plus recommandée consiste à s’assurer que le certificat racine ayant signé ce certificat est correctement installé sur les machines des utilisateurs finaux à l’emplacement approprié. Les IDE JetBrains et la plupart des autres IDE chargent les certificats depuis l’emplacement par défaut du système d’exploitation.

Votre certificat est émis et géré par votre équipe informatique ou équipe d’administration locale. Veuillez les contacter pour obtenir de l’aide concernant l’installation des certificats nécessaires sur votre système.

Il est important que la chaîne de certificats complète soit présentée à l’endroit où la connexion TLS est terminée. Souvent, si seul le certificat feuille est présenté, les IDE JetBrains et les autres IDE ne peuvent pas vérifier son authenticité, car ils ne connaissent pas le certificat intermédiaire qui valide le certificat feuille et qui est lui-même validé par le certificat racine. Les navigateurs peuvent souvent contourner ce problème, car les utilisateurs auront probablement déjà consulté un autre site web qui présente la chaîne de certificats complète, de sorte que le certificat intermédiaire est vu et mis en cache, mais les applications comme les IDE JetBrains n’ont pas cet avantage.

**Remarque** : dans les produits de la famille JetBrains **2024.3**, un bug a été introduit qui fait que l’IDE n’accepte pas les certificats du système d’exploitation ([rapport de problème JetBrains](https://youtrack.jetbrains.com/issue/IJPL-171446/Unable-to-find-valid-certification-path-to-requested-target-exception-in-Settings-Sync-when-proxy-is-used)). Pour résoudre ce problème, les utilisateurs peuvent faire l’une des choses suivantes :

* Revenir à une version antérieure des produits JB
* Utiliser la version de prévisualisation 2024.3.1 (version bêta)
* Ajouter `-Djavax.net.ssl.trustStoreType=Windows-ROOT` comme option JVM personnalisée

<div id="custom-workspaces">
  ## Workspaces personnalisés
</div>

Si vous rencontrez l’erreur suivante lorsque vous utilisez Cascade :

```
Cascade ne peut pas accéder aux chemins sans un workspace actif
```

Cela signifie que Cascade doit avoir accès à un workspace personnalisé pour fonctionner correctement. Pour résoudre ce problème :

1. Ouvrez les paramètres de votre IDE JetBrains en allant dans `File > Settings` (ou `IntelliJ IDEA > Preferences` sur macOS)

2. Accédez à `Tools > Windsurf Settings`

3. Dans le panneau Windsurf Settings, repérez la section "Custom Workspaces" en bas

4. Cliquez sur le bouton "Add Workspace" pour ajouter le workspace de votre projet

5. Sélectionnez le répertoire de workspace approprié pour votre projet

6. Cliquez sur "OK" pour appliquer les paramètres

7. Redémarrez votre IDE pour que les modifications prennent effet

<div id="enterprise-vs-non-enterprise-behavior">
  ### Comportement des comptes Enterprise et non-Enterprise
</div>

Le comportement des workspaces personnalisés varie selon votre type d’utilisateur :

<div id="enterprise-users">
  #### Utilisateurs Enterprise
</div>

Les utilisateurs Enterprise disposent d’un contrôle granulaire sur l’indexation du workspace :

* Lors de l’ajout de workspaces, une case à cocher permet d’activer l’indexation pour chaque workspace
* Seuls les workspaces dont la case est cochée seront indexés et accessibles à Cascade
* Cela vous permet de maîtriser quels workspaces consomment des ressources d’indexation
* Par sécurité, les appels d’outils sont limités au workspace actif

<div id="non-enterprise-users">
  #### Utilisateurs non‑Enterprise
</div>

Les utilisateurs non‑Enterprise bénéficient de l’indexation automatique du workspace :

* Tout workspace que vous ajoutez est automatiquement indexé, sans case à cocher
* Tous les workspaces ajoutés sont immédiatement disponibles dans Cascade
* Les appels d’outils ne sont jamais bloqués en dehors du workspace actif
* La fonctionnalité d’indexation sélective n’est pas pertinente dans ce modèle

Après avoir terminé les étapes de configuration ci‑dessus, Cascade devrait pouvoir accéder à votre workspace et fonctionner normalement.

<div id="keyboard-shortcuts-not-working-in-rider-on-windows">
  ## Les raccourcis clavier ne fonctionnent pas dans Rider sous Windows
</div>

Si vous utilisez JetBrains Rider sous Windows et constatez que Shift+Enter ne crée pas de nouvelle ligne dans Cascade, ou que la touche Delete ne fonctionne pas, c’est dû à un conflit de raccourcis clavier avec la fenêtre d’outils « Unit Test Tool Window » de Rider.

Il s’agit d’un problème connu qui affecte les plugins d’IA dans Rider. Pour le résoudre :

1. Ouvrez les paramètres de votre IDE JetBrains en allant dans `File > Settings`

2. Accédez à `Keymap`

3. Recherchez "Unit Test Tool Window Action"

4. Désactivez ou réattribuez les raccourcis clavier en conflit (Shift+Enter et Delete)

5. Redémarrez votre IDE pour que les modifications prennent effet
