跳过内容

@capgo/capacitor-patch

Apply vetted fixes to Capacitor core packages, the CLI, plugins, and native projects during sync and update hooks.

@capgo/capacitor-patch is a hook-only Capacitor package that applies selected patch files whenever Capacitor runs sync Capacitor update.

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

它修复了什么

标题:它修复了什么

Capacitor包

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

Capacitor CLI

修复的CLI JavaScript 文件。 当一个CLI修复被应用时,下一个 cap 使用修补的code命令。

原生项目

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

选择安全

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

修补程序目录

修补程序目录

修补程序默认为可选。列出已发送的目录,选择您的应用需要的修补程序ID,并将它们添加到 plugins.CapacitorPatch.patches.

每个目录条目包括:

  • 稳定的修补程序ID
  • 目标包或原生项目阶段
  • 支持的版本范围
  • 上游的Capacitor PR
  • 匹配的Capacitor+ 同步 branch
  • 包中包含的补丁文件

为什么使用它

标题:为什么使用它

使用 @capgo/capacitor-patch 情况:

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

For a full catalog and contribution guide, see the capacitor-patch 仓库.

继续从 @capgo/capacitor-patch

标题:继续从 @capgo/capacitor-patch

如果您正在使用 @capgo/capacitor-patch 来规划原生插件工作,连接它到 @capgo/capacitor-patch for the native capability in Using @capgo/capacitor-patch, @Capgo/__CAPGO_KEEP_1__-patch Capgo 插件目录 Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, 添加或更新插件 为添加或更新插件的实现细节提供详细信息,以及 Ionic 企业插件替代方案 为 Ionic 企业插件替代方案中的产品工作流程提供详细信息。