Flutter iOS端保存用户登录凭证问题求助

1. 主动触发凭证保存请求 #

iOS不会自动弹出保存凭证弹窗，必须在登录成功后手动调用Flutter的Autofill API发起请求：

// 登录验证通过后立即执行
if (mounted) {
  AutofillScope.of(context).requestSavePassword();
}

注意这段代码的context必须处于AutofillGroup的范围内，否则无法生效。

2. 修正AutofillGroup与输入框配置 #

• 确保AutofillGroup完整包裹账号输入框、密码输入框、登录按钮，不要拆分包裹不同的表单元素。
• 精准设置输入框的autofillHints，避免模糊值：

  // 账号输入框（支持邮箱/用户名）
  TextField(
    autofillHints: const [AutofillHints.username], // 若为邮箱则用AutofillHints.email
    textInputAction: TextInputAction.next,
    controller: _usernameController,
    decoration: const InputDecoration(labelText: "账号"),
  ),
  // 密码输入框
  TextField(
    autofillHints: const [AutofillHints.password],
    textInputAction: TextInputAction.done,
    obscureText: true,
    controller: _passwordController,
    decoration: const InputDecoration(labelText: "密码"),
  ),
  

3. 验证Xcode配置细节 #

• 关联域名格式必须为webcredentials:your-app-domain.com，不要添加http/https前缀，且域名需与Apple Developer后台配置的一致。
• 在Info.plist中添加NSUserActivityTypes配置：

  <key>NSUserActivityTypes</key>
  <array>
    <string>$(PRODUCT_BUNDLE_IDENTIFIER).autofill</string>
    <string>com.apple.authenticationservices.autofillcredentialprovider</string>
  </array>
  

• 确认Signing & Capabilities中已开启AutoFill Credential Provider权限。

4. 实现带账号的密码提示样式 #

要让系统显示带账号的提示，需满足：

• 登录成功后不要清空账号输入框的内容（保留_usernameController的text值）。
• AutofillGroup必须同时包裹账号和密码输入框，让系统识别两者的关联。
• 使用真机测试（模拟器的Autofill行为与真机存在差异），且设备已开启iCloud钥匙串功能。

5. 额外排查点 #

• 不要用隐私模式测试，该模式下Autofill会被禁用。
• 确认App的Bundle ID与Apple Developer后台的关联域名配置完全匹配。
• 若使用了自定义输入框组件，暂时替换为原生TextField测试，排查是否有组件干扰Autofill逻辑。

内容的提问来源于stack exchange，提问作者Amir Hossein Rahmanzadeh