跳到主要内容
版本:v8

Capacitor iOS 文档

Capacitor 配备了原生 iOS 运行时,使开发者能够在 JavaScript 与原生 Swift 或 Objective-C 代码之间进行通信。

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

iOS 支持

支持 iOS 15+。需要 Xcode 26.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 的信息

无线 iOS 设备

要启用在无线 iOS 设备上运行,请确保您的设备已与 Finder 配对,并选中"在 Wi-Fi 上显示此 iPhone"选项:

启用无线 iPhone 调试

您的设备现在应显示在 npx cap run ios --list 提供的可用设备列表中。

在 Xcode 中运行

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

运行您的应用

故障排除

如果您在入门过程中遇到任何问题,可以查阅 iOS 故障排除指南。如果您需要帮助,欢迎发起讨论

下一步

您现在已准备好继续开发和构建您的应用。使用各种可用的 API、Capacitor 或 Cordova 插件,或自定义原生代码来构建应用的其余部分。

延伸阅读

请跟随以下指南获取每个主题的更多信息:

配置和设置 iOS 权限 ›

为 iOS 构建原生插件 ›