iOS环境下Firebase邮箱链接认证的自动化测试方案咨询

方案1：拦截模拟器控制台日志提取链接并转换为APP适配格式 #

Firebase Auth模拟器会把邮件内容直接输出到控制台，你可以从中提取Web版认证链接，手动转换成APP支持的Deep Link/Universal Link：

• 先在iOS项目中配置模拟器环境：设置FIREBASE_AUTH_EMULATOR_HOST为localhost:9099，确保Auth请求走模拟器。
• 调用sendSignInLinkToEmail方法发起邮箱登录请求，此时控制台会打印包含认证链接的邮件内容，找到其中的actionURL字段（格式类似https://your-project.firebaseapp.com/__/auth/action?mode=signIn&oobCode=xxx）。
• 将这个Web URL转换成APP适配的链接：根据你的APP的自定义Scheme或Universal Link规则，替换域名部分或直接拼接参数。比如你的Scheme是yourapp://，可以构造为yourapp://auth/signin?mode=signIn&oobCode=xxx。
• 在XCTest中使用UIApplication.shared.openURL(_:)触发这个APP链接跳转，然后继续验证认证流程。

方案2：直接通过REST API生成APP适配的认证链接 #

绕过邮件发送环节，直接调用Firebase Auth模拟器的REST接口生成适配APP的链接：

• 向http://localhost:9099/v1/accounts:sendOobCode发送POST请求，请求体指定continueUrl为你的APP链接：

{
  "requestType": "EMAIL_SIGNIN",
  "email": "test@example.com",
  "continueUrl": "yourapp://auth/complete"
}

• 接口返回的oobLink就是直接适配APP的认证链接，无需转换，直接在测试中使用即可。
• 测试时调用这个接口拿到链接后，触发APP跳转，再调用signInWithEmailLink完成认证。

方案3：利用模拟器邮件捕获功能读取本地邮件文件 #

配置Firebase模拟器将邮件保存到本地文件，测试代码读取文件提取链接：

• 修改firebase.json配置邮件模拟器的交付方式为文件：

{
  "emulators": {
    "auth": {
      "port": 9099
    },
    "email": {
      "port": 1025,
      "delivery": "file",
      "outputDir": "./emulator-emails"
    }
  }
}

• 发起邮箱登录请求后，邮件会被保存到指定目录的文件中，测试代码可以读取文件内容，用正则表达式提取actionURL，再转换成APP适配的链接。

测试验证步骤 #

不管用哪种方案，最后都要验证认证流程是否完成：

1. 触发APP链接跳转后，调用Auth.auth().isSignIn(withEmailLink: yourAppLink)验证链接有效性。
2. 调用Auth.auth().signIn(withEmail: "test@example.com", link: yourAppLink)完成登录。
3. 检查Auth.auth().currentUser是否不为nil，且邮箱匹配测试邮箱。

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