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

96
否极泰来_2662
0.5 2018.11.02 11:31 字数 1666

一、运行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无论从性能还是人效方面来讲,都会在熟悉之后节省不少成本,希望各位能从我们的经验中节省更多宝贵的时间。同时,也希望大家把更多的埋坑记录发到评论里,帮助友队一起学习,一起成长。欢迎技术交流!

Flutter
Web note ad 1