メインコンテンツへスキップ
Capgo - Capacitor アプリのビルド、リリース、アップデート Capgo

機能

Capgo Live Updatesで利用可能なすべての機能の概要をここにまとめています。各機能には簡単な説明と詳細ドキュメントへのリンクが含まれています。

コアアップデートシステム

「コアアップデートシステム」というセクション

Over-the-Air (OTA) アップデート

「Over-the-Air (OTA) アップデート」というセクション

App Storeの承認を待たずに、JavaScript、HTML、CSS、およびアセットのアップデートをユーザーに直接配信できます。アップデートはバックグラウンドでダウンロードされ、次回のアプリ再起動時に適用されます。

主な機能:

  • バックグラウンドでのダウンロード
  • 自動インストール
  • ユーザー操作を妨げない
  • マルチプラットフォーム対応 (iOS, Android, Electron)

アップデートの挙動について詳しく見る →

Delta Updates (差分アップデート)

「Delta Updates (差分アップデート)」セクション

バージョン間で変更されたファイルのみをダウンロードするため、帯域幅の使用量を最大95%削減し、アップデートの配信を高速化します。

主な機能:

  • ファイルレベルの自動差分抽出
  • チェックサムによる検証
  • Deltaファイルの比較
  • 必要に応じてフルアップデートへインテリジェントにフォールバック

デルタアップデートの詳細を見る →

自動ロールバック

「自動ロールバック」セクション

アップデートの読み込みに失敗したり、クラッシュが発生したりした場合、システムは自動的に最後に正常に動作したバージョンへ戻ります。

主な機能:

  • クラッシュ検知
  • タイムアウト検知
  • 自動復元
  • ユーザーの操作は不要

ロールバックの詳細を見る →

チェックサム検証 & フォールバック

「チェックサム検証とフォールバック」セクション

チェックサムでbundleの整合性を検証し、破損が検出された場合は自動的に最後に動作したバージョンへフォールバックします。

主な機能:

  • ダウンロード時のチェックサム検証
  • 破損の検出
  • 最後に動作したbundleへの自動フォールバック
  • 手動リカバリツールの利用が可能

破壊的なアップデートの検出

「破壊的なアップデートの検出」セクション

古いcodeバージョンのNative Buildを実行しているデバイスに、互換性のないアップデートが適用されるのを防ぎます。

主な機能:

  • Nativeバージョンの互換性チェック
  • プラグインの依存関係バリデーション
  • 互換性のないアップデートの自動ブロック
  • 分かりやすいエラーメッセージ

詳細を見る →

デプロイ制御

「Deployment Control」セクション

チャネルシステム

「Channel System」セクション

柔軟なチャンネル設定により、異なる環境やユーザーセグメントごとにアップデートを整理・管理できます。

主な機能:

  • カスタムチャンネルを無制限に作成可能 (production, staging, beta など)
  • チャンネルごとのbundle割り当て
  • チャンネルごとのターゲティングルール
  • デバイスの自己割り当て
  • デバイスごとのチャンネル上書き

チャンネルの詳細を見る →

デバイスターゲティング

「デバイスターゲティング」セクション

段階的なロールアウトや制御されたデプロイのために、特定のデバイス、バージョン、またはユーザーセグメントをターゲットにできます。

主な機能:

  • バージョンベースのターゲティング
  • デバイス固有の上書き設定
  • プラットフォームフィルタリング (iOS, Android, Electron)
  • カスタムメタデータによるフィルタリング
  • エミュレータ/dev buildの更新をブロック

チャネルポリシー

「Channel Policies」セクション

各チャンネルにおけるアップデート配信のルールや制限を設定します。

主な機能:

  • 自動アップデートを無効化
  • メジャーバージョンの更新をブロック
  • エミュレータでのアップデートを無効化
  • development buildsでのアップデートを無効化
  • プラットフォーム固有のポリシー (iOSのみ、Androidのみ、Electronのみ)

Channel Policiesの詳細を見る →

デベロッパーツール

「Developer Tools」セクション

Bundleプレビュー

