拡張機能を配布する別の方法

[アーティクル]
09/25/2024

一般に、拡張機能は Microsoft Edge アドオン Web サイトを通じて配布されます。開発者が別の方法を使用して拡張機能を配布する必要があるシナリオがいくつかあります。以下に例を示します。

拡張機能は他のソフトウェアに関連付けられています。バンドルされたソフトウェアの残りの部分と一緒にインストールする必要があります。
ネットワーク管理者は、organization全体に拡張機能を配布したいと考えています。

Edge アドオンストアから読み込まれていない拡張機能は、 外部にインストールされた拡張機能と呼ばれます。外部にインストールされた拡張機能を配布する別の方法を次に示します。

Windows レジストリを使用します (Windows のみ)。
基本設定 JSON ファイル (macOS および Linux) を使用します。

これらのアプローチを以下に説明します。

初期情報の収集

Microsoft Edge アドオン Web サイトで拡張機能を発行するか、 .crx ファイルをパッケージ化し、コンピューターに正常にインストールされていることを確認します。 update_urlを使用して.crx ファイルをインストールする場合は、その URL で拡張機能に移動できることを確認してください。

また、次の情報があることを確認します。

.crx ファイルのファイルパス、または拡張機能のupdate_url。
拡張機能のバージョン。バージョン情報は、マニフェストファイル、またはパックされた拡張機能を読み込んだ後、 edge://extensions の Microsoft Edge で入手できます。
拡張機能の ID。 ID 情報は、パックされた拡張機能を読み込んだ後 edge://extensions Microsoft Edge で入手できます。

次の例では、バージョンとして 1.0 を使用し、ID に aaaaaaaabbbbbbbbccccccccdddddddd します。

Windows レジストリの使用 (Windows のみ)

Windows レジストリを使用して拡張機能を配布するには:

