トラブルシューティング

Here are some common issues you might encounter while using Capgo and how to resolve them.

🚀専門のヘルプが必要ですか?

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

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

アップロード失敗

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

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

詳細なアップロードオプション

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

• --tus: 大きなアップロードファイルやネットワーク接続が悪い場合に、より信頼性の高いアップロードを行うために tus再開可能アップロードプロトコル 10MBを超えるアップロードファイルやネットワーク接続が悪い場合に、検討してください --tus:

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

• --package-json そして --node-modules: Capgo にアプリのルートを探す場所を教える package.json そして node_modules アプリがモノレポや npm ワークスペースなどの非標準的な構造を使用している場合に、ルートのパスを渡す package.json パス: --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.

ターミナル画面 --channel 必要に応じて参照してください。 Capgo CLI ドキュメント アップロードの利用可能なオプションに関する詳細情報については、上記のドキュメントを参照してください。

アップロードに関する問題が解決しない場合、以下のサポートにご連絡ください。 Capgo サポート アップロードに関する問題が解決しない場合、以下のサポートにご連絡ください。

デバッグ更新

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

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

   npx @capgo/cli@latest app debug

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

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

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

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

   • 更新が見つからない場合、バンドルが正常にアップロードされたかどうかと、正しいチャネルを使用しているかどうかを確認してください。
   • 更新がダウンロードされるがインストールされない場合、を呼び出して、そしてアプリが完全に閉じて再起動されていることを確認してください。 CapacitorUpdater.notifyAppReady() エラー メッセージが表示される場合、__CAPGO_KEEP_0__ ドキュメントを参照してくださいまたはサポートに連絡してください。
   • If you see an error message, look up that specific error in the Capgo docs or reach out to support for help.

__CAPGO_KEEP_0__

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

Capgo デバッグコマンドに加えて、Android、iOS、Electron のネイティブログは、特にアップデートプロセスのネイティブ側の問題の場合、貴重なトラブルシューティング情報を提供します。

Android ログ

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

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

Android ログにアクセスするには: adb logcat コマンドとgrepを使用して Capgo ログをフィルタリングする。

The Capgo SDK は、更新プロセス中にキーイベントをログします。たとえば:

• 更新チェックが開始されたとき
• 更新が見つかり、どのバージョンであるか
• 更新ダウンロードが開始され、完了したとき
• 更新のインストールがトリガーされたとき
• ネイティブの更新ステップで発生したエラー

ログでよく見られるAndroid固有の問題には、次のものがあります。

• ネットワーク接続の問題が更新ダウンロードを妨げる
• ファイルパーミッションエラーが更新パッケージを保存または読み取る
• 更新パッケージのストレージスペースが不足している
• アップデートをインストールした後、再起動できない場合

iOS ログ

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

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

コマンドをターミナルで実行し、 log stream ログをフィルタするには Capgo を使用することもできます

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

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

ログで特定できるiOS固有の問題には、以下のものがあります:

• SSL証明書の問題がダウンロード中に発生する
• アップデートダウンロードがApp Transport Securityによってブロックされる
• アップデートパッケージのストレージスペースが不足している
• アップデートパッケージの適切な抽出または適用が失敗する

Electronログ

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

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

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

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

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

更新が適用されない

アップロードしたバンドルが見えていない場合、デバイス上で変更が反映されていないかどうかを確認してください:

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

詳細については、「 ライブアップデートの 」のガイドを参照してください。問題が解決しない場合は、「コマンドとネイティブログ」を使用して、起こっていることについてさらに詳細な情報を取得してください。 npx @capgo/cli@latest app debug アップデートの失敗の一般的なエラーコード

「アップデートの失敗の一般的なエラーコード」のセクション

deploying live updates disable_auto_update_to_major, semver_error, または cannot_update_via_private_channel, 専用ガイドを使用してください:

• 一般的な更新問題

それぞれの一般的な code の意味、原因、修正方法が説明されています。

SDK インストール

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

• アプリが Capacitor のサポートされているバージョン (4.0 以上) を使用していることを確認してください。
• 「__CAPGO_KEEP_0__」のインストール後にアプリを Sync したことを確認してください。 CI/CD統合 steps in order, including syncing your app after installing the SDK

steps

CapgoをCI/CDパイプラインからトリガーする問題について

• Capgoの認証トークンが正しく設定されていることを確認する
• ウェブアセットがビルドされた後、__CAPGO_KEEP_0__のアップロードコマンドを実行していることを確認する
• アップロードコマンドが正しいチャンネル名を使用していることを確認する

詳細なトラブルシューティングのためのドキュメント CI/CD統合 CI/CDトリガーされたアップデートがアプリケーションに受信されているかを確認する npx @capgo/cli@latest app debug トラブルシューティングから続ける

CI/CD統合

__CAPGO_KEEP_0__を使用している場合 トラブルシューティング データの保存とファイルの管理を計画するには、を接続してください。 @capgo/capacitor-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-fileのネイティブ機能を使用 @capgo/capacitor-file、 @capgo/capacitor-uploaderの実装詳細については、@capgo/capacitor-uploaderを参照してください。