> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Risoluzione dei problemi di JetBrains
> Risolvi i problemi del plugin JetBrains, tra cui errori JCEF, problemi di certificati, workspace personalizzati e diagnostica dell'estensione.
# Versioni supportate
Versione 2022.3 o superiore.
* JetBrains Fleet o ReSharper non sono supportati
* Remote SSH non è supportato.
# Raccolta dei log dell'estensione
A partire dalla versione 1.10.0 dell'estensione, il Chat Panel include un pulsante Extension Diagnostics nella pagina Settings. Questo pulsante raccoglie automaticamente i log e i parametri pertinenti in un file di testo scaricabile.
Per le versioni precedenti dell'estensione:
1. I log vengono scritti nel file idea.log. Per trovare questo file, vai all'opzione di menu `Help > Show Log in Finder/Explorer`
2. Esporta o copia i log
# Problemi noti dell'IDE e soluzioni
## Cascade non viene visualizzato
Di solito, nei log vedrai il seguente errore:
```
JCEF is not supported in this env or failed to initialize
```
oppure
```
Internal JCEF not supported, trying external JCEF
```
JCEF è un browser necessario per visualizzare Cascade. Per risolvere il problema, vai su `Help > Find Actions > Choose Java Boot Runtime` e seleziona un runtime che includa JCEF.
Se JCEF è già incluso nel runtime, potrebbe essere disabilitato nel registry/nelle proprietà.
Modifica le proprietà: Help > Edit Custom Properties, aggiungi il seguente flag e riavvia l'IDE:
```
ide.browser.jcef.enabled=true
```
## Problemi con i certificati
Se riscontri i seguenti errori:
```
Failed to fetch extension base URL at
```
```
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException:
unable to find valid certification path to requested target
```
Questo indica che l’estensione Codeium non riesce a considerare attendibile la connessione TLS al portale Enterprise / server API perché non si fida del certificato presentato. Ciò significa che il certificato presentato dalla distribuzione di Codeium non è attendibile oppure che non è attendibile un certificato presentato da un corporate proxy che intercetta la richiesta.
In entrambi i casi, la soluzione migliore è assicurarsi che il certificato radice che ha firmato questo certificato sia installato correttamente nel percorso appropriato sui computer degli utenti finali. Gli IDE JetBrains e la maggior parte degli altri IDE caricano i certificati dal percorso predefinito del sistema operativo.
Il certificato viene emesso e gestito dal team IT locale o dal team Admin. Contattalo per ricevere assistenza nell’installazione dei certificati necessari sul tuo sistema.
È importante che venga presentata l’intera catena di certificati dal punto in cui TLS viene terminato. Spesso, se viene presentato solo il certificato leaf, JetBrains IDE e altri IDE non riescono a verificarne l’autenticità perché non conoscono il certificato intermedio che convalida il certificato leaf ed è a sua volta convalidato dal certificato radice. I browser spesso riescono a ovviare a questo problema perché è probabile che gli utenti abbiano già visitato un altro sito web che presenta l’intera catena di certificati, quindi il certificato intermedio viene rilevato e memorizzato nella cache; applicazioni come gli IDE JetBrains, invece, non hanno questo vantaggio.
**Nota**: Nei prodotti della famiglia JetBrains **2024.3**, è stato introdotto un bug per cui l’IDE non riesce ad accettare i certificati del sistema operativo ([segnalazione del problema 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)). Per risolvere il problema, gli utenti possono eseguire una delle seguenti operazioni:
* Effettuare il downgrade dei prodotti JB a versioni precedenti
* Usare la versione preview 2024.3.1 (versione beta)
* Aggiungere `-Djavax.net.ssl.trustStoreType=Windows-ROOT` come opzione JVM personalizzata
## Workspace personalizzati
Se visualizzi il seguente errore quando usi Cascade:
```
Cascade cannot access paths without an active workspace
```
Questo indica che Cascade ha bisogno di accedere a un workspace personalizzato per funzionare correttamente. Per risolvere il problema:
1. Apri le Settings del tuo IDE JetBrains andando su `File > Settings` (oppure `IntelliJ IDEA > Preferences` su macOS)
2. Vai a `Tools > Windsurf Settings`
3. Nel pannello Windsurf Settings, individua la sezione "workspace personalizzati" in fondo
4. Fai clic sul pulsante "Add Workspace" per aggiungere il workspace del progetto
5. Seleziona la directory del workspace appropriata per il progetto
6. Fai clic su "OK" per applicare le impostazioni
7. Riavvia l'IDE affinché le modifiche abbiano effetto
### Comportamento: Enterprise vs non Enterprise
Il comportamento dei workspace personalizzati varia in base al tipo di utente:
#### Utenti Enterprise
Gli utenti Enterprise hanno un controllo selettivo sull'indicizzazione dei workspace:
* Quando aggiungi workspace, vedrai una casella di controllo per abilitare l'indicizzazione per ciascun workspace
* Solo i workspace con la casella di controllo attivata verranno indicizzati e saranno disponibili in Cascade
* Questo ti consente di controllare quali workspace consumano risorse di indicizzazione
* Le chiamate agli strumenti sono limitate al workspace attivo per motivi di sicurezza
#### Utenti non Enterprise
Gli utenti non Enterprise dispongono dell'indicizzazione automatica del workspace:
* Qualsiasi workspace aggiungi viene indicizzato automaticamente, senza dover selezionare alcuna casella
* Tutti i workspace aggiunti sono immediatamente disponibili in Cascade
* Le chiamate agli strumenti non vengono mai bloccate al di fuori del workspace attivo
* La funzionalità di indicizzazione selettiva non è pertinente in questo modello
Dopo aver completato i passaggi di configurazione sopra, Cascade dovrebbe essere in grado di accedere al tuo workspace e funzionare normalmente.
## Le scorciatoie da tastiera non funzionano in Rider su Windows
Se usi JetBrains Rider su Windows e riscontri problemi per cui Shift+Enter non va a capo in Cascade, oppure il tasto Delete non funziona, la causa è un conflitto tra le scorciatoie da tastiera e la finestra degli strumenti Unit Test di Rider.
Si tratta di un problema noto che interessa i plugin di IA in Rider. Per risolverlo:
1. Apri le Settings del tuo IDE JetBrains andando su `File > Settings`
2. Vai a `Keymap`
3. Cerca "Unit Test Tool Window Action"
4. Disattiva o riassegna le scorciatoie da tastiera in conflitto (Shift+Enter e Delete)
5. Riavvia l'IDE affinché le modifiche abbiano effetto