Flutter engine编译过程遇到的那些坑

3980次阅读 | 发布于4年以前

前言

在进行Flutter混合开发过程中，我们难免会遇到一些Flutter engine相关的bug或官方Flutter engine不能解决我们特定的一些问题，这时我们就需要根据特定需求来自己修改Flutter engine源码并编译打包。比如作者就刚刚遇到iOS原生项目集成Flutter时存在FlutterViewController有内存泄露的情况，其实已经有开发人员发现这个问题并给Flutter团队提了issue，但貌似目前都尚未解决，我们又不想坐等官方解决，那样太被动，那只有自己来修改Flutter engine源码解决了。

安装engine开发环境

修改Flutter engine，首先要安装engine开发环境，官方文档： https://github.com/flutter/flutter/wiki/Setting-up-the-Engine-development-environment

根据官方文档在安装过程中遇到两个问题：

1、depot_tool工具下载问题

是engine编译过程需要一个Chromium的depot_tool工具，该工具建议是通过下载git源码来安装，下载命令：

git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git

遇到问题

depot_tools不能正确安装

问题分析

通过在终端输入curl ip.cn来查看终端网络是否走代理，结果发现并没有走代理。

问题原因

depot_tools需要通过命令行git clone下来源码，该工具源码托管在googlesource.com下，要使用VPN代理才能下载下来，虽然自己电脑使用了Shadowsocks代理，但是终端下载默认是不走Shadowsocks客户端代理的。

解决方案：

下载Shadowsocks-NG版本，然后在Shadowsocks菜单中“复制终端代理命令”粘贴到终端执行即可使终端走代理。

2、`gclient sync`执行后下载依赖包的问题

gclient sync命令执行后会下载一系列engine相关的依赖库，下载过程中会报一个类似invalid proxy for 127.0.0.1:1087的错误并中断下载。

遇到问题

下载过程中报invalid proxy for 127.0.0.1:1087错误

问题分析

通过查看错误日志，找到报错文件python2.7中的urllib.py，打开后对相关代码进行打印再次执行gclient sync后发现如下图中print结果为

python_print::::::::::name = open_127.0.0.1

结果表明urltype获取到的值为127.0.0.1而不是http，所以推测应该是终端代理命令配置有误。

问题原因

在Shadowsocks菜单中点击“复制终端代理命令”后，修改了部分命令导致：

修改后：

alias proxy-on='export http_proxy=127.0.0.1:1087;export https_proxy=$http_proxy'
alias proxy-off='unset http_proxy;unset https_proxy'

修改前（完整复制）：

export http_proxy=http://127.0.0.1:1087;export https_proxy=http://127.0.0.1:1087;

为了在终端中灵活控制是否开启代理，导致修改命令时误将http://协议删掉了。

解决方案

将127.0.0.1:1087前加上协议名称改为http://127.0.0.1:1087即可。

编译引擎

在为iOS编译可执行文件时都很顺利，但是为安卓编译可执行文件时最后一步报了symbol(s) not found for architecture i386的错误。

遇到问题

FAILED: clang_x86/gen_snapshot 
../../buildtools/mac-x64/clang/bin/clang++ -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.14.sdk -mmacosx-version-min=10.12 -m32  -stdlib=libc++ -Wl,-search_paths_first -L. -Wl,-rpath,@loader_path/. -Wl,-rpath,@loader_path/../../.. -Wl,-pie -Xlinker -rpath -Xlinker @executable_path/Frameworks -o clang_x86/gen_snapshot -Wl,-filelist,clang_x86/gen_snapshot.rsp  -framework CoreFoundation -framework CoreServices -framework AppKit -framework ApplicationServices -framework Carbon -framework CoreVideo -framework Foundation -framework OpenGL -framework Security -framework IOKit -ldl -lpthread
.
.
ld: symbol(s) not found for architecture i386
clang-8: error: linker command failed with exit code 1 (use -v to see invocation)
ninja: build stopped: subcommand failed.

解决方案

根据报错提示推测应该是系统对应的SDK不包含 i386 architecture，经过查找资料发现已有开发者提了一个issue并且已经自行解决，issue地址：

https://github.com/flutter/flutter/issues/22598

最终是使用Xcode降级到9.4.1版本的方案解决了这个问题。

使用自编译引擎打包

执行编译打包并运行命令：

flutter run --local-engine-src-path=/Users/bruce/opensource/flutter/engine/src --local-engine=ios_debug_sim_unopt

该命令以一个Unable to detect local Flutter engine build directory.错误结束。

遇到问题

命令执行后具体打印错误信息如下：

Failed to build iOS app
Error output from Xcode build:
↳
    ** BUILD FAILED **

Xcode's output:
↳
    === BUILD TARGET Runner OF PROJECT Runner WITH CONFIGURATION Debug ===
    Unable to detect local Flutter engine build directory.
    Either specify a dependency_override for the sky_engine package in your pubspec.yaml and ensure --package-root is set if necessary, or set the $FLUTTER_ENGINE
    environment variable, or use --local-engine-src-path to specify the path to the root of your flutter/engine repository.
    Failed to package /Users/bruce/testworkspace/flutter_engine_test/flutter_engine_test.
    Command /bin/sh failed with exit code 255

问题分析

根据报错信息提示无法检测到本地flutter引擎构建目录，但实际命令中--local-engine-src-path参数后边跟的就是具体flutter引擎目录，这也是根据官方文档说明的写法，且命令执行后Generated.xcconfig文件中对应的值确实改变了，如下图所示：

于是，作者又根据报错信息查找对应命令执行文件

根据源码分析，它是去flutterRoot目录的平级目录去找engine目录，没有找到就报了以上错误，所以--local-engine-src-path参数的值设置是没有用的。

问题原因

推测应该是flutter执行命令源码的一个bug。

解决方案

将engine目录直接copy到flutter SDK同级目录即可解决，实际上engine和sdk放在统计目录执行命令是就无需在带上--local-engine-src-path参数，如下图所示正确执行方法和结果：

总结