跳到主要内容
版本:v5

配置 iOS

配置 Info.plist

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

要修改它,在 Xcode 中打开您的项目,选择 App 项目和 App target,然后点击 Info 标签。

Xcode 信息编辑器

您可以在表格中右键单击,在上下文菜单中勾选 Raw Keys & Values 来显示真实的键名。

您也可以手动打开和编辑 ios/App/App/Info.plist 文件来检查原始键。使用此参考文档查看可能的键列表。

管理权限

iOS 权限不需要像 Android 那样明确指定。但是,iOS 要求在 Info.plist 中定义"使用说明"(Usage Descriptions)。这些设置是人类可读的描述,当请求特定设备 API 的权限时,将呈现给最终用户。

查阅 Cocoa Keys 列表中包含 UsageDescription 的键,以查看您的应用可能需要的各种使用说明设置。

更多信息,Apple 提供了解决隐私敏感数据应用被拒的指南,其中包含有关需要使用说明的 API 的更多信息。

设置 Capabilities

Capabilities 用于启用应用可能需要的关键功能。每当 Capacitor 插件需要时,您可能需要配置它们。

与其他配置选项和使用说明不同,capabilities 不是Info.plist 中配置的。

要添加新的 capability,在 Xcode 中打开您的应用,选择 App 项目和 App target,点击标签栏中的 Signing & Capabilities,然后点击 + Capability 按钮。有关 iOS capabilities 的更多信息,请参阅这篇文章

Xcode Capabilities

重命名应用

您不能重命名 App 目录,但可以通过重命名 App target 来设置应用的名称。

要重命名 App target,在 Xcode 中打开您的项目,选择 App 项目,然后双击 App target。

Xcode Target

然后,打开 ios/App/Podfile 并重命名文件底部的当前 target:

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

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

有关 Deep Links 的指南,请参见此处