トラブルシューティング

Capgo を使用している際に発生する可能性のある一般的な問題とその解決策を以下に示します。

🚀 導入専門のサポートが必要ですか？

複雑な問題に詰まった場合、専門のチームがあなたのためにサポートを提供します。個別のサポート、code のレビュー、カスタマイズされた解決策が提供されます。

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

アップロード失敗

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

• あなたのアプリIDが capacitor.config.ts matches your app in the Capgo dashboard
• You’re running the upload command from the root of your Capacitor project
• あなたの

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

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

• --tus: __CAPGO_KEEP_0__ が使用する tus 可再生アップロードプロトコル 大きなバンドルまたはネットワーク接続が悪い場合に信頼性の高いアップロードを行うために。バンドルサイズが 10MB を超えている場合やネットワーク接続が不安定な場合、 --tus:

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

• --package-json : __CAPGO_KEEP_0__ にアプリのルートディレクトリの場所を教える --node-modulesアプリがモノレポや Capgo ワークスペースを使用している場合、ルートディレクトリのパスと package.json パス: node_modules npm package.json __CAPGO_KEEP_1__ --node_modules __CAPGO_KEEP_0__

  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__サポートにご連絡ください。

アップロードの問題が解決しない場合は、__CAPGO_KEEP_0__サポートにご連絡ください。 Capgo support デバッグアップデートのセクション

If you’re still having trouble with uploads, reach out to __CAPGO_KEEP_0__ support for further assistance.

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

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

   npx @capgo/cli@latest app debug

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

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

   • アプリが更新をチェックする
   • 更新が見つかっている場合とどのバージョンである
   • 更新のダウンロードとインストールの進行状況
   • 更新プロセス中に発生したエラー

4. デバッグ ログを使用して、問題が発生している場所を特定してください。例えば:

   • 更新が見つからなかった場合、バンドルが正常にアップロードされたかどうかと、アプリが正しいチャネルを使用しているかどうかを確認してください。
   • If the update downloads but doesn’t install, make sure you’ve called CapacitorUpdater.notifyAppReady() and that the app was fully closed and reopened.
   • If you see an error message, look up that specific error in the Capgo docs or reach out to support for help.

The debug command is especially useful for identifying issues with the update download and installation process. If the logs show the expected update version was found but not ultimately applied, focus your troubleshooting on the steps after the download.

Native Logsのデバッグ

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のデバッグ

1. デバイスを接続するかエミュレータを起動する
2. Android Studioを開き、”View > Tool Windows > Logcat”を選択する
3. In the Logcat window, filter the logs to just your app’s process by selecting it from the dropdown at the top
4. を含む行を探してください Capgo to find the SDK logs

コマンドを使用して、 adb logcat を検索してください Capgo のログを検索してください

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

• のログを検索してください
• のログを検索してください
• のログを検索してください
• のログを検索してください
• __CAPGO_KEEP_0__

Android固有の問題がログに出る可能性があります。

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

iOSログ

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

1. デバイスを接続またはシミュレータを起動
2. Xcodeを開き、「Window > Devices and Simulators」に移動
3. デバイスを選択し、「Open Console」をクリック
4. コンソール出力で、更新パッケージを含む行を探してください Capgo SDK ログを探す

You can also use the log stream コマンドをターミナルで実行し、grep でログをフィルタリングします。 Capgo ログをフィルタリングするには、を使用します。

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

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

ログで特定できるiOS固有の問題は次のとおりです:

• ダウンロード中のアップデートのSSL証明書問題
• アップデートダウンロードをブロックするアプリケーショントランスポートセキュリティ問題
• アップデートパッケージの保存スペースが不足しています
• アップデートパッケージの抽出または適用に失敗しました

Electronログ

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

1. Electronアプリをターミナルから通常の起動コマンドで実行し、起動、更新チェック、ネットワークエラーのターミナル出力を確認してください (例えば bun run electron:dev パッケージ化されたアプリの場合、クラッシュや起動失敗を確認するにはOSのログツールを使用してください: bun run electron:servemacOS
2. : open
3. macOSの場合、クラッシュや起動失敗を確認するには「Activity Monitor」を使用してください
   • Windowsの場合、クラッシュや起動失敗を確認するには「Event Viewer」を使用してくださいLinuxの場合、クラッシュや起動失敗を確認するには「journalctl」を使用してください Console.app とアプリ名でフィルタリング
   • Windows：オープン イベントビューアー → Windows ログ → アプリケーション
   • Linux：デスクトップログビューアーまたは journalctl アプリプロセス

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

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

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

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

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

• アプリ内で CapacitorUpdater.notifyAppReady() 「Capgo」codeを呼び出していることを確認してください。以下の quickstart
• デバイスがインターネットに接続されているか、デバッグログのCapgoがアップデートがダウンロードされたことを示していることを確認してください。
• アプリを完全に閉じて再度起動してください。アップデートは新しい起動時にのみ適用されます。
• デバイスのネイティブログに表示されるエラーを確認してください。アップデートの適用に問題がある可能性があります。

「ライブアップデートのデプロイ」 のガイドを参照してください。アップデートプロセスについての詳細情報が記載されています。問題が解決しない場合は、 「Capgo」 npx @capgo/cli@latest app debug コマンドとネイティブログを取得して、起こっていることをよりよく把握する。

一般的な更新失敗コード

あなたのログがバックエンドエラーを表示している場合、例えば「__CAPGO_KEEP_0__」や「__CAPGO_KEEP_0__」、など、使用する専用のガイドを参照してください。 disable_auto_update_to_major, semver_error一般的な更新問題 cannot_update_via_private_channelそれが何を意味し、どのように発生し、どのように解決するかを説明しています。

• __CAPGO_KEEP_0__ インストール

「code インストール」のセクション

SDK __CAPGO_KEEP_1__ をインストールする際に問題が発生している場合、確認してください。

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

• Your app is using a supported version of Capacitor (4.0 or newer)
• You’ve followed the quickstart 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
• Make sure you’re running the upload command after your web assets are built
• Check that the upload command is using the correct channel name for your target environment

See the CI/CD docs for more troubleshooting tips. You can also use the npx @capgo/cli@latest app debug CI/CDがアプリに受け取られているかどうかを確認するコマンドです。

トラブルシューティングから続けて

CI/CDが使用している場合 トラブルシューティング データストレージとファイルハンドリングを計画するには、@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-data-storage-sqliteと接続してください。 @capgo/capacitor-data-storage-sqliteの実装詳細については、@capgo/capacitor-data-storage-sqliteを参照してください。 @capgo/capacitor-data-storage-sqliteを使用して @capgo/capacitor-data-storage-sqliteのネイティブ機能を使用して @capgo/capacitor-fileの実装詳細については、@capgo/capacitor-fileを参照してください。 @capgo/capacitor-fileを使用して @capgo/capacitor-fileのネイティブ機能を使用して @capgo/capacitorファイルを使用 @capgo/capacitorファイルのネイティブ機能のために @capgo/capacitor ファイルを使用 @capgo/capacitor アップローダーの実装詳細のために