From f94e3f35a415d2d43b369ab4ea66294dabb1c09b Mon Sep 17 00:00:00 2001 From: Christian Liebel Date: Fri, 1 Nov 2024 07:54:19 +0100 Subject: [PATCH] Move `prefer_related_applications` and `related_applications` to manifest incubation --- index.html | 227 ----------------------------------------------------- 1 file changed, 227 deletions(-) diff --git a/index.html b/index.html index 7880b89b..eb96c60f 100644 --- a/index.html +++ b/index.html @@ -200,10 +200,6 @@

  • [=manifest/orientation=]
    • -
  • [=manifest/prefer_related_applications=] -
    • -
  • [=manifest/related_applications=] -
  • [=manifest/scope=]
  • [=manifest/short_name=] @@ -1096,81 +1092,6 @@

    algorithm is used to process the [=manifest/theme_color=] member.

    -
    -

    - `related_applications` member -

    - -

    - A related application is an application accessible to the - underlying application platform that has a relationship with the web - application. -

    -

    - The [=manifest's=] related_applications member lists related - applications and serves as an indication of such a relationship - between web application and related applications. This - relationship is unidirectional and unless a listed application claims - the same relationship, the user agent MUST NOT assume a - bi-directional endorsement. -

    -

    - Example of usages of the `related_applications` could be a crawler - that would use that information to gather more information about the - web application or a browser that could suggest a listed application - as an alternative if the user wants to install the web application. -

    -

    - To process the `related_applications` member, given - [=ordered map=] |json:ordered map| and [=ordered map=] - |manifest:ordered map|: -

    -
      -
    1. Let |relatedApplications:list| be a new [=list=]. -
      2. -
    2. Set |manifest|["related_applications"] to |relatedApplications|. -
      3. -
    3. If |json|["related_applications"] doesn't [=map/exist=] or - |json|["related_applications"] is not a [=list=], return. -
      4. -
    4. [=list/For each=] app of - |json|["related_applications"]: -
        -
      1. If neither app["id"] nor app["url"] are - missing: -
          -
        1. Set app["url"] to the result of running - process the `url` member of an application given - app["url"]. -
          2. -
        2. [=list/append=] app to - relatedApplications. -
          3. -
        -
        2. -
      -
      5. -
    5. Set relatedApplications. -
      6. -
    -
    -
    -

    - `prefer_related_applications` member -

    - -

    - The [=manifest's=] `prefer_related_applications` member is a - [=boolean=] that is used as a hint for the user agent to say that - related applications should be preferred over the web - application. If the `prefer_related_applications` member is set to - `true`, and the user agent wants to suggest to install the web - application, the user agent might want to suggest installing one of - the related applications instead. -

    -

    `background_color` member @@ -1646,9 +1567,6 @@

  • [=Process the `orientation` member=] passing |json|, |manifest|.
    • -
  • [=Process the `related_applications` member=] passing |json| - and |manifest|. -
  • [=Process the `shortcuts` member=] passing |json|, |manifest|, and |manifest URL|.
    • @@ -2471,151 +2389,6 @@

    -
    -

    - External application resource -

    - -

    - Each external - application resource represents an application related to the web - application. -

    -

    - An [=external application resource=] can have the following members, - some of which are required to be a [=valid external application - resource=]: -

    -
      -
    • [=external application resource/fingerprints=] member -
      • -
    • [=external application resource/id=] member -
      • -
    • [=external application resource/min_version=] member -
      • -
    • [=external application resource/platform=] member -
      • -
    • [=external application resource/url=] member -
      • -
    -

    - A valid external application resource MUST have [=external - application resource/platform=] member, and either an [=external - application resource/url=] or an [=external application resource/id=] - member (or both). -

    - -
    -

    - `platform` member -

    -

    - The platform member - represents the [=platform=] this [=external application resource=] is - associated with. A platform represents a - software distribution ecosystem or possibly an operating system. This - specification does not define the particular values for the - platform member. -

    - -
    -
    -

    - `url` member -

    -

    - An [=external application resource's=] url member is the - URL where the application can be found. -

    -

    - To process the `url` member of an application: -

    -
      -
    1. If application URL is missing, return null. -
      2. -
    2. Otherwise, [=URL Parser|parse=] application URL and if - the result is not failure, return the result. Otherwise return null. -
      3. -
    -
    -
    -

    - `id` member -

    -

    - An [=external application resource's=] id member represents the - id which is used to represent the application on the platform. -

    -
    -
    -

    - `min_version` member -

    -

    - An [=external application resource's=] min_version member - represents the minimum version of the application that is considered - related to this web app. This version is a string with - platform-specific syntax and semantics. -

    -
    -
    -

    - `fingerprints` member -

    -

    - An [=external application resource's=] fingerprints member - represents an [=list=] of [=fingerprints=]. -

    -

    - A fingerprint represents a - set of cryptographic fingerprints used for verifying the application. - A fingerprint has the following two members: type and value. Each of these are strings, but - their syntax and semantics are platform-defined. -

    -
    -

    Installable web applications