App Group: какво е, създаване на споделен контейнер и настройка на достъп

Какво е App Group?

App Group е механизъм на операционната система iOS, който предоставя споделено хранилище за няколко процеса на един разработчик. Без него всяко разширение работи в собствена пясъчна кутия и не може да прочете данни, записани от друг компонент. App Group решава тази изолация чрез създаване на директория във файловата система, достъпна за всички процеси с правилни entitlements.

Идентификаторът на групата започва с префикс group. и се посочва в entitlements файла на проекта. В Xcode този идентификатор се добавя чрез Capabilities — системата автоматично го включва в подписа на приложението. След настройка всички членове на групата получават достъп до споделената директория на пътя Library/Application Support/ вътре в контейнера.

Според Apple WWDC 2020 Session 10026, App Group покрива три ключови сценария: синхронизиране на настройки чрез NSUserDefaults, споделен достъп до файлове чрез FileManager и съвместно използване на Core Data с единно хранилище. За всеки сценарий е достатъчно да посочите идентификатора на групата в съответното API.

Как работи споделеният контейнер на App Group

iOS създава споделения контейнер при първото стартиране на който и да е процес, който има entitlement com.apple.security.application-groups. Физически контейнерът се намира в системна директория — пътят му се различава от пясъчната кутия на основното приложение и разширенията, но всички оторизирани процеси имат права за четене и запис.

Права за достъп и сигурност

Apple гарантира сигурността на App Group чрез връзката между team ID и подписа на кода. Процес, който не е подписан със същия сертификат на разработчика, не може да получи достъп до контейнера на групата. Това предотвратява изтичане на данни между приложения на различни разработчици.

Идентификатор на група

Формат на идентификатора: group.<team-id>.<name>. Например group.ABC123DEFG.widget-data. На едно устройство могат да бъдат създадени няколко групи, всяка със свой набор от участници. Едно приложение може да принадлежи към няколко App Group едновременно — това е полезно за разделяне на данните на различни разширения.

// Вземете URL на контейнера на App Group
guard let containerURL = FileManager.default
    .containerURL(forSecurityApplicationGroupIdentifier: "group.com.example.widget")
else { return }

// Създайте файл в споделения контейнер
let fileURL = containerURL.appendingPathComponent("shared.data")
try "Hello from main app".write(to: fileURL, atomically: true, encoding: .utf8)

FileManager предоставя метода containerURL(forSecurityApplicationGroupIdentifier:), който връща URL на споделената директория. Важно е да извиквате този метод във всеки процес поотделно — пътят е физически един и същ, но всеки процес го вижда през собствената си призма на сигурност.

Настройка на App Group в Xcode

Включването на App Group в Xcode започва от Capabilities — превключвателят App Groups добавя entitlement към проекта. Apple Developer Portal също изисква идентификаторът на приложението да включва тази capability. Без нея подписът на кода няма да работи на реално устройство.

Поетапна настройка

Отворете проекта в Xcode, изберете target на приложението и отидете на раздела Signing & Capabilities. Натиснете + и изберете App Groups. Създайте нова група или изберете съществуваща. Повторете същите стъпки за всяко разширение, което трябва да има достъп до споделения контейнер. Всички участници трябва да използват един и същ идентификатор на група.

Проверка на entitlements

След включване на Capabilities, Xcode автоматично създава файла .entitlements с ключа com.apple.security.application-groups и масив от идентификатори. Уверете се, че всички необходими разширения имат този файл с правилен team ID в идентификатора на групата.

<!-- Example entitlements file -->
<key>com.apple.security.application-groups</key>
<array>
    <string>group.com.example.shared</string>
</array>

Ако вашият проект има няколко разширения (Today Widget, Share Extension, Notification Service), всяко трябва да има собствен entitlements файл със същата група. Липсата на entitlements на който и да е target е честа причина разширението да не вижда споделени данни.

Използване на UserDefaults с App Group

Най-простият начин за синхронизиране на данни между приложението и разширенията — UserDefaults с посочване на suite name. Вместо стандартния UserDefaults.standard създавате инстанция с идентификатора на App Group и всички процеси четат едни и същи настройки.

Според Apple Human Interface Guidelines, този механизъм е подходящ за синхронизиране на състояние: избрана тема, любими елементи, флагове за онбординг. Той обаче не е предназначен за големи обеми данни или конкурентни операции за запис — за това използвайте файлове или Core Data.

// Запис в UserDefaults App Group (основно приложение)
let defaults = UserDefaults(suiteName: "group.com.example.shared")
defaults?.set(true, forKey: "isDarkMode")
defaults?.synchronize()

// Четене от UserDefaults App Group (разширение widget)
let sharedDefaults = UserDefaults(suiteName: "group.com.example.shared")
let isDark = sharedDefaults?.bool(forKey: "isDarkMode") ?? false

Обърнете внимание: инстанцията на UserDefaults с suiteName се създава във всеки процес поотделно, но чете от един plist файл в споделения контейнер. Методът synchronize() гарантира незабавен запис на диска — в iOS 13+ може да се пропусне, тъй като системата периодично синхронизира данните.

Споделен достъп до файлове и Core Data

За по-сложни сценарии App Group предоставя достъп до споделената файлова система. Всеки файл, създаден в директорията на контейнера, е достъпен за всички процеси от групата. Това позволява реализиране на споделена Core Data база данни, кеш на изображения или временни файлове.

Настройка на Core Data с App Group

За да използвате споделено хранилище на Core Data, създайте NSPersistentContainer с URL на файла .sqlite, намиращ се в директорията на App Group. Уверете се, че само един процес записва в базата данни едновременно — конкурентният запис може да повреди данните. Типична архитектура: основното приложение записва, разширенията четат.

// Настройка на Core Data с контейнер на App Group
lazy var persistentContainer: NSPersistentContainer = {
    let container = NSPersistentContainer(name: "SharedModel")
    guard let appGroupURL = FileManager.default
        .containerURL(forSecurityApplicationGroupIdentifier: "group.com.example.shared")
    else { return container }

    let storeURL = appGroupURL.appendingPathComponent("SharedModel.sqlite")
    container.persistentStoreDescriptions = [NSPersistentStoreDescription(url: storeURL)]
    container.loadPersistentStores { _, error in
        if let error = error { fatalError(error.localizedDescription) }
    }
    return container
}()

Алтернативен подход — файлов кеш на изображения. NSCache живее само в паметта, но чрез App Group можете да запазите кеширани изображения на диска в споделената директория. Разширението на widget получава достъп до същите файлове и показва актуални данни без допълнително зареждане от мрежата.

При работа със споделени файлове имайте предвид, че системата може да разтовари разширението по всяко време. Използвайте NSFileCoordinator за координация на достъпа, за да избегнете повреда на данни при едновременен запис от различни процеси.