Flutter v1.12.13 的一些坑

最近忙着升级Flutter SDK版本，遇到了一些问题，于是记录下来。

资源文件命名

cannot load assets file starting with “#” from the rootBundle after install

• #开头 #xxxx.png
• 带空格 xxx xxx.png
• 中文字符 4401-校历.svg
• 特殊字符非拉丁

解决

• 修改命名方式
• 执行git revert 383e90eb13bdc50ca0cce9f2575329ba8593506e，回滚Flutter版本
• 坐等官方发hotfix

命名不规范，alex两行泪

ios bitcode

因为某些问题，现存的ios 项目无法开启 bitcode，但是v1.12.13中Flutter默认开启了这个，并且引擎也是enable bitcode了的。这个会导致整个项目无法编译成功。网上到处搜索了下，也问了一些ios大佬，最终Flutter Team大佬告诉了使用命令来抽离出bitcode的办法。

• 执行命令flutter build ios-framework --no-debug --no-profile，生成App.framework(20.2MB)和Flutter.framework(369.8MB)

➜  flutter_module flutter build ios-framework --no-debug --no-profile
Building framework for com.example.flutterModule.cc in release mode...
 ├─Populating Flutter.framework...                               1,486ms
 ├─Building Dart AOT for App.framework...
  121.1s (!)
 ├─Assembling Flutter resources for App.framework...                0.2s
 └─Moving to build/ios/framework/Release                            0.0s

• cd 到framework，使用xcrun bitcode_strip -r app -o app抽离bitcode app 为App.framework 里面的那个可执行文件

同理也给Flutter.framework做相同操作xcrun bitcode_strip -r Flutter -o Flutter

抽离之后App.framework(10.6MB)和Flutter.framework(39.2MB)

安卓混合开发代码迁移

add-to-app官方文档 喵在Flutter 升级 1.12 适配教程中提到了关于插件注册的变化，这部分我就不再提了。

• FlutterActivity 设置透明 官方api有问题，BackgroundMode枚举并没有暴露出来

  FlutterActivity
    .withNewEngine()
    .backgroundMode(FlutterActivity.BackgroundMode.transparent)
    .build(context)

暂时可以通过下面代码来设置

       Intent intent = FlutterActivity.withNewEngine().initialRoute('route').build(activity);
       intent.putExtra("background_mode","transparent");
       activity.startActivity(intent);

• 官方支持缓存引擎

但是我没有发现初始化route的方法,如果从原生进一个flutter页面就要new一个引擎，那么这个 FlutterEngineCache的作用是？希望有知道的小伙伴能答疑一下。

更新

你可以通过 flutterEngine.getNavigationChannel().setInitialRoute('my/route');

但是页面堆载管理就比较复杂了，这也是咸鱼flutter_boost为我们做的事情了。

创建

    // Instantiate a FlutterEngine.
    flutterEngine = new FlutterEngine(this);

    // Start executing Dart code to pre-warm the FlutterEngine.
    flutterEngine.getDartExecutor().executeDartEntrypoint(
      DartEntrypoint.createDefault()
    );

    // Cache the FlutterEngine to be used by FlutterActivity.
    FlutterEngineCache
      .getInstance()
      .put("my_engine_id", flutterEngine);

使用

startActivity(
      FlutterActivity
        .withCachedEngine("my_engine_id")
        .build(currentActivity)
      );

混合开发调试热重载

混合开发一般都是安卓aar，ios framework这种方式，v1.12.13里面支持调试和热重载等功能。

方法很简单，以安卓为例子。

1. 打debug的flutter aar，引用到安卓项目中，你可以用maven本地引用，也可以上传到自己的maven库中远程引用。
2. debug运行安卓项目
3. vscode中打开你的flutter module项目，vscode的command palette中找到 debug:flutter attach to process(devices)
4. 进去你安卓项目中的flutter模块，这个时候vscode会同步文件到设备中。

我试了下可以debug，可以热重载，但是感觉有bug，第一次进去不会进断点，必须热重载一下。

ios的话，有bug，热重载报错

对于之前苦逼进行混合调试的我来说，已经很不错了，将就用了，希望官方继续完善。

安卓华为设备闪退

