最近忙著升級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裡面支援除錯和熱過載等功能。
方法很簡單,以安卓為例子。
- 打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全家桶,真香。