> ## 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.
# Solução de problemas do JetBrains
> Solucione problemas do plugin do JetBrains, incluindo erros JCEF, problemas de certificado, workspaces personalizados e diagnósticos de extensões.
# Versões compatíveis
Versão 2022.3 ou superior.
* JetBrains Fleet ou ReSharper não são compatíveis
* Remote SSH não é compatível.
# Coletando logs da extensão
A partir da versão 1.10.0 da extensão, o Painel do Chat inclui um botão Diagnóstico da Extensão na página de Configurações. Esse botão coleta automaticamente os logs e parâmetros relevantes em um arquivo de texto que pode ser baixado.
Para versões anteriores da extensão:
1. Os logs são gravados no arquivo idea.log. Para localizar esse arquivo, vá até a opção de menu `Help > Show Log in Finder/Explorer`
2. Exporte ou copie os logs
# Problemas conhecidos do IDE e soluções
## Cascade não está sendo exibido
Geralmente, você verá o seguinte erro nos logs:
```
JCEF não é compatível com este ambiente ou falhou na inicialização
```
ou
```
JCEF interno não é compatível, tentando JCEF externo
```
JCEF é o navegador necessário para exibir o Cascade. Para corrigir isso, vá em `Help > Find Actions > Choose Java Boot Runtime` e escolha um runtime com JCEF incluído.
Se você já tem o JCEF incluído como parte do seu runtime, ele pode estar desativado no seu registro/propriedades.
Edite suas propriedades: Help > Edit Custom Properties, adicione a seguinte flag e reinicie seu IDE:
```
ide.browser.jcef.enabled=true
```
## Problemas de certificado
Se você encontrar os seguintes erros:
```
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
```
Isso sugere que a extensão do Codeium não consegue confiar na conexão TLS com o seu portal corporativo/servidor de API porque não confia no certificado que está sendo apresentado. Isso significa que ou o certificado apresentado pela implantação do Codeium não é confiável ou um certificado apresentado por um proxy corporativo que está interceptando a requisição não é confiável.
Em qualquer um dos casos, a solução mais recomendável é garantir que o certificado raiz que assinou esse certificado esteja devidamente instalado nas máquinas dos usuários finais, no local apropriado. IDEs da JetBrains e a maioria dos outros IDEs carregam certificados do local padrão do sistema operacional.
Seu certificado é emitido e gerenciado pela sua equipe local de TI ou de Administração. Entre em contato com eles para obter ajuda na instalação dos certificados necessários no seu sistema.
É importante que toda a cadeia de certificação esteja sendo apresentada a partir de onde o TLS está sendo terminado. Muitas vezes, se apenas o certificado folha é apresentado, o IDE da JetBrains e outros IDEs não conseguem verificar sua autenticidade porque não conhecem o certificado intermediário que valida o certificado folha e é validado pelo certificado raiz. Navegadores geralmente conseguem contornar esse problema, pois os usuários provavelmente já acessaram algum outro site que apresenta a cadeia completa de certificação; assim, o certificado intermediário é visto e armazenado em cache, mas aplicações como IDEs da JetBrains não têm essa vantagem.
**Observação**: Nos produtos da família JetBrains **2024.3** foi introduzido um bug em que o IDE não está aceitando os certificados do SO ([relatório de problema da 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)). Para resolver isso, os usuários podem fazer qualquer uma das seguintes ações:
* Fazer downgrade dos produtos da JetBrains para versões anteriores
* Usar a versão preview 2024.3.1 (versão beta)
* Adicionar `-Djavax.net.ssl.trustStoreType=Windows-ROOT` como uma opção de JVM personalizada
## Custom Workspaces
Se você se deparar com o seguinte erro ao usar o Cascade:
```
Cascade não pode acessar caminhos sem um workspace ativo
```
Isso indica que o Cascade precisa ter acesso a um workspace personalizado para funcionar corretamente. Para resolver isso:
1. Abra as configurações do seu IDE JetBrains acessando `File > Settings` (ou `IntelliJ IDEA > Preferences` no macOS)
2. Navegue até `Tools > Windsurf Settings`
3. No painel de Windsurf Settings, localize a seção "Custom Workspaces" na parte inferior
4. Clique no botão "Add Workspace" para adicionar o workspace do seu projeto
5. Selecione o diretório apropriado de workspace para o seu projeto
6. Clique em "OK" para aplicar as configurações
7. Reinicie seu IDE para que as alterações sejam aplicadas
### Comportamento em planos Enterprise e não-Enterprise
O comportamento dos workspaces personalizados varia de acordo com o seu tipo de usuário:
#### Usuários Enterprise
Usuários Enterprise têm controle seletivo sobre a indexação de workspaces:
* Ao adicionar workspaces, você verá uma caixa de seleção para habilitar a indexação de cada workspace
* Apenas os workspaces com a caixa de seleção ativada serão indexados e disponibilizados ao Cascade
* Isso permite controlar quais workspaces consomem recursos de indexação
* As chamadas de ferramentas são restritas ao workspace ativo por segurança
#### Usuários Non-Enterprise
Usuários Non-Enterprise contam com indexação automática de workspace:
* Qualquer workspace que você adicionar será indexado automaticamente, sem necessidade de marcar uma caixa de seleção
* Todos os workspaces adicionados ficam imediatamente disponíveis para o Cascade
* As chamadas de ferramentas nunca são bloqueadas fora do workspace ativo
* O recurso de indexação seletiva não se aplica nesse modelo
Após concluir as etapas de configuração acima, o Cascade deverá conseguir acessar seu workspace e funcionar normalmente.
## Atalhos de teclado não funcionam no Rider no Windows
Se você estiver usando o JetBrains Rider no Windows e perceber que Shift+Enter não cria uma nova linha no Cascade, ou que a tecla Delete não funciona, isso é causado por um conflito de atalho de teclado com a janela Unit Test Tool Window do Rider.
Este é um problema conhecido que afeta plugins de IA no Rider. Para resolver:
1. Abra as configurações do seu IDE JetBrains indo em `File > Settings`
2. Navegue até `Keymap`
3. Procure por "Unit Test Tool Window Action"
4. Desative ou remapeie os atalhos de teclado em conflito (Shift+Enter e Delete)
5. Reinicie seu IDE para que as alterações entrem em vigor