Controle de versão: Git integrado ao PocketCode

Controle de versão: Git integrado ao PocketCode

O Git é fundamental no desenvolvimento moderno. O PocketCode o traz integrado (a biblioteca JGit, sem nenhum programa git para instalar) para que você gerencie seu código sem sair do app. O terminal local não tem o comando git: tudo abaixo é feito por telas, e o terminal tem seu próprio Painel Git.

Interface visual do Git

Controle de código-fonte

O Controle de código-fonte é o painel de Git do editor (menu do editor → Git, ou Ctrl+Shift+G com teclado físico, ou toque no nome do branch na barra de status). Ele mostra o branch, os commits que você ainda não enviou (↑) e não trouxe (↓), e agrupa seus arquivos assim:

• Alterações preparadas — Prontas para o próximo commit
• Alterações — Arquivos rastreados modificados
• Não rastreados — Arquivos novos

Em um repositório, o explorador de arquivos também marca cada arquivo alterado (modificado, adicionado, não rastreado, excluído ou renomeado) e as pastas que contêm alterações.

Diff visual

Toque em qualquer arquivo alterado para ler o diff em uma única lista:

• Linhas adicionadas em verde
• Linhas removidas em vermelho
• Números de linha e totais +N −M, com um botão Trocar para inverter os dois lados

Operações básicas

Fazendo um commit

No Controle de código-fonte:

1. Prepare os arquivos que quiser (Preparar tudo para todos), ou use Preparar por fragmentos para preparar só alguns blocos de um arquivo
2. Escreva a mensagem em Mensagem do commit…
3. Toque em Confirmar

O editor não mostra mensagem depois de um commit, push, pull, merge ou stash, então confira as listas e os contadores ↑↓. Em Projetos, o botão Commit do cartão do projeto abre Confirmar alterações com Commit, Commit & Push e Amend último commit, e o Painel Git do terminal também tem Confirmar alterações.

Trabalhando com branches

Os branches ficam no cartão do projeto em Projetos: toque em Git e depois em Ramo. Toque em um branch para trocar para ele, ou em Criar nova branch (com uma opção para ir para ela na hora). Essas linhas aparecem quando o projeto tem remoto (origin); o Painel Git do terminal também troca de branch e cria um localmente. Só branches locais são listados, e não há botão para excluir nem renomear um branch.

Merge e rebase

No Controle de código-fonte, toque em Mesclar, escolha um branch local e toque em Mesclar em seu branch atual. Para um merge ou um pull não existe resolvedor de conflitos guiado:

1. Se as mesmas linhas mudaram nos dois lados, os marcadores de conflito (<<<<<<<, =======, >>>>>>>) ficam nos seus arquivos
2. Abra os arquivos afetados e fique com a versão que quiser
3. Prepare e confirme, ou tente o pull de novo

O resolvedor guiado (Ours, Theirs, Both, bloco a bloco) só existe dentro do rebase interativo (Pick, Reword, Squash, Fixup, Drop, com um backup restaurável). Ele abre pelo menu ⋮ de PRs e issues do GitHub, e só quando o origin do projeto está no github.com.

Fluxos de trabalho

Git Flow

main ─────────────────────── produção
  └── develop ─────────────── desenvolvimento
        ├── feature/login ──── funcionalidade
        ├── feature/api ────── funcionalidade
        └── hotfix/bug-123 ── correção urgente

Trunk-Based Development

main ─────────────────────── branch principal única
  ├── short-lived-branch ──── de vida curta (< 1 dia)
  └── feature-flag ────────── funcionalidade oculta

Integração com plataformas

GitHub

• Enviar alterações (push) e Obter alterações (pull)
• Pull Requests a partir do app: listar, criar, fazer merge, fechar e comentar
• Issues: listar, criar, fechar e comentar
• CI: os checks de um pull request (GitHub Actions e outros) em um único resumo

GitLab

• Clonar a partir dos seus repositórios, publicar um projeto local e fazer push/pull por HTTPS
• O status da última execução de CI no feed de status do Backend Manager

Bitbucket

• Clonar a partir dos seus repositórios, publicar um projeto local e fazer push/pull por HTTPS
• O status da última execução do Pipelines no feed de status do Backend Manager

Pull/merge requests dentro do app são exclusivos do GitHub hoje (github.com). Para GitLab e Bitbucket, abra os MRs/PRs na interface web deles.

Git stash

Salve alterações temporariamente sem fazer commit. No Controle de código-fonte:

1. Toque em Guardar à parte e depois em Guardar as alterações à parte
2. Mais tarde, toque em uma entrada para Aplicar, Recuperar ou Descartar

Lembre que arquivos novos (não rastreados) não entram no stash, a mensagem opcional do stash não é guardada com a entrada, e Recuperar sempre pega a entrada mais recente; para restaurar uma específica, use Aplicar nela e depois Descartar.

Dicas para mensagens de commit

Siga o Conventional Commits para mensagens claras:

feat: add OAuth2 authentication
fix: correct email validation error
docs: update README with setup instructions
style: format code with Prettier
refactor: simplify price calculation logic
test: add tests for payment module
chore: update dependencies

O botão Mensagem com IA do Controle de código-fonte sugere mensagens em quatro estilos (Convencional, Descritivo, Imperativo, Emoji). Ele não é IA: é uma sugestão local, baseada em regras, montada a partir dos nomes dos arquivos que você alterou, então revise antes de usar.

Configuração

Seu nome nos commits

Os commits levam o nome e o e-mail salvos no repositório. Defina-os em Projetos → cartão do projeto → Git → Seu nome nos commits. Eles começam preenchidos com os do repositório, do seu serviço conectado ou da sua conta do PocketCode.

Autenticação

O PocketCode fala com os remotos apenas por HTTPS (remotos SSH não são suportados). GitHub e GitLab se conectam com o fluxo de dispositivo OAuth: em Configurações → Integrações → Serviços conectados o app mostra um código e você o aprova no navegador. O Bitbucket usa seu e-mail da Atlassian mais um API token. Clonar, fetch, pull e push para repositórios privados funcionam com a conta conectada, e o token é enviado apenas para github.com, gitlab.com e bitbucket.org; um remoto em qualquer outro host (GitHub Enterprise, um GitLab próprio) não recebe credenciais. Os tokens dos seus serviços conectados ficam guardados criptografados no dispositivo. Se você entra no próprio PocketCode com o GitHub, esse token do GitHub também é guardado, criptografado, no backend do PocketCode, que o usa para listar seus repositórios. Toda operação local — commit, branch, merge, stash, diff — não precisa de conexão depois que você entra na conta (o app precisa de conexão para entrar). Para automatizar suas rotinas de publicação, combine esse recurso com os fluxos de trabalho do PocketCode e consulte o guia de primeiros passos sempre que precisar.

---

Com o Git integrado, o PocketCode oferece o fluxo diário de Git no seu celular. Faça commits, gerencie branches e colabore com sua equipe sem sair do editor do PocketCode. O que não existe: remotos SSH, Git LFS, submódulos, assinatura de commits e hooks.