トラブルシューティング

インストール

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

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

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

プロフェッショナルサポートを受ける

アップロード失敗

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

アプリIDが capacitor.config.ts Capgoダッシュボードに登録されているアプリと一致していることを確認してください。
Capacitorプロジェクトのルートディレクトリからアップロードコマンドを実行していることを確認してください。
Your web assets are built and up to date

上位のアップロードオプション

Capgoは、Capgo CLIで利用できる追加のフラグを提供します。これにより、一般的なアップロード問題を解決するのに役立ちます:

--tus: __CAPGO_KEEP_0__がtusの再送可能なアップロードプロトコルを使用します。これにより、大きなバンドルやネットワーク接続が悪い場合でも、信頼性の高いアップロードが可能になります。バンドルが10MBを超えている場合や、ネットワーク接続が悪い場合には、ターミナル画面コピー --tus:
、
```
npx @capgo/cli@latest bundle upload --tus
```
--package-json 、 --node-modules: Tells Capgo where to find your root package.json Page/area: Capgo marketing website. Role: Short UI label or navigation item. Seen in: page trust.astro. Message key `and` (And). 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には、依存関係を正しくバンドルするために、この情報が必要です。

必要に応じて、これらのフラグを他のオプションと組み合わせることができます。 --channel 詳しくは、__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ドキュメントを参照してください。 Capgo CLI docs アップロードに関する問題が解決しない場合は、__CAPGO_KEEP_0__サポートにご連絡ください。

Terminal window Capgo support 追加のサポートを受けるために。

デバッグ更新

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

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

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

ネイティブログを使用したデバッグ

Capgo のデバッグコマンドに加えて、Android、iOS、Electron のネイティブログは、ネイティブ側のアップデートプロセスに関連するトラブルシューティング情報を提供するのに役立ちます。

Android ログ

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

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

または、コマンドを使用して、ログをフィルタリングする adb logcat コマンドと "を使用して、ログをフィルタリングする Capgo __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ は、更新プロセス中にキーエベントをログする

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

更新が見つかり、どのバージョンであるか
__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側の重要なイベントをログします:

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

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

更新をダウンロードする際のSSL証明書問題
アップデートダウンロードをブロックするアプリトランスポートセキュリティ
アップデートパッケージのインスufficientストレージスペース
アップデートパッケージの正しい抽出または適用に失敗

Electronログ

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

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

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

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

トラブルシューティングの難しいライブ更新問題の場合、Capgoのデバッグログとネイティブログをキャプチャすることは、問題の完全な理解を得るための良いアイデアです。2つのログを合わせると、問題を特定し解決するための最善のチャンスを得ることができます。

更新が適用されない

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

アプリ内で__CAPGO_KEEP_0__を呼び出すことを確認してください。 CapacitorUpdater.notifyAppReady() in your app code as shown in the デバイスがインターネットに接続されていることを確認し、__CAPGO_KEEP_0__のデバッグログが更新がダウンロードされたことを示していることを確認してください。
Check that your device is connected to the internet and the Capgo debug logs show the update was downloaded
ネイティブログに適用更新に関するエラーが存在する場合は、更新の適用に問題があることを示しています。
Look for any errors in the native logs that might indicate a problem applying the update

更新プロセスについての詳細は、ライブ更新の Deploying Live Updates npx @capgo/cli@latest app debug コマンドとネイティブログを使用して、起こっていることをよりよく理解することができます。

共通の更新エラー

バックエンドエラーがログに表示されている場合、 disable_auto_update_to_major, semver_error、または cannot_update_via_private_channel、Dedicated Guide

Common Update Problems

各共通のcodeの意味、原因、修正方法について説明しています。

SDKのインストール

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

Capacitor を使用しているアプリが、Capacitor のサポートされているバージョン (4.0 以上) を使用していることを確認してください
__CAPGO_KEEP_0__ のステップに従ってください __CAPGO_KEEP_0__ steps in order, including syncing your app after installing the SDK

CI/CD統合

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

Capgo のアップロードコマンドを実行する前に、ウェブアセットがビルドされていることを確認してください
__CAPGO_KEEP_0__ のアップロードコマンドが、ターゲット環境のチャンネル名を正しく使用していることを確認してください
__CAPGO_KEEP_1__

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

for more

tips. You can also use the command to confirm if your CI/CD-triggered updates are being received by the app. @capgo/capacitor-data-storage-sqlite for the implementation detail in @capgo/capacitor-data-storage-sqlite, If you are using the Troubleshooting feature to plan storage and file handling, connect it with @capgo/capacitor-data-storage-sqlite for the implementation detail in @capgo/capacitor-data-storage-sqlite, Using @capgo/capacitor-data-storage-sqlite Capgoのネイティブ機能を使用するために@capgo/capacitor-data-storage-sqlite @capgo/capacitor-file Capgoの実装詳細を参照するために@capgo/capacitor-file Capgoの@capgo/capacitor-fileを使用する Capgoのネイティブ機能を使用するために@capgo/capacitor-file、 @capgo/capacitor-uploader Capgoの実装詳細を参照するために@capgo/capacitor-uploader