跳到主要内容
版本：v3

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

编辑此页