Nessuna cerimonia Git
Clicca su Run workflow / Run pipeline. Capgo Build compila dalla branch che selezioni.
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
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.
gh secret set -f)CAPGO_TOKEN archiviato come secret mascherato / variabile CIdi GitHub Azioni la tab può avviare qualsiasi workflow che dichiari workflow_dispatch.
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 }} \ $EXTRAChiunque 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.ymlstages: - 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: neverPLATFORM / BUILD_MODE le variabili per questa esecuzionewhen: 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:
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.
trigger: none # disable CI push triggerspr: 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 groupstrigger: 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.
| Input | Valori suggeriti | Note |
|---|---|---|
| Piattaforma | ios, android, both | Matrice when both |
| Modalità | debug, release | Debug + --output-upload per link QA |
| Distribuzione iOS | app_store, ad_hoc | Ad-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.
release le build che vengono inviate agli store.inputs — solo in secrets/variabili.