Flutter 3.10.3+Xcode14.3.1 iOS端启用Records特性报错求助

问题回顾 #

在Flutter 3.10.3 + Xcode 14.3.1环境下，定义了记录类型：

typedef StringKeyValue = (String, String);

Android端运行正常，但iOS端报错：This requires the experimental 'records' language feature to be enabled.，项目SDK约束为^3.0.0，目前已改用Tuple库替代，寻求原生Records的解决方法。

可能的原因 #

Dart 3.0+中Records已是正式特性，但iOS端的Flutter编译链可能存在配置滞后，或是项目中依赖的Flutter插件未适配Dart 3.0的编译规则，导致编译器误将Records识别为实验特性。

解决步骤 #

1. 统一所有依赖的SDK约束

打开项目根目录的pubspec.yaml，确保所有依赖（包括本地插件）的SDK约束都明确支持Dart 3.0+，例如：

environment:
  sdk: ">=3.0.0 <4.0.0"

若有第三方插件未更新SDK约束，尝试升级插件版本，或联系插件作者适配Dart 3.0。

2. 手动配置iOS编译参数

通过Xcode强制开启Records特性的编译支持：

• 打开项目的ios/Runner.xcworkspace文件
• 选中左侧的Runner target
• 切换到Build Settings标签页，搜索Other Dart Flags
• 在对应输入框中添加编译标志：--enable-experiment=records
• 执行flutter clean清理项目缓存后重新编译iOS端

3. 升级Flutter稳定版

Flutter 3.10.x的iOS编译链可能存在Records兼容性问题，升级到更高版本的稳定版（如3.13.x及以上）可修复此类问题：

flutter upgrade

升级后执行flutter clean和flutter pub get，再重新编译iOS项目。

4. 尝试使用具名记录类型

若上述方法无效，可尝试将匿名记录改为具名记录，可能绕过编译识别问题：

typedef StringKeyValue = ({String key, String value});

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