「Bundle Preview」セクション

デバイスにデプロイする前に、WebダッシュボードからライブWeb環境でbundleをプレビューできます。

場所: Web Dashboard → App → Bundle → Previewタブ

ライブデバッグ

「Live Debugging」セクション

CLI を介して、特定のデバイスのアップデートイベントをリアルタイムで監視。チェック、download、install、エラーイベントを確認できます。

使い方:

ターミナルウィンドウ
npx @capgo/cli app debug [appId]

表示内容:

  • アップデートの確認
  • ダウンロードの進捗
  • インストール状況
  • エラーメッセージ
  • ポリシーによるブロック

Bundle差分ファイルビューア

「Bundle Delta Files Viewer」セクション

ファイルリスト、チェックサム、メタデータを含む、あらゆるbundleのdeltaファイルを詳細に確認できます。

場所: Web Dashboard → App → Bundle → Delta filesタブ

表示内容:

  • チェックサム付きファイルリスト
  • Bundleメタデータ
  • Nativeバージョンの互換性
  • プラグインの依存関係

Native Pluginの依存関係

「Native Plugin Dependencies」セクション

各bundleに含まれるすべてのnative Capacitorプラグインを表示し、バージョン間での依存関係の変化を追跡できます。

場所: Web Dashboard → App → Bundle → Dependenciesタブ

表示内容:

  • プラグイン名とバージョン
  • 依存関係の追加・削除
  • 互換性に関する警告

CLI 連携

「CLI 連携」セクション

自動デプロイやCI/CD連携に対応した、包括的なコマンドラインインターフェース。

主なコマンド:

  • bundle upload - 新しいbundleをupload
  • bundle list - すべてのbundleをリスト表示
  • bundle delete - bundleを削除
  • bundle cleanup - 古いbundleをクリーンアップ
  • channel set - channelを設定
  • app debug - ライブデバッグ

CLI のリファレンス全文を見る →

Bundle暗号化

「Bundle Encryption」セクション

AES-256によるバンドルのエンドツーエンド暗号化により、転送中および保存中の code を保護します。

主な機能:

  • RSA鍵ペアの生成
  • AES-256によるバンドル暗号化
  • Code の署名検証
  • 暗号化キーの管理

暗号化の詳細を見る →

Bundleのクリーンアップと保持期間

「Bundle Cleanup & Retention」セクション

保存ポリシーに基づいて古いバンドルを自動的にクリーンアップし、ストレージ使用量を管理します。

主な機能:

  • 保持件数の設定が可能
  • CLIによる自動クリーンアップ
  • 定期的なクリーンアップジョブ
  • ストレージ使用量の追跡

用途:

ターミナルウィンドウ
npx @capgo/cli bundle cleanup --keep=10

分析 & モニタリング

「分析 & モニタリング」セクション

アップデート統計

「アップデート統計」セクション

ユーザーベース全体におけるアップデートの採用率、成功率、デプロイ状況を追跡します。

利用可能なメトリクス:

  • ダウンロード成功率
  • インストール成功率
  • エラータイプ別の発生率
  • 時間の経過によるアップデート採用率
  • バージョン分布

場所: Web Dashboard → App → Statistics

デバイスログ

「Device Logs」セクション

チェックからインストールまでの完全なアップデートライフサイクルを示す、デバイスごとのイベントログ。

イベントタイプ:

  • アップデートの確認
  • ダウンロード開始/完了/失敗
  • インストール開始/完了/失敗
  • ロールバックイベント
  • ポリシーによるブロック

確認場所:

  • Web Dashboard → App → Device → Logs
  • Web Dashboard → App → Logs (全デバイス)

ログの詳細を見る →

Bundle使用状況の分析

「Bundle使用状況の分析」セクション

どのbundleがアクティブか、ダウンロード数、ストレージ使用量などの詳細な分析。

メトリクス:

  • bundleごとのアクティブなインストール数
  • ダウンロード数
  • bundleごとのストレージ使用量
  • 帯域幅の使用量

チャネル統計

「Channel Statistics」というタイトルのセクション

