機能

このページでは、Capgo Live Updates で利用できるすべての機能をまとめて紹介します。各機能には簡単な説明と、詳細ドキュメントへのリンクがあります。

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

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

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

主な機能:

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

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

---

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

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

主な機能:

• ファイル単位の自動差分検出
• チェックサムによる検証
• デルタファイルの比較
• 必要に応じたフルアップデートへの自動フォールバック

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

---

自動ロールバック

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

主な機能:

• クラッシュ検知
• タイムアウト検知
• 自動ロールバック
• ユーザーの介入不要

ロールバックの詳細 →

---

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

チェックサムでバンドルの完全性を検証し、破損を検出したら自動的に最後に正常に動作したバージョンにフォールバックします。

主な機能:

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

---

破壊的アップデート検出

古いネイティブ code バージョンで動作するデバイスに、互換性のないアップデートが適用されるのを防ぎます。

主な機能:

• ネイティブバージョンの互換性チェック
• プラグイン依存関係の検証
• 互換性のないアップデートの自動ブロック
• わかりやすいエラーメッセージ

バージョンターゲティングの詳細 →

---

デプロイ制御

チャネルシステム

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

主な機能:

• 無制限のカスタムチャネル（production、staging、beta など）
• チャネルごとの bundle 割り当て
• チャネル固有のターゲティングルール
• デバイスの自己割り当て
• デバイスごとのチャネル上書き

チャネルの詳細 →

---

デバイスターゲティング

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

主な機能:

• バージョンベースのターゲティング
• デバイスごとのオーバーライド
• プラットフォームによるフィルタリング (iOS, Android, Electron)
• カスタムメタデータによるフィルタリング
• エミュレータ/devビルドのブロック

---

チャネルポリシー

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

主な機能:

• 自動アップデートを無効化
• メジャーバージョンのアップデートをブロック
• エミュレータでのアップデートを無効化
• 開発用ビルドでのアップデートを無効化
• プラットフォーム固有のポリシー（iOSのみ、Androidのみ、Electronのみ）

チャネルポリシーの詳細を見る →

---

開発者ツール

Bundleプレビュー

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

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

---

ライブデバッグ

CLI経由で特定デバイスの更新イベントをリアルタイム監視し、チェック、ダウンロード、インストール、エラーの各イベントを表示します。

使い方:

npx @capgo/cli app debug [appId]

表示内容:

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

---

Bundle Delta Files ビューア

ファイル一覧、チェックサム、メタデータなど、任意のBundleのDeltaファイルを確認できます。

場所: Web ダッシュボード → アプリ → Bundle → Delta ファイル タブ

表示内容:

• チェックサム付きファイル一覧
• Bundle メタデータ
• ネイティブバージョンの互換性
• プラグインの依存関係

---

ネイティブプラグインの依存関係

各 Bundle に含まれるすべてのネイティブ Capacitor プラグインを表示し、バージョン間の依存関係の変更を追跡します。

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

表示内容:

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

---

CLI 連携

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

主なコマンド:

• bundle upload - 新しい bundle をアップロード
• bundle list - すべての bundle を一覧表示
• bundle delete - bundle を削除
• bundle cleanup - 古いバンドルをクリーンアップ
• channel set - チャネルを設定
• app debug - ライブデバッグ

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

---

Bundleの暗号化

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

主な機能:

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

暗号化の詳細 →

---

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

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

主な機能:

• 設定可能な保持数
• CLI による自動クリーンアップ
• スケジュールされたクリーンアップジョブ
• ストレージ使用量の追跡

使い方:

npx @capgo/cli bundle cleanup --keep=10

---

Analytics & モニタリング

アップデート統計

ユーザーベース全体でのアップデート採用率、成功率、デプロイ進捗をトラッキングします。

利用可能なメトリクス:

• ダウンロード成功率
• インストール成功率
• タイプ別エラー率
• アップデート採用率の推移
• バージョン分布

場所: Web ダッシュボード → アプリ → 統計

---

デバイスログ

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

イベントタイプ:

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

場所:

• Webダッシュボード → アプリ → デバイス → ログ
• Web Dashboard → App → Logs (全デバイス)

