在WWDC17上,苹果就已经带来了App密码自动填充的这一新的API。今天给 APP 加该功能的时候,又重新走了一遍,踩了一堆的坑,这里重新备注一下,防止下次掉坑里去。
Apple 官方视频地址:WWDC 2017 Introducing Password AutoFill for Apps
效果图
当需要用户填充用户名和密码时,在键盘的QuickType Bar(快速输入条)会给出候选的用户名与密码。
APP 页面开发
1.设置 TextField 的 ContentType
在iOS11中,TextContentType新增加了Username、Password类型,我们只需要将相应的TextField设置为对应的ContentType即可。
1).XIB 设置
2).代码设置
self.accountTF.textContentType = UITextContentTypeUsername;
self.passwordTF.textContentType = UITextContentTypePassword;
这时候,用户已经可以在输入用户名与密码时,通过点击QuickType Bar 中间的钥匙串按钮打开密码列表,在所有的保存的密码中选择要输入的用户名和密码了。
但是,这样还不是很方便,如果用户保存的密码很多,需要在列表中查找也并不很方便。我们需要在QuickType Bar的候选区列出用户曾经在我们的网站保存过的密码,就像效果图那样。密码多了QuickType Bar展示不下时,将我们网站的所有账号密码都提出来,单独展示,如下图:
2.Associated Domains
登录Apple开发者网站,打开Associated Domains
确认Associated Domains已经启用。同时,我们要记录一下当前应用的App ID Prefix,也就是上图中的 Team ID 后面会用到。
3.apple-app-site-association
1).创建apple-app-site-association
创建一个apple-app-site-association
文件,保证该文件不能有任何扩展名,否则会失效,文件内容如下
//6437CSLCVS是之前需要记住的 Team ID
//com.test.xyanl 是当前APP绑定的 Bundle ID
{
"webcredentials": {
"apps": [ "6437CSLCVS.com.test.xyanl" ]
}
}
2).上传到服务器
创建成功后,将apple-app-site-association
文件上传到服务器的根目录或者是.well-known下面,两个都可以(官方建议是.well-known目录下),
https://example.com/apple-app-site-association
https://example.com/.well-known/apple-app-site-association
3).校验
apple-app-site-association
上传成功后,要校验是否有效,可以去官方验证的网站。
4. 配置 Xcode
添加 Associated Domains
到这里就算完成了,你就可以运行一下看看,可以达到效果图的效果了。
5. 密码存储
iOS 已经简化了开发者的操作,以上都已经配置好后实际是不用考虑密码存储的,因为苹果已经都给你做完了,他会自动提示用户是否需要存储,自动存储无法关闭。
1).自动存储
在登录页面,输入完账号密码,点击登录离开登录页面之后,会自动弹出个提示框,如下图
�该提示框是根据 textFiled .textContentType 的设置自动判断的,不需要你做其他的操作。
self.accountTF.textContentType = UITextContentTypeUsername;
self.passwordTF.textContentType = UITextContentTypePassword;
2).手动存储
也可以调用 API 存储密码
// webcredentials:example.com 填写的服务器地址
NSString *services = @"example.com";
// 输入的账号
NSString *account = @"account";
// 输入的密码
NSString *password = @"123456";
// 存储密码
SecAddSharedWebCredential((CFStringRef)services, (CFStringRef)account, (CFStringRef)password, ^(CFErrorRef _Nullable error) {
if (error) {
NSLog(@"错误 %@",error);
}else {
NSLog(@"成功");
}
});
问题
1.要仔细看看创建的文件apple-app-site-association
,一定不能带有扩展名。
2.apple-app-site-association
文件内容是 JSON,也要检查JSON格式是否正确,
有时的粗心会耽误很多时间,以下是我之前写的JSON, 找了半天也没有发现问题,最后放在JSON 格式化校验才发现我少了一个逗号(,
)
{
"applinks": {
"apps": [],
"details": [{
"appID": "6437CSLCVS.com.YiFenF.BBS",
"paths": ["*"]
}]
}
"webcredentials": {
"apps": ["6437CSLCVS.com.YiFenF.BBS"]
}
}
3.还有会遇到的情况,有的服务器地址带 www
,有的不带的,在配置Associated Domains
的时候要注意,也会造成 Associated Domains
失效