Application Support：这是什么、配置存储和 Core Data

iOS 中的 Application Support 是什么？

Application Support — 是 iOS 应用沙盒中的一个目录，用于存储应用创建并用于自身运行的数据，但这些数据并非用户文档。这是配置文件、数据库、缓存元数据和其他辅助文件的主要存放位置。

iOS 将 Application Support 视为 Documents（用户数据）和 Caches（临时数据）之间的中间层级。Application Support 中的文件可能相对持久，但用户不应直接访问它们——这使其与 Documents Directory 区分开来。

根据 Apple Developer Documentation (2024)，Application Support 是存储 Core Data SQLite 数据库、Realm 文件、JSON/plist 格式配置、下载的参考资料以及应用使用但用户未明确创建的其他数据的推荐位置。

重要提示：默认情况下，Application Support 包含在 iCloud 和 iTunes 备份中。如果应用在此目录中存储了大量可恢复的数据（例如下载的指南），则需要为相应文件设置 isExcludedFromBackup 标志。

如何获取 Application Support 的路径

在 Swift 中，通过 FileManager.urls(for: .applicationSupportDirectory) 获取 Application Support Directory 的路径。Apple 建议在 Application Support 内创建一个以应用名称命名的子目录以实现数据隔离。

import Foundation

let fileManager = FileManager.default
guard let appSupportURL = fileManager.urls(
    for: .applicationSupportDirectory,
    in: .userDomainMask
).first else { return }

// 创建应用子目录
let bundleID = Bundle.main.bundleIdentifier ?? "com.example.app"
let appDir = appSupportURL.appendingPathComponent(bundleID)
try fileManager.createDirectory(
    at: appDir,
    withIntermediateDirectories: true
)

Objective-C 使用 NSSearchPathForDirectoriesInDomains 配合 NSApplicationSupportDirectory。与 Swift 类似，建议创建一个以应用名称命名的子目录。

@import Foundation;

NSArray *paths = NSSearchPathForDirectoriesInDomains(
    NSApplicationSupportDirectory,
    NSUserDomainMask,
    YES
);
NSString *appSupportPath = paths.firstObject;
NSString *appDir = [appSupportPath stringByAppendingPathComponent:@"com.example.app"];

在首次启动时，Application Support 目录可能不存在——需要使用 createDirectory(at:withIntermediateDirectories:) 创建。这使其与系统自动创建的 Documents Directory 区分开来。

在 Application Support 中存储哪些数据

Application Support 适用于应用在运行过程中使用的各种数据。为此目录选择正确的数据可以改善文件系统的组织并简化备份。

Core Data 和 Realm 数据库

SQLite 文件 Core Data 默认在 Application Support 中创建。Realm 也建议将数据库放置在此目录中。这可以将用户文档与应用内部数据库隔离开来。

配置文件

JSON、plist、带有应用设置的 XML 文件、Feature Flags、缓存的用户元数据（但不包括身份验证令牌——这些应使用 Keychain）。

选择标准：如果数据由应用创建和使用（而非用户），并且需要在启动之间保留——它们的位置在 Application Support 中。

Core Data 和 Application Support

Core Data — Application Support 的主要使用者之一。创建 NSPersistentContainer 时，Core Data 会自动将 SQLite 文件放置在 Library/Application Support 中，并使用基于模型名称的唯一名称。

了解 Core Data 存储文件的位置对于迁移、备份和调试至关重要。主要文件：.sqlite（数据）、.sqlite-wal（预写日志）、.sqlite-shm（共享内存）。

import CoreData

// 创建 Core Data 容器
let container = NSPersistentContainer(name: "MyAppModel")

// 自定义存储目录
guard let appSupportURL = FileManager.default
    .urls(for: .applicationSupportDirectory,
        in: .userDomainMask).first else { return }

let storeURL = appSupportURL
    .appendingPathComponent("MyAppModel.sqlite")
let description = NSPersistentStoreDescription(url: storeURL)
container.persistentStoreDescriptions = [description]

在使用 CloudKit 同步 Core Data 时，SQLite 文件保留在 Application Support 中，CloudKit 用作传输层。在这种情况下，不要将文件排除在备份之外非常重要——否则设备之间的同步可能会中断。

Application Support vs Documents Directory

Application Support 和 Documents 之间的区别——是正确组织 iOS 应用文件结构最重要的问题之一。错误的选择可能导致用户意外删除重要的应用数据，或者相反，无法找到自己的文件。

简单规则：如果用户应该能看到文件并可以删除它——使用 Documents。如果文件是应用运行所需但用户无需知道——使用 Application Support。如果数据可以恢复——使用 Caches。

使用 Application Support 的最佳实践

使用 Application Support 需要考虑几个使其区别于沙盒中其他目录的特性。遵循这些实践有助于避免数据丢失、迁移问题和应用的意外行为。

在首次启动时始终创建目录

与 Documents 不同，Application Support 在首次启动时可能不存在。使用 createDirectory(at:withIntermediateDirectories:) 并设置 withIntermediateDirectories: true 参数，以确保创建完整的子目录链。

使用带 Bundle Identifier 的子目录

在 Application Support 内创建一个带 Bundle Identifier 的子目录。这可以将你的应用数据与其他应用的数据隔离开来（尽管沙盒已经提供了隔离），并在更换提供商时简化迁移。

import Foundation

enum AppSupport {
    static func ensureDirectory() throws -> URL {
        let fm = FileManager.default
        let baseURL = try fm.url(
            for: .applicationSupportDirectory,
            in: .userDomainMask,
            appropriateFor: nil,
            create: true
        )
        let appDir = baseURL
            .appendingPathComponent(Bundle.main.bundleIdentifier ?? "default")
        try fm.createDirectory(at: appDir, withIntermediateDirectories: true)
        return appDir
    }
}

遵循这些实践可以确保应用的服务数据得到正确组织、防止用户意外删除，并能正确从备份中恢复。