Flutter混编之路——iOS踩坑记录

一、运行Xcode编译或者flutter run/build 过程中报错："x86_64" is not an allowed value for option "ios-arch".

---

解决方案

在Debug.xcconfig中指定 “FLUTTER_BUILD_MODE=debug”，Release.xcconfig中指定“FLUTTER_BUILD_MODE=release”

错误分析

这看起来是在模拟器编译环境下选择了真机的Framework什么的，后来查询发现是没有设置这个变量。因为工程的Build Phases里运行了<"$FLUTTER_ROOT/packages/flutter_tools/bin/xcode_backend.sh" build>相关命令，而xcode_backend里为build_mode变量设置了默认值"release"，这使得在查找Flutter.framework等编译所需的“原材料”时，默认选择了release的目录，导致了这个错误，所以，加上debug这个设置后，会去ios这个目录中查找相关文件，就不会有问题了。附目录截图：

注：所在目录 flutter/bin/cache/artifacts/engine/

二、Flutter plugin not installed; this adds Flutter specific functionality. Dart plugin not installed; this adds Dart specific functionality

---

解决方案

1.) Start the Android Studio application

2.) Open plugin preferences (Preferences>Plugins on macOS, File>Settings>Plugins on Windows & Linux).

3.) Select Browse repositories…, select the Flutter plug-in and click install .

4.) Click Yes when prompted to install the Dart plugin.

5.) Click Restart when prompted.

错误分析

如果你使用的是iOS开发环境或者没有安装Flutter插件的Android Studio，会报这个错误。Flutter是Google开发的移动开发SDK，为了方便，基于自己的IDE开发了Flutter插件，以方便集成过程。在Flutter生成双端产物的时候，需要经过插件做一些操作。

三、Android license status unknown

---

解决方案

执行 “flutter doctor --android-licenses” 命令

会问你'Do you want to review the licenses?'，输入“y” 然后 回车，这时再执行一次flutter doctor就好了

四、MissingPluginException(No implementation found for method xxx on channel xxx)

---

解决方案

方案一：flutter clean一下，再次 flutter run/build

方案二：将flutter run的进程终止掉重新 flutter run/build

方案三：看看你的FlutterPluginRegistrant产物是否存在，是否更新了

错误分析

问题本质是Plugin的方法没有找到，也可能是Plugin本身就没有注册成功。老版本的Flutter SDK遇到这个问题可能是没有触发GeneratedPluginRegistrant.register(this)，新版本的已经不需要手动触发了。

五、Waiting for another flutter command to release the startup lock

---

解决方案

rm ./flutter/bin/cache/lockfile

错误分析

原因是在flutter编译等操作运行过程中，会创建一个文件锁，但是由于一些原因锁没有释放导致的，而且一直无法释放……

六、'Flutter/Flutter.h' file not found

---

解决方案

方案一：如果集成方式是静态库(.a)，需要在引用Flutter的工程中，修改Build settings中的Header Search Paths，将Flutter所在目录加入其中。

方案二：如果集成方式是动态库(.framework)，说明在引用Flutter的工程中并没有依赖成功，需要检查Flutter.framework包内是否包含Headers文件夹，是否其中包含Flutter.h，另外就是Podspec和podfile是否正确。还有，Cocoapods必须1.5版本及以上。

方案三：如果你用的podspec.json，试试改写成podspec（这个坑曾让我浪费了几天的时间……）

七、error: cannot parse the debug map for xxx: No such file or directory

---

解决方案

依赖产物只针对 真机 ，但调试中使用了另一种 模拟器。或者反过来了。

错误分析

真机和模拟器的平台是不同的，符号也不同。

八、diff: /../Podfile.lock: No such file or directory

---

解决方案

方案一：重新pod install

方案二：删除workspace、podfile.lock、Pods/、~/Library/Developer/Xcode/DerivedData

方案三：

1、运行sudo gem install cocoapods-deintegrate安装快速解除项目cocopods依赖的库

2、安装成功后，cd到你项目的更目录运行pod deintegrate解除项目cocopods依赖

3、运行pod install,重新安装cocopods

错误分析

Cocoapods的锅……

九、Flutter Bitcode

---

解决方案

在podfile中禁止bitcode

错误分析

Flutter相关集成是不支持bitcode的，所以需要将相关产物的bitcode功能关闭。如果你的现有工程中仓库众多，有的仓库是必须bitcode的，这样的话就需要每次pod install之后再在工程配置中手动设置回来，以下脚本放在podfile中可以解决此问题。

post_install do |installer|

        installer.pods_project.targets.each do |target|

                if target.name =="App" || target.name =="Flutter"

                        target.build_configurations.each do |config|

                                config.build_settings['ENABLE_BITCODE'] ='NO'

                        end

                end

        end

end

十、module importing failed: ('invalid syntax', ('temp.py',xxx

---

解决方案

执行以下命令

brew update

brew uninstall --ignore-dependencies libimobiledevice ios-deploy cocoapods

brew uninstall --ignore-dependencies usbmuxd

brew install --HEAD usbmuxd

brew unlink usbmuxd

brew link usbmuxd

brew install --HEAD libimobiledevice

brew install ideviceinstaller ios-deploy cocoapods

十一、Flutter集成到现有工程后，性能问题

---

解决方案

用Release产物集成

问题分析

为了实现Hot refresh功能，Flutter在Debug下做了很多工作，影响了性能，可以通过修改

FLUTTER_BUILD_MODE的值（"debug" => "release"）

使用Release产物集成的方式屏蔽这部分影响。注意，flutter_assets是需要同时更新的，Debug产物中含有kernel_blob.bin文件，Release产物则没有。

十二、iOS系统中，第一次从Native跳转到Flutter页面时，会出现LaunchScreen

---

解决方案

采用继承、Category同名方法等方式，覆盖FlutterViewController的splashScreenView的get方法，直接返回成员变量，将中间的读取LaunchScreen页面过程覆盖掉，甚至可以自定义自己的逻辑。

问题分析

Flutter的渲染是异步的，第一次加载需要创建Application和页面，无法及时返回结果，所以Flutter自己把这部分逻辑加到了SDK内部，其实是为了解决 “纯Flutter App首屏白屏” 问题，但给我们这种混编的App带来了麻烦。

---

以上是我们到目前为止遇到的主要坑位，以及解决方案和原因分析，Flutter无论从性能还是人效方面来讲，都会在熟悉之后节省不少成本，希望各位能从我们的经验中节省更多宝贵的时间。同时，也希望大家把更多的埋坑记录发到评论里，帮助友队一起学习，一起成长。欢迎技术交流！