如何让点击快速输入栏钥匙图标时显示含Passkey的自动填充弹窗？

以下是针对你遇到的Passkey自动填充弹窗仅显示密码选项的问题，逐一排查和解决的关键点：

1. 关联域配置的深度验证 #

• 确保关联域使用webcredentials:前缀，且域名与Passkey注册时的relyingPartyIdentifier完全一致（不能带http/https前缀）。
• 检查apple-app-site-association文件：
  • 放置在域名的.well-known目录下，访问对应地址能直接获取到正确的JSON内容。
  • 文件中必须包含你的App的Team ID和Bundle ID，格式示例：

    {
      "webcredentials": {
        "apps": ["TEAM_ID.BUNDLE_ID"]
      }
    }
    

  • 确保文件无语法错误，服务器返回的Content-Type为application/json（避免返回text/plain）。
• 验证App的Info.plist中NSAppTransportSecurity配置：如果开启了NSAllowsArbitraryLoads，需在NSExceptionDomains中添加关联域名，并设置NSIncludesSubdomains为YES，确保系统能正常访问关联域文件。

2. ASAuthorizationController实现的正确性 #

• 必须创建PublicKeyCredential类型的请求，而不是仅密码请求，示例代码：

  // 生成挑战（需从后端获取）
  guard let challengeData = challengeString.data(using: .utf8) else { return }
  
  // 创建Passkey断言请求
  let provider = ASAuthorizationPublicKeyCredentialProvider(relyingPartyIdentifier: "your-domain.com")
  let passkeyRequest = provider.createCredentialAssertionRequest(challenge: challengeData)
  
  // 可选：同时添加密码登录请求（如果需要）
  let passwordProvider = ASAuthorizationPasswordProvider()
  let passwordRequest = passwordProvider.createRequest()
  
  // 初始化授权控制器
  let authController = ASAuthorizationController(authorizationRequests: [passkeyRequest, passwordRequest])
  authController.delegate = self
  authController.presentationContextProvider = self
  

• 调用performAutoFillAssistedRequests()的时机：必须是在用户点击自动填充栏的钥匙图标后触发，不能提前调用。通常通过textField(_:shouldChangeCharactersIn:replacementString:)或SwiftUI的onTapGesture监听用户操作。
• 确保ASAuthorizationControllerPresentationContextProviding的presentationAnchor(for:)返回正确窗口，比如UIKit中返回UIApplication.shared.windows.first，SwiftUI中返回UIApplication.shared.connectedScenes.first?.windows.first。

3. 文本字段的精确配置 #

• 用户名字段的textContentType设为.username，密码字段设为.password，同时关闭自动更正和自动大写：

  // UIKit示例
  usernameTextField.textContentType = .username
  usernameTextField.autocorrectionType = .no
  usernameTextField.autocapitalizationType = .none
  
  passwordTextField.textContentType = .password
  passwordTextField.autocorrectionType = .no
  passwordTextField.autocapitalizationType = .none
  

• SwiftUI中确保字段正确绑定textContentType：

  TextField("用户名", text: $username)
      .textContentType(.username)
      .autocorrectionDisabled()
      .autocapitalization(.none)
  
  SecureField("密码", text: $password)
      .textContentType(.password)
      .autocorrectionDisabled()
      .autocapitalization(.none)
  

4. 测试环境与设备设置 #

• 确保测试设备已保存对应域名的Passkey：先完成一次Passkey注册流程，否则自动填充弹窗不会显示Passkey选项。
• 检查设备的iCloud钥匙串是否开启，且登录的Apple ID已开启双重认证（Passkey依赖此设置）。
• 尝试重启设备和Xcode，清除App缓存后重新安装，避免配置缓存导致的问题。
• 使用系统默认键盘测试，第三方键盘可能干扰自动填充功能。

5. 排除App权限限制 #

• 检查Info.plist中是否存在禁用自动填充的配置，确保没有阻止自动填充的设置。
• 验证App的隐私设置中，“密码与账户”下的“自动填充密码”已开启。

内容的提问来源于stack exchange，提问作者Paper_Box_4112