Используйте альтернативные методы установки

Обычно пользователи 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.
  • Идентификатор расширения . Его можно найти в URL-адресе расширения в Интернет-магазине Chrome.

Идентификатор товара в Интернет-магазине Chrome

Установить из локального файла CRX

Если вы распространяете среди пользователей Linux локальный файл, вам необходимо упаковать файл CRX и записать следующую информацию:

  • Идентификатор расширения — его можно найти на странице управления расширениями chrome://extensions .

  • Версия расширения — отображается на странице управления расширениями chrome://extensions или в файле JSON манифеста.

Как узнать идентификатор и версию расширения

  • Расположение файла CRX . Это может быть локальный каталог или общий сетевой ресурс. Убедитесь, что файл доступен на компьютере, на котором вы хотите установить расширение.

Установка с личного сервера

Если вы распространяете расширение, размещенное на личном сервере для пользователей Linux, вам необходимо следовать инструкциям по установке расширений в Linux и принять к сведению следующую информацию:

  • Идентификатор расширения — его можно найти на странице управления расширениями chrome://extensions .

  • Путь к XML-файлу update_url — он должен совпадать с путем к полю update_url , объявленному в файле JSON манифеста.

В следующих примерах предполагается, что версия — 1.0, а идентификатор расширения — aaabbbcccdddeeefff.

Использовать файл настроек

macOS

  1. Создайте файл 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. Запустите консольную программу. Вы можете найти его в разделе /Приложения/Утилиты/Консоль.
  2. Если на крайнем левом значке консоли написано «Показать список журналов», щелкните этот значок. Слева появится второй столбец.
  3. Нажмите «Консольные сообщения» на левой панели.
  4. Найдите строку. Невозможно прочитать внешние расширения . Если возникнет проблема с чтением файлов внешних расширений, вы увидите сообщение об ошибке. Найдите другое сообщение об ошибке непосредственно перед ним, которое должно объяснить проблему. Например, если вы видите следующую ошибку: «Путь /Library/Application Support/Google/Chrome принадлежит не той группе», вам необходимо использовать chgrp или диалоговое окно «Получить информацию» Finder, чтобы изменить владельца группы каталога на группу «Администраторы». .
  5. После устранения проблемы перезапустите Chrome. Проверьте, установлено ли внешнее расширение. Вполне возможно, что одна ошибка разрешений не позволяет Chrome обнаружить вторую ошибку. Если внешнее расширение не было установлено, повторяйте эти действия, пока не увидите ошибку в консольном приложении.

Линукс

  1. Создайте файл JSON с именем идентификатора расширения. Например: aaabbbcccdddeeefff.json .

  2. Поместите его в одну из следующих папок:

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

  3. В следующем списке описана установка расширения из Интернет-магазина Chrome, файла CRX или личного сервера:

    • Чтобы установить расширение Интернет-магазина Chrome , укажите URL-адрес обновления с именем поля «external_update_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» и т. д. Если выбран другой локаль браузера, который не поддерживается расширением , внешние расширения будут удалены. Если список «поддерживаемые_локали» отсутствует, расширение будет установлено для любой локали. Например:

{
  "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 с тем же именем, что и идентификатор вашего расширения. Например: aaabbbcccdddeeefff .

  3. В ключе расширения создайте свойство update_url и установите для него следующее значение: json { "update_url": "https://clients2.google.com/service/update2/crx" }

  4. Запустите Хром.

  5. Перейдите на chrome://extensions ; вы должны увидеть расширение в списке.

Обновление и удаление

Google Chrome сканирует записи метаданных в настройках и реестре каждый раз при запуске браузера и вносит все необходимые изменения в установленные внешние расширения, размещенные в Интернет-магазине Chrome.

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

Чтобы удалить расширение (например, если ваше программное обеспечение удалено), удалите файл настроек (например, aaabbbcccdddeeefff.json ) или метаданные из реестра.

Часто задаваемые вопросы

В этом разделе приведены ответы на распространенные вопросы о внешних расширениях.

Поддерживается ли «предварительная установка» Google Chrome?

Да, но только при установке из Интернет-магазина Chrome update_url , а не по локальному пути CRX. Дополнительную информацию см. в разделе Политики приложений и расширений .

Каковы распространенные ошибки при установке с использованием файла настроек?

  • Не указан тот же идентификатор или версия, что указаны в файле CRX.
  • Файл JSON (например, aaabbbcccdddeeefff.json ) находится в неправильном месте, или указанный идентификатор не соответствует идентификатору расширения.
  • Синтаксическая ошибка в файле JSON (забыли разделить записи запятой или где-то оставили запятую в конце).
  • Запись файла JSON указывает на неправильный путь к файлу CRX (или указан путь, но нет имени файла)
  • Обратная косая черта в пути UNC не экранируется. Например, "\\server\share\file" неверно; это должно быть "\\\\server\\share\\extension" .
  • Проблемы с разрешениями на сетевом ресурсе.

Каковы распространенные ошибки при установке с использованием реестра?

  • Не указан тот же идентификатор, который указан в Интернет-магазине Chrome.
  • Ключ создан в неправильном месте реестра.
  • Запись реестра указывает на неправильный путь к файлу CRX в Интернет-магазине Chrome.
  • Проблемы с разрешениями на сетевом ресурсе.
  • Не все экземпляры Chrome закрыты. Попробуйте перезагрузить компьютер после настройки реестра.

Что если пользователь удалит расширение?

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

Как выйти из черного списка?

Если пользователь удаляет ваше расширение, вы должны уважать это решение. Однако если вы (разработчик) случайно удалили свое расширение через пользовательский интерфейс, вы можете удалить тег черного списка, установив расширение обычным способом через пользовательский интерфейс, а затем удалив его.