Xcode构建Flutter时--no-tree-shake-icons参数不生效的解决方法

你在Xcode中添加--no-tree-shake-icons参数不生效的核心原因是：Flutter的Release构建分两个阶段，第一阶段是Dart代码编译+资源打包（图标树摇逻辑就在这个阶段执行），第二阶段才是Xcode原生工程编译。你在Xcode配置页加的参数只会作用于第二阶段的原生编译，根本传不到第一阶段的Flutter构建流程里，自然无效。

按优先级选以下方案操作即可：

• 方案1：一劳永逸配置，适配所有Xcode触发的Archive/构建场景
  打开项目路径下的ios/Flutter/Release.xcconfig文件（如果是打Profile包就改同目录下的Profile.xcconfig），在文件末尾追加一行配置：

  EXTRA_FRONT_END_OPTIONS=--no-tree-shake-icons
  

  保存后回到项目根目录执行flutter clean清理所有历史构建缓存，再重新打开Xcode构建即可生效。
• 方案2：命令行构建时直接传参
  如果你是用终端命令触发构建，不需要改Xcode配置，直接在构建命令后追加参数即可，例如打正式ipa包的命令：

  flutter build ipa --release --no-tree-shake-icons
  

• 方案3：根治问题（不关闭树摇，不损失包体积优化效果）
  这个报错的本质是项目里存在非常量的IconData实例，树摇工具无法静态识别你用到的图标，才会抛出异常。你可以顺着报错信息给出的代码位置，把动态构造的IconData改成const修饰的常量即可：

  常见触发场景：通过接口返回的图标编码值动态构造IconData、把IconData作为可变参数传递时没有加const修饰。只要把所有用到的IconData在静态声明时加const，不需要关闭树摇就能正常构建，还能减少最终安装包体积。

常见踩坑提醒 #

• 不要在Xcode的Schema -> Run/Archive -> Arguments 里加这个参数，这个位置的参数是传给运行中的App的，和编译流程无关，加了完全没用。
• 改完配置必须执行flutter clean，否则Flutter会复用之前的构建缓存，配置不会生效。
• Debug模式默认不会触发图标树摇，只有Release/Profile模式构建才会出这个错，不需要给Debug模式加配置。

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