トラブルシューティング

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

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

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

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

アップロード失敗

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

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

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

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

• --tus: __CAPGO_KEEP_0__がtusの再送可能なアップロードプロトコルを使用します。 大きなバンドルやネットワーク接続が悪い環境で信頼性の高いアップロードを行うために使用します。バンドルサイズが10MBを超えている場合やネットワーク接続が不安定な場合、__CAPGO_KEEP_0__を使用することを検討してください。 ターミナル画面 --tus:

  npx @capgo/cli@latest bundle upload --tus

• --package-json Capgoのマーケティングサイトのページ/エリア: trust.astro. ロール: ショートUIラベルまたはナビゲーションアイテム。 --node-modules: Tells Capgo where to find your root package.json Capgoのマーケティングサイトのページ/エリア: trust.astro. ロール: ショートUIラベルまたはナビゲーションアイテム。 node_modules あなたのアプリが標準的な構造を使用していない場合、例えばモノレポやnpmワークスペースを使用している場合。 package.json パスをrootの --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__サポートまでお問い合わせください。

Terminal window Capgo support 詳細な支援についてはこちら。

デバッグ更新

Capgoデバッグコマンドを使用すると、ライブ更新に関連する問題を解決するのに役立ちます。使用方法は以下のとおりです。

1. プロジェクトディレクトリで以下のコマンドを実行してください。

   npx @capgo/cli@latest app debug

2. デバイスまたはエミュレータ上でアプリを起動し、更新をトリガーするアクションを実行してください (例：アップロードした新しいバンドルをアップロードした後、アプリを再起動します)。

3. デバッグコマンドの出力を確認してください。更新プロセスに関する情報をログします。以下の情報が含まれます。

   • アプリが更新をチェックする時点
   • 更新が見つかった場合、そのバージョン
   • 更新のダウンロードおよびインストールの進行状況
   • アップデートプロセス中に発生するエラー

4. デバッグログを使用して、問題が発生している場所を特定します。たとえば:

   • アップデートが見つからない場合は、バンドルが正常にアップロードされたかどうか、そしてアプリが正しいチャンネルを使用しているかどうかを確認してください。
   • アップデートがダウンロードされるがインストールされない場合は、次のことを確認してください。 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 ログにアクセスするには:

1. デバイスを接続するかエミュレータを起動する
2. Android Studioを開き、「ビュー > ツール ウィンドウ > Logcat」を選択する
3. Logcat ウィンドウで、ログをアプリのプロセスだけにフィルタリングするには、上部のドロップダウンから選択する
4. アプリのログに含まれる行を探す Capgo SDK ログを見つけるには

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

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

• 更新が見つかった場合とそのバージョン
• __CAPGO_KEEP_0__ __CAPGO_KEEP_1__
• アップデートダウンロードが開始され、完了したとき
• アップデートのインストールがトリガーされたとき
• ネイティブアップデートのステップで発生したエラー

ログで見ることができるAndroid固有の一般的な問題には次のものがあります:

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

iOSログ

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

1. デバイスを接続したりシミュレータを起動したりする
2. Xcodeを開いて、「Window > Devices and Simulators」に移動してください。
3. デバイスを選択し、「Open Console」をクリックしてください。
4. コンソール出力で、__CAPGO_KEEP_0__ログを含む行を探してください。 Capgo SDKログを検索するには、ターミナルで以下のコマンドを実行してください。

ログをフィルタリングするには、以下のコマンドを実行してください。 log stream iOS側の重要なイベントをログするには、__CAPGO_KEEP_1__を使用します。 Capgo アップデートチェックの開始と結果

Similar to Android, the Capgo SDK will log key iOS-side events:

• インストールのトリガーと結果
• ネイティブアップデートプロセス中のエラー
• __CAPGO_KEEP_0__ __CAPGO_KEEP_1__
• __CAPGO_KEEP_0__

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

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

Electronログ

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

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

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

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

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

更新が適用されない

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

• アプリ内で __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
• __CAPGO_KEEP_0__
• __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__ を Sync した後、順番に quickstart のステップを実行してください CI/CD統合 SDK インストール

CI/CDパイプラインから __CAPGO_KEEP_0__ のアップロードをトリガーする際の問題については、次の点を確認してください:

Webアセットがビルドされた後、Capgo のアップロードコマンドを実行していることを確認してください

• Double check your Capgo authentication token is set up correctly
• CI/CD統合
• CI/CDパイプラインから__CAPGO_KEEP_0__のアップロードをトリガーする際の問題については、次の点を確認してください:

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

トラブルシューティング

トラブルシューティング を使用すると、ストレージとファイルハンドリングの計画を行い、 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-data-storage-sqlite @capgo/capacitor-data-storage-sqlite for the implementation detail in @capgo/capacitor-data-storage-sqlite, @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を参照してください。