別のインストール方法を使用する

通常、Chrome ユーザーは Chrome ウェブストアで拡張機能のリスティングにアクセスし、そのページから直接拡張機能をインストールします。ただし、他のインストール フローの方が適している場合もあります。例:

  • 拡張機能は他のソフトウェアに関連付けられており、ユーザーがそのソフトウェアをインストールするたびにインストールする必要があります。
  • ネットワーク管理者が組織全体に同じ拡張機能をインストールしたいと考えています。

上記のケースでは、Google Chrome は次の拡張機能のインストール方法をサポートしています。

どちらの方法でも、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 で確認できます。

Chrome ウェブストアのアイテム ID

ローカル CRX ファイルからインストールする

ローカル ファイルから Linux ユーザーに配布する場合は、CRX ファイルをパッケージ化し、次の情報をメモしておく必要があります。

  • 拡張機能 ID - 拡張機能の管理ページ chrome://extensions で確認できます。

  • 拡張機能のバージョン - 拡張機能管理ページ chrome://extensions またはマニフェスト JSON ファイルに表示されます。

拡張機能 ID とバージョンを確認する方法

  • CRX ファイルの場所 - ローカル ディレクトリまたはネットワーク共有のいずれかです。拡張機能をインストールするマシンでファイルが利用できることを確認してください。

個人用サーバーからインストールする

Linux ユーザー向けに個人サーバーでホストされている拡張機能を配布する場合は、Linux に拡張機能をインストールするの手順に沿って、次の情報をメモしてください。

  • 拡張機能 ID - 拡張機能の管理ページ chrome://extensions で確認できます。

  • update_url XML ファイルのパス - マニフェストの JSON ファイルで宣言されている update_url フィールドのパスと一致する必要があります。

次の例では、バージョンが 1.0 で、拡張機能 ID が aaabbbcccdddeeefff であることを前提としています。

設定ファイルを使用する

macOS

  1. 拡張 ID の名前を持つ JSON ファイルを作成します。例: aaabbbcccdddeeefff.json

  2. 次のいずれかのフォルダに配置します。

    特定のユーザー用
    ~USERNAME/Library/Application Support/Google/Chrome/External Extensions/
    すべてのユーザー向け
    /Library/Application Support/Google/Chrome/External Extensions/

  3. 更新 URL をフィールド名「external_update_url」で指定します。次に例を示します。json { "external_update_url": "https://clients2.google.com/service/update2/crx" }

  4. JSON ファイルを保存します。

  5. Google Chrome を起動して chrome://extensions に移動します。拡張機能が表示されます。

Mac OS の権限に関する問題のトラブルシューティング

macOS では、ファイル システム権限によって権限のないユーザーが変更できない場合にのみ、すべてのユーザーの外部拡張機能ファイルが読み取られます。Chrome の起動時にインストールされている外部拡張機能が表示されない場合は、外部拡張機能の設定ファイルに権限の問題がある可能性があります。この問題かどうかを確認する手順は次のとおりです。

  1. Console プログラムを起動します。/Applications/Utilities/Console の下にあります。
  2. コンソールの左端のアイコンに「Show Log List」と表示されている場合は、そのアイコンをクリックします。左側に 2 つ目の列が表示されます。
  3. 左側のペインで [コンソール メッセージ] をクリックします。
  4. 文字列「Can not read external extensions」を検索します。外部の拡張機能ファイルの読み取りで問題が発生すると、エラー メッセージが表示されます。その直前に別のエラー メッセージがないか確認します。そこに問題の説明が記載されているはずです。たとえば、「パス /Library/Application Support/Google/Chrome は間違ったグループが所有しています」というエラーが表示された場合は、chgrp または Finder の [情報] ダイアログを使用して、ディレクトリのグループ所有者を管理者グループに変更する必要があります。
  5. 問題を解決したら、Chrome を再起動します。外部拡張機能がインストールされたことをテストします。1 つの権限エラーにより、Chrome で 2 つ目のエラーが検出されないことがあります。外部拡張機能がインストールされていない場合は、Console アプリケーションにエラーが表示されなくなるまで、上記の手順を繰り返します。

Linux

  1. 拡張 ID の名前を持つ JSON ファイルを作成します。例: aaabbbcccdddeeefff.json。

  2. 次のいずれかのフォルダに配置します。

    • /opt/google/chrome/extensions/
    • /usr/share/google-chrome/extensions/

  3. 次のリストは、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" }

  4. JSON ファイルを保存します。

  5. 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 レジストリを使用する

  1. レジストリで次のキーを探すか、作成します。

    32 ビット Windows
    HKEY_LOCAL_MACHINE\Software\Google\Chrome\Extensions
    64 ビット Windows
    HKEY_LOCAL_MACHINE\Software\Wow6432Node\Google\Chrome\Extensions

  2. Extensions キーの下に、拡張機能の ID と同じ名前で新しいキー（フォルダ）を作成します。例: aaabbbcccdddeeefff。

  3. 拡張機能キーで「update_url」プロパティを作成し、次の値に設定します。 json { "update_url": "https://clients2.google.com/service/update2/crx" }

  4. Chrome を起動します。

  5. chrome://extensions にアクセスすると、拡張機能が表示されます。

アップデートとアンインストール

Google Chrome は、ブラウザの起動時に設定とレジストリのメタデータ エントリをスキャンし、Chrome ウェブストアでホストされているインストール済みの外部拡張機能に必要な変更を加えます。

ローカルの CRX ファイル拡張機能を新しいバージョンに更新するには、ファイルを更新してから、設定 JSON ファイルのバージョンを更新します。

拡張機能をアンインストールするには（ソフトウェアがアンインストールされている場合など）、レジストリから設定ファイル（aaabbbcccdddeeefff.json など）またはメタデータを削除します。

よくある質問

このセクションでは、外部拡張機能に関するよくある質問とその回答をご紹介します。

Google Chrome では「プリインストール」は引き続きサポートされていますか？

はい。ただし、ローカルの CRX パスからではなく、Chrome ウェブストアの update_url からインストールする必要があります。詳しくは、アプリと拡張機能のポリシーをご覧ください。

環境設定ファイルを使用してインストールするときによくあるミスは何ですか？

  • 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 から通常どおりに拡張機能をインストールしてからアンインストールすることで、ブロックリストタグを削除できます。