Portões de Qualidade de CI

Portões de qualidade de CI executam os mesmos scripts lint, typecheck, format:check e test em cada pull request - capturando erros de dependência de hooks e quebras de tipo entre pacotes antes que o EAS gaste minutos em uma compilação nativa.

Receita

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

// package.json - scripts que a CI chamará
{
  "scripts": {
    "lint": "expo lint",
    "typecheck": "tsc --noEmit",
    "format:check": "prettier --check .",
    "test": "jest"
  }
}

# Pre-push local (mesma sequência da CI)
npm run format:check && npm run lint && npm run typecheck && npm run test

Quando usar isso:

• Todas as equipes que usam pull requests para mesclar em main ou release/*.
• Apps Expo onde um erro de tipo atualmente aparece apenas durante eas build.
• Monorepos que precisam de lint e tsc em apps/mobile e packages/*.
• Projetos que adotam EAS Workflows e desejam verificações de qualidade antes dos jobs type: build.
• Para impor uma política ESLint de zero avisos sem depender de hooks de pré-commit baseados na honra.

Exemplo de Trabalho

# .github/workflows/quality.yml
name: Quality Gates
 
on:
  pull_request:
    branches: [main]
  push:
    branches: [main]
 
concurrency:
  group: quality-${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
 
jobs:
  quality:
    name: Lint, Format, Types, Tests
    runs-on: ubuntu-latest
    timeout-minutes: 15
 
    steps:
      - name: Checkout
        uses: actions/checkout@v4
 
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
 
      - name: Install dependencies
        run: npm ci
 
      - name: Generate Expo types
        run: npx expo customize tsconfig.json
 
      - name: Prettier
        run: npm run format:check
 
      - name: ESLint
        run: npm run lint
 
      - name: TypeScript
        run: npm run typecheck
 
      - name: Unit tests
        run: npm run test -- --ci --passWithNoTests

# .eas/workflows/quality-gates.yml - mesmos scripts na infraestrutura do Expo
name: Quality Gates
 
on:
  pull_request:
    branches: [main]
  push:
    branches: [main]
 
concurrency:
  cancel_in_progress: true
  group: ${{ workflow.filename }}-${{ github.ref }}
 
jobs:
  quality:
    name: Lint, Format, Types, Tests
    steps:
      - uses: eas/checkout
      - uses: eas/use_npm_token
      - uses: eas/install_node_modules
 
      - name: Generate Expo types
        run: npx expo customize tsconfig.json
 
      - name: Format check
        run: npm run format:check
 
      - name: Lint
        run: npm run lint
 
      - name: Typecheck
        run: npm run typecheck
 
      - name: Unit tests
        run: npm run test -- --ci --passWithNoTests
 
  build_ios:
    name: iOS build (after quality)
    needs: [quality]
    type: build
    params:
      platform: ios
      profile: preview

// turbo.json - monorepo distribui os mesmos portões
{
  "$schema": "https://turbo.build/schema.json",
  "tasks": {
    "lint": {
      "dependsOn": ["^lint"]
    },
    "typecheck": {
      "dependsOn": ["^typecheck"]
    },
    "test": {
      "dependsOn": ["^test"]
    },
    "format:check": {
      "outputs": []
    }
  }
}

# .github/workflows/quality-monorepo.yml
name: Monorepo Quality
 
on:
  pull_request:
 
jobs:
  quality:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: npm
      - run: npm ci
      - run: npx turbo run format:check lint typecheck test

O que isso demonstra:

• Uma única superfície de script package.json - desenvolvedores e CI executam comandos idênticos.
• GitHub Actions usa npm ci, Node 20 e cancelamento de concorrência para economizar minutos.
• npx expo customize tsconfig.json garante que .expo/types exista antes de tsc --noEmit.
• EAS Workflows reutiliza os mesmos scripts, então os blocos needs: [quality] de builds nativos falham.
• Turborepo executa lint/typecheck/test entre workspaces com ordenação ciente de dependências.

Mergulho Profundo

Como Funciona

• Cada etapa da CI é um comando de shell que sai com um código diferente de zero em caso de falha - GitHub e EAS marcam a execução como falha.
• expo lint envolve o ESLint com eslint-config-expo - erros falham o job a menos que você passe --max-warnings intencionalmente.
• tsc --noEmit valida todo o grafo TypeScript, incluindo pacotes de workspace importados pelo app.
• prettier --check falha em desvios de formatação sem modificar o sistema de arquivos do runner.
• Regras de proteção de branch podem exigir a verificação quality antes do merge - aplicação de política, não sugestões.

Scripts que a CI Deve Chamar

GitHub Actions vs EAS Workflows

Ordem dos Portões

format:check → lint → typecheck → test → (opcional) eas build

• Formatação primeiro - sinal mais rápido; falha em segundos em pequenas diferenças.
• Lint em segundo - captura problemas específicos do RN que o ESLint gerencia.
• Verificação de tipos em terceiro - mais lento, mas encontra quebras entre arquivos.
• Testes por último - mais caro; ainda antes da compilação nativa.
• EAS build - somente após a qualidade passar; economiza tempo de fila e créditos de build.

Notas de Monorepo

// apps/mobile/package.json
{
  "scripts": {
    "lint": "expo lint",
    "typecheck": "tsc --noEmit",
    "test": "jest"
  }
}

• O turbo run lint typecheck raiz respeita dependsOn: ["^lint"] para que packages/ui faça lint antes de apps/mobile.
• Fixe uma versão do Node em engines e na CI - as ferramentas do RN esperam o Node 20 LTS.
• Para pnpm, troque npm ci por pnpm install --frozen-lockfile e cache: pnpm em setup-node.

Armadilhas

• Pular expo customize antes de tsc - Rotas tipadas falham com .expo/types ausente em um checkout limpo da CI. Correção: Adicione uma etapa explícita antes de typecheck, ou comite os tipos gerados apenas se a política da sua equipe exigir (geralmente não).

• npm install em vez de npm ci na CI - Derivação do lockfile produz instabilidade do tipo "funciona na CI, falha localmente". Correção: Sempre use npm ci quando package-lock.json existir.

• Executar prettier --write na CI - O runner formata arquivos que nunca são comitados; o main permanece sujo. Correção: Use --check apenas em workflows.

• Avisos de lint permitidos para merge - --max-warnings 0 não é o padrão em todos os lugares; avisos se acumulam. Correção: Trate avisos como erros na CI ao adotar uma política de zero avisos, ou corrija os avisos antes de habilitar o portão.

• Job de qualidade não exigido na proteção de branch - Desenvolvedores mesclam com bypass de admin enquanto os checks estão vermelhos. Correção: GitHub → Configurações → Branches → exija o status check quality.

• Build EAS sem needs: [quality] - Builds nativos iniciam enquanto o lint ainda está falhando. Correção: Encadeie needs para que os jobs type: build esperem pelo job de qualidade personalizado.

Alternativas

FAQs

npx turbo run test --filter=mobile
# ou todos os pacotes:
npx turbo run test

Relacionados

• Noções Básicas de Linting - eslint-config-expo e as regras que expo lint impõe
• Prettier & Ordenação de Imports - script format:check e .prettierignore
• Modo Estrito do TypeScript - o que typecheck valida
• Monorepo com Turborepo - turbo run lint typecheck entre workspaces
• Noções Básicas de Configuração de Projeto - scripts padrão gerados com o SDK 57
• EAS Workflows - catálogo completo de workflows além dos portões de qualidade

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