将使用 Cordova 的 Web 应用迁移至 Capacitor: 分步指南

本指南将帮助您将 Web 应用从 Cordova 迁移到 Capacitor，内容通俗易懂，易于上手。我们将涵盖所有章节，并提供分步操作方法。

Cordova 与 Capacitor 简介

Cordova 和 Capacitor 都是让 Web 开发者能够使用 HTML、CSS 和 JavaScript 为各种平台创建原生应用的工具。虽然它们有相似之处，但在原生项目管理、插件管理以及 CLI/版本管理方面存在关键差异。

迁移策略

根据应用的复杂度，从 Cordova 迁移到 Capacitor 可以选择逐步迁移或直接整体替换。Capacitor 与 Cordova 保持向后兼容，您可以随时将现有的 Web 应用切换过来。

为了协助迁移，可以考虑使用 Ionic 对比 Code 扩展并审计您现有的 Cordova 插件。如果需要，您可以继续使用 Cordova 插件，或者将其替换为 Capacitor 的等效插件。

逐步迁移指南

按照以下步骤将您的 Web 应用从 Cordova 迁移到 Capacitor：

在独立的 code 分支中操作：建议在应用这些更改时，在独立的 code 分支中进行操作。
使用 Capacitor 初始化应用：在终端中打开您的项目，并参考以下指南为 Web 应用添加 Capacitor 或在 Ionic 应用中添加 Capacitor。利用 Cordova 中的 config.xml 信息来确定应用名称和 Bundle ID。
构建 Web 应用：在添加任何原生平台之前，请至少构建一次 Web 项目。这能确保 www 文件夹在 Capacitor 配置文件中得到正确配置。
添加平台：运行 npx cap add ios 和 npx cap add android 来添加 iOS 和 Android 平台。这将在项目根目录下创建独立的原生项目文件夹。
生成图标和启动页：如果你已有现成的图标和启动页图片，请使用 cordova-res 工具来生成并将它们复制到原生项目中。
审计并迁移现有的 Cordova 插件：检查你现有的 Cordova 插件，如果可能，请将其替换为 Capacitor 的等效插件。移除所有不必要的插件。
移除 Cordova 插件：在替换或移除 Cordova 插件后，请卸载该插件并运行 npx cap sync 以从原生项目中移除 code 插件。
配置额外权限：在以下各项之间进行映射 plugin.xml 与 iOS 和 Android 上的必要设置，以应用所需的权限。
配置首选项：手动从以下位置添加首选项 config.xml 至 Capacitor 配置文件。
处理平台特定配置：从以下内容进行配置 config.xml 根据需要为每个平台（iOS 和 Android）进行配置。
更改内容服务的 Scheme：如有必要，请更改应用中用于内容服务的 scheme，以避免数据丢失。
测试并移除 Cordova：测试迁移后的应用，确保所有更改均已正确应用。确认无误后，您可以从项目中移除 Cordova，或者如果您打算继续使用 Cordova 插件，也可以将其保留。

恭喜！您已成功将 Web 应用从 Cordova 迁移到 Capacitor。要了解更多关于在 Capacitor 项目中使用 Cordova 插件或 Capacitor 开发工作流的信息，请访问官方 Capacitor 文档.

使用我们的 Capgo 服务实现 Live Updates

我们很自豪能提供 Capgo，这是我们为 Capacitor 应用提供的解决方案，支持 Live Updates，让您能以合理的价格实现 Over-The-Air (OTA) 更新。该功能对于快速修复 Bug、部署新功能以及确保用户无需等待 App Store 审核即可始终使用最新版本非常有用。

Capgo 服务的工作原理

Capgo 是一项基于云的服务，允许您为 Capacitor 应用部署 Live Update。它由 Web dashboard 和可集成到应用中的原生 SDK 组成。SDK 会在启动时或特定间隔检查更新并在后台进行 download。当有可用更新时，SDK 会提示用户进行安装。如果用户接受，更新将立即安装并生效。

Capgo Live Updates 的优势

更新更快速： 无需等待 App Store 审核，即可即时部署更新。
降低对 Apple Store 的依赖： 绕过 App Store 的限制与约束。
提升用户体验： 无需用户手动更新应用，即可通过最新功能和 Bug 修复保持用户活跃。

如何实现 Capgo Live Updates

要在您的 Capacitor 项目中实现 Capgo Live Updates，请遵循以下步骤：

注册 Capgo 账号.
在项目中安装 Capgo SDK。
配置您的应用，使其在启动时或按特定间隔检查更新。
通过 Capgo dashboard 发布应用更新。

总结

希望本指南能帮助您将 Web 应用从 Cordova 迁移到 Capacitor。如果您在迁移过程中有任何疑问或需要帮助，欢迎通过我们的 discord 服务器联系我们。

继续阅读《从 Cordova 迁移 Web 应用到 Capacitor：分步指南》

如果你正在使用 将 Web App 从 Cordova 迁移到 Capacitor：分步指南 规划迁移与企业运营，并将其与 Capgo 企业版了解 Capgo 企业版的产品工作流， Ionic Enterprise 插件替代方案适用于 Ionic Enterprise 插件替代方案的产品工作流， Capgo 替代方案适用于 Capgo 替代方案的产品工作流， Capgo 咨询适用于 Capgo 咨询服务的产品工作流，以及 Capgo 高级支持适用于 Capgo 高级支持的产品工作流。