Альтернативные способы распространения расширений

Статья
12/14/2023

Как правило, расширения распространяются через веб-сайт надстроек Microsoft Edge. Существует несколько сценариев, в которых разработчикам может потребоваться распространять расширения с помощью альтернативных методов. Например:

Расширение связано с другим программным обеспечением и должно быть установлено вместе с остальным пакетным программным обеспечением.
Сетевые администраторы хотят распространить расширение по всей организации.

Расширения, которые не загружаются из хранилища надстроек Edge, называются расширениями, установленными извне. Ниже приведены альтернативные методы распространения внешних установленных расширений.

Используйте реестр Windows (только для Windows).
Используйте JSON-файл параметров (macOS и Linux).

Эти подходы описаны ниже.

Прежде чем начать

Обязательно опубликуйте расширение на веб-сайте надстроек Microsoft Edge или упаковайте .crx файл и убедитесь, что оно успешно установлено на компьютере. Если вы устанавливаете .crx файл с помощью update_url, убедитесь, что вы можете перейти к расширению по указанному URL-адресу.

Кроме того, убедитесь, что у вас есть следующие сведения:

Путь к файлу .crx или update_url расширение.
Версия расширения. Сведения о версии доступны в файле манифеста или в Microsoft Edge по адресу edge://extensions после загрузки упакованного расширения.
Идентификатор расширения. Сведения об идентификаторе доступны в Microsoft Edge по адресу edge://extensions после загрузки упакованного расширения.

В следующих примерах используется 1.0 в качестве версии и aaaaaaaabbbbbbbbccccccccdddddddd для идентификатора.

Использование реестра Windows (только для Windows)

Чтобы распространить расширение с помощью реестра Windows, выполните следующие действия.

Найдите или создайте следующий раздел в реестре:
- 32-разрядная версия Windows: HKEY_LOCAL_MACHINE\Software\Microsoft\Edge\Extensions
- 64-разрядная версия Windows: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\Edge\Extensions
Создайте новый ключ или папку в разделе Расширения с тем же именем, что и идентификатор расширения. Например, создайте ключ с именем aaaaaaaabbbbbbbbccccccccdddddddd.
В разделе Расширения создайте update_url свойство и присвойте ей значение https://edge.microsoft.com/extensionwebstorebase/v1/crx. Свойство update_url указывает на .crx файл расширения на веб-сайте надстроек Microsoft Edge.
```
{
    "update_url": "https://edge.microsoft.com/extensionwebstorebase/v1/crx"
}
```
Примечание.

Если вы хотите установить расширение из Интернет-магазина Chrome, задайте для параметра значение update_urlhttps://clients2.google.com/service/update2/crx.
В Microsoft Edge перейдите по адресу edge://extensions, а затем убедитесь, что ваше расширение указано в списке.

Использование JSON-файла параметров (macOS и Linux)

Чтобы распространить расширение с помощью JSON-файла параметров, выполните следующее:

При использовании Linux убедитесь, что .crx файл расширения доступен на компьютере, на котором будет установлено расширение. Скопируйте файл расширения в .crx локальный каталог или используйте сетевую папку, доступную с компьютера.
Создайте JSON-файл, в котором имя файла соответствует идентификатору расширения. Например, создайте JSON-файл с именем aaaaaaaabbbbbbbbccccccccdddddddd.jsonфайла .

Имя JSON-файла параметров — это идентификатор CRX расширения Microsoft Edge, за которым следует .json расширение. Идентификатор CRX — это уникальный 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_crx и external_version:
```
{
    "external_crx": "/home/share/extension.crx",
    "external_version": "1.0"
}
```
- Применимо к macOS и Linux. При установке из update_urlукажите URL-адрес обновления в external_update_url.
  
  Скопируйте следующий код в JSON-файл параметров при установке только из локальных .crx файлов в Linux:
```
{
    "external_update_url": "http://myhost.com/mytestextension/updates.xml"
}
```
- Скопируйте следующий код в JSON-файл параметров при установке с веб-сайта надстроек Microsoft Edge в macOS и Linux:
```
{
    "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" ]
}
```
Убедитесь, что расширение установлено в Microsoft Edge, перейдя по адресу edge://extensions.

Обновление и удаление внешних установленных расширений

Microsoft Edge проверяет записи метаданных в реестре при каждом запуске браузера и вносит любые изменения в установленные извне расширения.

Чтобы обновить расширение до новой версии, обновите version строку в файле манифеста расширения, а затем обновите версию в реестре.

Возможно, потребуется удалить внешние расширения, которые были установлены в составе пакета программного обеспечения, установленного ранее на компьютере. Чтобы удалить расширение, удалите JSON-файл параметров или раздел из реестра.

См. также:

Формат файла манифеста для расширений

Блокировка расширений

Политики для ExtensionInstallForcelist, списка блокировок и ExtensionSettings используются, когда предприятия хотят установить или заблокировать определенные расширения на клиентских компьютерах. Расширения и их источник, настроенные в ExtensionInstallForcelist, ExtensionInstallSources или ExtensionSettings , имеют приоритет над BlockExternalExtensions.

BlockExternalExtensions Если для политики задано значение Not Configured или Disabled, это не оказывает никакого влияния. BlockExternalExtensions Если для политики задано значение Enabled, установка внешнего расширения (сторонним программным обеспечением) не допускается.

Примечание.

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой Google и используемой в соответствии с условиями, описанными в международной лицензии Creative Commons Attribution 4.0. Исходная страница находится здесь.

Эта работа лицензируется по международной лицензии Creative Commons Attribution 4.0.