Flutter v1.12.13 的一些坑

时间 2020-01-16

标签 flutter v1.12.13 一些繁體版

原文原文链接

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

资源文件命名

cannot load assets file starting with "#" from the rootBundle after installios

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

解决git

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

命名不规范，alex两行泪github

ios bitcode

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

执行命令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)bash

安卓混合开发代码迁移

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

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

FlutterActivity
    .withNewEngine()
    .backgroundMode(FlutterActivity.BackgroundMode.transparent)
    .build(context)
复制代码

暂时能够经过下面代码来设置app

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

官方支持缓存引擎

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

更新

你能够经过 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里面支持调试和热重载等功能。

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

打debug的flutter aar，引用到安卓项目中，你能够用maven本地引用，也能够上传到本身的maven库中远程引用。
debug运行安卓项目
vscode中打开你的flutter module项目，vscode的command palette中找到 debug:flutter attach to process(devices)
进去你安卓项目中的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，以及从新打包引擎来解决安卓华为闪退)，能够不用，可是要会。

注意下交叉编译平台只有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上面操做

fq设置代理，你懂的

export http_proxy=http://127.0.0.1:1087
    export https_proxy=http://127.0.0.1:1087
复制代码

下载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"

到https://github.com/flutter/engine 下载代码到本地，官方建议你fork，这样能够方便更新，看我的状况
在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": "",
  },
]
复制代码

cd 到engine目录执行gclient sync，这是一个漫长的过程并且网络没有问题的话
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

cd到src/flutter/tools下面

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

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

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

cd到src/flutter/tools下面

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

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

使用本地引擎打包

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全家桶，真香。