最近忙着升级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 里面的那个可执行文件
image
image
同理也给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里面支持调试和热重载等功能。
方法很简单，以安卓为例子。
- 打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小糖果( <a target="_blank" href="https://jq.qq.com/?_wv=1027&k=5bcc0gy"><img border="0" src="https://user-gold-cdn.xitu.io/2019/10/27/16e0ca3f1a736f0e?w=90&h=22&f=png&s=1827" alt="flutter-candies" title="flutter-candies"></a>QQ群:181398081)
最最后放上Flutter Candies全家桶，真香。
