指南
如何在 Capacitor 中使用 Capacitor Patch
使用 @capgo/capacitor-patch
在过程中从版本控制的 patch 目录中应用选定的 Capacitor 修复 cap sync 以及 cap update.
安装
npm install @capgo/capacitor-patch
npx cap sync
列出可用补丁
npx capgo-capacitor-patch list --all
该目录包含补丁 ID、目标包、支持的 Capacitor 版本,以及指向上游 Capacitor PR 的链接。
在 Capacitor 配置中选择补丁
import type { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = {
appId: 'com.example.app',
appName: 'Example',
webDir: 'dist',
plugins: {
CapacitorPatch: {
patches: ['upstream-pr-8418-android'],
strict: true,
},
},
};
export default config;
演练与同步
npx capgo-capacitor-patch doctor --phase package --strict
npx cap sync
先运行包级补丁 sync 以及 update后运行原生项目补丁 sync 以及 update.
配置
patches- 指定要应用的补丁 ID。recommended- 应用 Capgo 标记为推荐的补丁。disabled- 跳过指定的补丁 ID。strict- 当选定的 patch 不兼容或无法应用时,操作会失败。
完整参考
- GitHub: https://github.com/Cap-go/capacitor-patch/
- 文档: /docs/plugins/capacitor-patch/
继续阅读 使用 @capgo/capacitor-patch
如果你正在使用 使用 @capgo/capacitor-patch 要规划原生插件工作,请将其与 @capgo/capacitor-patch 有关 @capgo/capacitor-patch 的实现细节,请参阅 Capgo 插件目录 查看 Capgo 插件目录中的产品工作流, Capgo 提供的 Capacitor 插件 查看由 Capgo 提供的 Capacitor 插件中的实现细节, 添加或更新插件 关于“添加或更新插件”中的实现细节,以及 Ionic Enterprise 插件替代方案 关于“Ionic Enterprise 插件替代方案”中的产品工作流。