メインコンテンツへスキップ
CI/CD

GitHub Actionsを使ってLovableからCapgo Live Updatesを自動化する

Lovable から本番ユーザーへワンクリック Publish:GitHub に同期し、Capgo の API キーを secret として保存。あとは GitHub Actions がプッシュのたびに build と upload します。

LovableからGitHub Actionsを使ってCapgo Live Updatesを自動化する Capgo ブログ記事のイラスト

クライアントは、Lovableのボタン1つで全アクティブユーザーに変更を配信したいと考えています。更新フローが手動で動くことはすでに確認済みです:

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

足りないのは、Lovable内で実行する別のターミナルコマンドではありません。 LovableはPublish時にCapgoを実行できません。 GitHubの同期が有効な場合、 Publishはリポジトリにコミットをプッシュします. GitHub Actionsがビルドを実行し、 bundle upload あなたの代わりに行います。

このガイドでは、クライアントが一度だけ行う必要がある唯一の手動設定、つまり CAPGO_TOKEN GitHub secretとして追加する方法を説明します。ワークフローファイルについては、すぐに使えるAIへの指示をLovableにコピー&ペーストしてください(ステップ3)。

パイプラインの仕組み

ステップ 誰が 何が起きるか
1 クライアント Lovableでアプリを編集し、 公開
2 Lovable GitHub へのコミットとプッシュ(通常 main)
3 GitHub アクション npm ci, npm run build, bundle upload --auto-bump Capgo へ
4 Capgo チャネル上のアクティブデバイス production が更新を受信します

SSHもローカルのCLIも不要。シークレット設定後は追加のクリックも不要です。

前提条件

  • GitHub に接続された Lovable プロジェクト (エクスポートガイド)
  • Capacitor + @capgo/capacitor-updater リポジトリ内(Lovableアプリのモバイル化ガイド)
  • Capgo に登録済みのアプリで、 capacitor.config.ts 正しい appId
  • production channel を指しており、ユーザーが実行するビルドと紐付いている必要があります。

理由 --auto-bump

すべての Capgo アップロードには、 新しい一意の bundle バージョンが必要です。Lovable Publish はバージョンを自動で package.json 上げてくれないため、同じバージョンを再利用すると 2 回目のデプロイで CI が失敗します。

--auto-bump は、channel(または app)の最新バージョンを読み取ってインクリメントします。デフォルトのレベルは minorです。以下のように指定できます。 --auto-bump patch または --auto-bump major もしよろしければ。

ステップ 1 — Capgo API キーを作成する

  1. 開く console.capgo.app/apikeys/
  2. アプリの bundle を upload する権限がある API キーを作成します
  3. キーは一度だけコピーしてください。完全な値は二度と表示されません。

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

ステップ 2 — 追加 CAPGO_TOKEN GitHub 内(唯一の env ステップ)

これは Kuldeep と、リポジトリを所有するクライアントに送るステップです。

  1. Lovable が同期する GitHub リポジトリを開きます
  2. 以下に移動します: 設定 → Secrets と変数 → アクション
  3. クリック 新しいリポジトリ Secret
  4. 名前: CAPGO_TOKEN
  5. 値: ステップ1の Capgo API キーを貼り付けてください
  6. 保存

GitHub はシークレットをワークフローに以下のように注入します ${{ secrets.CAPGO_TOKEN }}。以下のワークフローはこれを CAPGO_TOKEN 環境変数として Capgo CLI に読み取ります。

リポジトリがクライアントの組織内にある場合、クライアントが 自身の リポジトリにシークレットを追加する必要があります。Lovable の設定ではなく、GitHub のキーだけが必要です。

ステップ 3 — このプロンプトを Lovable に貼り付ける

以下のブロックを Lovable のチャットにコピーしてください。デフォルトブランチが main異なる場合は、 main ワークフロー内の箇所をブランチ名に置き換えてください。

Add Capgo Live Updates CI with GitHub Actions.

