Web App Manifest
================

**Экспериментальная возможность:** **Это экспериментальная технология**  
Так как спецификация этой технологии ещё не стабилизировалась, смотрите таблицу совместимости по поводу использования в различных браузерах. Также заметьте, что синтаксис и поведение экспериментальной технологии может измениться в будущих версиях браузеров, вслед за изменениями спецификации.

**Манифесты веб-приложений** являются частью набора веб-технологий, называемых прогрессивными веб-приложениями (en-US) (PWA, progressive web apps), представляющими собой веб-сайты, которые можно установить на домашний экран устройства без магазина приложений. В отличие от обычных веб-приложений с простыми ссылками на домашний экран или закладками, PWA можно загружать заранее и работать в автономном режиме, а также использовать обычные `Web API`.

Манифест веб-приложения предоставляет информацию о приложении в текстовом файле JSON, который необходим того, чтобы веб-приложение было загружено и отображалось пользователю аналогично нативному приложению (например, для установки на домашний экран устройства, предоставляющий пользователям более быстрый доступ и больше возможностей).

Содержимое манифеста
--------------------

Манифест может содержать следующие элементы:

* background\_color
* categories
* description
* display
* icons
* name
* orientation
* prefer\_related\_applications
* related\_applications
* scope
* screenshots
* short\_name
* start\_url
* theme\_color
Пример манифеста
----------------


```json
{
  "name": "HackerWeb",
  "short\_name": "HackerWeb",
  "start\_url": ".",
  "display": "standalone",
  "background\_color": "#fff",
  "description": "A simply readable Hacker News app.",
  "icons": [
    {
      "src": "images/touch/homescreen48.png",
      "sizes": "48x48",
      "type": "image/png"
    },
    {
      "src": "images/touch/homescreen72.png",
      "sizes": "72x72",
      "type": "image/png"
    },
    {
      "src": "images/touch/homescreen96.png",
      "sizes": "96x96",
      "type": "image/png"
    },
    {
      "src": "images/touch/homescreen144.png",
      "sizes": "144x144",
      "type": "image/png"
    },
    {
      "src": "images/touch/homescreen168.png",
      "sizes": "168x168",
      "type": "image/png"
    },
    {
      "src": "images/touch/homescreen192.png",
      "sizes": "192x192",
      "type": "image/png"
    }
  ],
  "related\_applications": [
    {
      "platform": "web"
    },
    {
      "platform": "play",
      "url": "https://play.google.com/store/apps/details?id=cheeaun.hackerweb"
    }
  ]
}
```

Внедрение манифеста
-------------------

Манифест веб-приложения внедряется в вашу HTML-страницу, с помощью тега ссылки в заголовке вашего документа:


```html
<link rel="manifest" href="/manifest.webmanifest" />
```


**Примечание:** Расширение `.webmanifest` указывается в разделе спецификации Media type registration section of the specification (ответ файла манифеста должен возвращать `Content-Type: application/manifest+json`). Браузеры обычно поддерживают манифесты с другими соответствующими расширениями, такими как `.json` (`Content-Type: application/json`).

**Примечание:** Если для получения манифеста требуются учётные данные - атрибут `crossorigin` должен иметь значение `"use-credentials"`, даже если файл манифеста находится в том же источнике, что и текущая страница.

Заставки
--------

В Chrome 47 и более поздних версиях заставки отображаются при загрузке веб-приложения с домашнего экрана. Эти заставки автоматически генерируются с использованием свойств, указанных в манифесте приложения, например: `name`, `background_color` и иконки в массиве `icons,` которые ближе к 128dpi для устройства.

Спецификации
------------

| Specification |
| --- |
| Web Application Manifest # background\_color-member |
| Web App Manifest - Application Information # categories-member |
| Web App Manifest - Application Information # description-member |
| Web Application Manifest # display-member |
| Manifest Incubations # display\_override-member |
| Manifest Incubations # file\_handlers-member |
| Web Application Manifest # icons-member |
| Web Application Manifest # id-member |
| Web App Launch Handler API # launch\_handler-member |
| Web Application Manifest # name-member |
| Manifest Incubations # note\_taking-member |
| Web Application Manifest # orientation-member |
| Web Application Manifest # prefer\_related\_applications-member |
| Manifest Incubations # protocol\_handlers-member |
| Web Application Manifest # related\_applications-member |
| Web Application Manifest # scope-member |
| Web App Manifest - Application Information # screenshots-member |
| Web Share Target API # share\_target-member |
| Web Application Manifest # short\_name-member |
| Web Application Manifest # shortcuts-member |
| Web Application Manifest # start\_url-member |
| Web Application Manifest # theme\_color-member |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.