通常、Chrome ユーザーは Chrome ウェブストアの拡張機能のリストにアクセスし、そのページから直接拡張機能をインストールすることで、拡張機能をインストールします。ただし、他のインストール フローのほうが適切な場合もあります。次に例を示します。
- 拡張機能は他のソフトウェアに関連付けられており、ユーザーがそのソフトウェアをインストールするたびにインストールする必要があります。
- ネットワーク管理者が、組織全体に同じ拡張機能をインストールしたいと考えています。
前述のケースでは、Google Chrome は次の拡張機能のインストール方法をサポートしています。
- 環境設定 JSON ファイルを使用する（macOS X と Linux の場合のみ）
- Windows レジストリの使用（Windows のみ）
どちらの方法でも、update_URL でホストされる拡張機能のインストールがサポートされます。Windows と macOS の場合、update_URL は Chrome ウェブストアを指定する必要があります。これらの方法で拡張機能をインストールした場合、Windows と macOS のユーザーは、次の確認ダイアログで拡張機能を有効にする必要があります。
Linux では、ユーザーのパソコン上にある Chrome ウェブストアの拡張機能、外部でホストされている拡張機能、CRX 拡張機能ファイルを環境設定ファイルで指定できます。Linux ユーザーに対して、拡張機能を有効にするよう求めるメッセージは表示されません。拡張機能は自動的にインストールされます。
始める前に
Chrome ウェブストアからインストールする
Chrome ウェブストアでホストされている拡張機能を配布する場合は、まず拡張機能を公開する必要があります。次に、以下の内容をメモします。
- 更新 URL -
https://clients2.google.com/service/update2/crxこの URL は Chrome ウェブストアを指します。 - 拡張機能の ID - 拡張機能の Chrome ウェブストア URL で確認できます。
ローカル CRX ファイルからインストールする
ローカル ファイルから Linux ユーザーに配布する場合は、CRX ファイルをパッケージ化して、次の情報に注意する必要があります。
拡張機能 ID - 拡張機能の管理ページ
chrome://extensionsで確認できます。拡張機能のバージョン - 拡張機能の管理ページ
chrome://extensionsまたはマニフェストの JSON ファイルに表示されます。
- CRX ファイルの場所 - ローカル ディレクトリまたはネットワーク共有のいずれかです。拡張機能をインストールするマシンでファイルを使用できることを確認してください。
個人用サーバーからインストールする
個人用サーバーでホストされている拡張機能を Linux ユーザーに配布する場合は、Linux に拡張機能をインストールするの手順に沿って操作し、次の情報に注意する必要があります。
拡張機能 ID - 拡張機能の管理ページ
chrome://extensionsで確認できます。update_url XML ファイルのパス - マニフェスト JSON ファイルで宣言された
update_urlフィールドのパスと一致する必要があります。
次の例では、バージョンが 1.0、拡張機能 ID が aaabbbcccdddeeefff であることを前提としています。
環境設定ファイルを使用する
macOS
- 拡張機能 ID の名前を含む JSON ファイルを作成します。例:
aaabbbcccdddeeefff.json 次のいずれかのフォルダに配置します。
- 特定のユーザー
~USERNAME/Library/Application Support/Google/Chrome/External Extensions/- すべてのユーザー
/Library/Application Support/Google/Chrome/External Extensions/
フィールド名を「external_update_url」にして更新 URL を指定します。例:
json { "external_update_url": "https://clients2.google.com/service/update2/crx" }JSON ファイルを保存します。
Google Chrome を起動して chrome://extensions に移動します。リストに拡張機能が表示されます。
Mac OS の権限に関する問題のトラブルシューティング
macOS では、すべてのユーザーの外部拡張機能ファイルが読み取られるのは、ファイル システムの権限によって権限のないユーザーによる変更が許可されている場合のみです。Chrome の起動時に外部拡張機能がインストールされていない場合は、外部拡張機能の環境設定ファイルの権限に問題がある可能性があります。これが問題の原因かどうかを確認する手順は次のとおりです。
- コンソール プログラムを起動します。/Applications/Utilities/Console にあります。
- コンソールの左端のアイコンに [ログリストを表示] と表示されている場合は、そのアイコンをクリックします。左側に 2 列目が表示されます。
- 左側のペインで [Console Messages] をクリックします。
- 「Can not read external extensions」という文字列を検索します。外部拡張ファイルの読み取り中に問題が発生すると、エラー メッセージが表示されます。問題の直前の別のエラー メッセージを探します。たとえば、「Path /Library/Application Support/Google/Chrome isowned by the wrong group」というエラーが表示された場合は、
chgrpまたは Finder の [情報を取得] ダイアログを使用して、ディレクトリのグループ オーナーを管理者グループに変更する必要があります。 - 問題を修正したら、Chrome を再起動します。外部拡張機能がインストールされていることをテストします。1 つの権限エラーで Chrome が 2 つ目のエラーを検出できない可能性もあります。外部拡張機能がインストールされていない場合は、コンソール アプリにエラーがなくなるまで上記の手順を繰り返します。
Linux
- 拡張機能 ID の名前を含む JSON ファイルを作成します。例:
aaabbbcccdddeeefff.json。 次のいずれかのフォルダに配置します。
/opt/google/chrome/extensions//usr/share/google-chrome/extensions/
次のリストは、Chrome ウェブストア、CRX ファイル、または個人用サーバーからの拡張機能のインストールを示しています。
- Chrome ウェブストアの拡張機能をインストールするには、フィールド名「external_update_url」を使用して更新 URL を指定します。たとえば、
json { "external_update_url": "https://clients2.google.com/service/update2/crx" }です。 - CRX ファイルから拡張機能をインストールするには、external_crx にロケーションを、external_version にバージョンを指定します。たとえば、
json { "external_crx": "/home/share/extension.crx", "external_version": "1.0" }です。 - 個人用サーバーでホストされている拡張機能をインストールするには、external_update_url フィールドが XML ファイルを指している必要があります。次に例を示します。
json { "external_update_url": "http://myhost.com/mytestextension/updates.xml" }
- Chrome ウェブストアの拡張機能をインストールするには、フィールド名「external_update_url」を使用して更新 URL を指定します。たとえば、
JSON ファイルを保存します。
Google Chrome を起動して chrome://extensions に移動します。リストに拡張機能が表示されます。
サポートされている言語 / 地域
一部のブラウザ ロケールに対してのみ拡張機能をインストールする場合は、フィールド名「supported_locales」にサポートされているロケールを指定できます。ロケールでは、「en」などの親ロケールを指定できます。この場合、拡張機能は「en-US」や「en-GB」など、すべての英語ロケールにインストールされます。拡張機能でサポートされていない別のブラウザ ロケールが選択されている場合、外部拡張機能はアンインストールされます。「supported_locales」リストがない場合、任意のロケールに対して拡張機能がインストールされます。 次に例を示します。
{
"external_update_url": "https://clients2.google.com/service/update2/crx",
"supported_locales": [ "en", "fr", "de" ]
}
Windows レジストリを使用する
レジストリで次のキーを検索または作成します。
- 32 ビット Windows
HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions- 64 ビット Windows
HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions
Extensions キーの下に、拡張機能の ID と同じ名前で新しいキー（フォルダ）を作成します。例:
aaabbbcccdddeeefff拡張機能キーで「update_url」プロパティを作成し、
json { "update_url": "https://clients2.google.com/service/update2/crx" }の値に設定します。Chrome を起動します。
chrome://extensions に移動します。拡張機能がリストに表示されます。
更新とアンインストール
Google Chrome はブラウザが起動するたびに設定とレジストリのメタデータ エントリをスキャンし、Chrome ウェブストアでホストされているインストール済みの外部拡張機能に必要な変更を加えます。
ローカルの CRX ファイル拡張子を新しいバージョンに更新するには、ファイルを更新してから、設定 JSON ファイル内のバージョンを更新します。
拡張機能をアンインストールするには（ソフトウェアをアンインストールした場合など）、設定ファイル（aaabbbcccdddeeefff.json など）やメタデータをレジストリから削除します。
よくある質問
このセクションでは、外部拡張機能に関するよくある質問に回答します。
Google Chrome では「プリインストール」はサポートされていますか？
はい。ただし、Chrome ウェブストアの update_url からのインストールとしてのみ可能です。ローカルの CRX パスからのインストールは行いません。詳細については、アプリと拡張機能のポリシーをご覧ください。
環境設定ファイルと一緒にインストールするときによくある間違いは何ですか？
- CRX ファイルに記載されている ID またはバージョンと同じ ID またはバージョンを指定していない。
- JSON ファイル（
aaabbbcccdddeeefff.jsonなど）の場所が間違っているか、指定された ID が拡張機能 ID と一致していません。 - JSON ファイルの構文エラー（カンマでエントリを区切るのを忘れた、または末尾にカンマが残っている）。
- JSON ファイル エントリが CRX ファイルへの間違ったパスを指している（またはパスは指定されているがファイル名がない）
- UNC パスのバックスラッシュはエスケープされません。たとえば、
"\\server\share\file"は誤りです。これは"\\\\server\\share\\extension"にする必要があります。 - ネットワーク共有での権限の問題。
レジストリと一緒にインストールするときによくある間違いは何ですか？
- Chrome ウェブストアに記載されている ID と同じ ID を指定していない。
- レジストリの間違った場所にキーが作成されました。
- レジストリのエントリが Chrome ウェブストアの CRX ファイルへの誤ったパスを指している。
- ネットワーク共有での権限の問題。
- Chrome のすべてのインスタンスが終了しているわけではありません。レジストリを設定したら、パソコンを再起動してみてください。
ユーザーが拡張機能をアンインストールした場合はどうなりますか？
ユーザーが UI から拡張機能をアンインストールすると、起動するたびにインストールや更新は行われなくなります。つまり、外部拡張機能がブロックリストに登録されています。
ブロックリストから削除するにはどうすればよいですか？
ユーザーが拡張機能をアンインストールした場合は、その決定を尊重する必要があります。ただし、デベロッパーが UI から誤って拡張機能をアンインストールした場合は、UI から拡張機能を通常どおりインストールしてからアンインストールすることで、ブロックリスト タグを削除できます。