华为设备闪退

• Huawei DUB AL00A
• Huawei DUB AL00
• Honor BKK AL10
• Huawei ARS AL00
• Huawei DUB AL20

issue里面已有大佬提出了解决方案，回滚引擎。官方也做了回滚，坐等hotfix。

在官方回复的这段时间，尝试了接触了一下flutter引擎这个东西（本来想通过重新打包引擎来去掉bitcode，Creating-an-iOS-Bitcode-enabled-app，以及重新打包引擎来解决安卓华为闪退)，可以不用，但是要会。

• 编译引擎官方文档

• 准备编译引擎环境

1. 注意下交叉编译平台只有mac同时支持安卓和ios

• Linux supports cross-compiling artifacts for Android, but not iOS.

• macOS supports cross-compiling artifacts for Android and iOS.

• Windows doesn’t support cross-compiling artifacts for either Android or iOS.

mac真香？能交叉编译安卓和ios的只有mac，让我大窗户儿用户情何以堪。后面为mac上面操作

2. 设置这个，你懂的

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

3. 下载google的depot_tools工具包 depot_tools是个工具包，里面包含gclient、gn和ninja等工具。是Google为解决Chromium源码管理问题为Chromium提供的源代码管理的一个工具。

• clone代码

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

• 设置环境变量

  export PATH="$PATH:/xxx/xxx/depot_tools"

4. 到github.com/flutter/eng… 下载代码到本地，官方建议你fork，这样可以方便更新，看个人情况
5. 在engine目录下面创建.gclient文件

• 可以使用fork的branch,添加下面内容，替换你fork的名字

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

• 也可以指定一个某个版本，比如我们指定回滚奔溃的版本

solutions = [
  {
    "managed": False,
    "name": "src/flutter",
    "url": "https://github.com/flutter/engine.git@2994f7e1e682039464cb25e31a78b86a3c59b695",
    "custom_deps": {
      'src/third_party/skia': "https://skia.googlesource.com/skia.git@768f900a88cbfc5237e8edcc16aadde32536ed3e",
      'src/third_party/wuffs': 'https://skia.googlesource.com/external/github.com/google/wuffs.git@65e7b2b6c98a4d35e26bc2fc437e2e00f1393dc2',
    },
    "deps_file": "DEPS",
    "safesync_url": "",
  },
]

6. cd 到engine目录 执行gclient sync，这是一个漫长的过程而且网络没有问题的话
7. Flutter的引擎是基于Ninja进行构建的，Ninja是Google为了改进编译速度而开发出来的， Chromium目前也是通过Ninja进行构建的，没办法Flutter team的成员大部分来之Chromium

全部参数组合

构建主要参数

• optimized/unoptimized(是否优化),
• debug/profile/release
• cpu 安卓分arm，arm64，x86和x86_64
• cpu ios 分arm，arm64，还有一个模拟器参数–simulator

8. cd到src/flutter/tools下面

执行命令 gn --android --runtime-mode=release 3618个文件将会编译，根据你的mac的性能可能是半小时至一辈子的时间。

编译完成之后会在src/out下面生成android_release文件夹

对于安卓来说，你可以直接从这个文件夹里面把Flutter.so给弄出来直接使用

9. cd到src/flutter/tools下面

执行命令gn --runtime-mode=release 4271个文件，这里我的mac被alex的mac弯道超车，我花了半天时间才编译完毕。。

编译完成之后会在src/out下面生成host_release文件夹，为啥要做这一步呢，如果你想用你编译的引擎来打包的话，这个文件夹是必须生成的。

10. 使用本地引擎打包

flutter build apk --target-platform android-arm --local-engine-src-path /Users/roott/Documents/Tools/flutter/engine/src --local-engine=android_release

• –local-engine-src-path指向engine/src

• –local-engine 指向的是engine/src/out下面的android_release目录

结语

最近发现官方在弄Fuchsia,加上听小道消息说国内厂商都在适配Fuchsia，2020年我们应该很快就能吃上Fuchsia了，新的一年新的期待。

欢迎加入Flutter Candies，一起生产可爱的Flutter小糖果( QQ群:181398081)

最最后放上Flutter Candies全家桶，真香。