将使用 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 配置文件中。
处理平台特定配置：根据需求为每个平台（iOS 和 Android）配置 config.xml 中的元素。
更改内容提供方案：如有必要，更改应用中用于提供内容的 scheme，以避免数据丢失。
测试并移除 Cordova：测试迁移后的应用，确保所有更改都已正确应用。确认无误后，你可以从项目中移除 Cordova；如果计划继续使用 Cordova 插件，也可以保留。

恭喜！你已成功将 Web 应用从 Cordova 迁移到 Capacitor。如需了解如何在 Capacitor 项目中使用 Cordova 插件，或了解 Capacitor 开发工作流，请访问官方 Capacitor 文档.

通过我们的 Capgo 服务实现 Live Updates

我们很自豪地推出 Capgo，这个解决方案可为你的 Capacitor 应用提供实时更新，让你以合理的价格发布 OTA 更新。该功能特别适合快速修复、发布新功能，并确保用户始终使用最新版应用，无需等待应用商店审核。

我们的 Capgo 服务如何运作

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

Capgo Live Updates 的优势

更快的更新： 无需等待应用商店审核，即可即时部署更新。
降低对 Apple 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 Enterprise 中的产品工作流， Ionic Enterprise 插件替代方案用于 Ionic Enterprise 插件替代方案的产品工作流， Capgo 替代方案用于 Capgo 替代方案的产品工作流， Capgo 咨询适用于 Capgo Consulting 的产品工作流，以及 Capgo 高级支持适用于 Capgo Premium Support 的产品工作流。