Create `.github/workflows/capgo-live-updates.yml` (create folders if needed). Start from this YAML, then adapt install/build to this project while keeping Capgo upload + CAPGO_TOKEN secret behavior:

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 --auto-bump
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Rules:
- Do not hardcode any Capgo API key in the repo or in chat.
- The workflow must read CAPGO_TOKEN only from GitHub Actions secrets (`${{ secrets.CAPGO_TOKEN }}`).
- Keep `--auto-bump` on the upload command so each Publish gets a new unique bundle version.
- Prefer the project's real production build script from package.json (for example `npm run build` or `vite build`).
- If package-lock.json is missing, use `npm install` instead of `npm ci`.
- Do not modify app UI or Capacitor config for this task.
- Commit the workflow file so the next Publish pushes it to GitHub.

Lovable が変更を適用したら、クリックして 公開 ワークフローが GitHub に反映されるようにします。

手動で行う場合

Lovable のチャットを使いたくない場合は、作成してください .github/workflows/capgo-live-updates.yml このYAMLのみを使用してください(プロンプトの文章ではありません)。プロジェクト構成が異なる場合は、上記のルールに従ってinstall/buildの手順を調整し、commitしてpushしてください。

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 --auto-bump
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}

Vite base path: LovableのViteアプリでは、多くの場合以下が必要です: base: './' における vite.config.ts ネイティブシェル内でアセットを読み込むためです。OTAアップデート後に画面が白くなる場合は、Lovableに以下を設定するよう依頼してください: base: './'、再度publishを行い、ワークフローによる再デプロイを待ってください。

暗号化されたbundle: 以下を使用する場合は、 Capgo 暗号化を CAPGO_PRIVATE_KEY 2つ目の GitHub secretとして追加して渡し、 --key-data-v2 "${{ secrets.CAPGO_PRIVATE_KEY }}" アップロードステップで。

ステップ4 — Publishトリガーによるデプロイの確認

  1. Lovableで、目に見える小さな変更(例: ボタンのラベルテキスト)を行います
  2. クリック 公開
  3. GitHubで、 アクション を開いて Capgo Live Update
  4. ジョブがグリーンになったら、 Capgoコンソール で新しいbundleを確認します production チャンネル
  5. アプリをインストール済みのデバイスで、変更が反映されたことを確認してください(チャンネル設定により1分ほどかかる場合があります)

✅ 成功: LovableでPublish → 緑の GitHub Action → Capgoに新しいbundle → ユーザーにアップデートが届く。

トラブルシューティング

症状 考えられる原因 解決策
ワークフローが実行されない プッシュ先が指定のブランチ以外になっている main 変更内容 branches ワークフロー内、またはpublish先の main
CAPGO_TOKEN / 認証エラー Secretが未設定か、名前が間違っています Secretは完全一致で CAPGO_TOKEN Actions secrets の下に
バージョンは既に存在します アップロードで同じbundleバージョンが再利用されました 保持 --auto-bump アップロードステップで (または渡す) --auto-bump patch)
Buildが失敗する npm ci Lockfileが同期していません 実行 npm install ローカルでcommit package-lock.json, 再公開する
アップロード成功、白画面 誤り webDir または Vite base 合わせる capacitor.config.ts webDir をビルド出力に (dist Vite の場合) に設定します base: './'
ユーザーにアップデートが表示されません Channel がビルドに紐付けられていません Capgo で、デバイスのビルドを Channel にリンクします production または Channel を public に設定します

その他のワークフローパターン (feature branch、PR Channel、暗号化) の詳細はこちら GitHub Actionsとの連携.

クライアントに伝える内容

このチェックリストを送ってください:

  1. お客様 LovableをGitHubに接続し、モバイルアプリにCapgoを設定済みであること。
  2. クライアントは GitHubのsecretを1つ追加します: CAPGO_TOKEN CapgoのAPIキーを使って(apikeysページ)).
  3. クライアントは クリックして 公開 Lovable で、ユーザーに変更を届けたいタイミングで。
  4. ローカルで実行するのは npx @capgo/cli 必要があるときだけです。

これは、彼らが求めていたワンクリック体験に合致しています。Lovable での Publish がボタンであり、GitHub Actions と Capgo が残りを処理します。

次へ進む

Capacitor アプリ向けの Live Updates

Web レイヤーのバグが本番で発生したら、App Store の審査を何日も待たずに Capgo で修正を配信しましょう。ネイティブの変更は通常の審査フローに残したまま、ユーザーはバックグラウンドでアップデートを受け取れます。

最新のブログ記事

Capgoは、真にプロフェッショナルなモバイルアプリを作るために必要な最高のインサイトを提供します。