跳过内容

@capgo/capacitor-patch

将审查过的修复应用到 Capacitor 核心包、 CLI 、插件和原生项目中,同步和更新钩子中。

@capgo/capacitor-patch 是一个只包含钩子的 Capacitor 包,应用选定的补丁文件,任何时候 Capacitor 运行时 syncupdate.

它是为在官方 Capacitor 发布之前有用的修复而构建的。集成目录跟踪外部上游 Capacitor PRs,通过 Capacitor+ 分支镜像。 sync/upstream-pr-* 注意

标题:它修复了什么

Section titled “What it patches”

Capacitor 包裹

修补 @capacitor/core, @capacitor/android, @capacitor/ios,以及第三方Capacitor插件 node_modules.

Capacitor CLI

修补了CLI JavaScript文件。当应用CLI修补程序时,下一个 cap 命令将使用修补的code。

原生项目

在应用生成的Android或iOS项目修补程序后 cap synccap update.

安全选择

版本范围、幂等性检查和严格模式有助于防止静默应用陈旧修补程序。

修补程序目录

Patch catalog

默认情况下,补丁是可选的。列出已发货的目录,选择您的应用程序需要的补丁ID,并将其添加到 plugins.CapacitorPatch.patches.

每个目录条目包括:

  • 稳定的补丁ID
  • 目标包或原生项目阶段
  • 支持的版本范围
  • 上游Capacitor PR
  • 匹配的Capacitor+同步支
  • 补丁文件与包一起发货

为什么使用它

为什么使用它

使用 @capgo/capacitor-patch 何时:

  • 当上游存在一个 Capacitor 修复但尚未发布时
  • 您的应用程序需要修复而不需要维护本地补丁脚本
  • 您希望在每次 Capacitor 同步/更新后重新应用补丁
  • 您需要一个团队可读的修复清单,展示您的应用程序依赖的修复

要查看完整清单和贡献指南,请参阅 capacitor-patch 仓库.