在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 设置

ContentType

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

Associated Domains 配置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失效