カスタムブラウザのよくある問題のトラブルシューティング
この記事の内容
カスタムブラウザのよくある問題
1:拡張機能が正しくインストールされているか確認する
カスタムブラウザのインストール手順:カスタムブラウザの使用方法
上記のインストール手順に従って操作しても、インストール後に拡張機能が動作しない場合は、次の手順で原因を調査できます。
2:拡張機能のバージョンを確認する
ブラウザエンジンがChrome 75未満の場合はサポート対象外です。ブラウザのアップグレードをお勧めします。
ブラウザエンジンがChrome 75~97の場合は、V2拡張機能を使用する必要があります。
ブラウザエンジンがChrome 97以上の場合は、V3拡張機能の使用をお勧めします。
ブラウザエンジンのバージョンを確認します。
3:chromiumBrowser.configファイルを確認する
このファイルのパスは%localappdata%\DATA_FOLDER\ChromiumBrowser.configです(DATA_FOLDERは製品のデータフォルダー名を表すプレースホルダーです。実際のインストール環境のフォルダー名に置き換えてください)。次の点を確認する必要があります。
- このファイルが存在し、読み取り可能であることを確認します(ファイルが存在しない場合や、システムによってファイルの拡張子が変更されている場合は問題が発生するため、ユーザーへの連絡が必要です)。
- ファイル内に対象のカスタムブラウザの設定があり、ウィンドウ名が正しいことを確認します。以下の例で、この箇所のMainWindowClassNameが
Chrome_WidgetWin_2の場合は、手動でChrome_WidgetWin_1に変更する必要があります。 - ExePathのパスがブラウザプロセスの起動パスになっているか確認します。
4:manifestIDが一致しているか確認する
拡張機能IDが一致しているか確認します。
対象ブラウザで chrome://extensions ページを開き、拡張機能IDを確認します。拡張機能IDを表示するには、デベロッパーモードを有効にする必要があります。
manifest.jsonファイルを確認します。manifestのパスは、次のレジストリキーにあります(NATIVE_HOST_NAMEは、インストール済みのネイティブメッセージングホストの実際の登録名に置き換えるプレースホルダーです。ディレクトリ名やプロセス名ではありません。このキー名をそのまま使用しないでください)。
コンピューター\HKEY_CURRENT_USER\SOFTWARE\Google\Chrome\NativeMessagingHosts\NATIVE_HOST_NAME
または
コンピューター\HKEY_LOCAL_MACHINE\SOFTWARE\Google\Chrome\NativeMessagingHosts\NATIVE_HOST_NAME
上記のレジストリパスに記載されたmanifestファイルを開き、そのkeyと拡張機能IDを比較して、拡張機能IDが一致しているか確認します。たとえば、下図は拡張機能IDが一致していない例です。
この場合は、この箇所のIDが一致するようにする必要があります。
ブラウザ内にcrxファイルを手動でドラッグするか、展開済みのファイルを読み込みます。
ユーザーのマシン上のmanifestファイルを変更し、拡張機能IDをallowed_originsに追加します。
上記の確認操作が完了すれば、通常は正常に使用できるようになります。それでも正常に使用できない場合は、特殊な環境の問題である可能性があるため、対象ブラウザ専用のドキュメントを参照してください。
補足:
1、CRXファイルをブラウザ内にドラッグできない
- ブラウザが管理者権限で開かれていないか確認します。管理者権限で開かれている場合は、拡張機能をドラッグしてインストールできません。
- 一部のブラウザではcrxファイルのドラッグが制限されています。この場合はcrxを展開し、展開済みのファイルを読み込むことができます。
2、タブに対応するウィンドウが見つかりません。xxブラウザを再起動してください
一部のカスタムブラウザでは、バックグラウンドページが別ウィンドウで開かれず、ほかのページと同じブラウザウィンドウ内にあります。この場合、V3拡張機能では、そのブラウザウィンドウ内のすべてのタブを取得できなくなります。このようなブラウザでは、V3 3.1拡張機能を使用する必要があります。