Universal Links (apple-app-site-association文件说明)

一、示例:
{
  "applinks": {
      "substitutionVariables": {
          "food": [ "burrito", "pizza", "sushi", "samosa" ]
       },
      "details": [
           {
             "appIDs": [ "ABCDE12345.com.example.app", "ABCDE12345.com.example.app2" ],
             "components": [
               { 
                  "/" : "/$(lang)_$(region)/$(food)/"
               },
               {
                  "#": "no_universal_links",
                  "exclude": true,
                  "comment": "Matches any URL whose fragment equals no_universal_links and instructs the system not to open it as a universal link"
               },
               {
                  "/": "/buy/*",
                  "comment": "Matches any URL whose path starts with /buy/"
               },
               {
                  "/": "/buy/*",
                  "#": "my_great_product_123",
                  "comment": "Matches any URL whose path starts with /buy/ and fragment equals my_great_product_123, ignoring case"
               },
               {
                  "/": "/help/website/*",
                  "exclude": true,
                  "comment": "Matches any URL whose path starts with /help/website/ and instructs the system not to open it as a universal link"
               },
               {
                  "/": "/help/*",
                  "?": { "articleNumber": "????" },
                  "comment": "Matches any URL whose path starts with /help/ and which has a query item with name 'articleNumber' and a value of exactly 4 characters"
               }
             ],
             "defaults": { "caseSensitive": false, "percentEncoded": true }
           }
       ]
   },
   "webcredentials": {
      "apps": [ "ABCDE12345.com.example.app" ]
   },
    "appclips": {
        "apps": ["ABCED12345.com.example.MyApp.Clip"]
    }
}
二、各字段说明:

Services

Services include:

  • webcredentials
    Use this service for shared web credentials.
  • applinks
    Use this service for universal links.
  • activitycontinuation
    Use this service for Handoff.
  • appclips
    Use this service for an App Clip.

applinks

  • defaults iOS 14.0+
    The global pattern-matching settings to use as defaults for all universal links in the domain.
  • details iOS 9.0+
    An array of Details objects that define the apps and the universal links they handle for the domain.
  • substitutionVariables iOS 13.5+
    Custom variables to use for simplifying complex pattern matches. Each name acts as a variable that the system replaces with each string in the associated string array.

applinks.Defaults

  • caseSensitive boolean
    A Boolean value that indicates whether pattern matching is case-sensitive. The default is true.
  • percentEncoded boolean
    A Boolean value that indicates whether URLs are percent-encoded. The default is true.

applinks.Details

  • appIDs [string]
    An array of application identifiers that specify the apps that can handle the universal links in the components array.
  • components applinks.Details.Components
    An array of components that define the universal link URLs an app can handle.
  • defaults applinks.Defaults
    A dictionary for defining the default settings to use for all universal links pattern matching in the components array.

applinks.AppIDs

Use appIDs to specify the apps that can access the specific URLs you define in the associated components array. You specify the application identifiers in the following format:
<Application Identifier Prefix>.<Bundle Identifier>

applinks.Details.Components

  • / string
    The pattern to match with the URL path component. The default is *, which matches everything.
  • ? * string, applinks.Details.Components.Query
    The pattern or dictionary to match with the URL query component. The default is *, which matches everything.
  • # string
    The pattern to match with the URL fragment component. The default is *, which matches everything.
  • exclude boolean
    A Boolean value that indicates whether to stop pattern matching and prevent the universal link from opening if the URL matches the associated pattern. The default is false.
  • comment string
    Text that the system ignores. Use this to provide information about the URLs a pattern matches.
  • caseSensitive boolean
    A Boolean value that indicates whether pattern matching is case-sensitive. The default is true.
  • percentEncoded boolean
    A Boolean value that indicates whether URLs are percent-encoded. The default is true.

applinks.Details.Components.Query

  • Any Key string
    The pattern to match with the specified NSURLQueryItem name.

applinks.SubstitutionVariables

  • Any Key [string]
    An array of strings to substitute for the associated variable in URL pattern-matching operations.

参考:
Support Universal Links
Supporting Associated Domains
Associated Domains Entitlement
applinks

推荐阅读更多精彩内容