トラブルシューティング

インストール、同期、そしてこのプラグインの完全なマークダウンガイドを含む設定用のコピー可能な質問をコピーします。

Capgoの一般的な問題と解決策

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

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

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

アップロードの失敗

アップロードが失敗した場合、次のことを確認してください:

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

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

Capgo CLIは、一般的なアップロード問題に役立つ追加のフラグを提供します。

--tus: Capgoを使用します。 tus再送信アップロードプロトコル大きなバンドルまたはネットワーク接続が悪い場合に信頼性の高いアップロードを行うために使用します。バンドルが10MBを超えている場合やネットワーク接続が悪い場合、 --tus:
ターミナルウィンドウ
```
npx @capgo/cli@latest bundle upload --tus
```
--package-json 、 --node-modules: Capgo のルートを探す場所を教える package.json 、 node_modules アプリが非標準的な構造を使用している場合、例えばモノレポやnpmワークスペースを使用している場合、ルートディレクトリのパスを渡してください。 package.json と --node_modules path:
ターミナルウィンドウ
```
npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modules
```
Capgoにはアプリの依存関係を正しくバンドルするために必要な情報が必要です。

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

__CAPGO_KEEP_0__のアップロードオプションに関する詳細な情報については、 Capgo __CAPGO_KEEP_1__ドキュメントを参照してください。

アップロードに問題が残っている場合は、

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

プロジェクトディレクトリで以下のコマンドを実行してください:
ターミナル画面
```
npx @capgo/cli@latest app debug
```
デバイスまたはエミュレータ上でアプリを起動し、更新をトリガーするアクションを実行してください (例: アップロードした新しいバンドルをアップロードした後、アプリを再起動します)。
デバッグコマンドの出力を確認してください。アップデートプロセスに関する情報がログ出力されます。以下の情報が含まれます:
- アプリがアップデートをチェックする時
- アップデートが見つかり、どのバージョンであるか
- アップデートのダウンロードとインストールの進行状況
- アップデートプロセス中に発生したエラー
デバッグログを使用して、問題が発生している場所を特定してください。例えば:
- アップデートが見つからない場合は、バンドルが正常にアップロードされたかどうかと、アプリが正しいチャンネルを使用しているかどうかを確認してください。
- アップデートがダウンロードされるがインストールされない場合は、次のことを確認してください。 CapacitorUpdater.notifyAppReady() と呼び出されたことを確認し、アプリが完全に閉じて再起動されていることを確認してください。
- エラーメッセージが表示される場合は、Capgo ドキュメントでその特定のエラーを調べたり、サポートに問い合わせたりしてください。

デバッグコマンドは、特にアップデートのダウンロードとインストールプロセスに関連する問題を特定するのに役立ちます。ログが期待どおりのアップデートバージョンが見つかったが最終的に適用されなかった場合は、ダウンロード後のステップに焦点を当ててトラブルシューティングを進めてください。

ネイティブログのデバッグ

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.

Android ログ

Android ログにアクセスするには:

デバイスに接続したりエミュレータを起動したりしてください
Android Studioを開いて、「View > Tool Windows > Logcat」を選択
Logcatウィンドウで、ログをアプリのプロセスだけにフィルタリングするには、上部のドロップダウンから選択
検索する行を含む Capgo を検索して、SDK ログを見つける

代わりに、コマンドを使用して adb logcat を指定して、ログをフィルタリングする Capgo __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ はアップデートプロセス中のキーエベントをログする

The Capgo SDK will log key events during the update process, such as:

アップデートが見つかった場合とそのバージョン
アップデートダウンロードが開始され完了したとき
アップデートのインストールがトリガーされたとき
protectedTokens
Native アップデートのステップで発生するエラー

ログに表示される可能性のある一般的な Android 特有の問題

ネットワーク接続の問題がアップデートのダウンロードを阻害
アップデートバンドルの保存または読み取り時にファイルパーミッションエラー
アップデートバンドルのストレージ空間不足
アップデートがインストールされた後、再起動に失敗

iOS ログ

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

デバイスを接続またはシミュレーターを起動
Xcode を開き、「Window > Devices and Simulators」を選択
デバイスを選択し、「Open Console」をクリック
コンソール出力で、__CAPGO_KEEP_0__ を含む行を探します。 Capgo SDK ログを検索してみましょう。

また、 log stream コマンドをターミナルで実行し、 Capgo __CAPGO_KEEP_0__ を含むログをフィルタリングしてみましょう。

iOS では、Android と同様に、Capgo SDK は、iOS側の重要なイベントをログ出力します。

アップデートのチェック開始と結果
ダウンロードの開始、進行、完了
ネイティブのアップデートプロセス中のエラー
ネイティブのアップデートプロセス中のエラー

iOS固有の問題としてログに出力されるものには、以下のものがあります。

ダウンロード中にSSL証明書の問題が発生します。
アプリケーション輸送セキュリティがアップデートダウンロードをブロックしています。
アップデートパッケージのインストールに十分なストレージスペースが確保されていません。
アップデートパッケージの抽出または適用に失敗しました。

エレクトロンログ

エレクトロンアプリケーションでは、メインプロセスとレンダラープロセスの両方の出力を確認してください。

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

When debugging updates, compare messages from both main-process and renderer-process logs to separate Electron bootstrap issues from Capgo update lifecycle issues.

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

問題を解決するには、難しい live update 問題の場合、両方の Capgo デバッグログとネイティブログをキャプチャすることをお勧めします。これにより、問題が起こっていることの包括的な理解が得られます。両方のログを合わせると、問題を特定し、解決するための最善のチャンスが得られます。

更新が適用されない

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

アプリ内で CapacitorUpdater.notifyAppReady() code の例を参照してください。
インターネットに接続されているデバイスを確認し、Capgo デバッグログに表示されているアップデートのダウンロードが完了していることを確認してください。
デバイスがインターネットに接続されていることを確認し、__CAPGO_KEEP_0__ デバッグログが更新がダウンロードされたことを示していることを確認してください。
アプリを完全に閉じて再起動してください。更新は新しい起動時にのみ適用されます。

ネイティブログに適用更新に関するエラーがないかを確認してください。「live updatesをデプロイする」の詳細を参照してください。更新プロセスについての詳細は、以下のガイドを参照してください。問題が解決しない場合は、 npx @capgo/cli@latest app debug コマンドとネイティブログを使用して、起こっていることについてより詳細な情報を取得できます。

一般的な更新失敗コード

エラーが表示される場合は、バックエンドエラーが表示される場合 disable_auto_update_to_major, semver_error, or cannot_update_via_private_channel以下の専用ガイドを参照してください:

一般的な更新問題

各一般的なcodeの意味、原因、および解決方法について説明しています。

SDKのインストール

インストールに問題がある場合は、CapgoとSDKを確認してください。

Capacitor (4.0 以降を使用している)
__CAPGO_KEEP_0__ の設定を確認 __CAPGO_KEEP_0__ アプリをインストールした後、SDK を同期するステップを順番に実行してください。

CI/CD

CI/CD パイプラインから Capgo アップロードをトリガーする問題の場合:

Capgo 認証トークンが正しく設定されていることを確認してください。
CI/CD の設定
CI/CD

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