レジストリで次のキーを検索または作成します。
- 32 ビット Windows: HKEY_LOCAL_MACHINE\Software\Microsoft\Edge\Extensions
- 64 ビット Windows: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\Edge\Extensions
拡張機能の ID と同じ名前の [ 拡張機能 ] で、新しいキーまたはフォルダーを作成します。たとえば、 aaaaaaaabbbbbbbbccccccccddddddddという名前のキーを作成します。
Extensions キーで、update_url プロパティを作成し、値を https://edge.microsoft.com/extensionwebstorebase/v1/crx に設定します。 update_url プロパティは、Microsoft Edge アドオン Web サイトの拡張機能の.crx ファイルを指します。
```
{
    "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
}
```
Chrome Web ストアから拡張機能をインストールする場合は、[ update_url ] の値を [ https://clients2.google.com/service/update2/crx] に設定します。
Microsoft Edge で、[ edge://extensions] に移動し、拡張機能が一覧表示されていることを確認します。

基本設定 JSON ファイル (macOS および Linux) の使用

基本設定 JSON ファイルを使用して拡張機能を配布するには:

Linux を使用する場合は、 .crx 拡張機能ファイルが、拡張機能がインストールされるコンピューターで使用できることを確認します。 .crx拡張機能ファイルをローカルディレクトリにコピーするか、コンピューターから到達可能なネットワーク共有を使用します。
ファイルの名前が拡張機能の ID に対応する JSON ファイルを作成します。たとえば、ファイル名が aaaaaaaabbbbbbbbccccccccdddddddd.jsonされた JSON ファイルを作成します。

基本設定 JSON ファイルの名前は、Microsoft Edge 拡張機能の CRX ID で、その後に .json 拡張子が続きます。 CRX ID は、拡張機能の URL の末尾に存在する文字である一意の 32 文字コードです。
オペレーティングシステムに応じて、JSON ファイルを次のいずれかのフォルダーに保存します。
- macOS
  - ユーザー固有: ~USERNAME/Library/Application Support/Microsoft Edge/External Extensions/
  - すべてのユーザーの場合: /Library/Application Support/Microsoft/Edge/External Extensions/
  承認されていないユーザーがすべてのユーザーの拡張機能をインストールできないようにするには、拡張機能の基本設定ファイルが読み取り専用であることを確認します。
  
  また、次の条件が満たされていることを確認します。
  - パス内のすべてのディレクトリは、ユーザールートによって所有されます。
  - パス内のすべてのディレクトリは、 admin または wheel グループに割り当てられます。
  - パス内のすべてのディレクトリは書き込み可能 world ではありません。
  - パスにはシンボリックリンクが含まれている必要があります。
- Linux
  - ユーザー固有: ~/.config/microsoft-edge/External Extensions/
  - すべてのユーザーの場合: /usr/share/microsoft-edge/extensions/
シナリオに応じて、次の適切なコードを基本設定の JSON ファイルにコピーします。
- Linux にのみ適用されます。ファイルからインストールする場合は、 external_crx と external_versionで場所とバージョンを指定します。
```
{
   "external_crx": "/home/share/extension.crx",
   "external_version": "1.0"
}
```
- macOS と Linux に適用されます。 update_urlからインストールする場合は、external_update_urlで更新 URL を指定します。
  
  Linux 上のローカル .crx ファイルからのみインストールする場合は、次のコードをユーザー設定の JSON ファイルにコピーします。
```
{
   "external_update_url": "http://myhost.com/mytestextension/updates.xml"
}
```
- macOS と Linux の Microsoft Edge アドオン Web サイトからインストールするときに、次のコードをユーザー設定の JSON ファイルにコピーします。
```
{
   "external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
}
```
特定のロケールの拡張機能をインストールするには、サポートされているロケールを supported_localesに一覧表示します。

親ロケールを指定して、その親を使用するすべての言語ロケールの拡張機能をインストールできます。たとえば、親ロケール enを使用する場合、拡張機能は、 en-US、 en-GBなど、すべての英語ロケールに対してインストールされます。ユーザーがブラウザーでロケールを変更すると、外部にインストールされた拡張機能がアンインストールされます。任意のロケールの拡張機能をインストールするには、supported_localesを使用しないでください。
```
{
   "external_update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx",
   "supported_locales": [ "en", "fr", "de" ]
}
```
[ edge://extensions] に移動して、拡張機能が Microsoft Edge にインストールされていることを確認します。

外部にインストールされた拡張機能を更新してアンインストールする

Microsoft Edge は、ブラウザーが起動するたびにレジストリ内のメタデータエントリをスキャンし、外部にインストールされている拡張機能に変更を加えます。

拡張機能を新しいバージョンに更新するには、拡張機能マニフェストファイルの version 文字列を更新し、レジストリのバージョンを更新します。

コンピューターに以前にインストールされたソフトウェアのバンドルの一部としてインストールされた、外部にインストールされた拡張機能をアンインストールする必要がある場合があります。拡張機能をアンインストールするには、ユーザー設定の JSON ファイルを削除するか、レジストリからキーを削除します。

拡張機能のブロック

ExtensionInstallForcelist、ブロックリスト、およびExtensionSettingsのポリシーは、企業がクライアントマシンに特定の拡張機能をインストールまたはブロックする場合に使用されます。 ExtensionInstallForcelist、ExtensionInstallSources、または ExtensionSettings で構成されている拡張機能とその配信元は、BlockExternalExtensions よりも優先されます。

BlockExternalExtensions ポリシーが Not Configured または Disabled に設定されている場合、影響はありません。 BlockExternalExtensions ポリシーが Enabled に設定されている場合、外部拡張機能のインストール (サードパーティ製ソフトウェアによる) は禁止されます。

次の方法で共有

拡張機能を配布する別の方法

初期情報の収集

Windows レジストリの使用 (Windows のみ)

基本設定 JSON ファイル (macOS および Linux) の使用

外部にインストールされた拡張機能を更新してアンインストールする

拡張機能のブロック

関連項目

フィードバック

その他のリソース