欢迎关注微信公众号：FSA全栈行动 👋
一、概述
等了这么久，就在 4月9号 这一天，Shorebird 的 1.0 正式版终于来了！本次最关心的还是对 iOS 的热更新支持得如何了，因为在之前的版本中，iOS 的性能表现简直差到无法使用~
先给个结论：iOS 端终于能用了！通过测试，iOS 端打完补丁后的性能表现已达上线水平 🥳
需要注意的是：
iOS热更新稳定版本需要使用最新版本的Shorebird CLI (1.0.0)和最新稳定版本的Flutter (3.19.5)。
但是
对，但是，先不要着急用！
二、踩坑
我在发布的当天就升级到 1.0 来尝尝鲜，结果在打完补丁后，有几个页面灰屏了！！！
当时脑袋嗡嗡的，我就只改了文本的颜色，不至于吧~ 😕
根据控制台的报错的内容定位到了项目里以下两处代码（已简化）
dart
bool _isExist(SomeType type) {
try {
final model = state.models.firstWhere(
(element) => element.type == type,
);
return true;
} catch (e) {
return false;
}
}
dart
String value = '';
...
try {
return json.decode(value);
} catch (e) {
return null;
}推测 tryCatch 失效了，然后我建了一个最小的 Demo 做测试，竟然一切正常。。。
然后开始忙需求去了，直到 4月15号 小伙伴说官方有提到相关说明，如下图所示
还真是 tryCatch 导致的，现在我们能做的就是静静的等待下个版本了。
三、脚本适配（混编）
关于基本使用，这里就不再赘述，有需要的小伙伴可以看我之前的两篇文章
我们接下来讲一讲升级到正式版后的一些调整
以下是
Shorebird的1.0与0.22.1版本之间的命令改动
ios-framework-alpha 改名为 ios-framework
diff
- shorebird release ios-framework-alpha --release-version 7.0.0+1
+ shorebird release ios-framework --release-version 7.0.0+1flutter versions use 废弃
现在你再按如下命令执行，会提示你找不到 use
shell
shorebird flutter versions use 3.19.3
Could not find a subcommand named "use" for "shorebird flutter versions".
Usage: shorebird flutter versions <subcommand> [arguments]
-h, --help Print this usage information.
Available subcommands:
list List available Flutter versions.
Run "shorebird help" to see global options.如果你需要指定 Flutter 版本，就得在 release 命令中使用 --flutter-version
ini
# 安卓
shorebird release aar --release-version=7.0.0+1 --flutter-version=3.19.5
# iOS
shorebird release ios-framework --release-version=7.0.0+1 --flutter-version=3.19.5release 的 --force 废弃
shell
The --force flag has been deprecated
If you believe you have a valid reason to use the --force flag, please reach out to the Shorebird team by filing an issue at https://github.com/shorebirdtech/shorebird/issues/new
diff
- shorebird release aar -f --release-version 7.0.0+1
+ shorebird release aar --release-version 7.0.0+1Flutter 3.19 补丁
在【Flutter - 升级3.19之后页面多次rebuild？🤨】一文中有讲到补丁需要去到 Flutter 源码目录下执行。我们知道，Shorebird 的热更新是魔改 Flutter 实现的，所以我们就需要去找到用来打包时的魔改版 Flutter 的目录位置。
下载的 Flutter 源码统一存放在如下目录
shell
~/.shorebird/bin/cache/flutter
.
├── 5b9d29d67adb059103beefb65710ee3dabae2f85
├── 771d07b2cf97cf107bae6eeedcf41bdc9db772fa
├── a3d5f7c614aa1cc4d6cb1506e74fd1c81678e68e
├── a6d1747d7f573b2ba2e2b96db1b76ed2f3f024da
└── b9b23902966504a9778f4c07e3a3487fa84dcb2a但是目录中都是以 hash 码命名的目录，要找到对应版本的目录，可以查看如下文件里的值
shell
~/.shorebird/bin/internal/flutter.version
# a6d1747d7f573b2ba2e2b96db1b76ed2f3f024da如果原先的 flutter versions use 还能用的话，一切就很简单了，先切到对应的 Flutter 版本，然后 cat 一下该文件，拿到 hash 码就可以进入到对应版本的 Flutter 目录，但是它已经被废弃了，所以得换另一个思路。
我们依旧可以通过 flutter.version 拿到 hash 码，但是它是当前最新受支持的 Flutter 版本的，不过不慌，拿到后进入到该 Flutter 目录，因为它是以 git 的方式拉取下来的，所以有分支记录。
我们可以通过 git rev-parse 命令拿到指定版本的 hash。
shell
git rev-parse --verify refs/remotes/origin/flutter_release/3.19.3
# 得到如下输出
# 0addba5b750987523c04ebe69e9755509369615a四、脚本使用（混编）
专门服务于混编项目的 Python 脚本，用于切换原生端集成 Flutter 的方式（源码 或 二进制），以及封装 Shorebird 命令的使用。
我们日常研发依旧使用的是源码依赖的方式，只会在打最终测试包时才需要通过脚本切到二进制依赖，并结合
Jenkins来辅助完成这种万年不变的无聊步骤~
Github: github.com/LinXunFeng/...
switch_flutter_integrate.py
切换
Flutter项目的集成方式
| 参数 | 描述 |
|---|---|
-p |
原生工程路径 |
-f |
平台（ios / android） |
shell
# 二进制依赖
python switch_flutter_integrate.py -p '原生工程路径' -m 'binary' -f 'ios'
# 源码依赖
python switch_flutter_integrate.py -p '原生工程路径' -m 'source' -f 'ios' shorebird.py
自动获取版本号，并执行
Shorebird相关命令
| 参数 | 描述 |
|---|---|
-p |
原生工程路径 |
-s |
Flutter 工程路径 |
-m |
模式 （release / patch） |
-f |
平台（ios / android） |
--flutter_version |
Flutter 版本号，如：3.19.3 |
--patch_fix |
是否打 3.19 补丁，如需要请传 1 |
shell
# release
python shorebird.py -p '原生工程路径' -s 'Flutter工程路径' -m release -f ios
# 指定 Flutter 版本，以及打 3.19 的补丁
python shorebird.py -p '原生工程路径' -s 'Flutter工程路径' -m release -f ios --flutter_version=3.19.3 --patch_fix=1
# patch
python shorebird.py -p '原生工程路径' -s 'Flutter工程路径' -m patch -f ios如果文章对您有所帮助, 请不吝点击关注一下我的微信公众号：FSA全栈行动, 这将是对我最大的激励. 公众号不仅有
iOS技术，还有Android，Flutter，Python等文章, 可能有你想要了解的技能知识点哦~