App Group: ce este, crearea containerului partajat și configurarea accesului

Ce este App Group?

App Group este un mecanism al sistemului de operare iOS care oferă o zonă de stocare comună pentru mai multe procese ale aceluiași dezvoltator. Fără el, fiecare extensie funcționează în propriul sandbox și nu poate citi datele scrise de un alt component. App Group rezolvă această izolare prin crearea unui director în sistemul de fișiere, accesibil tuturor proceselor cu entitlements corecte.

Identificatorul grupului începe cu prefixul group. și este specificat în fișierul entitlements al proiectului. În Xcode, acest identificator se adaugă prin Capabilities — sistemul îl include automat în semnătura aplicației. După configurare, toți membrii grupului obțin acces la directorul comun de la calea Library/Application Support/ din interiorul containerului.

Conform Apple WWDC 2020 Session 10026, App Group acoperă trei scenarii cheie: sincronizarea setărilor prin NSUserDefaults, accesul partajat la fișiere prin FileManager și partajarea Core Data cu un singur depozit. Pentru fiecare scenariu este suficient să specificați identificatorul grupului în API-ul corespunzător.

Cum funcționează containerul partajat App Group

iOS creează containerul partajat la prima lansare a oricărui proces care are entitlement com.apple.security.application-groups. Fizic, containerul se află într-un director de sistem — calea sa diferă de sandbox-ul aplicației principale și al extensiilor, dar toate procesele autorizate au drepturi de citire și scriere.

Drepturi de acces și securitate

Apple garantează securitatea App Group prin legătura dintre team ID și semnătura de cod. Un proces care nu este semnat cu același certificat de dezvoltator nu poate accesa containerul grupului. Acest lucru previne scurgerea de date între aplicațiile diferiților dezvoltatori.

Identificatorul grupului

Formatul identificatorului: group.<team-id>.<name>. De exemplu, group.ABC123DEFG.widget-data. Pe un singur dispozitiv pot fi create mai multe grupuri, fiecare cu propriul set de participanți. O aplicație poate face parte din mai multe App Group simultan — acest lucru este util pentru separarea datelor diferitelor extensii.

// Obțineți URL-ul containerului App Group
guard let containerURL = FileManager.default
    .containerURL(forSecurityApplicationGroupIdentifier: "group.com.example.widget")
else { return }

// Creați un fișier în containerul partajat
let fileURL = containerURL.appendingPathComponent("shared.data")
try "Hello from main app".write(to: fileURL, atomically: true, encoding: .utf8)

FileManager oferă metoda containerURL(forSecurityApplicationGroupIdentifier:) care returnează URL-ul directorului partajat. Este important să apelați această metodă în fiecare proces separat — calea este fizic aceeași, dar fiecare proces o vede prin propria prismă de securitate.

Configurarea App Group în Xcode

Activarea App Group în Xcode începe cu Capabilities — comutatorul App Groups adaugă entitlement în proiect. Apple Developer Portal necesită, de asemenea, ca identificatorul aplicației să includă această capability. Fără ea, semnătura de cod nu va funcționa pe un dispozitiv real.

Configurare pas cu pas

Deschideți proiectul în Xcode, selectați targetul aplicației și mergeți la fila Signing & Capabilities. Apăsați + și alegeți App Groups. Creați sau selectați un grup existent. Repetați aceiași pași pentru fiecare extensie care ar trebui să aibă acces la containerul partajat. Toți participanții trebuie să folosească același identificator de grup.

Verificarea entitlements

După activarea Capabilities, Xcode creează automat fișierul .entitlements cu cheia com.apple.security.application-groups și un array de identificatori. Asigurați-vă că toate extensiile necesare au acest fișier cu team ID corect în identificatorul grupului.

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

Dacă proiectul dumneavoastră are mai multe extensii (Today Widget, Share Extension, Notification Service), fiecare trebuie să aibă propriul fișier entitlements cu același grup. Lipsa entitlements la orice target este o cauză frecventă pentru care extensia nu vede datele partajate.

Utilizarea UserDefaults cu App Group

Cea mai simplă modalitate de sincronizare a datelor între aplicație și extensii — UserDefaults cu specificarea suite name. În loc de UserDefaults.standard standard, creați o instanță cu identificatorul App Group și toate procesele citesc aceleași setări.

Conform Apple Human Interface Guidelines, acest mecanism este potrivit pentru sincronizarea stării: tema selectată, elemente favorite, flaguri de onbording. Cu toate acestea, nu este destinat pentru volume mari de date sau operații concurente de scriere — pentru acestea utilizați fișiere sau Core Data.

// Scrieți în UserDefaults App Group (aplicația principală)
let defaults = UserDefaults(suiteName: "group.com.example.shared")
defaults?.set(true, forKey: "isDarkMode")
defaults?.synchronize()

// Citiți din UserDefaults App Group (extensia widget)
let sharedDefaults = UserDefaults(suiteName: "group.com.example.shared")
let isDark = sharedDefaults?.bool(forKey: "isDarkMode") ?? false

Rețineți: instanța UserDefaults cu suiteName este creată în fiecare proces separat, dar citește dintr-un singur fișier plist din containerul partajat. Metoda synchronize() garantează scrierea imediată pe disc — în iOS 13+ poate fi omisă, deoarece sistemul sincronizează datele periodic.

Accesul partajat la fișiere și Core Data

Pentru scenarii mai complexe, App Group oferă acces la sistemul de fișiere partajat. Orice fișier creat în directorul containerului este accesibil tuturor proceselor din grup. Acest lucru permite implementarea unei baze Core Data partajate, a unui cache de imagini sau a fișierelor temporare.

Configurarea Core Data cu App Group

Pentru a utiliza depozitul Core Data partajat, creați NSPersistentContainer cu URL-ul fișierului .sqlite situat în directorul App Group. Asigurați-vă că un singur proces scrie în bază la un moment dat — scrierea concurentă poate deteriora datele. Arhitectura tipică: aplicația principală scrie, extensiile citesc.

// Configurați Core Data cu containerul 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
}()

O abordare alternativă — cache-ul de imagini pe disc. NSCache trăiește doar în memorie, dar prin App Group puteți salva imaginile cache pe disc în directorul partajat. Extensia widgetului are acces la aceleași fișiere și afișează date actualizate fără încărcare suplimentară din rețea.

Când lucrați cu fișiere partajate, rețineți că sistemul poate descărca extensia în orice moment. Utilizați NSFileCoordinator pentru coordonarea accesului, pentru a evita deteriorarea datelor la scrierea simultană de către procese diferite.