跳到主要内容
版本：v4

iOS 配置指南

配置 Info.plist​

Info.plist 文件是 iOS 应用的主配置文件。当 Capacitor 插件需要新设置或权限时，您可能需要编辑此文件。

修改方式：先在 Xcode 中打开项目，选中 App 项目和 App 目标，然后点击 Info 标签页。

Xcode信息编辑器

在表格中右键点击并勾选上下文菜单中的 Raw Keys & Values，可显示原始键名。

您也可以手动打开并编辑 ios/App/App/Info.plist 文件查看原始键值。完整的键名列表请参考 苹果官方文档。

权限管理​

iOS 权限不需要像 Android 那样显式声明，但必须在 Info.plist 中定义"使用说明"。这些设置是当请求特定设备 API 权限时，向终端用户展示的人类可读描述。

请查阅 Cocoa Keys 列表中包含 UsageDescription 的键，了解应用可能需要配置的各种使用说明设置。

更多信息可参考苹果官方的 解决隐私敏感数据应用被拒 指南，其中详细说明了需要提供使用说明的 API。

设置功能特性​

功能特性（Capabilities）用于启用应用所需的关键功能。当 Capacitor 插件有要求时，您需要进行配置。

与其他配置选项和使用说明不同，功能特性 不 在 Info.plist 中配置。

添加新功能特性的步骤：先在 Xcode 中打开应用，选中 App 项目和 App 目标，点击顶部 Signing & Capabilities 标签，然后点击 + Capability 按钮。iOS 功能特性的详细信息请参阅 这篇文章。

Xcode功能特性

重命名应用​

虽然无法重命名 App 目录，但您可以通过重命名 App 目标来更改应用显示名称。

重命名步骤：先在 Xcode 中打开项目，选中 App 项目，双击 App 目标进行修改。

Xcode目标

接着打开 ios/App/Podfile 文件，修改底部的目标名称：

-target 'App' do
+target 'MyRenamedApp' do
   capacitor_pods
   # 在此添加您的 Pods
 end

最后，在 Capacitor 配置文件 的 ios 对象中添加 scheme 属性。

深度链接（即通用链接）​

深度链接配置指南请 参阅此处。

Contents

编辑此页