跳到主要内容
版本:v2

更新 Capacitor iOS 项目

有时,你需要对 iOS 应用进行 Capacitor 更新,包括更新应用中使用的 Capacitor 版本,或在 iOS 代码库中使用新的与 Capacitor 交互的方式(例如,针对新的 iOS API 变更)。

更新 Capacitor iOS 库

要更新应用中使用的 @capacitor/ios 版本,只需安装最新版本:

npm install @capacitor/ios@2

然后同步原生项目:

npx cap sync ios

更新 iOS 项目

要更新 Xcode 项目的基础结构,请在 Capacitor 代码库中查看 ios-template 项目,该模板位于与 Capacitor 最新稳定版对应的标签下。核心项目有意保持简单:查看核心项目与你项目之间的差异应该不会花费太多时间。

特别是,应定期检查 AppDelegate.swift,以了解 iOS 事件的可能变更。

从 1.0.0 到 1.1.0

建议的变更:

  • 使用 这些更改 更新 ios 文件夹内的 .gitignore 文件

从 <= 1.5.1 到 2.0.0

建议的变更:

  • 将原生项目升级到 Swift 5

    Capacitor 2.0 使用 Swift 5,建议也将你的原生项目更新为使用 Swift 5。 为此,在 Xcode 中点击 Edit -> Convert -> To Current Swift Syntax

    App.app 将显示为选中状态,点击 Next 按钮。

    然后会出现消息提示 No source changes necessary

    最后,点击 Update 按钮。

关于 API 变更,请查看 发布说明