> ## 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 no Eclipse

> Solucione problemas do plugin do Eclipse, incluindo problemas de inicialização, tela do Chat em branco, WebView2 e erros de certificado com soluções usando o keystore do Java.

<Note>
  Recomendamos fortemente usar o Windsurf Editor nativo ou o plugin local da JetBrains, por suas capacidades avançadas de IA agentic e recursos de última geração.
  O plugin do Eclipse encontra-se em modo de manutenção.
</Note>

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

Versão 4.25+ (2022-09+)

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

No Eclipse, os logs são gravados nos seguintes caminhos:

* **Mac/Linux**: \~/.codeium/codeium.log
* **Windows**: C:\Users\<username>.codeium\codeium.log

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

<div id="codeium-isnt-starting">
  ## Codeium não está iniciando
</div>

Se o Codeium não estiver inicializando, use os logs para investigar a possível causa (veja acima). Se você não conseguir resolver o problema, abra uma solicitação de suporte enviando um ticket em help.codeium.com. Certifique-se de incluir os logs mencionados acima para ajudar nossa equipe a diagnosticar o problema o mais rápido possível.

<div id="codeium-chat-shows-an-empty-screen">
  ## Codeium Chat exibe uma tela em branco
</div>

Se você estiver usando o Windows 10, talvez seja necessário instalar o **WebView2** para alterar o mecanismo de renderização da Web do Eclipse de Internet Explorer para Edge.

Você pode verificar isso clicando com o botão direito --> `Properties` e vendo se há um ícone do Internet Explorer.

<div id="certificate-issue">
  ## Problema de certificado
</div>

Esse problema pode ser indicado pelos seguintes erros nos logs:

```
Falha ao buscar versão da extensão em <YourDomainURL>
javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
```

Ao contrário de outros IDEs, o Eclipse não usa o repositório de certificados do sistema operacional. Você precisará carregar os certificados no keystore do Java.

* Usuários de SaaS precisarão carregar a URL do Codeium GitHub
* Usuários self-hosted (On‑prem) precisarão carregar o domínio do Codeium Enterprise, bem como a URL do Codeium GitHub

**Observação**: Este é um exemplo para usuários de SaaS, mas o processo é o mesmo. *Para usuários Enterprise — seu certificado é emitido e gerenciado pela sua equipe local de TI ou de Administração. Entre em contato com eles para obter assistência na instalação dos certificados necessários no seu sistema.*

1. Exporte o certificado de [https://exafunction.github.io/](https://exafunction.github.io/) do navegador como arquivo `githubio.cer`

No Chrome: acesse o site, clique no cadeado, clique em `Connection is secure`, clique em `Certificate is valid`, vá até a guia `Details`, pressione o botão `Copy to File...`

2. Importe no keystore do JDK/JRE: (É necessário executar a partir de um prompt de comando aberto com privilégio de "Administrator")

```
keytool -import -noprompt -trustcacerts -alias codeiumgithub -file githubio.cer -keystore "%JAVA_HOME%/jre/lib/security/ cacerts" -storepass changeit
```

3. Verifique se o certificado foi adicionado ao Keystore executando:

```
keytool -list -keystore "%JAVA_HOME%/jre/lib/security/ cacerts" | findstr codeium
```

Insira a senha do Keystore.

4. Reinicie o Eclipse e acesse a extensão do marketplace pelo navegador interno. Você deverá ser instruído a confiar no conteúdo não assinado.

5. Em alguns casos, talvez seja necessário também passar o caminho dos certificados nos argumentos da VM, editando o arquivo eclipse.ini e adicionando o caminho:

```
-Djavax.net.ssl.trustStore="caminho-para-seus-certificados"
```