开发咨询：iOS设置列表中应用未显示，如何添加应用设置页面？

阿华AIGC实验室

2026-5-14

iOS应用在系统设置中显示独立页面的配置方法

嘿，这个问题我太熟悉了——很多开发者第一次做iOS设置页面都会踩这个坑。你的Pearl现在只在定位服务里显示，是因为定位权限的设置项是系统自动生成的，但独立的系统设置页面必须手动添加Settings.bundle配置才能触发，下面一步步帮你搞定：

第一步：添加Settings.bundle到项目
打开Xcode，点击菜单栏的File > New > File，在搜索框里输入Settings Bundle，选中后点击Next，最后把它添加到你的项目根目录（注意要勾选对应的应用目标）。这个文件的名字绝对不能改，必须是Settings.bundle，否则iOS系统识别不到。

第二步：配置Root.plist定义设置项
打开Settings.bundle里的Root.plist，这就是你设置页面的“蓝图”。默认模板已经包含了几个示例项（比如开关、文本输入框），你可以根据自己的需求修改或添加新的设置类型：

常用的类型包括PSToggleSwitchSpecifier（开关）、PSTextFieldSpecifier（文本框）、PSMultiValueSpecifier（下拉选项）等
每个设置项都需要设置Title（显示的标题）和Key（用来在代码中读取值的键名），还可以设置DefaultValue（默认值）

给你个简单的配置示例，比如添加一个推送通知开关和一个自定义文本项：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>StringsTable</key>
    <string>Root</string>
    <key>PreferenceSpecifiers</key>
    <array>
        <dict>
            <key>Type</key>
            <string>PSGroupSpecifier</string>
            <key>Title</key>
            <string>Pearl应用设置</string>
        </dict>
        <dict>
            <key>Type</key>
            <string>PSToggleSwitchSpecifier</string>
            <key>Title</key>
            <string>启用推送通知</string>
            <key>Key</key>
            <string>push_notification_enabled</string>
            <key>DefaultValue</key>
            <true/>
        </dict>
        <dict>
            <key>Type</key>
            <string>PSTextFieldSpecifier</string>
            <key>Title</key>
            <string>自定义昵称</string>
            <key>Key</key>
            <string>custom_nickname</string>
            <key>DefaultValue</key>
            <string>珍珠用户</string>
        </dict>
    </array>
</dict>
</plist>

第三步：在代码中读取设置值
用户在系统设置里修改的内容会自动同步到UserDefaults，你可以直接在代码里读取：

// 读取推送开关状态
let isPushEnabled = UserDefaults.standard.bool(forKey: "push_notification_enabled")
// 读取自定义昵称
let nickname = UserDefaults.standard.string(forKey: "custom_nickname") ?? "珍珠用户"