Flutter engine 编译-构建

准备工作

depot_tools工具安装

1. mac或者linux环境
git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git

配置环境变量
export PATH="$PATH:/path/to/depot_tools"

2. windows [参考官网](https://commondatastorage.googleapis.com/chrome-infra-docs/flat/depot_tools/docs/html/depot_tools_tutorial.html#_setting_up)

在这一步碰到个坑
安装depot_toos后，depot_toos里有repo文件，导致在其他项目里使用的repo文件执行了这里，表现的现象就是其他项目里执行repo命令报错:
NameError: name 'reload' is not defined， 如果按这个错误去搜索，会发现都是说python2.x python3.x的问题，所以造成了误导。但其实是因为depot_toos自带有repo，其他项目执行repo命令的时候跑到这里了，可以在终端里输入which repo命令，看具体执行的repo文件在哪里。

代理配置

Git代理配置

Git代理配置一般需要两种，第一种是走http协议的代理，第二种是走ssh协议代理

http代理(注意最后的1087端口，根据你的梯子的端口去配置)
git config --global http.proxy http://127.0.0.1:1087
git config --global https.proxy http://127.0.0.1:1087

如果要取消http代理
git config --global --unset http.proxy
git config --global --unset https.proxy

加上http代理后，内网很可能无法访问，加上如下配置
export no_proxy="127.0.0.1,localhost,xxxx"（xxx是内网git域名）

ssh代理
open ~/.ssh/config
文件里增加
Host github.com
   HostName github.com
   User git
   # 注意这里的1080端口，如 Shadowsocks，v2ray，根据自己的梯子端口配置）
   ProxyCommand nc -v -x 127.0.0.1:1080 %h %p

终端代理配置(这是临时配置)

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

获取源码官方参考文档

构建前的配置

创建目录
mkdir engine_compile
cd engine_compile

创建gclient配置文件
[参考地址](https://chromium.googlesource.com/chromium/tools/depot_tools.git/+/HEAD/README.gclient.md)

在上一步创建的目录中执行 touch .gclient
把以下的内容复制粘贴到.gclient文件中
solutions = [
  {
    "managed": False,
    "name": "src/flutter",
    "url": "git@github.com:flutter/engine.git",
    "custom_deps": {},
    "deps_file": "DEPS",
    "safesync_url": "",
  },
]

在当前目录下执行 gclient sync， 刚开始没有任何提示的，可以打开网络监控看流量，然后静静等待，差不多12G多的内容
在实际场景中，一般都是需要获取指定版本的engine代码，所以得进入到src/flutter目录执行git reset --hard commitID加上gclient sync --with_branch_heads --with_tags --verbose才会生效。
commitID其实就是engine的version，在你的flutter环境下的 /flutter/bin/internal/engine.version可以找到

开始构建官方参考文档

gn -h 参数如下
usage: gn [-h] [--unoptimized]
          [--runtime-mode {debug,profile,release,jit_release}] [--interpreter]
          [--dart-debug] [--full-dart-debug]
          [--target-os {android,ios,linux,fuchsia}] [--android]
          [--android-cpu {arm,x64,x86,arm64}] [--ios] [--ios-cpu {arm,arm64}]
          [--simulator] [--fuchsia] [--linux-cpu {x64,x86,arm64,arm}]
          [--fuchsia-cpu {x64,arm64}] [--arm-float-abi {hard,soft,softfp}]
          [--goma] [--no-goma] [--lto] [--no-lto] [--clang] [--no-clang]
          [--clang-static-analyzer] [--no-clang-static-analyzer]
          [--target-sysroot TARGET_SYSROOT]
          [--target-toolchain TARGET_TOOLCHAIN]
          [--target-triple TARGET_TRIPLE]
          [--operator-new-alignment OPERATOR_NEW_ALIGNMENT] [--enable-vulkan]
          [--enable-fontconfig] [--enable-skshaper]
          [--enable-vulkan-validation-layers] [--embedder-for-target]
          [--coverage] [--out-dir OUT_DIR] [--full-dart-sdk]
          [--no-full-dart-sdk] [--ide IDE] [--build-glfw-shell] [--bitcode]
          [--stripped]

我们使用到的构建参数主要有以下几种
--android 指定android平台
--ios 指定ios平台
--runtime-mode debug,profile,release,jit_release 前三个大家应该都熟，第四个jit_release猜测应该是支持hot_reload的release ([Flutter's modes](https://github.com/flutter/flutter/wiki/Flutter%27s-modes)官网里没看到说明呀 )
--unoptimized 默认是optimized优化过的
--android-cpu {arm,x64,x86,arm64} 默认是arm(对应arm-v7)
--ios --ios-cpu {arm,arm64}

构建Android产物

Android的arm的debug优化版
cd src/
./flutter/tools/gn --android 
ninja -C out/android_debug -j 8
./flutter/tools/gn 
ninja -C out/host_debug -j 8

Android arm64的release优化版
cd src/
./flutter/tools/gn --android --android-cpu arm64 --runtime-mode=release
ninja -C out/android_release_arm64 -j 8
./flutter/tools/gn --android-cpu arm64 --runtime-mode=release
ninja -C out/host_release_arm64 -j 8

Android x64的profile非优化版
cd src/
./flutter/tools/gn --android --android-cpu x64 --unoptimized --runtime-mode=profile
ninja -C out/android_profile_unopt_x64 -j 8
./flutter/tools/gn --android-cpu x64 --unoptimized --runtime-mode=profile
ninja -C out/host_profile_unopt_x64 -j 8

Android使用本地引擎

终端命令行参数传入
gradlew clean assembleDebug -PlocalEngineOut=engine/src/out/android_debug_unopt

或者

在gradle.properties文件中加入如下内容
localEngineOut=engine/src/out/android_debug_unopt

或者直接使用flutter的build方式

flutter build apk --local-engine=android_debug_unopt --local-engine-src-path=/engine/src

构建IOS产物

iOS arm64未优化debug版本
cd /engine/src/
./flutter/tools/gn --ios --unoptimized --runtime-mode=debug
ninja -C out/ios_debug_unopt -j 8
./flutter/tools/gn --unoptimized --runtime-mode=debug
ninja -C out/host_debug_unopt -j 8

本地引用
flutter build ios --debug --local-engine=ios_debug_unopt --local-engine-src-path=engine/src

还有另外一种暴力方式，Android和iOS都可以直接替换掉本地flutter环境里的engine，目录在flutter/bin/cache/artifacts/engine (不推荐)

Flutter engine 编译-构建

准备工作

depot_tools工具安装

代理配置

获取源码 官方参考文档

构建前的配置

开始构建 官方参考文档

构建Android产物

构建IOS产物

获取源码官方参考文档

开始构建官方参考文档