如何通过Amplify CLI设置Cognito用户池preferred_username为登录选项

首次配置场景（执行amplify add auth时） #

当引导流程走到How do you want users to be able to sign in?步骤时，不要直接确认默认的Username选项，可通过上下方向键切换选择预设登录方案：

• 选择Email：仅支持邮箱作为唯一登录方式
• 选择Phone Number：仅支持已验证手机号作为唯一登录方式
• 选择Email or Phone Number：支持邮箱/手机号二选一登录
• 选择Username为主登录方式时，后续引导会额外询问是否允许用户使用邮箱、已验证手机号、preferred_username作为辅助登录别名，按需勾选对应选项即可。

如果需要更精细化的属性配置，可在初始配置第一步选择Manual configuration模式，自定义所有登录相关参数。

已有Auth资源修改场景 #

如果已经完成amplify add auth配置需要调整登录方式，执行以下操作：

1. 运行命令amplify update auth，选择目标auth资源实例
2. 在操作选项中选择Update sign-in and sign-out experience
3. 按引导重新选择需要的登录方式，开启对应登录别名
4. 配置完成后执行amplify push即可将变更同步到AWS云端

注意：Cognito用户池的主登录方式创建后不支持修改，调整主登录方式会触发用户池资源重建，原有用户数据会被清空，操作前请做好数据备份。

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