Capgoのリアルタイム更新をGitHubアクションで自動化する

クライアントは、Lovableに変更をすべてのアクティブユーザーに送信するための単一のボタンを求めています。

npx @capgo/cli@latest bundle upload --channel=production

既に、更新パスが手動で機能していることを証明しました。 Lovable cannot run Capgo on Publish. LovableではGitHubをPublish時に実行できません。 リポジトリにコミットをプッシュします。 GitHub Actions はビルドを実行し、 bundle upload あなたのために。

このガイドでは、クライアントが一度だけ行う必要がある唯一の手動設定について説明します: CAPGO_TOKEN as a GitHub secret. Everything else can be added with a Lovable prompt or a small workflow file.

__CAPGO_KEEP_0__ シークレットとして追加します。 すべての他の設定は、Lovable のプロンプトまたは小さなワークフロー ファイルで追加できます。

No SSH, no local CLI, no extra click after the secret is configured.

Prerequisites

• Lovable project connected to GitHub (export guide)
• Capacitor + @capgo/capacitor-updater リポジトリ内 (モバイル向けガイド)
• アプリが Capgo に登録されています。 capacitor.config.ts 正しい __CAPGO_KEEP_0__ を指しています。 appId
• production チャンネルが存在し、ビルドにリンクされています。ユーザーが実行するビルド

Step 1 — Capgo と API のキーを作成します。

1. Open console.capgo.app/apikeys/
2. アプリのバンドルアップロードに必要な API キーを作成します。
3. このキーを1度コピーしてください。再度表示することはできません。

このキーはパスワードと同じように扱ってください。Gitにコミットしたり、Lovableチャットに貼ったりしないでください。

Step 2 — 追加 CAPGO_TOKEN In GitHub (環境設定の 1 つのステップ)

このステップは、Kuldeep さんやリポジトリの所有者に送信します。

1. GitHub リポジトリを開きます。Lovable が同期するものです。
2. Go to 設定 → シークレットと変数 → アクション
3. Click 新しいリポジトリシークレット
4. Name: CAPGO_TOKEN
5. 値: Capgo API キーをステップ 1 からペーストしてください。
6. Save

GitHubはワークフローにシークレットをインジェクトする ${{ secrets.CAPGO_TOKEN }}ワークフローは__CAPGO_KEEP_0__の__CAPGO_KEEP_1__を環境変数として読み取る CAPGO_TOKEN environment variable for the Capgo CLI.

リポジトリの__CAPGO_KEEP_0__にキーが必要ですが、Lovableの設定に必要ありません ステップ3 — __CAPGO_KEEP_0__アクションズワークフローを追加する repo. You only need the key in GitHub, not in Lovable settings.

Step 3 — Add the GitHub Actions workflow

LovableはYAMLを追加し、次回のPublish時にリポジトリにプッシュする

オプションB — ファイルを自分で追加する main):

Create `.github/workflows/capgo-live-updates.yml` that runs on every push to `main`:

1. Checkout code
2. Setup Node.js 24 with npm cache
3. Run `npm ci` and `npm run build`
4. Run `npx @capgo/cli@latest bundle upload --channel=production`
5. Use environment variable `CAPGO_TOKEN` from GitHub Actions secrets (do not hardcode the API key)

Use `actions/checkout@v6` and `actions/setup-node@v6`. Commit the workflow file to the repo.

ファイルを作成する

__CAPGO_KEEP_0__

__CAPGO_KEEP_1__ .github/workflows/capgo-live-updates.yml:

name: Capgo Live Updates

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v6

      - name: Setup Node.js
        uses: actions/setup-node@v6
        with:
          node-version: '24'
          cache: 'npm'

      - name: Install and build
        run: |
          npm ci
          npm run build

      - name: Upload bundle to Capgo
        run: npx @capgo/cli@latest bundle upload --channel=production
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

コミットしてプッシュ。最初の実行は、GitHub がプッシュを受け取ったときにすぐに始まります。

Vite base path: 愛されるViteアプリはよく base: './' で vite.config.ts なので、ネイティブシェル内でアセットがロードされることがあります。ユーザーがOTAアップデート後に白い画面を表示した場合、再度 baseを公開し、ワークフローを再デプロイしてください。

暗号化されたバンドル: あなたが Capgo暗号化を使用している場合、 CAPGO_PRIVATE_KEY を追加して、2番目のGitHubシークレットとして渡してください --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" アップロードステップで

Step 4 — Publishを確認するとデプロイが発生します

1. Lovableで、ボタンのラベルテキストなどの小さな変更を行ってください (例えばボタンのラベルテキストの変更)
2. Click Publish
3. CapgoでGitHubを開きます Actions そして__CAPGO_KEEP_0__のライブアップデートを確認してください ジョブが緑色になると、Capgoコンソールを開いて新しいバンドルが表示されていることを確認してください
4. __CAPGO_KEEP_0__コンソールを開いて新しいバンドルが表示されていることを確認してください Capgoコンソールを開いて新しいバンドルが表示されていることを確認してください __CAPGO_KEEP_0__コンソールを開いて新しいバンドルが表示されていることを確認してください production __CAPGO_KEEP_0__
5. アプリがインストールされたデバイスで、変更が到着することを確認します (チャンネル設定に応じて 1 分かかる場合があります)。

✅ 成功: Publish in Lovable → 緑の GitHub Action → 新しい Capgo → ユーザーがアップデートを受け取ります。

トラブルシューティング

クライアントに送るチェックリスト: GitHub Actions integration.

What you tell your client

Send them this checklist:

1. You すでにGitHubと接続されており、モバイルアプリでCapgoを設定済みです。
2. 彼ら 1つのGitHubシークレットを追加します： CAPGO_TOKEN Capgo APIキー（apikeysページ).
3. 彼ら クリック LovableでPublishをクリックすると、ユーザーが変更を受け取るようにすることができます。 彼らは
4. ローカルで実行することはありません。 npx @capgo/cli 必要に応じて実行する場合を除いて。

PublishボタンはLovableで1クリックで実行できます。GitHub ActionsとCapgoは残りの作業を処理します。

__CAPGO_KEEP_0__

• iOSとAndroidに変換 — アプリをWrapしていない場合は、Capacitor + Capgoの設定を完了してください
• GitHub Actionsを使用した自動ビルドとリリース — タグベースのリリースとバージョンアップ
• GitHub Actionsの統合 — 多チャンネルとPRプレビュー チャンネル
• Capgo Live Updates — チャンネル、ロールバック、採用統計