メニューに進む
Capgo - Capacitor アプリ向けライブアップデート Capgo

トラブルシューティング

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

アップロード失敗

「アップロード失敗」のセクション

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

  • CapgoダッシュボードでアプリIDが capacitor.config.ts matches your app in the Capgo dashboard
  • You’re running the upload command from the root of your Capacitor project
  • あなたのウェブアセットがビルドされ最新の状態であるか

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

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

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

  • --tus: 大きなバンドルやネットワーク接続が悪い場合に、より信頼性の高いアップロードを行うために使用されるtus再開可能アップロードプロトコルを使用します。バンドルサイズが10MBを超えている場合や、ネットワーク接続が不安定な場合、 ターミナル画面 クリップボードにコピー --tus:

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

  • --package-json 、 --node-modulesアプリがモノレポやCapgoワークスペースを使用している場合、rootのパスとワークスペースのパスを指定してください。 package.json __CAPGO_KEEP_0__ node_modules if your app uses a non-standard structure like a monorepo or npm workspace. Pass the path to the root package.json __CAPGO_KEEP_0__ --node_modules path:

    ターミナルウィンドウ
    npx @capgo/cli@latest bundle upload --package-json=path/to/package.json --node_modules=path/to/node_modules

    Capgoには、{0}の依存関係を正しくバンドルするために必要な情報が必要です。

必要に応じて、他のオプションと組み合わせて使用できます。 --channel {0}の詳細なドキュメントについては、{1}を参照してください。 Capgo CLI docs アップロードに関する問題が解決しない場合は、{0}のサポートにご連絡ください。

アップデートのデバッグ Capgo __CAPGO_KEEP_1__

__CAPGO_KEEP_0__

「更新のデバッグ」セクション

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

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

    ターミナル ウィンドウ
    npx @capgo/cli@latest app debug

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

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

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

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

    • アップデートが見つからない場合は、バンドルが正常にアップロードされたことを確認し、正しいチャンネルを使用していることを確認した上で、再度確認してください。
    • アップデートがダウンロードされるがインストールされない場合は、__CAPGO_KEEP_0__を確認してください。 CapacitorUpdater.notifyAppReady() アプリが完全に閉じて再起動されました。
    • エラー メッセージが表示された場合、Capgo ドキュメントでその特定のエラーを検索するか、サポートに連絡して助けを求めます。

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

本番環境でのデバッグに使用するネイティブログを参照する

「Nativeログを使用したデバッグ」セクション

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

Android ログ

Android ログセクション

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

  1. デバイスを接続するか、エミュレータを起動する
  2. Android スタジオを開いて、「ビュー > ツール ウィンドウ > Logcat」を選択
  3. Logcat ウィンドウで、ログをあなたのアプリのプロセスだけにフィルタリングするには、上部のドロップダウンから選択
  4. __CAPGO_KEEP_0__ ログを見つけるには、次の行を探す Capgo SDK ログを表示するには、代わりに「コマンド」と「grep」を使用してログをフィルタリングする

__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ は、更新プロセス中のキーエベントをログする adb logcat 更新チェックが開始されたとき Capgo 更新が見つかり、どのバージョンであるか

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

  • 更新のインストールがトリガーされたとき
  • __CAPGO_KEEP_0__
  • __CAPGO_KEEP_1__
  • android studio
  • ネイティブのアップデートステップで発生するエラー

ログに表示される可能性のある一般的なAndroid固有の問題には次のものがあります:

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

iOSログ

「iOSログ」セクション

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

  1. デバイスを接続するかシミュレータを起動する
  2. Xcodeを開き、「Window > Devices and Simulators」に移動する
  3. デバイスを選択し、「Open Console」にクリックする
  4. In the console output, look for any lines that include Capgo to find the SDK logs

You can also use the log stream コマンドをターミナルで実行し、 Capgo を指定してログをフィルタリングする

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

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

iOS固有の問題としてログに表示されるものには、

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

Electron ログ

Electron ログ

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

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

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

プラットフォームを問わず、ネイティブログは、より低レベルのアップデートプロセスに関する詳細情報を提供し、ネイティブ実装に関する詳細情報を提供します。 Capgo の JavaScript レイヤー外で発生する問題を特定するには、特に便利です。

When troubleshooting a tricky live update problem, it’s a good idea to capture both the Capgo debug logs and the native logs for a comprehensive picture of what’s happening. The two logs together will give you the best chance of identifying and resolving the issue.

更新が適用されない

Section titled “Updates not applying”

更新が適用されない

  • If you’ve uploaded a bundle but aren’t seeing the changes on your device: CapacitorUpdater.notifyAppReady() in your app code as shown in the Capacitorの
  • Check that your device is connected to the internet and the Capgo debug logs show the update was downloaded
  • Check that your device is connected to the internet and the __CAPGO_KEEP_0__ debug logs show the update was downloaded
  • Try fully closing and reopening the app, as updates are only applied on a fresh launch

Look for any errors in the native logs that might indicate a problem applying the update Refer to the "Capgoのlive updatesのデプロイ" __CAPGO_KEEP_0__の詳細な更新プロセスについては、 npx @capgo/cli@latest app debug コマンドとネイティブログを使用して、起こっていることについてより多くの情報を取得することができます。

一般的な更新失敗コード

「一般的な更新失敗コード」のセクション

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

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

あなたがSDK __CAPGO_KEEP_1__のインストールに苦労している場合、以下のことを確認してください:

Section titled “SDK Installation”

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

  • あなたのアプリは、Capacitor (4.0 またはそれ以降のバージョン) をサポートしているバージョンを使用しています。
  • CI/CD インテグレーション CI/CD インテグレーション steps in order, including syncing your app after installing the SDK

CI/CD インテグレーション

CI/CD インテグレーション

For issues with triggering Capgo uploads from your CI/CD pipeline:

  • Double check your Capgo authentication token is set up correctly
  • CI/CD インテグレーション
  • CI/CD インテグレーション

CI/CD インテグレーション CI/CD インテグレーション docsからさらにトラブルシューティングのヒントを取得することができます。 npx @capgo/cli@latest app debug コマンドを使用して、CI/CDによってトリガーされる更新がアプリケーションに受け取られているかどうかを確認することができます。

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

トラブルシューティングのセクションのタイトル “トラブルシューティングから続けて”

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