CI UIからネイティブビルドをトリガーする

このプラグインのインストール手順とフルマークダウンガイドを含むセットアッププロンプトをコピーします。

時々、PRをマージせずにリリースタグを切ることなく、iOSまたはAndroidバイナリを署名したい場合があります。これは、QAビルド、ストアの再提出、または一時的なTestFlightです。すべての主なcodeホストは、Web UIからパイプラインを開始できます。このガイドでは、そのUIをCapgoビルドと接続する方法を示します。

何が得られるか

Gitの式は必要ありません

Click Run workflow / Run pipeline. Capgo Build compiles from the branch you pick.

安全な入力

プラットフォームとビルドモードは、ホストがサポートする場合に制約された選択肢を使用します (GitHub / Bitbucket / Azure). GitLab変数は、定義しない限り、各実行で編集可能です。パイプライン入力と options.

CIと同じシークレットを使用

リポジトリにすでに存在する Capgo ビルドのクレデンシャルを再利用します。ノートパソコンでは新しいものはありません。

前提条件

ローカルまたはCIで Capgo ビルドを実行することができます。詳細は「Getting Started」を参照してください。ホストですでに存在するシークレットを署名します ( __CAPGO_KEEP_0__
Signing secrets already in the host (for GitHub, エクスポートするには CLI と gh secret set -f)
CAPGO_TOKEN 保存されたマスクされたシークレット / CI 変数として保存されます

GitHub アクション

GitHub の アクション タブから、__CAPGO_KEEP_0__ が宣言する任意のワークフローを開始できます workflow_dispatch.

1. ワークフローを追加する

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

2. UI から実行する

GitHub リポジトリを開く
ここに移動する アクション
選択する Capgo ビルド (手動)
クリックする ワークフローを実行する
ブランチ、プラットフォーム、モードを選択する
確認する ワークフローを実行する

誰でも書くアクセスがビルドを開始できる。サンプルマップは release GitHub環境名 production — その環境を作成し、必要なレビュアーを追加してビルドを待機状態にする。承認がなければ environment: ジョブにアクセスしていない場合、環境保護ルールは適用されない。

GitLab CI

GitLabは、 ビルド→ Pipelines→ Run pipeline そのブランチでジョブが利用可能になるまでにジョブを実行します。

# 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

GitLabプロジェクトを開く
Go to ビルド→ Pipelines→ Run pipeline
ブランチを選択
この実行用に変数を設定する PLATFORM / BUILD_MODE パイプラインを開始し、再生ボタンをクリックしてください
コピー capgo_native_manual

when: manual プッシュごとにジョブを実行しないようにする; Web UI (または) pipeline trigger token) は、オンデマンドで開始する。

Bitbucket Pipelines

Bitbucket UI が変数を渡すことができるカスタムパイプラインを使用します:

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"

Run it from パイプライン → パイプライン実行 → カスタム: capgo-native-buildに保存 CAPGO_TOKEN CI/CDトリガー リポジトリ設定 → Pipelines → リポジトリ変数.

Azure DevOps

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 CI/CDトリガー pr: none パイプライン → パイプライン実行 (またはWebhook). プロジェクトがAzure Reposブランチポリシーを使用している場合、このパイプラインをキューするポリシーを個別に無効にします。 推奨入力 CAPGO_TOKEN 秘密の変数グループに署名情報と署名値を追加します。

azure-pipelines-__CAPGO_KEEP_0__-manual.yml

入力	推奨値	注記
プラットフォーム	`ios`, `android`, `both`	マトリックスの場合 `both`
モード	`debug`, `release`	デバッグ + `--output-upload` QA リンクのために
iOS の配布	`app_store`, `ad_hoc`	App Store にアプリを提出しないアドホック

ダウンロード可能な QA アーティファクトの場合、デバッグ Android を組み合わせてください --no-playstore-upload --output-upload URLを読み取ります。 build last-output.

セキュリティに関する注意事項

環境保護ルール(GitHub)またはGitLabの保護変数を使用して release アプリストアにアップロードするビルドの場合
ワークフローの署名パスワードを入力しないでください。 inputs ワークフローを実行する権限を制限するには、リポジトリのロールとチームの権限を使用してください。
ビルドを実行する権限が必要です(GitHub)。 ワークフローを実行するワークフロー内で、より狭いグループのみがビルドを開始できるようにするには、追加の認可チェックを実行してください。

GitHub アクション (フルセット) 資格情報のエクスポートとプッシュ/タグワークフロー。

Auto OTA またはネイティブ Capgo ビルドの自動更新とCIによる選択

Webhook経由でトリガー HTTP経由で同じpipelineを呼び出す管理画面