channelごとのパフォーマンスと採用メトリクスを追跡します。

メトリクス:

  • channelごとのデバイス数
  • channelごとのUpdate成功率
  • デプロイ履歴
  • チャネル別のエラー率

確認場所: Web Dashboard → App → Channel → Statistics

デプロイ履歴

「デプロイ履歴」というタイトルのセクション

すべてのbundleデプロイ、チャネル割り当て、および設定変更の完全な監査トレイル。

追跡されるイベント:

  • Bundleのアップロード
  • チャネルの割り当て
  • ポリシーの変更
  • デバイスのオーバーライド

確認場所: Web Dashboard → App → Channel → History

セキュリティとコンプライアンス

「セキュリティとコンプライアンス」セクション

エンドツーエンド暗号化

「エンドツーエンド暗号化」セクション

業界標準のAES-256暗号化により、保存時および転送時のbundleを保護します。

暗号化の詳細を見る →

Code の署名

「Code Signing」セクション

暗号署名によってbundleの整合性を検証し、改ざんを防止します。

SOC 2 Type II コンプライアンス

「SOC 2 Type II コンプライアンス」セクション

エンタープライズレベルのセキュリティを実現するため、SOC 2 Type II 規格に準拠したインフラとプロセスを採用しています。

App Store コンプライアンス

「App Store コンプライアンス」セクション

OTA アップデートに関する Apple App Store および Google Play Store のポリシーに完全準拠しています。

コンプライアンスの詳細を見る →

2FA 強制 (組織レベル)

「2FA 強制 (組織レベル)」セクション

ダッシュボードおよび API へのアクセスに、組織内の全メンバーに対して二要素認証を必須化できます。

確認場所: Web ダッシュボード → Organization → Security

2FA の詳細を見る →

暗号化されたBundleの強制適用

「暗号化されたBundleの強制適用」というセクション

組織レベルですべてのbundleを暗号化必須に設定できます。

確認場所: Web Dashboard → Organization → Security

チームコラボレーション

「チームコラボレーション」というセクション

ロールベースのアクセス制御 (RBAC)

「ロールベースのアクセス制御 (RBAC)」というセクション

組織およびアプリレベルでの詳細なアクセス権限管理。

組織のロール:

  • org_super_admin - 組織のフルコントロール
  • org_admin - Organization管理（請求・削除不可）
  • org_billing_admin - 請求管理専用アクセス
  • org_member - Organizationの読み取り専用アクセス

アプリのロール:

  • app_admin - 1つのアプリに対するフルコントロール
  • app_developer - bundleのアップロード、デバイス管理
  • app_uploader - bundleのアップロードのみ
  • app_reader - 読み取り専用アクセス

確認場所:

  • Web Dashboard → Organization → Members
  • Web Dashboard → App → アクセス

RBACの詳細を見る →

監査ログ

「監査ログ」というタイトルのセクション

コンプライアンスとセキュリティのため、組織およびアプリの全アクティビティを完全に記録します。

記録されるイベント:

  • ユーザー操作（ログイン、ログアウト、権限変更）
  • Bundle操作（upload、delete、assign）
  • Channel操作（create、update、delete）
  • 組織の設定変更（設定、メンバー）

確認場所: Web Dashboard → Organization → Audit Logs

Webhooks

「Webhooks」というタイトルのセクション

HTTP webhook経由で、アプリ内のイベントに関するリアルタイム通知を受け取れます。

サポートされているイベント:

  • apps - アプリの作成/更新/削除
  • app_versions - Bundleのアップロード/削除
  • channels - Channelの作成/更新/削除
  • org_users - メンバーの追加/削除
  • orgs - Organizationの更新

機能:

  • カスタムwebhook URL
  • イベントフィルタリング
  • 配信ログ
  • リトライメカニズム
  • 機能テスト

確認場所: Web Dashboard → Organization → Webhooks

マルチユーザーによる共同作業

「マルチユーザーによる共同作業」セクション

特定のロールと権限を割り当てて、チームメンバーを組織に招待できます。

