how to add support for "?" (query) in path for apple-app-site-association file?

Question

"apple-app-site-association" file content:

{

    "appclips": {
        "apps": ["**********.com.project.example.Clip"]
    },
    "applinks": {
        "apps": ["**********.com.project.example"],
        "details": [
          {
            "appID": "**********.com.project.example",
            "paths": [ "/event/*", "/ticket?v=*" ]
          }
        ]
    }
}

File is already set at "https://< fully qualified domain>/.well-known/apple-app-site-association"

problem I'm facing is that it is working for

"https://< fully qualified domain>/event/EVENT-ID",

but it is not invoking app for

"https://< fully qualified domain>/ticket?v=VOLUME-ID"

Is it because of "?" or I'm missing some thing?

tank · Accepted Answer · 2023-06-21T10:25:27.523

1

We need to use components array

 "components": [  
     {
         "/": "/help/*",
         "?": { "articleNumber": "????" },
         "comment": "blah blah"
     }
 ]

Please refer https://developer.apple.com/documentation/xcode/supporting-associated-domains

edited Jun 21 '23 at 10:25

answered Jun 21 '23 at 10:06

tank

26
2

thanks for resource, I've added components part, it still not invoking the app. Should I remove path part and only leave components? – Deep Gandhi Jun 21 '23 at 16:58
it worked, it takes time to reflect update. later I found that it'll update within 24 hours. (thanks to https://stackoverflow.com/a/75450985/8351061) – Deep Gandhi Jun 22 '23 at 11:48

score 0 · Answer 2 · answered Jun 22 '23 at 18:17

ended up implementing this solution:

used "components" instead "paths"

{
  "appclips": {
    "apps": [
      "**********.com.project.example.Clip"
    ]
  },
  "applinks": {
    "apps": [
      "**********.com.project.example"
    ],
    "details": [
      {
        "appID": "**********.com.project.example",
        "components": [
          {
            "/": "/event/*",
            "comment": "(www.example.com/event/EVENTID) Matches any URL with a path that starts with /event/."
          },
          {
            "/": "/ticket",
            "?": {
              "v": "???????"
            },
            "comment": "(www.example.com/ticket?v=QWERTYU) Matches any URL with a path that has a query item with name 'v' and a value of exactly seven characters."
          },
          {
            "?": {
              "L": "??????????"
            },
            "comment": "(www.example.com?L=QWERTYUIOP) Matches any URL with a path that has a query item with a value of exactly ten characters."
          }
        ]
      }
    ]
  }
}

Note:

when checking deepLinking, wait for a while as it takes time to reflect change after updating AASA file content. apple document resource
iOS will download your AASA when your app is first installed and when updates are installed from the App Store, but it will not refresh any more frequently. If you wish to change the paths in your AASA for a production app, you will need to issue a full update via the App Store so that all of your users' apps re-fetch your AASA and recognize the new paths. refrence

how to add support for "?" (query) in path for apple-app-site-association file?

2 Answers2