トラブルシューティング

このプラグインのインストール手順とフルマークダウンガイドを含むセットアップの質問をコピーしてください。

Capgoの一般的な問題とその解決策です。

🚀 専門家の助けが必要ですか

複雑な問題に詰まっている場合、専門チームがあなたのために個人化されたサポート、codeのレビュー、カスタムソリューションを提供します。

プロフェッショナルサポート

アップロードエラー

アップロードが失敗した場合、確認してください：

アプリIDが capacitor.config.ts あなたのアプリとCapgoのダッシュボードに一致しているか
アップロードコマンドを実行しているCapacitorプロジェクトのルートディレクトリ
あなたのウェブアセットがビルドされ、最新の状態であるか

高度なアップロードオプション

Capgo CLIには、一般的なアップロード問題を解決するために使用できる追加のフラグが含まれています:

--tus: __CAPGO_KEEP_0__は、信頼性の高いアップロードを実現するために、 tus再開可能アップロードプロトコルを使用します。大量のバンドルやネットワーク接続が悪い場合、10MBを超えるバンドルをアップロードする場合は、 --tus:
ターミナルウィンドウ
```
npx @capgo/cli@latest bundle upload --tus
```
--package-json と --node-modules: Capgoに、ルートの場所を教えます。 package.json そして、 node_modules あなたのアプリがモノレポやnpmワークスペースを使用している場合、ルートのパスと package.json を指定します。 --node_modules パス:
ターミナル画面
```
npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modules
```
Capgoにはこの情報が必要です。アプリの依存関係を正しくバンドルするため。

必要に応じて、他のオプションと組み合わせて使用できます。 --channel 詳しくは Capgo CLI ドキュメントを参照してください。

アップロードに関する詳細な情報については、 Capgo サポートまでご連絡ください。

アップロードに関する問題が解決しない場合、

ライブ更新で問題が発生している場合、Capgo デバッグコマンドはトラブルシューティングに役立つツールです。使用するには:

プロジェクトディレクトリで次のコマンドを実行してください:
ターミナル画面
```
npx @capgo/cli@latest app debug
```
デバイスまたはエミュレータでアプリを起動し、更新をトリガーするアクションを実行してください (例: アップロードした新しいバンドルをアップロードした後、アプリを再起動します)。
デバッグコマンドの出力を確認してください。更新プロセスに関する情報をログします。以下の情報が含まれます:
- アプリが更新をチェックする
- 更新が見つかった場合とそのバージョン
- 更新のダウンロードとインストールの進行状況
- 更新プロセス中に発生したエラー
デバッグログを使用して、問題が発生している場所を特定してください。例えば:
- __CAPGO_KEEP_0__
- のアップデートが見つからない場合、バンドルが正常にアップロードされたかどうかを確認し、正しいチャンネルを使用していることを確認してください。 CapacitorUpdater.notifyAppReady() アップデートがダウンロードされるがインストールされない場合は、
- If you see an error message, look up that specific error in the Capgo docs or reach out to support for help.

が完全に閉じて再起動されたことを確認してください。

エラーメッセージが表示される場合は、

In addition to the Capgo debug command, the native logs on Android, iOS, and Electron can provide valuable troubleshooting information, especially for issues on the native side of the update process.

Native Logsを使用したデバッグ

Native Logsを使用したデバッグの場合、Android、iOS、Electronのネイティブログは、ネイティブ側のアップデートプロセスに関する問題のトラブルシューティング情報を提供するのに役立ちます。
Android スタジオを開いて、「ビュー > ツールウィンドウ > ログキャット」を選択
ログキャットウィンドウで、ログをあなたのアプリのプロセスだけにフィルタリングするには、上部のドロップダウンから選択
あなたのアプリのログキャットのログを検索するには Capgo SDK ログを見つけるために

代わりに、 adb logcat コマンドを使用して、 Capgo ログをフィルタリングする

Capgo SDK は、更新プロセス中にキーエベントをログする

更新チェックが開始されたとき
更新が見つかり、どのバージョンであるか
更新ダウンロードが開始され、完了したとき
更新のインストールがトリガーされたとき
native update のステップで発生するエラー

ログに表示される可能性のある一般的な Android の問題には次のものがあります。

ネットワーク接続の問題がアップデートのダウンロードを妨げる
ファイルのパーミッションエラーがアップデートのバンドルを保存または読み取る
アップデートのバンドルに十分なストレージスペースがない
アップデートがインストールされた後、再起動に失敗する

iOS ログ

