跳过主要内容

Capacitor 补丁 Capacitor 插件

在cap同步和更新期间应用版本锁定的Capacitor核心、CLI插件和原生项目修补程序

安装

bun add @capgo/capacitor-patch bunx cap sync
npm、pnpm或yarn
  • npm install @capgo/capacitor-patch
  • pnpm add @capgo/capacitor-patch
  • yarn add @capgo/capacitor-patch

指南

如何使用 Capacitor Patch 在 Capacitor 中

使用 @capgo/capacitor-patch

在版本控制的修补程序目录中选择 Capacitor 修复并应用 cap sync 并 cap update.

安装

npm install @capgo/capacitor-patch
npx cap sync

可用修补程序列表

npx capgo-capacitor-patch list --all

该目录包含补丁ID、目标包、支持的Capacitor版本以及链接到上游Capacitor PRs。

在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 - 当选定的补丁不兼容或无法应用时,失败。

全局参考

继续使用@capgo/capacitor-patch

如果您正在使用 使用@capgo/capacitor-patch 来规划原生插件工作,连接它到 @capgo/capacitor-补丁 以获取@capgo/capacitor-patch中的实现细节 Capgo插件目录 Capgo插件目录中的产品工作流程 Capacitor 由 Capgo 提供的插件 为 Capacitor 插件的实现细节提供了 Capgo 的支持。 添加或更新插件 为添加或更新插件的实现细节 Ionic 企业插件替代品 为 Ionic 企业插件替代品的产品工作流

常见问题

Capacitor Patch插件FAQ

如何在Capacitor应用中安装Capacitor Patch插件?

运行"bun add @capgo/capacitor-patch" (或 "npm install @capgo/capacitor-patch" ),然后运行 "bunx cap sync" 以便 iOS 和 Android 项目捕获 native code。从 "@capgo/capacitor-patch" 导入您的应用code。

是否支持@capgo/capacitor-patch与React、Vue和Angular?

是。Capacitor Patch是一个Capacitor包,因此它与任何运行在Capacitor中的Web框架兼容,包括Ionic、React、Vue、Angular、Svelte和普通JavaScript。

哪个Capacitor版本支持@capgo/capacitor-patch?

Capgo插件遵循Capacitor的主要版本:使用与Capacitor主要版本匹配的插件主要版本(例如插件v8与Capacitor 8)。在GitHub README中列出的维护版本表中可以找到兼容性信息。

是否@capgo/capacitor-patch免费且开源?

是。源码code在GitHub上公开(https://github.com/Cap-go/capacitor-patch/),并且可以从npm免费安装。欢迎bug报告和pull请求。

是否可以在不经过App Store审核的情况下更新code,该code使用Capacitor Patch?

安装或升级插件会改变原生code,因此需要重新构建商店。之后,使用Capgo实时更新的JavaScript、HTML和CSS更改可以立即部署给用户。

不必等待应用程序审查,直接将 Capacitor Patch 更改部署

一旦插件在您的商店构建中, Capgo 实时更新将将您的 JavaScript、HTML 和 CSS 更改推送给用户几分钟内

从 Capgo 开始