源码获取

说明

以下步骤在Mac系统上完结，其它系统能够参考下面的官方说明：
先附上官方的说明：Setting up the Engine development environment

因为Engine和Embedder自身依靠了很多第三方库房（并且很多第三方代码保管在chromium.googlesource.com、fuchsia.googlesource.com、skia.googlesource.com等域名下，下载进程中需求开启git署理以及http、https署理服务。），所以不能像Framework层代码一样经过git clone获取。需求凭借Chromium的depot_tools东西完结依靠的下载。

第一步下载depot_tools并将其参加环境变量
$ mkdir flutter_source
$ cd flutter_source
$ git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
 #(换成自己的目录或在当前目录履行 export PATH=$PATH:`pwd`/depot_tools)
$ export PATH=/path/to/depot_tools:$PATH
第二步装备 .gclient 文件

depot_tools中提供了gclient东西，装备环境变量后更方便食用。

新建一个.gclient 文件（PS：最好新建一个文件夹比方engine，因为一般会在.gclient 文件地点的目录下载Engine/Embedder源码），内容如下：

solutions = [
  {
    "managed": False,
    "name": "src/flutter", //指定库房的寄存位置
    "url": "https://github.com/<your_name>/engine.git", //拟定即将下载的库房地址,最好fork一份到自己库房
    "custom_deps": {},
    "deps_file": "DEPS", // 指定寄存第三方依靠的文件名。
    "safesync_url": "",
  },
]
第三步下载flutter/engine源码及其依靠。

在.gclient 文件地点的目录履行

$ gclient sync

注： 该命令再输入后或许会一段时刻内没有任何输出（网络原因），能够经过活动监视器检查网络状况（署理记住开），gclient在输出“Syncing project: 100%(106/106),done”,后还会发动cipd_client下载部分大文件（活动监视器种检查状况，搜索挑选‘cipd’能够看到），不要中断下载,下载时刻依据网络情况大约几十分钟～几小时不等。

到这一步Flutter源码就下载完了（前提是设备已经有了Flutter开发环境，已经获取过Framework层的代码即 ‘git clone github.com/flutter/flu…

第四步 切换源码。

编译前的一个重要操作是将源码切换到 本地 Flutter SDK 的 engine version (一个 commit id) 对应的提交点，防止或许呈现的报错。

  • 检出对应版别 获取当前Flutter（SDK）版别的提交信息
# 检查本地 Flutter SDK 引擎版别, 这个文件中是包含对应的 commit id 
# 当前运用的flutter目录
vim /src/flutter/bin/internal/engine.version
# 或者运用
cat /src/flutter/bin/internal/engine.version

会得到一个具体的commit_id

  • 切换源码
# 切换到engine地点目录
cd engine/src/flutter
# 拟定git版别和本地flutter sdk运用版别一致
git reset --hard <commit id>
# engine版别切换，DEPS或许也会改变，后边两个参数表示将tag、refspecs等库房信息一同同步
gclient sync -D --with_branch_heads --with_tags
Flutter Engine目录结构

以下是src/flutter中的部分目录和对应的简单说明

├── assets  #资源读取
├── common  #公共逻辑
├── flow  #烘托管道相关逻辑
├── flutter_frontend_server  #Dart构建相关逻辑
├── fml   #消息循环相关逻辑
├── lib   #Dart Runtime及烘托和Web相关逻辑
├── runtime  #Dart Runtime相关逻辑
├── shell
    ├──platform
        ├──android  #Android Embedder相关逻辑
        ├──common #Embedder公共逻辑
├── sky
├── testing  #测试相关
├── third_party

Flutter源码编译

切换到engine/src目录下

$ cd engine/src
$ ./flutter/tools/gn --android --android-cpu arm --unoptimized
$ ninja -C out/android_debug_unopt -j 8
$ ./flutter/tools/gn --android-cpu arm --unoptimized
$ ninja -C out/host_debug_unopt -j 8

留意点：

  1. 因为depot_tools设置过环境变量，不要直接运用gn命令（会运用depot_toolsde gn东西）
  2. 因为Engine是由C++开发，编译后的机器码和平台强相关，留意自己需求用的是arm/arm64或其它，其中–android-cpu能够省掉，默许就是arm格局，一起默许编译debug版别。
  3. 编译进程比较耗时，约30分钟左右，cpu或许满负荷（）

编译完结会有两个产品：

├── out
│ ├── android_debug_unopt
│ └── host_debug_unopt
  • host_debug_unopt 作用是构建flutter工程，生成Dart Kernel或特定平台的AOT文件，能在x86架构的PC设备上生成ARM架构的机器码，正是得益于这个目录产品，构建出的产品将用于Flutter项目的编译。
  • android_debug_unopt 将寄存终究构建出Engine和Embedder产品，文件较多，其中重要的文件是libflutter.jar该文件包含了Engine（libflutter.so）和Embedder的构建产品，构建出的产品将作为Flutter项目的SDK。

此外还会生成一个独立的libflutter.so文件，其包含了符号表等调试信息，文件会比较大，可用于源码调试。

看一下上述中linflutter.jar文件的结构，直接将后缀名改为zip后解压得到如下目录：

├── io
│ └── flutter    #Embedder相关代码
│     ├── BuildConfig.class
│     ├── FlutterInjector$1.class
│     ├── FlutterInjector$Builder.class
│     ├── FlutterInjector.class
│     ├── Log.class
│     ├── app
│     ├── embedding
│     ├── plugin
│     ├── util
│     └── view
└── lib
    └── armeabi-v7a    #Engine相关代码
        └── libflutter.so