Swift 应用配置：iOS/macOS 工具与库

Swift 应用配置 (iOS/macOS)：工具与库

应用配置是 iOS 和 macOS 开发中至关重要的一部分。它允许您在不更改代码的情况下灵活管理应用行为，为不同环境（开发/预发布/生产）配置参数，并个性化用户体验。在本文中，我们将介绍用于配置管理的 Swift 主要工具和库。

1. iOS/macOS 内置工具

Apple 提供了几种用于存储和读取配置数据的内置机制。

1.1 PropertyList (Info.plist)

存储静态配置的经典方式。Info.plist 文件包含应用的基本设置：版本、bundle identifier、支持的屏幕方向等。

// 从 Info.plist 读取值if let appVersion = Bundle.main.object(forInfoDictionaryKey: "CFBundleShortVersionString") as? String {    print("应用版本: \\(appVersion)")}

// 读取自定义键if let apiURL = Bundle.main.object(forInfoDictionaryKey: "APIBaseURL") as? String {    print("API 基础 URL: \\(apiURL)")}

1.2 UserDefaults

UserDefaults 是存储少量数据（字符串、数字、布尔值）的简单方法。非常适合用户设置。

// 保存UserDefaults.standard.set(true, forKey: "isDarkModeEnabled")UserDefaults.standard.set("ru", forKey: "appLanguage")

// 读取let isDarkMode = UserDefaults.standard.bool(forKey: "isDarkModeEnabled")let language = UserDefaults.standard.string(forKey: "appLanguage") ?? "en"

1.3 SwiftUI @AppStorage

用于 SwiftUI 的 UserDefaults 现代封装。允许自动与 UI 同步状态。

struct SettingsView: View {    @AppStorage("isDarkMode") private var isDarkMode = false    @AppStorage("username") private var username = "访客"        var body: some View {        Form {            Toggle("深色主题", isOn: $isDarkMode)            TextField("用户名", text: $username)        }    }}

2. 高级配置库

2.1 Firebase Remote Config

来自 Google 的云端配置。允许在不发布 App Store 更新的情况下更改应用参数。

import FirebaseRemoteConfig

class RemoteConfigManager {    static let shared = RemoteConfigManager()    private let remoteConfig = RemoteConfig.remoteConfig()        func setup() {        let defaults: [String: NSObject] = [            "welcome_message": "欢迎！" as NSObject,            "max_items_count": 20 as NSObject        ]        remoteConfig.setDefaults(defaults)        remoteConfig.fetch(withExpirationDuration: 3600) { status, error in            if status == .success {                self.remoteConfig.activate()            }        }    }        var welcomeMessage: String {        remoteConfig.configValue(forKey: "welcome_message").stringValue ?? ""    }        var maxItemsCount: Int {        Int(remoteConfig.configValue(forKey: "max_items_count").numberValue ?? 20)    }}

2.2 SwiftyUserDefaults

UserDefaults 的便捷封装，支持 Codable 和类型安全键。

import SwiftyUserDefaults

extension DefaultsKeys {    static let isFirstLaunch = DefaultsKey<Bool>("isFirstLaunch", defaultValue: true)    static let userProfile = DefaultsKey<Data?>("userProfile")}

struct UserProfile: Codable {    let name: String    let age: Int}

// 使用Defaults[.isFirstLaunch] = false

let profile = UserProfile(name: "伊万", age: 30)if let data = try? JSONEncoder().encode(profile) {    Defaults[.userProfile] = data}

if let profileData = Defaults[.userProfile],   let decoded = try? JSO