iOS-配置Universal Links通用链接

1、开启Associated Domains服务

登录苹果开发者网站,在Certificates, Identifiers & Profiles页面左侧选择Identifiers,右侧选择对应的App ID,点击进入配置详情页,开启Associated Domains服务;

image.png

2、更新Profile文件(配置文件)

Certificates, Identifiers & Profiles页面左侧选择Profiles,右侧选择对应的配置文件,点击进入,点击Edit进入修改页,直接点击Save,保存后点击Download下载并打开;

3、Xcode配置

Xcode打开项目,进入工程配置,添加Associated Domains项,步骤如图:

image.png

4、添加完成后配置applinks域名

注意:
a、必须是https链接
b、必须外网能访问(可以理解为不用代理直接用流量能访问)
c、将https://替换为applinks:
d、不用/结尾
e、可以给DebugRelease分别配置。
配好后格式如图:(applinks:为前缀,test.uubx.com为域名

image.png

5、创建apple-app-site-association文件

(1)文件名必须为:apple-app-site-association,直接复制
(2)文件不能后缀,是纯文本
(3)文件必须放在服务器根目录或者.well-known目录下,这是苹果规定的,具体请教后端的同事
创建步骤:
a、打开系统自带的文本编辑器,进入偏好设置,如图:

image.png

b、进入打开和存储,关闭给纯文本文件添加.txt扩展名选项,如图:
image.png

c、选择格式,切换为制作纯文本,如图:
image.png

d、编辑内容,先复制以下内容到编辑器,并看注释

{
    "applinks": {
        "apps": [],
        "details": [
            {
                "appID": "AAAAA.BBBBB",
                "paths": ["/path1/*"]
            },
            {
                "appID": "CCCCC.DDDDD",
                "paths": ["/path1/*","/path2/*","/path3/*"]
            },
            {
                "appID": "EEEEE.FFFFF",
                "paths": ["/*"]
            }
        ]
    }
}

注释:
(1)格式是固定的
(2)apps为空就行,不需要更改
(3)支持多个App共用一个apple-app-site-association文件(即一个域名有多个App在使用)
(4)多个App共用,只需要在上述配置details中添加
(5)details为一个list,切记注意格式
(6)details下一个字典为一个App,多个App添加多个字典就行,注意,号隔开
(7)details下字典格式固定,注意别更改
(8)appID格式为:Team ID+.+Bundle Identifier,即上述配置中,AAAAA、CCCCC、EEEEE为Team ID,BBBBB、DDDDD、FFFFF为Bundle Identifier,注意Team ID与Bundle Identifier中间用”.“链接
(9)Team ID查找,登录开发者账号,进入账户,进入会员资格详细信息,找到团队 ID,即为Team ID,如图

image.png

(10)paths是一个list,表示路径,一个App可以配置多个path,也可以直接使用/*
(11)/* 表示通用链接,即只要域名正确,可以直接命中,一般不建议直接使用/* ,如配置为/path1/* ,则必须域名+/path1/才能命中
(12)path中的路径是自定义的,但一定要以/* 结尾,切记,切记,切记
e、编辑好内容后,保存文件,切记文件名字必须为apple-app-site-association,如图:
image.png

6、上传文件到服务器

将刚才的文件发送给后端同事,让帮忙上传至服务器根目录或者.well-known目录下,切记,只能这两个目录

7、验证

7.1 验证服务器文件上传是否成功

在服务器上传文件后,通过浏览器是可以正常访问到的。如果文件放在根目录下,链接为:https://test.uubx.com/apple-app-site-association,如果文件放在.well-known目录下,则链接为:
https://test.uubx.com/.well-known/apple-app-site-association(注:https://test.uubx.com/需要替换为你自己的域名)。浏览器打开后,会看到我们刚才配置的apple-app-site-association文件内容,如果不能,则需要查看文件目录是否正确,网络是否支持外网,服务器是否拦截。

7.2 验证Universal Link链接是否配置正确

方法一:打开备忘录,输入https://test.uubx.com/path1/(域名替换为你配置的域名,path1路径替换为你自己配置的路径,如果直接配置的/* 则直接输入域名即可),编辑完成后,长按链接,如果出现在”XXX”中打开,则表示配置成功。如图:

image.png

方法二:打开safri浏览器,输入https://test.uubx.com/path1/(域名替换为你配置的域名,path1路径替换为你自己配置的路径,如果直接配置的/* 则直接输入域名即可),编辑完成后,点击前往,加载完成后(会有一个报错页面),轻轻下拉网页,如果出现App的图标、名称打开按钮,则表示配置成功。如图:

image.png

Tips:

a、 apple-app-site-association文件会在第一次安装App的时候自动下载
b、 如果手机上已经安装过App,并且已经下载过apple-app-site-association文件,这时服务器更改了apple-app-site-association文件,手机上的apple-app-site-association文件是不会自动更新的。
c、 偶现过一种情况,手机网络卡,在打开App后,猜测系统自动下载apple-app-site-association文件失败,导致手机上没有apple-app-site-association文件,这时系统不会在自动下载apple-app-site-association文件,不知道描述是否正确,偶现过一两次。
d、 如果出现b、c两种情况,尝试解决办法,1、完全杀死App,然后重启手机,手机开机后,不要先打开App,等待网络稳定后,在打开App; 2、直接卸载当前App,重新下载。在网络较稳定的情况下打开App。
e、 感觉最坑的一个是apple-app-site-association应该不是实时的,会有一定延迟,如果整体流程按照要求配置完成,没有出错的情况下,出现无法打开的情况,可以尝试更换其他手机测试,或者稍微等待。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,293评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,604评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,958评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,729评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,719评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,630评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,000评论 3 397
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,665评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,909评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,646评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,726评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,400评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,986评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,959评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,996评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,481评论 2 342

推荐阅读更多精彩内容