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

Обычно пользователи Chrome устанавливают расширения, посещая список расширений в Интернет-магазине Chrome и устанавливая их непосредственно с этой страницы. Однако в некоторых случаях более подходящим может оказаться другой порядок установки. Например:

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

Примечание. Администраторы также могут использовать корпоративные политики для управления установкой расширений. Дополнительные сведения см. в разделе Политики Extension Enterprise .

В предыдущих случаях Google Chrome поддерживает следующие способы установки расширений:

• Использование файла настроек JSON (только для macOS X и Linux)
• Использование реестра Windows (только для Windows)

Оба способа поддерживают установку расширения, размещенного по адресу update_URL . В Windows и macOS update_URL должен указывать на Интернет-магазин Chrome. Если расширение установлено этими методами, пользователям Windows и macOS придется включить расширение, используя следующее диалоговое окно подтверждения:

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

Предупреждение. Установки для Windows и Mac должны осуществляться из Интернет-магазина Chrome. Начиная с Chrome 33, никакие внешние установки по пути к локальному файлу CRX в Windows не допускаются (см. Защита пользователей Windows от вредоносных расширений ). Начиная с Chrome 44, никакая внешняя установка не допускается по пути к локальному файлу CRX в Mac OS (см. Продолжение защиты пользователей Chrome от вредоносных расширений ).

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

Установите из Интернет-магазина Chrome.

Если вы распространяете расширение, размещенное в Интернет-магазине Chrome, вам необходимо сначала опубликовать расширение . Затем обратите внимание на следующее:

• URL обновления — https://clients2.google.com/service/update2/crx . Этот URL-адрес указывает на Интернет-магазин Chrome.
• Идентификатор расширения . Его можно найти в URL-адресе расширения в Интернет-магазине Chrome.

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

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

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

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

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

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

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

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

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

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

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

Примечание. Только для MacOS X и Linux: не используйте файл настроек для Windows. Вместо этого используйте реестр Windows .

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 ; вы должны увидеть расширение в списке.

Примечание. Файл внешнего расширения для всех пользователей доступен только для чтения, если каждый каталог в пути принадлежит пользователю root , имеет admin группы или wheel и не доступен для записи всем пользователям. Путь также не должен содержать символических ссылок. Эти ограничения не позволяют непривилегированному пользователю устанавливать расширения для всех пользователей. См. Устранение проблем с разрешениями .

Устранение проблем с разрешениями 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 ; вы должны увидеть расширение в списке.

Примечание. При необходимости используйте chmod , чтобы убедиться, что файлы aaabbbcccdddeeefff.json доступны для чтения всем. Дополнительную помощь можно найти в разделе часто задаваемых вопросов по типичным ошибкам файла настроек .

Поддерживаемые локали

Если вы хотите установить расширение только для некоторых локалей браузера, вы можете указать поддерживаемые локали в поле с именем «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 ; вы должны увидеть расширение в списке.

Примечание. Для получения дополнительной помощи проверьте распространенные ошибки реестра Windows .

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

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 закрыты. Попробуйте перезагрузить компьютер после настройки реестра.

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

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

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

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