跳到主要内容
版本:v6

Capacitor iOS 文档

Capacitor 提供了原生 iOS 运行时环境,使开发者能够在 JavaScript 与原生 Swift 或 Objective-C 代码之间建立通信。

Capacitor iOS 应用通过 Xcode 和 CocoaPods 进行配置和管理。

iOS 支持要求

支持 iOS 13+ 系统。需要 Xcode 15.0+ 版本(参见环境配置)。Capacitor 使用 WKWebView,而非已弃用的 UIWebView

添加 iOS 平台

首先安装 @capacitor/ios 包:

npm install @capacitor/ios

然后添加 iOS 平台:

npx cap add ios

打开 iOS 项目

在 Xcode 中打开项目运行:

npx cap open ios

也可以手动通过以下命令打开 Xcode:

open ios/App/App.xcworkspace

运行应用

您可以通过命令行或 Xcode 运行应用。

命令行运行

在设备或模拟器上运行项目:

npx cap run ios

该命令会提示选择运行目标。了解更多关于 run 命令的信息。

在 Xcode 中运行

在 Xcode 中,先选择设备或模拟器,然后点击播放按钮运行应用。

运行应用

问题排查

如果在入门阶段遇到任何问题,可以参考 iOS 问题排查指南。如需帮助,欢迎发起讨论

后续步骤

现在您可以继续开发和构建应用了。使用各类可用 API、Capacitor 或 Cordova 插件,或自定义原生代码来完成应用的其余部分。

延伸阅读

了解更多专题内容可查阅以下指南:

iOS 配置与权限设置 ›

为 iOS 构建原生插件 ›