创建补丁

概述

Patch（补丁）是针对某个 Release 的增量更新。当你修复了 Bug 或做了小改动后，可以通过补丁直接推送给用户，无需重新提交应用商店。

创建 Patch

在你的 Flutter 项目根目录运行：

patchwing patch

CLI 会自动：

1. 构建你的 Flutter 应用（Release 模式）
2. 提取新的 libapp.so
3. 与 baseline 进行二进制差分，生成补丁文件
4. 将补丁上传到 Patchwing 服务器

补丁生效

补丁上传后会立即生效。当用户下次启动应用时：

1. 应用检查 Patchwing 服务器是否有新补丁
2. 如果有，下载补丁文件（通常只有几十 KB）
3. 应用补丁到本地 libapp.so
4. 下次启动时使用更新后的代码

管理补丁

查看补丁列表

patchwing patches list

禁用补丁

如果发现补丁有问题，可以立即禁用：

patchwing patches disable --patch-id <ID>

回滚补丁

回滚会让用户回到上一个正常的补丁版本：

patchwing patches rollback --patch-id <ID>

你也可以在 Patchwing Console 中进行这些操作。

注意事项

• 补丁只能包含 Dart 代码变更，不支持原生代码变更
• 每个补丁都基于 Release 的 baseline 生成
• 补丁大小通常在 10-100 KB 之间
• 建议在推送补丁前进行充分测试