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 одночасно — це корисно для розділення даних різних розширень.

// Get the App Group container URL
guard let containerURL = FileManager.default
    .containerURL(forSecurityApplicationGroupIdentifier: "group.com.example.widget")
else { return }

// Create a file in the shared container
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 також вимагає, щоб ідентифікатор застосунку включав цю можливість. Без неї підпис коду не спрацює на реальному пристрої.

Покрокове налаштування

Відкрийте проєкт у Xcode, виберіть таргет застосунку та перейдіть на вкладку 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 у будь-якого таргета — часта причина, через яку розширення не бачить спільні дані.

Використання UserDefaults з App Group

Найпростіший спосіб синхронізації даних між застосунком та розширеннями — UserDefaults із зазначенням suite name. Замість стандартного UserDefaults.standard ви створюєте екземпляр з ідентифікатором App Group, і всі процеси читають одні й ті самі налаштування.

За даними Apple Human Interface Guidelines, цей механізм підходить для синхронізації стану: вибраної теми, вподобаних елементів, прапорців онбордингу. Однак він не призначений для великих обсягів даних або конкурентних операцій запису — для цього використовуйте файли або Core Data.

// Write to UserDefaults App Group (main app)
let defaults = UserDefaults(suiteName: "group.com.example.shared")
defaults?.set(true, forKey: "isDarkMode")
defaults?.synchronize()

// Read from UserDefaults App Group (widget extension)
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. Переконайтеся, що лише один процес пише до бази одночасно — конкурентний запис може пошкодити дані. Типова архітектура: основний застосунок пише, розширення читають.

// Setup Core Data with App Group container
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 можна зберігати кешовані зображення на диску в спільній директорії. Розширення віджету отримує доступ до тих самих файлів і відображає актуальні дані без додаткового завантаження з мережі.

Працюючи зі спільними файлами, враховуйте, що система може вивантажити розширення в будь-який момент. Використовуйте NSFileCoordinator для координації доступу, щоб уникнути пошкодження даних при одночасному записі різними процесами.