Рекомендации по предупреждению о разрешении

Расширения Chrome улучшают работу пользователя в браузере. Для этого расширения используют API-интерфейсы Chrome , для которых требуются определенные разрешения. Некоторые разрешения менее навязчивы и не отображают предупреждения. Другие разрешения вызывают предупреждение, которое пользователи должны разрешить. На этой странице представлены рекомендации по работе с предупреждениями о разрешениях. Конкретные предупреждения указаны в Разрешениях под разрешениями, к которым они применяются.

Пример предупреждений о разрешениях отображается, когда пользователь добавляет новое расширение.
Рис. 1. Диалоговое окно с предупреждениями о разрешениях, отображаемое при установке.

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

Пример расширения, которое отключено до тех пор, пока пользователь не примет новое разрешение.
Рисунок 2. Расширение, которое отключено до тех пор, пока пользователь не примет новое разрешение.

Некоторые разрешения могут не отображать предупреждения в сочетании с другими разрешениями. Например, предупреждение "tabs" не будет отображаться, если расширение также запрашивает "<all_urls>" .

Лучшие практики

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

Запросить соответствующие разрешения
Расширения необходимы для достижения единственной цели и соответствуют политике использования разрешений . Убедитесь, что вы запрашиваете только те разрешения, которые поддерживают основные функции расширения.
Используйте дополнительные разрешения
Улучшите процесс регистрации, запрашивая разрешения во время выполнения. Это позволяет предоставить больше контекста для конкретного разрешения и позволяет пользователям выбирать, какие функции они хотят включить. Подробности реализации см. в разделе Permissions API .
Используйте разрешение «activeTab»
Это разрешение не отображает предупреждение о разрешении. Он предоставляет временное разрешение хоста для сайта, на котором находится пользователь. Подробности см. в разделе Общие сведения о разрешении activeTab .

Просмотр предупреждений

Чтобы просмотреть предупреждения о разрешениях расширения, у вас есть следующие варианты:

Используйте инструмент тестирования обновлений расширений

Прежде чем вы начнете

  1. Установите Node.js и NPM.
  2. Установите Хромиум .
  3. Клонируйте репозиторий инструмента тестирования обновлений расширений .
  4. Запустите npm install в корне репозитория.

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

  1. Запустите npm start .
  2. Откройте локальный сервер по адресу http://localhost:8080 в Chromium.
  3. Перетащите распакованное расширение (папку или ZIP-файл) на страницу.
  4. Следуйте инструкциям в разделе «Установить вручную», чтобы загрузить и установить расширение.

Упаковав расширение вручную

  1. Перейдите к chrome://extensions
  2. Включить режим разработчика
  3. Нажмите Расширение пакета .
    Расширение пакета
    Рисунок 3. Режим разработчика включен на странице управления расширениями.
  4. Укажите путь к папке расширения в поле корневого каталога расширения. Игнорируйте поле «Частный ключ» для первого пакета.

  5. Нажмите кнопку «Упаковать расширение» .

    Укажите путь расширения, затем нажмите «Упаковать расширение».
    Рис. 4. Указание пути расширения.

  6. Chrome создаст два файла: файл .crx и файл .pem . Файл .pem содержит закрытый ключ, используемый для подписи расширения. Обязательно помните, в каком каталоге были сохранены эти файлы.

    Упакованные файлы расширений
    Рис. 5. Упакованные файлы расширений.

  7. Храните файл .pem в секретном и безопасном месте; это будет необходимо для обновления расширения.

  8. Установите файл .crx , перетащив его на страницу управления расширением.

    Перетащите файл для установки
    Рисунок 6. Перетащите файл для установки.

  9. После удаления файла .crx браузер спросит, можно ли добавить расширение, и отобразит предупреждения.

    Предупреждение о расширении новой вкладки
    Рисунок 7. Предупреждение о расширении «Новая вкладка».

Обновить разрешения

Когда расширение добавляет новое разрешение, вызывающее предупреждение, оно может временно отключить его. Расширение будет повторно включено только после того, как пользователь согласится принять новое разрешение.

Чтобы проверить, будет ли ваше расширение отключено при добавлении нового разрешения, у вас есть следующие варианты:

Обновление с помощью инструмента тестирования обновлений расширений.

Эти шаги предполагают, что вы следовали инструкциям «Использование средства тестирования обновлений расширений» для запуска сервера.

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

  1. Добавьте новое разрешение с предупреждением .
  2. Увеличьте номер версии расширения.
  3. Перетащите распакованное расширение (папку или ZIP-файл) на страницу.
  4. Перейдите на chrome://extensions .
  5. Нажмите кнопку «Обновить» .

Обновите расширение вручную

  1. Найдите файл .crx , который вы только что создали, в разделе «Просмотр предупреждений» .
  2. Переименуйте его или удалите.
  3. Откройте файл manifest.json и добавьте любое разрешение, которое вызывает предупреждение .
  4. Перейдите на chrome://extensions . Не удаляйте ранее установленный пакет .
  5. Упакуйте расширение еще раз, но на этот раз добавьте файл pem во второй вход.
    Файл Pem добавляется при упаковке расширения.
    Рис. 8. Диалоговое окно расширения упаковки с включенным pem-файлом.
  6. Перетащите новое упакованное расширение на страницу «Управление расширениями».

  7. Вы увидите диалоговое окно, предлагающее пользователю принять новые разрешения.

    Расширение отключено

    Рис. 9. Предупреждение об отключенном расширении.

    Согласен с разрешениями
    Рис. 10. Диалоговое окно запроса нового разрешения.