AWS SDK for iOS 在 Xcode 16 和 iOS 18 中的 WebView 登录冻结问题解析

问题背景

近期有开发者在使用 AWS SDK for iOS 时遇到了一个棘手的问题：在升级到 Xcode 16 和 iOS 18 后，AWSMobileClient 的 signIn 方法中 WebView 登录界面会出现完全冻结的情况。这个问题只出现在新版本的开发环境中，而在 Xcode 15.4 和 iOS 17.x 上则能正常工作。

问题现象

开发者描述的具体症状包括：

1. 调用 AWSMobileClient.default().showSignIn 方法后，WebView 界面会加载但立即冻结
2. 界面上只能看到取消按钮和底部工具栏，内容区域空白
3. 所有 WebView 内的按钮都无法响应
4. 问题仅出现在 Xcode 16 和 iOS 18 模拟器环境中

技术分析

经过深入调查和问题重现，我们发现这个问题的根源与项目的架构设置有关。具体来说：

1. 架构排除设置的影响：项目中设置了 EXCLUDED_ARCHS[sdk=iphonesimulator*] = arm64，这在新版本的 Xcode 和 iOS 中会导致 WebView 渲染异常。

2. 依赖冲突：当项目同时包含 AWS SDK 和其他第三方库（如 Firebase 和 Google 登录相关库）时，架构设置会引发更复杂的兼容性问题。

3. 构建系统变化：Apple 在 Xcode 16 和 iOS 18 中对构建系统做了内部调整，这使得之前能够正常工作的架构排除设置现在会导致运行时问题。

解决方案

针对这个问题，我们推荐以下解决方案：

1. 移除架构排除设置：

   • 从项目设置中移除 arm64 的排除设置
   • 从 Podfile 的 post_install 脚本中移除相关配置
   • 确保所有依赖库都已更新到最新版本

2. 清理构建环境：

   • 完全清理 Derived Data
   • 清除构建文件夹
   • 执行干净的 pod install

3. 检查部署目标：

   • 确保所有 Pod 的部署目标版本一致
   • 避免出现 iOS 8 等过低版本的设置

深入技术细节

这个问题实际上反映了现代 iOS 开发中几个重要的技术点：

1. 架构过渡：随着 Apple Silicon Mac 的普及，arm64 架构在模拟器环境中的支持变得越来越重要。过度排除架构可能会导致意想不到的运行时行为。

2. 构建系统演进：Xcode 16 对构建系统做了优化，使得一些之前被容忍的配置现在会被更严格地处理。

3. 依赖管理：大型项目往往包含多个第三方库，这些库可能有不同的架构要求，需要仔细协调。

最佳实践建议

为了避免类似问题，我们建议开发者：

1. 定期更新所有依赖库到最新版本
2. 谨慎使用架构排除设置，只在确实必要时使用
3. 保持开发环境的整洁，定期清理构建缓存
4. 在升级 Xcode 和 iOS 版本时，进行全面的兼容性测试

总结

这个案例展示了开发环境升级可能带来的兼容性挑战。通过理解问题的根本原因并采取适当的解决措施，开发者可以确保 AWS SDK for iOS 在各种环境下都能稳定工作。记住，保持开发环境的规范化和一致性是预防这类问题的关键。