Noções Básicas de Git para Equipes Mobile

Um guia prático para um modelo de branching que respeita congelamentos de lançamento da loja - integração trunk-based em main, branches de recursos de curta duração e pistas de lançamento que não colidem com as janelas de revisão da App Store ou do Play.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

# Daily feature work
git checkout main && git pull --ff-only
git checkout -b feat/SHIP-412-checkout-summary
# ... commits ...
git push -u origin feat/SHIP-412-checkout-summary
# Open PR → squash merge to main after review + CI green

# Release cut (Tuesday - before Thursday freeze)
git checkout main && git pull --ff-only
git checkout -b release/2.6.0
git push -u origin release/2.6.0
# Only bugfixes cherry-picked or PRs targeting release/2.6.0 until tag

# Tag after QA sign-off (post-review)
git checkout release/2.6.0
git tag -a v2.6.0 -m "Release 2.6.0 - build_id abc123"
git push origin v2.6.0

Branch lanes (mobile)
  main              ← integration; always green CI
  feat/*            ← days, squash merge
  release/X.Y       ← weeks; freeze during store review
  hotfix/X.Y.Z      ← hours; from tag, cherry-pick to main
  ota/production    ← optional long-lived for channel-only JS (see GitHub Flow page)

Quando usar isso:

• Primeira equipe mobile a adotar Git após builds ad-hoc em laptop.
• Janelas de submissão da loja onde mesclar recursos durante a revisão arrisca rejeição.
• Coordenação de atualizações de JavaScript OTA com binários de loja marcados.
• Integração de engenheiros que conhecem Git web, mas não disciplina de artefatos nativos.

Quando evitar:

• Projeto paralelo solo sem QA ou cadência de loja - main + tags podem ser suficientes.
• GitFlow com develop durando meses - a revisão da loja mobile pune o desvio.

Exemplo de Trabalho

Recurso → lançamento → congelamento → tag de ponta a ponta para um aplicativo Expo SDK 57 sendo enviado via EAS.

Etapa 1 - Higienização do repositório inicial

npx create-expo-app@latest ShipApp --template blank-typescript
cd ShipApp
git init

# .gitignore - essenciais mobile (NÃO ignore lockfile)
node_modules/
.expo/
dist/
*.jks
*.p8
*.p12
*.mobileprovision
ios/Pods/
android/.gradle/
android/app/build/

{
  "scripts": {
    "lint": "expo lint",
    "typecheck": "tsc --noEmit",
    "test": "jest",
    "format:check": "prettier --check .",
    "prepare": "husky"
  }
}

# .husky/pre-commit
npm run format:check && npm run lint && npm run typecheck

• Commit package-lock.json - CI usa npm ci (Noções Básicas de CI/CD Mobile)
• Nunca comite chaves de assinatura - EAS armazena credenciais (GitHub Actions + EAS)

Etapa 2 - Branch de recurso com commits com escopo de ticket

git checkout main && git pull --ff-only
git checkout -b feat/SHIP-412-checkout-summary
 
git add src/screens/CheckoutSummary.tsx
git commit -m "feat(checkout): add order summary sheet [SHIP-412]"
 
git push -u origin feat/SHIP-412-checkout-summary

PR tem como alvo main. Squash merge preserva um commit por recurso - cherry-picks mais fáceis para release/* depois.

Etapa 3 - Corte do branch de lançamento antes do congelamento

<!-- docs/release-calendar.md (excerpt) -->
| Week | Event                          | Git rule                          |
|------|--------------------------------|-----------------------------------|
| W12  | Cut release/2.6.0 Tue 10:00    | New features → main only          |
| W12  | Code freeze Thu 18:00 UTC      | release/2.6.0: bugfixes only      |
| W12  | Submit Fri after Maestro       | Tag v2.6.0 from release branch    |
| W13  | Store review in flight         | No native changes on release/2.6.0|

git checkout main && git pull --ff-only
git checkout -b release/2.6.0
git push -u origin release/2.6.0

Proteção de branch em release/2.6.0:

• Exigir revisões de PR
• Exigir verificações de status (quality de Integração GitHub Actions)
• Bloquear pushes diretos, exceto para gerentes de lançamento

Etapa 4 - Cherry-pick de uma correção de bug durante o congelamento

Uma correção crítica chega ao main após o corte. Cherry-pick - não mescle todo o main.

git checkout release/2.6.0 && git pull --ff-only
git cherry-pick <sha-from-main>
git push origin release/2.6.0

# Verify the cherry-pick is the only diff vs tag candidate
git log --oneline main..release/2.6.0
git diff main...release/2.6.0 --stat

Etapa 5 - Tag aciona o pipeline de lançamento

git checkout release/2.6.0
git tag -a v2.6.0 -m "Release 2.6.0 - QA build_id abc123"
git push origin v2.6.0

A tag v* aciona eas build no CI - o mesmo artefato que o QA testou (Promoção Automatizada da Loja).

Etapa 6 - Mesclar lançamento de volta para main

Após aprovação da loja e lançamento gradual:

git checkout main && git pull --ff-only
git merge --ff-only release/2.6.0
git push origin main
git branch -d release/2.6.0
git push origin --delete release/2.6.0

Regras de Git Específicas para Mobile

# Inspect what changed in native folders before merging SDK bump
git diff main -- ios/ android/ app.json eas.json
npx expo-doctor

Armadilhas

• Mesclar main em release/* durante a revisão - Puxa recursos não testados por QA; risco de rejeição da loja. Correção: Cherry-pick apenas SHAs listados.
• Branch de recurso a partir de main desatualizado - Rebase antes do PR; conflitos de runtimeVersion desatualizados surgem tarde. Correção: git fetch && git rebase origin/main semanalmente.
• .env comitado "apenas para CI" - Segredos no Git para sempre. Correção: Variáveis de ambiente EAS (Ambientes e Variáveis de Ambiente EAS).
• Assets binários no Git sem LFS - Inchaço do repositório retarda o checkout do CI. Correção: git lfs track "*.psd" ou hospedar em CDN.
• Squash merge perde metadados de cherry-pick - ID do ticket no corpo do commit ainda é necessário para picks de lançamento.

Alternativas

FAQs

Relacionados

• GitHub Flow & Release Branches - pistas de hotfix paralelas aos canais OTA
• Interactive Rebase & Worktrees - spikes de SDK paralelos sem stash
• Integração GitHub Actions - modelos de PR e verificações obrigatórias
• Calendário de Trem de Lançamento - janelas de congelamento em um calendário compartilhado
• Noções Básicas de CI/CD Mobile - o que o CI executa em cada branch
• Canais e Branches de Lançamento - Branch Git vs Branch de Atualização EAS
• Melhores Práticas de Git & GitHub - Resumo de 25 itens

Versões da Stack: Esta página foi escrita para React 19.2.3, React Native 0.86.0, e Expo SDK 57 (expo ~57.0.4).