分发扩展的替代方法

项目
12/14/2023

通常，扩展通过 Microsoft Edge 加载项网站分发。在某些情况下，开发人员可能需要使用备用方法分发扩展。例如：

扩展与其他软件相关联，应将其与其他捆绑软件一起安装。
网络管理员希望在整个组织中分发扩展。

未从 Edge 加载项存储区加载的扩展称为外部安装的扩展。以下是分发外部安装的扩展的备用方法：

使用 Windows 注册表 (仅限 Windows) 。
(macOS 和 Linux) 使用首选项 JSON 文件。

下面介绍了这些方法。

开始之前

请确保在 Microsoft Edge 加载项网站上发布扩展，或打包 .crx 文件并确保它成功安装在计算机上。如果使用安装 .crx 文件， update_url请确保可以转到该 URL 处的扩展。

此外，请确保你拥有以下信息：

文件的文件路径 .crx 或 update_url 扩展名的。
扩展的版本。在加载打包的扩展后，可在清单文件中或在 Microsoft Edge edge://extensions 中获取版本信息。
扩展的 ID。加载打包的扩展后，MICROSOFT Edge edge://extensions 中提供了 ID 信息。

以下示例将 1.0 用作版本，并将 aaaaaaaabbbbbbbbccccccccdddddddd 用作 ID。

将 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 指向 .crx Microsoft Edge 加载项网站上的扩展文件。
```
{
    "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
}
```
注意

如果要从 Chrome Web Store 安装扩展，请将的值 update_url 设置为 https://clients2.google.com/service/update2/crx。
在 Microsoft Edge 中，转到 edge://extensions，然后验证是否已列出扩展。

(macOS 和 Linux) 使用首选项 JSON 文件

若要使用首选项 JSON 文件分发扩展，请执行以下操作：

使用 Linux 时，请确保 .crx 扩展文件在将安装扩展的计算机上可用。将 .crx 扩展文件复制到本地目录，或使用可从计算机访问的网络共享。
创建一个 JSON 文件，其中文件名对应于扩展名的 ID。例如，创建名为 aaaaaaaabbbbbbbbccccccccdddddddd.json的 JSON 文件。

首选项 JSON 文件的名称是 Microsoft Edge 扩展的 CRX ID，后跟扩展名 .json 。 CRX ID 是一个唯一的 32 个字符的代码，它是扩展 URL 末尾存在的字母。
根据操作系统，将 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_crxexternal_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 加载项网站安装时，请将以下代码复制到首选项 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 文件，或从注册表中删除密钥。

另请参阅：

扩展的清单文件格式

阻止扩展

当企业想要在客户端计算机上安装或阻止特定扩展时，将使用、块列表和 ExtensionSettings 的策略ExtensionInstallForcelist。 ExtensionInstallForcelist、ExtensionInstallSources 或 ExtensionSettings 中配置的扩展及其源优先于 BlockExternalExtensions。

如果策略 BlockExternalExtensions 设置为 Not Configured 或 Disabled，则没有任何影响。如果策略 BlockExternalExtensions 设置为 Enabled，则阻止第三方软件) (外部扩展安装。

注意

此页面的部分内容是基于 Google 创建和共享的工作进行的修改，并根据 Creative Commons 署名 4.0 国际许可中所述的条款使用。原始页面在此处找到。

此作品根据 Creative Commons 署名 4.0 国际许可获得许可。