トラブルシューティング

コピー用意

ここでは、Capgoを使用する際に発生する可能性のある一般的な問題と、それを解決する方法について説明します。

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

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

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

アップロード失敗

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

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

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

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

--tus: __CAPGO_KEEP_0__が使用するプロトコル tus再送信可能なアップロードプロトコル大きなバンドルやネットワーク接続が悪い場合に信頼性の高いアップロードを行うために使用します。バンドルサイズが10MBを超えている場合やネットワーク接続が不安定な場合、__CAPGO_KEEP_0__を使用することを検討してください。 --tus:
ターミナルウィンドウ
```
npx @capgo/cli@latest bundle upload --tus
```
--package-json そして --node-modules: Capgoがrootディレクトリの場所を知るように指示します package.json そして node_modules あなたのアプリが非標準的な構造を使用している場合、例えばモノレポやnpmワークスペースを使用している場合。 package.json パスをrootに渡してください。 --node_modules そして
パス:
```
npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modules
```
Capgo needs this information to correctly bundle your app’s dependencies.

__CAPGO_KEEP_0__はこの情報を必要とします。アプリの依存関係を正しくバンドルするため。 --channel これらのフラグを他のオプションと組み合わせることができます。 Capgo CLI docs 詳細については__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ドキュメントを参照してください。

アップロードの問題が解決しない場合は、__CAPGO_KEEP_0__サポートにご連絡ください。 Capgo support 追加のサポートを受けるには。

デバッグ更新

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

プロジェクトディレクトリで次のコマンドを実行してください:
ターミナルウィンドウ
```
npx @capgo/cli@latest app debug
```
デバイスまたはエミュレータでアプリを起動し、更新をトリガーするアクションを実行してください (例: アップロードした新しいバンドルをアップロードした後、アプリを再起動する)
デバッグコマンドの出力を確認してください。更新プロセスに関する情報をログします。以下の情報が含まれます:
- アプリが更新をチェックする時
- 更新が見つかった場合とどのバージョンであるか
- 更新のダウンロードとインストールの進行状況
- アップデートプロセス中に発生するエラー
デバッグログを使用して、問題が発生している場所を特定します。例えば:
- アップデートが見つからない場合は、バンドルが正常にアップロードされたかどうか、またアプリが正しいチャンネルを使用しているかどうかを確認してください。
- アップデートがダウンロードされるがインストールされない場合は、 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.

__CAPGO_KEEP_0__ のデバッグコマンドに加えて、Android、iOS、Electron などのネイティブログは、ネイティブ側のアップデートプロセスに関連する問題を特定するために非常に役立ちます。

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

デバイスを接続するかエミュレータを起動する
Android Studioを開き、「ビュー > ツールウィンドウ > Logcat」を選択する
Logcat ウィンドウで、ログをアプリのプロセスだけにフィルタリングするには、上部のドロップダウンから選択する
__CAPGO_KEEP_0__ ログを含む行を探す Capgo to find the SDK logs

ログをフィルタリングするには、を検索する adb logcat __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ は、更新プロセス中にキーエベントをログする Capgo 更新チェックが開始されたとき

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

__CAPGO_KEEP_0__
__CAPGO_KEEP_1__
アップデートのダウンロードが開始され、完了したとき
アップデートのインストールがトリガーされたとき
ネイティブのアップデートのステップで発生したエラー

Android固有の一般的な問題はログで確認できます。

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

iOSログ

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

デバイスを接続したりシミュレータを起動したりしてください
Xcodeを開いて、「Window > Devices and Simulators」に移動してください。
デバイスを選択し、「Open Console」をクリックしてください。
コンソール出力で、__CAPGO_KEEP_0__ログを含む行を探してください。 Capgo SDKログを見つけるには、

また、 log stream コマンドをターミナルで実行し、 Capgo ログをフィルタリングするために使用します。

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

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

iOS固有の問題はログで検出できます。

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

Electronログ

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

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

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

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

トラブルシューティングの難しいライブアップデート問題の場合、Capgoのデバッグログとネイティブログをキャプチャすることは、問題を特定し解決するための包括的なビューを提供することです。両方のログを合わせると、問題を特定し解決するための最も良い機会を得ることができます。

更新が適用されない

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

アプリ内で CapacitorUpdater.notifyAppReady() code の方法を実行してください。
Check that your device is connected to the internet and the Capgo debug logs show the update was downloaded
デバイスがインターネットに接続されていることを確認し、__CAPGO_KEEP_0__のデバッグログが更新がダウンロードされたことを示していることを確認してください。
アプリを完全に閉じて再度開きます。更新は新しい起動時にのみ適用されます。

参考のためのライブ更新の展開の詳細については、更新プロセスについての npx @capgo/cli@latest app debug コマンドとネイティブログを使用して、まだ詰まっている場合は、起こっていることについてのより多くの視覚性を得ることができます。

一般的な更新失敗コード

ログがバックエンドエラーを示している場合、または disable_auto_update_to_major, semver_error、専用のガイドを使用してください: cannot_update_via_private_channel一般的な更新問題

各一般的な

It explains what each common code means, why it happens, and how to fix it.

SDK Installation

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

アプリが Capacitor のサポートされているバージョン (4.0 以上) を使用していることを確認してください
__CAPGO_KEEP_0__ をインストールした後、__CAPGO_KEEP_0__ を同步する手順に従ってください CI/CD統合 SDK CI/CD統合

__CAPGO_KEEP_0__ のアップロードを CI/CD パイプラインからトリガーする際の問題について:

Capgo のアップロードコマンドを実行する前に、ウェブアセットがビルドされていることを確認してください

Double check your Capgo authentication token is set up correctly
__CAPGO_KEEP_0__
__CAPGO_KEEP_1__

See the CI/CD integration npx @capgo/cli@latest app debug docs

tips command confirm @capgo/capacitor-data-storage-sqlite for the implementation detail in @capgo/capacitor-data-storage-sqlite, Using @capgo/capacitor-data-storage-sqlite native機能の使用 (@capgo/capacitor-data-storage-sqlite) について @capgo/capacitor-file 実装詳細 (@capgo/capacitor-file) について native機能の使用 (@capgo/capacitor-file) native機能の使用 (@capgo/capacitor-file) と @capgo/capacitor-uploader 実装詳細 (@capgo/capacitor-uploader) について