> ## 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.

# Solução de problemas do JetBrains

> Solucione problemas com o plugin do JetBrains, incluindo erros de JCEF, problemas com certificados, workspaces personalizados e diagnósticos da extensão.

<div id="supported-versions">
  # Versões compatíveis
</div>

Versão 2022.3 ou posterior.

* JetBrains Fleet ou ReSharper não têm suporte
* Remote SSH não tem suporte.

<div id="gathering-extension-logs">
  # Coletando logs da extensão
</div>

A partir da versão 1.10.0 da extensão, o Chat Panel passou a ter um botão Extension Diagnostics 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 mais antigas da extensão:

1. Os logs são gravados no arquivo idea.log. Para localizar esse arquivo, acesse a opção de menu `Help > Show Log in Finder/Explorer`

2. Exporte ou copie os logs

<div id="known-ide-issues-and-solutions">
  # Problemas conhecidos do IDE e soluções
</div>

<div id="cascade-not-being-displayed">
  ## Cascade não é exibido
</div>

Normalmente, você verá o seguinte erro nos logs:

```
JCEF is not supported in this env or failed to initialize
```

ou

```
Internal JCEF not supported, trying external JCEF
```

JCEF é um navegador necessário para exibir o Cascade. Para resolver isso, vá até `Help > Find Actions > Choose Java Boot Runtime` e selecione um runtime com JCEF incluído.
Se o JCEF já estiver incluído no seu runtime, ele pode estar desativado no seu registro/properties.
Edite suas propriedades: Help > Edit Custom Properties, adicione a flag a seguir e reinicie a IDE:

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

<div id="certificate-issues">
  ## Problemas com certificados
</div>

Se você encontrar os seguintes erros:

```
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
```

Isso sugere que a extensão Codeium não consegue confiar na conexão TLS com o portal Enterprise / servidor de API porque não confia no certificado apresentado. Isso significa que ou o certificado apresentado pela implantação do Codeium não é confiável, ou o certificado apresentado por um proxy corporativo que intercepta a requisição não é confiável.

Em qualquer um dos casos, a solução mais recomendada é garantir que o certificado raiz que assinou esse certificado esteja devidamente instalado nas máquinas dos usuários finais, no local apropriado. Os IDEs da JetBrains e a maioria dos outros IDEs carregam certificados do local padrão do sistema operacional.

Seu certificado é emitido e gerenciado pela equipe local de TI ou de Admin. Entre em contato com ela para obter ajuda para instalar os certificados necessários no seu sistema.

É importante que a cadeia completa de certificados seja apresentada onde quer que o TLS esteja sendo encerrado. Muitas vezes, se apenas o certificado final é apresentado, os IDEs da JetBrains e outros IDEs não conseguem verificar sua autenticidade porque não conhecem o certificado intermediário, que valida o certificado final e é validado pelo certificado raiz. Os navegadores geralmente conseguem contornar esse problema, pois os usuários provavelmente já terão acessado outro site que apresenta a cadeia completa de certificados, então o certificado intermediário é identificado e armazenado em cache, mas aplicativos como os 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 consegue aceitar os certificados do sistema operacional ([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 opções a seguir:

* Fazer downgrade dos produtos JB 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 personalizada da JVM

<div id="custom-workspaces">
  ## Workspaces personalizados
</div>

Se aparecer o seguinte erro ao usar o Cascade:

```
Cascade cannot access paths without an active workspace
```

Isso indica que o Cascade precisa de acesso a um workspace personalizado para funcionar corretamente. Para resolver isso:

1. Abra as Configurações da sua IDE JetBrains acessando `File > Settings` (ou `IntelliJ IDEA > Preferences` no macOS)

2. Vá para `Tools > Windsurf Settings`

3. No painel 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 de workspace adequado para o seu projeto

6. Clique em "OK" para aplicar as configurações

7. Reinicie a IDE para que as alterações entrem em vigor

<div id="enterprise-vs-non-enterprise-behavior">
  ### Comportamento no Enterprise vs. fora do Enterprise
</div>

O comportamento de workspaces personalizados varia de acordo com o tipo de usuário:

<div id="enterprise-users">
  #### Usuários Enterprise
</div>

Usuários Enterprise têm controle seletivo sobre a indexação de workspaces:

* Ao adicionar workspaces, você verá uma caixa de seleção para ativar a indexação de cada workspace
* Somente os workspaces com a caixa de seleção ativada serão indexados e ficarão disponíveis no Cascade
* Isso permite controlar quais workspaces consomem recursos de indexação
* Por segurança, as chamadas de ferramentas ficam restritas ao workspace ativo

<div id="non-enterprise-users">
  #### Usuários não Enterprise
</div>

Usuários não Enterprise têm indexação automática do workspace:

* Qualquer workspace que você adicionar será indexado automaticamente, sem exigir 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 é relevante nesse modelo

Após concluir as etapas de configuração acima, o Cascade deverá conseguir acessar seu workspace e funcionar normalmente.

<div id="keyboard-shortcuts-not-working-in-rider-on-windows">
  ## Atalho de teclado não funciona no Rider no Windows
</div>

Se você estiver usando o JetBrains Rider no Windows e encontrar um problema em que Shift+Enter não cria uma nova linha no Cascade ou a tecla Delete não funciona, isso é causado por um conflito de atalhos de teclado com a janela Unit Test Tool Window do Rider.

Este é um problema conhecido que afeta plugins de IA no Rider. Para resolver isso:

1. Abra as Configurações da IDE JetBrains em `File > Settings`

2. Vá até `Keymap`

3. Pesquise por "Unit Test Tool Window Action"

4. Desative ou reatribua os atalhos de teclado em conflito (Shift+Enter e Delete)

5. Reinicie a IDE para que as alterações entrem em vigor
