android app links 和 iOS universal links 支持特定 path 踩坑记录

最近开发中的 app 被客户提了 bug，说在邮箱里打开我们网站的链接会自动跳到 app。app 只有一种情景才需要跳转到 app，用邮箱验证注册。其实解决方法不难，无论是android 的 app links 还是 iOS 的 universal links 都支持配置特定的 path 才允许跳转，但实际上却花费了点时间来踩坑，以下为记录。

android

android 很简单，只需要在 AndroidManifest.xml 配置 app links 的地方再加上 android:pathPrefix 即可

<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />

    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data
        android:scheme="https"
        android:host="${domain}"
        android:pathPrefix="/register/verifyEmail" />
intent-filter>

实际测试下来，功能符合预期，没问题

iOS

iOS 才是踩坑的地方，可以确定的是要支持特定链接，不需要改动到 app 的代码，只需要修改网站的 apple-app-site-association 文件。最新版可以通过 components，旧版可以配置 paths，当然为了兼容性可以两者都配置，参考官网 developer.apple.com/documentati… 的教程，很快就把 apple-app-site-association 改好了

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appIDs": [
                    "YOUR_TEAM_ID.com.example.yourapp"
                ],
                "components": [
                    {
                        "/": "/register/verifyEmail/*",
                        "comment": "Matches any URL with a path that starts with /register/verifyEmail/."
                    },
                    {
                        "/": "/*",
                        "exclude": true,
                        "comment": "Instructs the system not to open it as a universal link."
                    }
                ]
            }
        ]
    }
}

信心满满的上传到网站去测试，确认了文件已更新，结果发现无用；以为是写法不对，改成 paths 的方式又试了几次，均达不到想要的效果；最后我试着把 appIDs 里面给清空，结果竟然能跳转。很显然，跳转所依赖的 apple-app-site-association 并不是我们所更新的那一份，去以 “apple-app-site-association updated but not work” 之类的关键词搜了一下，结果找到原因，apple 会有个 cdn 的网站来存在这些文件，链接是 https://app-site-association.cdn-apple.com/a/v1/{domain}，后缀改成我们公司的网站，一打开，果然还是旧的那份

原因找到，但如果等 apple 更新同步再测试，就太麻烦了，好在 apple 官方允许我们以开发模式来测试，将 Associated Domains 处设置的 applinks:{domain} 加上 ?mode=developer，然后重 build app，测试结果符合预期