Как пользоваться
- Введите Название и Короткое название, затем Стартовый адрес и Область действия приложения.
- Выберите Режим экрана и введите Цвет фона и Цвет темы как шестнадцатеричные цвета.
- Запишите по одному значку в строке под Значки: адрес, затем размеры, тип и назначение, разделённые чертами.
- Сохраните текст под manifest.webmanifest и исправьте каждое предупреждение из списка Проверки установки.
Что означают поля
Манифест — это файл JSON. Его поля описаны в спецификации W3C Web Application Manifest (раздел 1). Записываются только заполненные поля, поэтому пустое поле не попадает в файл. Режим экрана определяет, как браузер показывает приложение. Если браузер не поддерживает режим, он берёт следующий из цепочки (раздел 6): полный экран, затем отдельное окно, затем минимальный интерфейс, затем вкладка браузера.
Стартовый адрес на другом источнике, чем страница, игнорируется, потому что спецификация требует одного источника. Область действия используется, только если она содержит стартовый адрес. Иначе браузеры берут область, которая равна стартовому адресу без имени файла, строки запроса и фрагмента.
Что проверяют предупреждения
MDN перечисляет поля, которые браузеры на основе Chromium требуют, прежде чем предложить установить веб-приложение: название или короткое название, значки 192 и 512 пикселей, стартовый адрес и режим экрана. Там же сказано, что сайт должен отдаваться по https или с localhost и что сервис-воркер не обязателен. Firefox на компьютере не устанавливает веб-приложение из файла манифеста.
Инструмент проверяет поля выше и правило области действия. Он не проверяет файлы значков, адрес HTTPS и ссылку на ваших страницах: это нужно подтвердить самостоятельно.
Значения по умолчанию
С теми значениями, с которыми страница открывается, манифест содержит поля ниже. Предупреждений нет: название, стартовый адрес и оба размера значков на месте.
| Поле | Значение |
|---|---|
| name, short_name | Заметки, Заметки |
| start_url, scope | /, / |
| display | standalone |
| background_color, theme_color | #ffffff, #1f6feb |
| icons | PNG-файлы 192x192 и 512x512; у значка 512 назначение any maskable |
Частые вопросы
Где сохранить файл манифеста?
Сохраните его в корне сайта или в папке приложения и назовите manifest.webmanifest. Затем свяжите его с каждой страницей приложения элементом link, у которого rel равно manifest, как описано в MDN.
Нужен ли сервис-воркер, чтобы установить приложение?
Нет. MDN говорит, что сервис-воркер не требуется, чтобы PWA можно было установить, хотя многие приложения используют его для работы без сети. Сайт по-прежнему должен отдаваться по https или с localhost.
Какие размеры значков нужны?
MDN указывает значки 192 и 512 пикселей для браузеров на основе Chromium. Записывайте размеры как ширину и высоту через x; если в одном файле несколько размеров, разделяйте их пробелами. У файла SVG размер может быть any.
В чём разница между коротким названием и названием?
Название — это полное название приложения. Короткое название нужно там, где мало места, например для подписи под значком на главном экране. Укажите хотя бы одно из них: инструмент предупреждает, если оба пусты.
Почему инструмент предупреждает об области действия?
Область действия используется, только если она содержит стартовый адрес (W3C, раздел 1). Если стартовый адрес вне области, браузеры игнорируют её и берут область по умолчанию, поэтому приложение может открыться за пределами нужной части сайта.
Источники
- W3C (на английском): Web Application Manifest (Working Draft, 6 November 2026): sections 1, 2 and 6
- MDN (на английском): Making PWAs installable
- MDN (на английском): display member of the web app manifest
- MDN (на английском): icons member of the web app manifest
Цифры и текст в последний раз проверены вторник, 10 ноября 2026 г..