Flutter -- 17.渲染引擎准备工作

一.下载渲染引擎

1.下载引擎时需注意的点

• 路径不能有中文
• 工具(后续用到的下载工具)所在的目录需要有可执行权限

2.查看当前Engine版本flutter doctor -v

mac@zhangtao ~ % flutter doctor -v  
[✓] Flutter (Channel stable, 2.5.3, on macOS 11.6 20G165 darwin-x64, locale
    zh-Hans-CN)
    • Flutter version 2.5.3 at /Users/mac/flutter
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 18116933e7 (7 weeks ago), 2021-10-15 10:46:35 -0700
    • Engine revision d3ea636dc5
    • Dart version 2.14.4

[✓] Android toolchain - develop for Android devices (Android SDK version 31.0.0)
    • Android SDK at /Users/mac/Library/Android/sdk
    • Platform android-31, build-tools 31.0.0
    • Java binary at: /Applications/Android
      Studio.app/Contents/jre/Contents/Home/bin/java
    • Java version OpenJDK Runtime Environment (build 11.0.10+0-b96-7281165)
    • All Android licenses accepted.

[✓] Xcode - develop for iOS and macOS
    • Xcode at /Applications/Xcode.app/Contents/Developer
    • Xcode 13.1, Build version 13A1030d
    • CocoaPods version 1.11.2

[✓] Chrome - develop for the web
    • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

[✓] Android Studio (version 2020.3)
    • Android Studio at /Applications/Android Studio.app/Contents
    • Flutter plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/9212-flutter
    • Dart plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/6351-dart
    • Java version OpenJDK Runtime Environment (build 11.0.10+0-b96-7281165)

[✓] Connected device (1 available)
    • Chrome (web) • chrome • web-javascript • Google Chrome 96.0.4664.55

• No issues found!

• 当前Engine版本是d3ea636dc5
• Channel stable(稳定版本)

3.查看channel版本flutter channel

mac@zhangtao ~ % flutter channel                  
Flutter channels:
  master
  dev
  beta
* stable

• 共有4个版本，主分支、开发分支、公共测试版本分支、稳定版本分支(开发使用的)
• 如果想切换至某个版本flutter channel xxx，例如flutter channel dev

4.Github上查看Engine

• Engine
• 我们需要下载到稳定版本

5.查看当前Engine详细的CommitId(d3ea636dc5)

mac@zhangtao internal % cat $FLUTTER_ENGINE                     
d3ea636dc5d16b56819f3266241e1f708979c233

.zshrc中配置的环境变量(老版本使用.base_profile)
#Flutetr
export FLUTTER=~/flutter
export FLUTTER_ENGINE=${FLUTTER}/bin/internal/engine.version

• engine在flutter目录下/bin/internal/engine.version
• cat常用来显示文件内容
• d3ea636dc5d16b56819f3266241e1f708979c233当前稳定版本的CommitId

6.工具准备(使用到depot_tools)

• Chromium提供的部署工具depot_tools

#depot_tools
export DEPOT_TOOLS=~/depot_tools

//写入环境变量
export PATH=$FLUTTER/bin:DEPOT_TOOLS:$PATH

• git clone https://chromium.googlesource.com/chromium/tools/depot_tools.git
• 默认下载到家目录下也就是DEPOT_TOOLS

7.安装ant

brew install ant

8.开始下载

• 1.新建目录(路径不能含有中文)

mkdir engine

• 2.创建gclient文件

touch .gclient

• 3.配置gclient文件（保证CommitId一致）

solutions = [
    {
        "managed": False,
        "name": "src/flutter",
        "url":
"git@github.com:flutter/engine.git@d3ea636dc5d16b56819f3266241e1f708979c233
2",
        "custom_deps": {},
        "deps_file": "DEPS",
        "safesync_url": "",
}, ]

• 4.执行gclient sync（大概10G的文件）

gclient sync

二.更新渲染引擎

• 更新.gclient文件中的commitId
• 进入src/flutter目录下

git pull
git reset --hard commitID //告诉Git下次下载就下载这个CommitId

• 回到engine目录，也就是.gclient文件所在目录

gclient sync --with_branch_heads --with_tags --verbose

三.编译引擎代码(GN构建、Ninja编译)

1.首先使用GN(是一个生成Ninja)构建文件的元构建系统

• GN -> engine/src/flutter/tools/gn
• 进入engine/src/flutter/tools终端目录进行构建
• 构建后的文件会放到engine/src/out目录

# 构建iOS设备使用的引擎
# 真机debug版本 -构建后的-> ios_debug_unopt
./gn --ios --unoptimized
# 真机release版本（日常开发使用，如果我们要自定义引擎）-构建后的-> ios_release_unopt
./gn --ios --unoptimized --runtime-mode=release 
#模拟器版本 -构建后的-> ios_debug_sim_unopt
./gn --ios --simulator --unoptimized
# 主机端(Mac) -构建后的->  host_debug_unopt
./gn --unoptimized

• ios_xx_unopt，Flutter.framework
• host_debug_unopt ，server端，热重载功能

2.使用Ninja编译工程

• 进入engine/src/out目录编译
• 使用ninja -C xxx进行编译

ninja -C host_debug_unopt && ninja -C ios_debug_sim_unopt && ninja -C
ios_debug_unopt && ninja -C ios_release_unopt

engine_out.png

四.安装Ninja(Mac big Sur)

1.首先要先安装re2c并进入re2c目录

//进入家目录执行
git clone https://github.com/skvadrik/re2c.git && cd re2c

2.执行./autogen.sh

• 如果报错autoreconf: command not found,说明未安装automake
• 通过homebrew安装

brew install automake
brew install libtool

• 安装完成后继续执行步骤2./autogen.sh

3.执行./configure&&make&&make install

• 如果报错Error: Permission denied @ apply2files - /usr/local/lib/docker/cli-plugins

sudo chown -R $(whoami) $(brew --prefix)/*

• 继续执行./configure&&make&&make install

4.此时rec2就安装完成了，安装ninja

git clone git://github.com/ninja-build/ninja.git && cd ninja
./configure.py --bootstrap

5.安装cmake

• 安装cmake

brew install cmake

• 执行以下命令

cmake -Bbuild-cmake -H.
cmake --build build-cmake

6.配置Ninja

• 1.将ninja可执行文件拷贝到user/bin目录下

cp ninja /usr/bin/

• 报错cp: /usr/bin/ninja: Operation not permitted，可以在恢复模式下关闭了Rootless解决
• 可能会报错cp: /usr/bin/ninja: Read-only file system，bin文件只有只读权限，目前没找到解决办法
• 综上，因此我这里只能采用的配置环境变量方式
  
  
• 2.配置Ninja环境变量

#Flutetr
export FLUTTER=~/flutterSDK
export NINJA=~/re2c/ninja
export PATH=$FLUTTER/bin:$PATH
FLUTTER_ENGINE="${FLUTTER}/bin/internal/engine.version"
export PATH="/Users/mac/re2c/ninja":"$PATH"

• 3.测试Ninja是否安装成功

ninja --version  

• 当出现下列数据时，ninja安装成功

mac@user ninja % ninja --version
1.10.2.git

• 至此，就可以使用ninja去构建版本了
  
  
• 我这里有一个构建好的版本Flutter_engine_d3ea636dc5（提取码11rq；编译了4个版本，文件有点大）