Vai al contenuto

Avvia Native Build dalla UI della CI

A volte serve un binario iOS o Android firmato senza dover mergiare una PR o tagliare un tag di release: un build per QA, un resubmit sullo store o un TestFlight one-off. Ogni host code principale può avviare una pipeline dalla sua UI web. Questa guida mostra come collegare quell'UI a Capgo Build.

Nessuna cerimonia Git

Clicca su Run workflow / Run pipeline. Capgo Build compila dalla branch che selezioni.

Input sicuri

Piattaforma e modalità di build usano scelte vincolate dove supportate dall'host (GitHub / Bitbucket / Azure). Le variabili GitLab restano modificabili per ogni run, a meno che non definisci input della pipeline con options.

Stesse Secrets della CI

Riutilizza le credenziali di Capgo Build già presenti nel tuo repo. Niente di nuovo sui laptop.

di GitHub Azioni la tab può avviare qualsiasi workflow che dichiari workflow_dispatch.

.github/workflows/capgo-build-manual.yml
name: Capgo Build (Manual)
on:
workflow_dispatch:
inputs:
platform:
description: Platform to build
required: true
default: both
type: choice
options: [ios, android, both]
mode:
description: Build mode
required: true
default: debug
type: choice
options: [debug, release]
ref_note:
description: Optional note for the run summary
required: false
type: string
jobs:
build:
runs-on: ubuntu-latest
environment: ${{ inputs.mode == 'release' && 'production' || 'build-debug' }}
strategy:
fail-fast: false
matrix:
platform: ${{ fromJSON(inputs.platform == 'both' && '["ios","android"]' || format('["{0}"]', inputs.platform)) }}
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v6
with:
node-version: '24'
cache: 'npm'
- run: npm ci
- run: npm run build
- run: npx cap sync ${{ matrix.platform }}
- name: Capgo Build
env:
CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
P12_PASSWORD: ${{ secrets.P12_PASSWORD }}
CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP }}
APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }}
APPLE_ISSUER_ID: ${{ secrets.APPLE_ISSUER_ID }}
APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }}
APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}
ANDROID_KEYSTORE_FILE: ${{ secrets.ANDROID_KEYSTORE_FILE }}
KEYSTORE_KEY_ALIAS: ${{ secrets.KEYSTORE_KEY_ALIAS }}
KEYSTORE_KEY_PASSWORD: ${{ secrets.KEYSTORE_KEY_PASSWORD }}
KEYSTORE_STORE_PASSWORD: ${{ secrets.KEYSTORE_STORE_PASSWORD }}
PLAY_CONFIG_JSON: ${{ secrets.PLAY_CONFIG_JSON }}
run: |
EXTRA=""
if [ "${{ inputs.mode }}" = "debug" ] && [ "${{ matrix.platform }}" = "android" ]; then
EXTRA="--no-playstore-upload --output-upload"
fi
npx @capgo/cli@latest build request com.example.app \
--platform ${{ matrix.platform }} \
--build-mode ${{ inputs.mode }} \
$EXTRA
  1. Apri il repository GitHub nel browser
  2. Vai su Azioni
  3. Seleziona Capgo Build (manuale)
  4. Clicca su Esegui workflow
  5. Seleziona branch, piattaforma e modalità
  6. Verifica Esegui workflow

Chiunque con write access può avviare una build. L'esempio mappa release runs a un GitHub Environment denominato production — crea quell'ambiente e aggiungi i revisori richiesti in modo che le build per gli store attendano l'approvazione. Senza environment: sul job, le regole di protezione dell'ambiente non vengono mai applicate.

GitLab può eseguire un job da Build → Pipelines → Esegui pipeline quando il job è disponibile per quel branch.

