Application Support: armazenamento de configurações e Core Data

O que é Application Support no iOS?

Application Support é um diretório no sandbox do aplicativo iOS projetado para armazenar dados que o aplicativo cria e usa para seu funcionamento, mas que não são documentos do usuário. Este é o local principal para configurações, bancos de dados, metadados em cache e outros arquivos auxiliares.

O iOS designa o Application Support como uma camada intermediária entre Documents (dados do usuário) e Caches (dados temporários). Os arquivos no Application Support podem ser relativamente permanentes, mas o usuário não deve ter acesso direto a eles — isso o distingue do Diretório Documents.

De acordo com a Documentação para Desenvolvedores da Apple (2024), o Application Support é o local recomendado para armazenar bancos de dados SQLite do Core Data, arquivos Realm, configurações em formato JSON/plist, materiais de referência baixados e outros dados que o aplicativo usa, mas que o usuário não criou explicitamente.

Importante: por padrão, o Application Support está incluído no backup do iCloud e iTunes. Se o aplicativo armazenar grandes quantidades de dados neste diretório que podem ser recriados (por exemplo, guias baixadas), é necessário definir a flag isExcludedFromBackup para os arquivos relevantes.

Como obter o caminho para o Application Support

Em Swift, o caminho para o Diretório Application Support é obtido através de FileManager.urls(for: .applicationSupportDirectory). A Apple recomenda criar um subdiretório com o nome do aplicativo dentro do Application Support para isolar os dados.

import Foundation

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

// Create app subdirectory
let bundleID = Bundle.main.bundleIdentifier ?? "com.example.app"
let appDir = appSupportURL.appendingPathComponent(bundleID)
try fileManager.createDirectory(
    at: appDir,
    withIntermediateDirectories: true
)

O Objective-C usa NSSearchPathForDirectoriesInDomains com NSApplicationSupportDirectory. Assim como no Swift, é recomendado criar um subdiretório filho com o nome do aplicativo.

@import Foundation;

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

Na primeira inicialização, o diretório Application Support pode não existir — ele deve ser criado usando createDirectory(at:withIntermediateDirectories:). Isso o diferencia do Diretório Documents, que é criado automaticamente pelo sistema.

Quais dados armazenar no Application Support

Application Support é adequado para uma ampla gama de dados que o aplicativo usa para seu funcionamento. Escolher os dados certos para este diretório melhora a organização do sistema de arquivos e simplifica o backup.

Bancos de dados Core Data e Realm

Os arquivos SQLite do Core Data são criados no Application Support por padrão. O Realm também recomenda colocar bancos de dados neste diretório. Isso isola os documentos do usuário dos bancos de dados internos do aplicativo.

Arquivos de configuração

Arquivos JSON, plist, XML com configurações do aplicativo, Feature Flags, metadados de usuário em cache (mas não tokens de autenticação — para eles use Keychain).

Critério de seleção: se os dados são criados e usados pelo aplicativo, não pelo usuário, e devem persistir entre execuções — seu lugar é no Application Support.

Core Data e Application Support

Core Data é um dos principais consumidores do Application Support. Ao criar um NSPersistentContainer, o Core Data coloca automaticamente os arquivos SQLite em Library/Application Support com um nome único baseado no nome do modelo.

Entender onde o Core Data armazena arquivos é fundamental para migrações, backup e depuração. Principais arquivos: .sqlite (dados), .sqlite-wal (Write-Ahead Log), .sqlite-shm (Shared Memory).

import CoreData

// Create Core Data container
let container = NSPersistentContainer(name: "MyAppModel")

// Custom store URL directory
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]

Ao usar a sincronização do Core Data com CloudKit, o arquivo SQLite permanece no Application Support e o CloudKit atua como uma camada de transporte. Neste caso, é importante não excluir arquivos do backup — caso contrário, a sincronização entre dispositivos pode falhar.

Application Support vs Diretório Documents

A diferença entre Application Support e Documents é uma das mais importantes para organizar corretamente a estrutura de arquivos do aplicativo iOS. Escolher incorretamente pode levar o usuário a excluir acidentalmente dados importantes do aplicativo ou, inversamente, não conseguir encontrar seus arquivos.

Regra simples: se o usuário deve ver o arquivo e poder excluí-lo — use Documents. Se o arquivo é necessário para o aplicativo funcionar, mas o usuário não precisa saber dele — use Application Support. Se os dados podem ser recriados — use Caches.

Melhores práticas para trabalhar com Application Support

Trabalhar com Application Support requer considerar várias características que o distinguem de outros diretórios do sandbox. Seguir essas práticas ajuda a evitar perda de dados, problemas de migração e comportamentos inesperados do aplicativo.

Sempre criar o diretório na primeira inicialização

Ao contrário do Documents, o Application Support pode não existir na primeira inicialização. Use createDirectory(at:withIntermediateDirectories:) com o parâmetro withIntermediateDirectories: true para garantir a criação de toda a cadeia de subdiretórios.

Usar um subdiretório com Bundle Identifier

Crie um subdiretório com o Bundle Identifier dentro do Application Support. Isso isola os dados do seu aplicativo de outros aplicativos (embora o sandbox já forneça isolamento) e simplifica a migração ao mudar de provedor.

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
    }
}

Seguir essas práticas garante que os dados de serviço do aplicativo estejam organizados corretamente, protegidos contra exclusão acidental pelo usuário e restaurados corretamente a partir de backups.