機能:

  • メールによる招待
  • ロールの割り当て
  • メンバー管理
  • アクセス権の取り消し

確認場所: Web Dashboard → Organization → Members

API キー管理

「API キー管理」セクション

API キーの作成、管理、失効が可能です。有効期限の設定やハッシュ化による保存にも対応しています。

主な機能:

  • アプリ単位または組織単位のキー
  • 有効期限の設定（任意）
  • ハッシュ化による保存（不可逆）
  • キーローテーションに対応

確認場所: Web Dashboard → API Keys

API キーの詳細を見る →

パスワードポリシー

「パスワードポリシー」というタイトルのセクション

セキュリティ基準を強制するための、組織レベルのパスワード要件。

設定可能なポリシー:

  • 最小文字数
  • 大文字を必須にする
  • 数字を必須にする
  • 特殊文字を必須にする

確認場所: Web Dashboard → Organization → Security

プラットフォーム対応

「プラットフォームサポート」というタイトルのセクション

マルチプラットフォーム対応

「マルチプラットフォーム対応」セクション

単一の SDK で、iOS、Android、Electronアプリに対応。

対応プラットフォーム:

  • iOS (Capacitor 5, 6, 7, 8)
  • Android (Capacitor 5, 6, 7, 8)
  • Electron (2025年新対応)

長期サポート（LTS）

「長期サポート」セクション

レガシーアプリとの互換性を維持するため、古い Capacitor バージョンも継続的にサポートします。

現在のサポート対象:

  • Capacitor 8 (最新)
  • Capacitor 7
  • Capacitor 6
  • Capacitor 5

カスタムストレージバックエンド

カスタムストレージバックエンド

Capgo のデフォルトストレージではなく、独自のストレージインフラ（S3、R2など）を使用できます。

カスタムストレージの詳細を見る →

中国向け設定

中国向け設定

中国本土で配信されるアプリが現地の規制を遵守するための専用設定です。

中国向け設定の詳細を見る →

高度な機能

「高度な機能」セクション

カスタムアップデート動作

「カスタムアップデート動作」セクション

SDK を使用して、アップデートのチェックおよび適用を行うタイミングと方法を設定します。

設定可能なオプション:

  • チェック間隔 (periodCheckDelay - 最低 600 秒)
  • 自動アップデートポリシー (autoUpdate - off, atBackground, atInstall, onLaunch, always, onlyDownload)
  • ネットワーク要件 (Android のみ - WorkManager 経由)

アップデート動作の詳細を見る →

アップデートの種類

「アップデートの種類」セクション

即時アップデートからユーザーによるインストール制御まで、用途に合わせた様々なアップデートタイプを提供します。

利用可能なタイプ:

  • バックグラウンドアップデート (デフォルト)
  • 即時アップデート
  • ユーザーへのプロンプトによるアップデート
  • 条件付きアップデート

アップデートの詳細を見る →

クレジットシステム

「クレジットシステム」セクション

帯域幅、ストレージ、その他のリソースに対してクレジットを使用した従量課金制を採用しています。

機能:

  • クレジット使用量の追跡
  • 使用量アラート
  • Stripeによるチャージ
  • クレジット履歴

確認場所: Web Dashboard → Organization → Credits

はじめに

「Getting Started」セクション

これらの機能を使う準備はできましたか？まずは クイックスタートガイド に従って、Capgo Live Updates で最初のアプリをセットアップしましょう。

ヘルプが必要ですか？

「お困りですか？」セクション

機能の続きを読む

「機能一覧」からの続き

以下を使用している場合： 機能 モニタリングや分析を計画するには、以下と連携してください： 統計 Statistics の実装詳細についてはこちら： ログ Logs の実装詳細についてはこちら： @capgo/capacitor-appinsights @capgo/capacitor-appinsights の実装詳細についてはこちら： @capgo/capacitor-appinsights を使用する場合 Using @capgo/capacitor-appinsights のネイティブ機能についてはこちら、および @capgo/capacitor-firebase-analytics @capgo/capacitor-firebase-analytics. の実装詳細についてはこちら