跳过内容
Capgo - 实时更新 Capacitor 应用 Capgo

从 CI UI 触发本地构建

有时您需要在合并PR或切换release标签之前签署iOS或Android二进制文件——QA构建、商店重新提交或一次性TestFlight。每个主要code主机都可以从其web UI启动管道。这份指南展示了如何将UI连接到Capgo构建。

您将获得

标题：您将获得

无Git仪式

点击运行工作流 / 运行管道。 Capgo 从您选择的分支中编译。

安全输入

平台和构建模式使用受限的选择，其中主机支持它们 (GitHub / Bitbucket / Azure)。 GitLab 变量除非您定义了 管道输入 with options.

同 CI 的机密

重用您的仓库中已经有的 Capgo Build 凭据。无需在笔记本电脑上添加新内容。

前提条件

标题为“前提条件”的部分

GitHub 动作

标题：GitHub 动作

GitHub 的 动作 标签可以启动任何声明的工作流 workflow_dispatch.

1. 添加工作流

标题：1. 添加工作流
github/workflows/capgo-手动构建.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

2. 从 UI 运行

Section titled “2. 从 UI 运行它”
  1. 在浏览器中打开 GitHub 仓库
  2. 前往 操作
  3. 选择 Capgo 构建 (手动)
  4. 点击 运行工作流
  5. 选择分支、平台和模式
  6. 确认 运行工作流

任何有权访问 write 可以开始构建。样本映射 release 运行到一个GitHub环境 production —创建该环境并添加所需的审阅者，以便存储构建等待批准。没有 environment: 在工作中，环境保护规则永远不会应用。

GitLab CI

GitLab CI

GitLab可以从 构建 → Pipelines → 运行管道 当该分支的工作就绪时

# 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. 打开GitLab项目
  2. 前往 构建 → Pipelines → 运行管道
  3. 选择分支
  4. 可选设置 PLATFORM / BUILD_MODE 此次运行的变量
  5. 然后点击播放按钮 capgo_native_manual

when: manual __CAPGO_KEEP_0__ __CAPGO_KEEP_0__pipeline触发令牌

)根据需要启动它。

Bitbucket Pipelines

标题：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"

复制到剪贴板 从"管道"菜单中选择"运行管道"，然后选择"自定义：capgo-native-build"存储 CAPGO_TOKEN 并且签名材料 仓库设置 → Pipelines → 仓库变量.

Azure DevOps

Azure DevOps
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 并且 pr: none context: Capgo营销网站. 角色: 短的UI标签或导航项. 见于: 页面trust.astro. 消息键`and` (And). 保持管道不自动触发CI/PR运行，因此从 管道 → 运行管道 CAPGO_TOKEN (或一个webhook). 如果项目使用Azure Repos分支策略排队这个管道，请单独禁用该策略。 添加

推荐输入项
输入项建议值注意
平台ios, android, both矩阵时 both
模式debug, release调试 + --output-upload 用于 QA 链接
iOS 分发app_store, ad_hocAd-hoc never submits to App Store

对于可下载的 QA_artifacts，结合调试 Android --no-playstore-upload --output-upload 并且阅读URL build last-output.

安全注意事项

标题为“安全注意事项”的部分
  • 优先使用环境保护规则（GitHub）或受保护的变量（GitLab）进行 release 将提交到商店的构建
  • 不要将签名密码放在工作流中 inputs — 只在密钥/变量中。
  • 限制谁可以运行工作流，使用仓库角色和团队权限（必须具有GitHub的写入访问权限）。仅靠 branch 保护无法控制 运行工作流; 如果只有一个更窄的组可以启动构建，请在工作流中添加授权检查。
标题为“相关指南”的部分
GitHub Actions (full setup) 导出凭据并推送/标记工作流。
自动OTA或本机 让CI选择实时更新或Capgo 在每次推送时进行构建。
通过Webhook触发 通过HTTP调用同一pipeline从管理台