Skip to content

Commit 3ea974b

Browse files
christianliebelchristianliebel
authored
Merge branch 'main' into case-insensitive-enums
2 parents 0e4717f + 1a06ac7 commit 3ea974b

File tree

1 file changed

+0
-227
lines changed

1 file changed

+0
-227
lines changed

‎index.html

-227
Original file line numberDiff line numberDiff line change
@@ -200,10 +200,6 @@ <h2>
200200
</li>
201201
<li>[=manifest/orientation=]
202202
</li>
203-
<li>[=manifest/prefer_related_applications=]
204-
</li>
205-
<li>[=manifest/related_applications=]
206-
</li>
207203
<li>[=manifest/scope=]
208204
</li>
209205
<li>[=manifest/short_name=]
@@ -1102,81 +1098,6 @@ <h3>
11021098
algorithm is used to process the [=manifest/theme_color=] member.
11031099
</p>
11041100
</section>
1105-
<section>
1106-
<h3>
1107-
`related_applications` member
1108-
</h3>
1109-
<aside class="issue" data-number="956"></aside>
1110-
<p>
1111-
A <dfn>related application</dfn> is an application accessible to the
1112-
underlying application platform that has a relationship with the web
1113-
application.
1114-
</p>
1115-
<p>
1116-
The [=manifest's=] <code><dfn data-export="" data-dfn-for=
1117-
"manifest">related_applications</dfn></code> member lists <a>related
1118-
applications</a> and serves as an indication of such a relationship
1119-
between web application and <a>related applications</a>. This
1120-
relationship is unidirectional and unless a listed application claims
1121-
the same relationship, the <a>user agent</a> MUST NOT assume a
1122-
bi-directional endorsement.
1123-
</p>
1124-
<p>
1125-
Example of usages of the `related_applications` could be a crawler
1126-
that would use that information to gather more information about the
1127-
web application or a browser that could suggest a listed application
1128-
as an alternative if the user wants to install the web application.
1129-
</p>
1130-
<p>
1131-
To <dfn>process the `related_applications` member</dfn>, given
1132-
[=ordered map=] |json:ordered map| and [=ordered map=]
1133-
|manifest:ordered map|:
1134-
</p>
1135-
<ol class="algorithm">
1136-
<li>Let |relatedApplications:list| be a new [=list=].
1137-
</li>
1138-
<li>Set |manifest|["related_applications"] to |relatedApplications|.
1139-
</li>
1140-
<li>If |json|["related_applications"] doesn't [=map/exist=] or
1141-
|json|["related_applications"] is not a [=list=], return.
1142-
</li>
1143-
<li>[=list/For each=] <var>app</var> of
1144-
|json|["related_applications"]:
1145-
<ol>
1146-
<li>If neither <var>app</var>["id"] nor <var>app</var>["url"] are
1147-
missing:
1148-
<ol>
1149-
<li>Set <var>app</var>["url"] to the result of running
1150-
<a>process the `url` member of an application</a> given <var>
1151-
app</var>["url"].
1152-
</li>
1153-
<li>[=list/append=] <var>app</var> to
1154-
<var>relatedApplications</var>.
1155-
</li>
1156-
</ol>
1157-
</li>
1158-
</ol>
1159-
</li>
1160-
<li>Set <var>relatedApplications</var>.
1161-
</li>
1162-
</ol>
1163-
</section>
1164-
<section>
1165-
<h3>
1166-
`prefer_related_applications` member
1167-
</h3>
1168-
<aside class="issue" data-number="957"></aside>
1169-
<p>
1170-
The [=manifest's=] <code><dfn data-export="" data-dfn-for=
1171-
"manifest">`prefer_related_applications`</dfn></code> member is a
1172-
[=boolean=] that is used as a hint for the user agent to say that
1173-
<a>related applications</a> should be preferred over the web
1174-
application. If the `prefer_related_applications` member is set to
1175-
`true`, and the user agent wants to suggest to install the web
1176-
application, the user agent might want to suggest installing one of
1177-
the <a>related applications</a> instead.
1178-
</p>
1179-
</section>
11801101
<section>
11811102
<h3>
11821103
`background_color` member
@@ -1652,9 +1573,6 @@ <h3>
16521573
<li>[=Process the `orientation` member=] passing |json|,
16531574
|manifest|.
16541575
</li>
1655-
<li>[=Process the `related_applications` member=] passing |json|
1656-
and |manifest|.
1657-
</li>
16581576
<li>[=Process the `shortcuts` member=] passing |json|, |manifest|,
16591577
and |manifest URL|.
16601578
</li>
@@ -2477,151 +2395,6 @@ <h2>
24772395
</ol>
24782396
</section>
24792397
</section>
2480-
<section>
2481-
<h2>
2482-
External application resource
2483-
</h2>
2484-
<aside class="issue atrisk" data-number="956"></aside>
2485-
<p>
2486-
Each <dfn data-local-lt="external application resource's">external
2487-
application resource</dfn> represents an application related to the web
2488-
application.
2489-
</p>
2490-
<p>
2491-
An [=external application resource=] can have the following members,
2492-
some of which are required to be a [=valid external application
2493-
resource=]:
2494-
</p>
2495-
<ul>
2496-
<li>[=external application resource/fingerprints=] member
2497-
</li>
2498-
<li>[=external application resource/id=] member
2499-
</li>
2500-
<li>[=external application resource/min_version=] member
2501-
</li>
2502-
<li>[=external application resource/platform=] member
2503-
</li>
2504-
<li>[=external application resource/url=] member
2505-
</li>
2506-
</ul>
2507-
<p>
2508-
A <dfn>valid external application resource</dfn> MUST have [=external
2509-
application resource/platform=] member, and either an [=external
2510-
application resource/url=] or an [=external application resource/id=]
2511-
member (or both).
2512-
</p>
2513-
<aside class="example">
2514-
<p>
2515-
In the following example, the web application is listing two
2516-
different related applications, one on Google Play Store and the
2517-
other one on the iTunes Store. The one on the Google Play Store has
2518-
an Android package name, a minimum version specifier, and
2519-
cryptographic fingerprints used for verification, in a
2520-
Play-Store-specific manner.
2521-
</p>
2522-
<pre class="json">
2523-
{
2524-
"related_applications": [
2525-
{
2526-
"platform": "play",
2527-
"url": "https://play.google.com/store/apps/details?id=com.example.app1",
2528-
"id": "com.example.app1",
2529-
"min_version": "2",
2530-
"fingerprints": [
2531-
{
2532-
"type": "sha256_cert",
2533-
"value": "92:5A:39:05:C5:B9:EA:BC:71:48:5F:F2"
2534-
}
2535-
]
2536-
},
2537-
{
2538-
"platform": "itunes",
2539-
"url": "https://itunes.apple.com/app/example-app1/id123456789"
2540-
}
2541-
]
2542-
}
2543-
</pre>
2544-
</aside>
2545-
<section>
2546-
<h3>
2547-
`platform` member
2548-
</h3>
2549-
<p>
2550-
The <code><dfn data-dfn-for=
2551-
"external application resource">platform</dfn></code> member
2552-
represents the [=platform=] this [=external application resource=] is
2553-
associated with. A <dfn data-dfn-for="">platform</dfn> represents a
2554-
software distribution ecosystem or possibly an operating system. This
2555-
specification does not define the particular values for the
2556-
<a>platform</a> member.
2557-
</p>
2558-
<aside class="Platforms registry">
2559-
The working group maintains a <a href=
2560-
"https://github.com/w3c/manifest/wiki/Platforms">registry of known
2561-
platform values</a>.
2562-
</aside>
2563-
</section>
2564-
<section>
2565-
<h3>
2566-
`url` member
2567-
</h3>
2568-
<p>
2569-
An [=external application resource's=] <code><dfn data-dfn-for=
2570-
"external application resource">url</dfn></code> member is the
2571-
<a>URL</a> where the application can be found.
2572-
</p>
2573-
<p>
2574-
To <dfn>process the `url` member of an application</dfn>:
2575-
</p>
2576-
<ol class="algorithm">
2577-
<li>If <var>application URL</var> is missing, return null.
2578-
</li>
2579-
<li>Otherwise, [=URL Parser|parse=] <var>application URL</var> and if
2580-
the result is not failure, return the result. Otherwise return null.
2581-
</li>
2582-
</ol>
2583-
</section>
2584-
<section>
2585-
<h3>
2586-
`id` member
2587-
</h3>
2588-
<p>
2589-
An [=external application resource's=] <code><dfn data-dfn-for=
2590-
"external application resource">id</dfn></code> member represents the
2591-
id which is used to represent the application on the platform.
2592-
</p>
2593-
</section>
2594-
<section>
2595-
<h3>
2596-
`min_version` member
2597-
</h3>
2598-
<p>
2599-
An [=external application resource's=] <code><dfn data-dfn-for=
2600-
"external application resource">min_version</dfn></code> member
2601-
represents the minimum version of the application that is considered
2602-
related to this web app. This version is a <a>string</a> with
2603-
platform-specific syntax and semantics.
2604-
</p>
2605-
</section>
2606-
<section>
2607-
<h3>
2608-
`fingerprints` member
2609-
</h3>
2610-
<p>
2611-
An [=external application resource's=] <code><dfn data-dfn-for=
2612-
"external application resource">fingerprints</dfn></code> member
2613-
represents an [=list=] of [=fingerprints=].
2614-
</p>
2615-
<p>
2616-
A <dfn data-local-lt="fingerprints">fingerprint</dfn> represents a
2617-
set of cryptographic fingerprints used for verifying the application.
2618-
A fingerprint has the following two members: <dfn data-dfn-for=
2619-
"fingerprint">type</dfn> and <dfn data-dfn-for=
2620-
"fingerprint">value</dfn>. Each of these are <a>string</a>s, but
2621-
their syntax and semantics are platform-defined.
2622-
</p>
2623-
</section>
2624-
</section>
26252398
<section>
26262399
<h2>
26272400
Installable web applications

0 commit comments

Comments
 (0)