Pular para o conteúdo principal

​
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 <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 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). 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