Guia de Instalação

O CodeX é compatível com os principais sistemas operacionais. Abaixo você encontra os passos detalhados para instalar o editor no seu dispositivo.

Requisitos Mínimos

• Windows: Windows 10 ou 11 (x64 ou ARM64)
• macOS: macOS 11.0 (Big Sur) ou superior
• Linux: Ubuntu 20.04+, Debian 11+, Fedora 36+

Instalação no Windows

1. Vá até a nossa página de download e selecione o Instalador x64.

2. Execute o arquivo de instalação baixado (CodeXSetup-x64.exe).

3. Siga as instruções do assistente de instalação. Recomendamos marcar a caixa "Adicionar ao PATH" para poder abrir pastas diretamente pelo terminal usando o comando codex ..

4. Clique em Concluir e abra o CodeX.

Instalação no Linux

Distribuições baseadas em Debian/Ubuntu

Baixe o pacote .deb e execute no terminal:

sudo dpkg -i codex_amd64.deb
sudo apt-get install -f # Corrige possíveis dependências quebradas

Distribuições baseadas em Red Hat/Fedora

Baixe o pacote .rpm e instale executando:

sudo dnf install codex_x86_64.rpm

Instalação no macOS

1. Baixe o arquivo .zip universal para Mac.

2. Extraia o conteúdo e arraste o executável do CodeX.app para a sua pasta de Aplicativos.

3. Abra o Finder, vá em Aplicativos e inicie o CodeX.

Tour pela Interface

A interface do CodeX foi projetada para focar na legibilidade e eficiência. O design em cores escuras teal-black associado ao verde ativo destaca as seções de código e estados importantes.

Principais Componentes da UI

Abaixo estão descritos os 5 elementos essenciais da janela principal do CodeX:

1. Barra de Atividades (Activity Bar)

Localizada na extremidade esquerda. Permite alternar rapidamente entre a árvore de arquivos, pesquisa global, controle de versão (Git), depuração e o gerenciador de extensões.

2. Barra Lateral (Sidebar)

Exibe a visualização ativa da Barra de Atividades. Por exemplo, quando o Explorador de Arquivos está ativo, exibe a estrutura de pastas e arquivos abertos do projeto atual.

3. Grupos de Editores (Editor Groups)

A área central onde você edita seus arquivos. Você pode abrir múltiplos arquivos lado a lado, em grades ou em abas. O CodeX suporta divisão vertical e horizontal de editores.

4. Painel Inferior (Panel)

Área que fica na parte inferior onde você pode visualizar a saída de compilação, problemas no código (errors/warnings), terminal integrado e consoles de depuração.

5. Barra de Status (Status Bar)

A linha na parte inferior da janela. Exibe informações sobre o arquivo aberto no momento (linha e coluna, codificação, quebra de linha, linguagem ativa) e o branch Git atual.

Customização e Configurações

O CodeX é altamente customizável. Você pode modificar quase tudo na interface e comportamento através das configurações visuais ou editando o arquivo settings.json.

Abrindo as Configurações

Para abrir as configurações interativas do editor:

• Pressione o atalho Ctrl + , (ou Cmd + , no macOS).
• Ou clique no ícone de engrenagem no canto inferior esquerdo e selecione Settings.

Editando o settings.json

Se preferir configurar via JSON direto, clique no ícone de arquivo JSON (canto superior direito da aba de configurações). Um exemplo típico de personalização do CodeX seria:

{
    "editor.theme": "codex-dark-green",
    "editor.fontSize": 14,
    "editor.fontFamily": "Fira Code, Consolas, monospace",
    "editor.fontLigatures": true,
    "editor.tabSize": 4,
    "files.autoSave": "afterDelay",
    "workbench.iconTheme": "codex-icons"
}

Configurando Atalhos de Teclado

Você pode personalizar qualquer atalho de teclado abrindo o painel Keyboard Shortcuts pelo atalho Ctrl + K Ctrl + S.

Atalhos de Teclado

Dominar os atalhos de teclado é o caminho mais rápido para programar com alta velocidade. Abaixo, listamos os atalhos mais úteis configurados por padrão no CodeX.

Atalhos do Sistema Geral

Atalhos de Edição Básica

Gerenciamento de Extensões

O poder real do CodeX reside em sua capacidade de expandir recursos através de extensões. Como o CodeX utiliza o motor do VS Code, ele possui suporte total a todas as extensões do marketplace oficial.

Instalando uma Extensão

1. Clique no ícone de Extensões na Barra de Atividades à esquerda (ou pressione Ctrl + Shift + X).
2. Use a barra de pesquisa para digitar o nome da extensão desejada (por exemplo, Python, Prettier, ou GitLens).
3. Clique no botão verde Install correspondente à extensão.
4. Uma vez instalada, ela estará ativada globalmente ou no seu workspace atual.

Extensões Recomendadas

• Prettier - Code Formatter: Mantém seu código limpo e padronizado automaticamente no salvamento.
• GitLens: Adiciona anotações de autoria de código inline, facilitando o rastreio de commits diretamente pelo editor.
• ESLint: Ferramenta essencial de linting para projetos JavaScript/TypeScript.

Depuração de Código (Debugging)

O CodeX possui um dos depuradores nativos mais poderosos do mercado, permitindo inspecionar o fluxo de execução do seu código sem sair da janela principal.

Como Configurar a Depuração

Para iniciar o debug de um projeto, precisamos definir um arquivo de configuração launch.json:

1. Clique na aba de Run and Debug na Barra de Atividades (atalho Ctrl + Shift + D).
2. Clique no link "create a launch.json file" no topo da barra lateral.
3. Selecione o ambiente correspondente (por exemplo: Node.js, Python, Chrome, etc.).

Exemplo de launch.json (para Node.js)

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "launch",
            "name": "Executar Programa",
            "skipFiles": ["/**"],
            "program": "${workspaceFolder}/index.js"
        }
    ]
}

Utilizando Breakpoints

Você pode adicionar um breakpoint clicando na margem esquerda (gutter) ao lado do número da linha de código. Uma bola vermelha aparecerá indicando que o depurador pausará a execução naquela linha específica, permitindo que você inspecione as variáveis na barra lateral.

Integração com Versionamento Git

O controle de versão integrado no CodeX suporta quase todos os comandos comuns do Git, permitindo sincronizar seus projetos diretamente pela Barra de Atividades.

Fluxo de Trabalho Básico

Quando você edita arquivos em um diretório inicializado com Git, o CodeX exibe indicadores de alteração coloridos na lateral esquerda das linhas modificadas:

• Verde: Linhas novas adicionadas.
• Azul: Linhas modificadas.
• Vermelho (seta): Linhas deletadas.

Realizando Commits

1. Clique na aba de Source Control (Ctrl + Shift + G).

2. Clique no ícone de + ao lado de um arquivo para prepará-lo (git add).

3. Digite sua mensagem de commit na caixa de texto superior e clique no botão verde Commit.

4. Clique em Sync Changes na barra inferior para realizar o envio ao seu repositório remoto (git push).