Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Describe manifest update behavior #1011

Merged
merged 15 commits into from
Feb 17, 2022
32 changes: 26 additions & 6 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -842,11 +842,12 @@ <h3>
application, it SHOULD treat that manifest as a description of a
distinct application, even if it is served from the same URL as that
of another application. When the user agent sees a manifest where
|manifest|["id"] [=url/equal|equals=] the [=identity=] of an
already-installed application, it SHOULD be used as a signal that
this manifest is a replacement for the already-installed
application's manifest, and not a distinct application, even if it is
served from a different URL than the one seen previously.
|manifest|["id"] is [=url/equal=] with [=URL serializer/exclude
fragment|exclude fragment true=] to the [=identity=] of an
already-installed application, it SHOULD be used as a signal that this
manifest is a replacement for the already-installed application's
manifest, and not a distinct application, even if it is served from a
different URL than the one seen previously.
</p>
<p class="note">
The [=identity=] can be used by a service that collects lists of web
Expand Down Expand Up @@ -1293,6 +1294,13 @@ <h3>
<li>[=Process the `id` member=] passing |json|, |manifest| and
|document URL|.
</li>
<li>
If the [=document=]'s [=document|processed
manifest=] is not null, and [=document=]'s [=document|processed
manifest=]'s id is not
[=URL/equal=] with [=URL serializer/exclude fragment|exclude fragment true=] to |manifest|["id"],
return.
</li>
<li>[=Process the `scope` member=] passing |json|, |manifest|, and
|manifest URL|.
</li>
Expand Down Expand Up @@ -1421,7 +1429,19 @@ <h3 id="applying">
<h3>
Updating the manifest
</h3>
<aside class="issue" data-number="446"></aside>
<p>
For installed web application, the manifest is fetched and processed
on every page load. When the processing is successful, user agents
MAY apply updated manifest to any current and future <a>application
contexts</a>
associated with the application.
philloooo marked this conversation as resolved.
Show resolved Hide resolved
</p>
<p>
User agents SHOULD be careful about performing update to manifest
fields like app name and icons. Users should be fully aware if
such fields are to be be updated to avoid web applications being
installed and silently changed to appear as a different one.
</p>
philloooo marked this conversation as resolved.
Show resolved Hide resolved
</section>
</section>
</section>
Expand Down