# Job fragment for .gitlab-ci.yml
stages:
- build
variables:
APP_ID: com.example.app
PLATFORM: android # override from Run pipeline UI
BUILD_MODE: debug
capgo_native_manual:
stage: build
when: manual
script:
- npm ci
- npm run build
- npx cap sync "$PLATFORM"
- |
npx @capgo/cli@latest build request "$APP_ID" \
--platform "$PLATFORM" \
--build-mode "$BUILD_MODE"
rules:
# Actions / Pipelines UI → manual play button
- if: '$CI_PIPELINE_SOURCE == "web"'
when: manual
# Pipeline trigger token / webhook → run automatically
- if: '$CI_PIPELINE_SOURCE == "trigger"'
when: on_success
- when: never
  1. Apri il progetto GitLab
  2. Vai su Build → Pipelines → Esegui pipeline
  3. Seleziona il branch
  4. Facoltativamente imposta PLATFORM / BUILD_MODE le variabili per questa esecuzione
  5. Avvia la pipeline, quindi clicca sul pulsante play su capgo_nativo_manuale

when: manual evita che il job parta a ogni push; la web UI (o un token di trigger della pipeline) la avvia on demand.

Use a custom pipeline so the Bitbucket UI can pass variables:

bitbucket-pipelines.yml
pipelines:
custom:
capgo-native-build:
- variables:
- name: PLATFORM
default: android
allowed-values:
- ios
- android
- name: BUILD_MODE
default: debug
allowed-values:
- debug
- release
- step:
name: Capgo Build
image: node:24
script:
- npm ci
- npm run build
- npx cap sync "$PLATFORM"
- npx @capgo/cli@latest build request com.example.app --platform "$PLATFORM" --build-mode "$BUILD_MODE"

Eseguila da Pipelines → Run pipeline → Custom: capgo-native-build. Store CAPGO_TOKEN e materiale di firma sotto Impostazioni del repository → Pipeline → Variabili del repository.

azure-pipelines-capgo-manual.yml
trigger: none # disable CI push triggers
pr: none # also disable PR triggers (GitHub/Bitbucket-backed projects)
parameters:
- name: platform
displayName: Platform
type: string
default: android
values:
- ios
- android
- name: buildMode
displayName: Build mode
type: string
default: debug
values:
- debug
- release
pool:
vmImage: ubuntu-latest
steps:
- task: NodeTool@0
inputs:
versionSpec: '24.x'
- script: |
npm ci
npm run build
npx cap sync ${{ parameters.platform }}
npx @capgo/cli@latest build request com.example.app \
--platform ${{ parameters.platform }} \
--build-mode ${{ parameters.buildMode }}
env:
CAPGO_TOKEN: $(CAPGO_TOKEN)
# map other signing secrets from Library → Variable groups

trigger: none e pr: none mantieni la pipeline disattivata per le esecuzioni automatiche CI/PR in modo che parta da Pipelines → Esegui pipeline (o un webhook). Se il progetto usa le policy di ramo di Azure Repos che mettono in coda questa pipeline, disattiva quella policy separatamente. Aggiungi CAPGO_TOKEN e i valori di firma a un gruppo di variabili contrassegnato come segreto.

InputValori suggeritiNote
Piattaformaios, android, bothMatrice when both
Modalitàdebug, releaseDebug + --output-upload per link QA
Distribuzione iOSapp_store, ad_hocAd-hoc non invia mai all'App Store

Per artefatti QA scaricabili, combina debug Android con --no-playstore-upload --output-upload e leggi l'URL con build last-output.

  • Preferisci le regole di protezione dell'ambiente (GitHub) o le variabili protette (GitLab) per release le build che vengono inviate agli store.
  • Non inserire password di firma nei workflow inputs — solo in secrets/variabili.
  • Limita chi può eseguire i workflow tramite i ruoli del repository e i permessi del team (è richiesto l'accesso in scrittura su GitHub). La branch protection da sola non controlla Esegui workflow; aggiungi un controllo di autorizzazione nel workflow se solo un gruppo ristretto può avviare le build.