ログの詳細を見る →

---

Bundle使用状況の分析

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

メトリクス:

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

---

Channel統計

チャンネルごとのパフォーマンスと導入指標を追跡します。

メトリクス:

• チャンネルごとのデバイス数
• チャンネルごとのアップデート成功率
• デプロイ履歴
• チャンネルごとのエラー率

場所: Web Dashboard → アプリ → チャンネル → 統計

---

デプロイ履歴

すべてのbundleデプロイ、チャンネル割り当て、設定変更を網羅する完全な監査証跡。

追跡対象のイベント:

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

場所: Web ダッシュボード → アプリ → チャンネル → 履歴

---

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

エンドツーエンド暗号化

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

暗号化の詳細 →

---

Code 署名

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

---

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

エンタープライズセキュリティのために、インフラとプロセスはSOC 2 Type II基準で認証されています。

---

App Store コンプライアンス

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

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

---

2FA強制（組織レベル）

ダッシュボードと API へのアクセスには、組織の全メンバーに2要素認証を必須にします。

場所: Web ダッシュボード → 組織 → セキュリティ

2FA の詳細 →

---

暗号化バンドルの強制適用

組織レベルで、すべてのバンドルが暗号化されることを必須にします。

場所: Web ダッシュボード → 組織 → セキュリティ

---

チームコラボレーション

ロールベースアクセス制御（RBAC）

組織とアプリレベルのアクセス制御に対応した、きめ細かい権限。

組織ロール:

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

アプリロール:

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

場所:

• Web Dashboard → 組織 → メンバー
• Web Dashboard → App → アクセス

RBACの詳細を見る →

---

監査ログ

コンプライアンスとセキュリティのための、組織とアプリの全アクティビティを網羅した監査証跡。

記録されるイベント:

• ユーザー操作（ログイン、ログアウト、権限変更）
• Bundle操作（アップロード、削除、割り当て）
• Channel操作（作成、更新、削除）
• 組織の変更（設定、メンバー）

場所: Web ダッシュボード → Organization → Audit Logs

---

Webhook

HTTP Webhook を通じて、アプリのイベントに関するリアルタイム通知を受け取れます。

対応イベント:

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

機能:

• カスタム Webhook URL
• イベントのフィルタリング
• 配信ログ
• リトライ機構
• テスト機能

場所: Web ダッシュボード → Organization → Webhooks

---

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

特定のロールと権限を付与して、チームメンバーを組織に招待します。

機能:

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

場所: Web Dashboard → 組織 → メンバー

---

API キー管理

任意の有効期限とハッシュ化保存に対応した API キーを作成・管理・取り消しができます。

主な機能:

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

場所: Webダッシュボード → API キー

API キーの詳細を見る →

---

パスワードポリシー

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

設定可能なポリシー：

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

場所: Web ダッシュボード → 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 LTS
• Capacitor 6
• Capacitor 5

---

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

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

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

---

中国向け設定

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

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

---

高度な機能

アップデート動作のカスタマイズ

SDK で、アップデートを確認・適用するタイミングと方法を設定できます。

設定可能なオプション:

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

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

---

アップデートの種類

即時更新からユーザーが制御できるインストールまで、ユースケースに応じたさまざまな更新タイプを用意しています。

利用できるタイプ:

• バックグラウンド更新（デフォルト）
• 即時更新
• ユーザープロンプト付き更新
• 条件付きアップデート

アップデートの種類の詳細 →

---

クレジットシステム

帯域幅、ストレージなどのリソース使用量に応じたクレジット制の従量課金。

機能:

• クレジット使用量の追跡
• 使用量アラート
• Stripeでチャージ
• クレジット台帳

場所: Webダッシュボード → 組織 → クレジット

---

スタートガイド

これらの機能を使い始める準備はできましたか？私たちの クイックスタートガイド 最初のアプリに Capgo Live Updates を設定します。

ヘルプが必要ですか？

• Discordに参加して コミュニティサポート
• FAQ を確認 よくある質問
• API ドキュメントを参照 API の統合
• サポートに連絡 エンタープライズ向けの支援

Featuresから次へ進む

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