iOS ログにアクセスするには

デバイスを接続するかシミュレータを起動する
Xcode を開き、「Window > Devices and Simulators」を選択する
デバイスを選択し、「Open Console」をクリックする
In the console output, look for any lines that include Capgo to find the SDK logs

を使用して log stream コマンドをターミナルで実行し Capgo でログをフィルタ

iOS側の重要なイベントをログするように、SDK Capgo と同様に機能します:

更新チェックの開始と結果
ダウンロードの開始、進行、完了
インストールのトリガーと結果
ネイティブの更新プロセス中に発生したエラー

ログで特定できるiOS固有の問題には、次のものがあります:

ダウンロード中にSSL証明書の問題が発生します
App transport security がアップデートダウンロードをブロックしています。
アップデートパッケージのストレージスペースが不足しています。
アップデートパッケージの抽出または適用に失敗しました。

Electron ログ

Electron アプリの場合、メインプロセスとレンダラープロセスの両方の出力を確認してください。

ターミナルから通常の起動コマンドでElectron アプリを実行し、起動、更新チェック、ネットワークエラーのターミナル出力を確認してください。 bun run electron:dev レンダラーウィンドウでDevToolsを開き（View → Toggle Developer Tools）、アップデートフローを再現する際にコンソールログと失敗したネットワークリクエストを検査してください。 bun run electron:serveパッケージ化されたアプリの場合、クラッシュや起動失敗を確認するにはOSのログツールを使用してください。
macOS
macOS
- macOS: open Console.app とアプリ名でフィルタリング
- Windows: open イベントビューア → Windows ログ → アプリケーション
- Linux: デスクトップログビューアを使用して journalctl アプリケーションプロセス

更新のデバッグ時、メインプロセスとレンダラープロセスのログからメッセージを比較して、Electron の初期化問題と Capgo の更新ライフサイクル問題を区別する。

プラットフォームを問わず、ネイティブログは、より低レベルの更新プロセスビューを提供し、ネイティブ実装に関する詳細情報を提供します。特に、Capgo の JavaScript レイヤー外で発生する問題を特定するのに役立ちます。

トラブルシューティングの際に、難しいライブアップデートの問題が発生した場合、Capgo のデバッグログとネイティブログを両方キャプチャすることをお勧めします。 2 つのログを合わせると、問題の特定と解決のための最良のチャンスを得ることができます。

アップデートの適用ができません

アップロードしたバンドルがデバイスに表示されない場合:

あなたのアプリで __CAPGO_KEEP_0__ を呼び出すことを確認してください。以下の "quickstart" に示されているように CapacitorUpdater.notifyAppReady() デバイスがインターネットに接続されていることを確認し、code のデバッグログでアップデートがダウンロードされたことを確認します。アプリを完全に閉じて再度開きます。アップデートは新しい起動時にのみ適用されます。
Check that your device is connected to the internet and the Capgo debug logs show the update was downloaded
「ライブアップデートのデプロイ」
ライブアップデートのデプロイ

ライブアップデートのデプロイライブアップデートのデプロイ更新プロセスについての詳細は、以下のガイドを参照してください。問題が解決しない場合は、 npx @capgo/cli@latest app debug コマンドとネイティブログを使用して、起こっていることをよりよく理解することができます。

一般的な更新エラー

バックエンドエラーがログに表示されている場合、例えば「」や「」など、以下の専用ガイドを参照してください。 disable_auto_update_to_major, semver_error一般的な更新問題 cannot_update_via_private_channel各一般的な__CAPGO_KEEP_0__の意味、原因、対処方法について説明しています。

__CAPGO_KEEP_0__のインストール

「codeのインストール」

SDK __CAPGO_KEEP_1__のインストールに問題がある場合は、以下を確認してください:

If you’re having trouble installing the Capgo SDK, make sure:

あなたのアプリは、Capacitor (4.0 またはそれ以降のバージョン) をサポートしているバージョンを使用しています。
CI/CD インテグレーション CI/CD インテグレーション steps in order, including syncing your app after installing the SDK

CI/CD インテグレーション

For issues with triggering Capgo uploads from your CI/CD pipeline:

Double check your Capgo authentication token is set up correctly
CI/CD インテグレーション
CI/CD インテグレーション

CI/CD インテグレーション CI/CD インテグレーション docsからさらにトラブルシューティングのヒントを取得することができます。 npx @capgo/cli@latest app debug コマンドを使用して、CI/CDトリガーされた更新がアプリケーションに受け取られているかどうかを確認できます。