App Group: apa itu, membuat container bersama dan konfigurasi akses

Apa itu App Group?

App Group adalah mekanisme sistem operasi iOS yang menyediakan area penyimpanan bersama untuk beberapa proses dari satu pengembang. Tanpanya, setiap ekstensi bekerja di sandbox-nya sendiri dan tidak dapat membaca data yang ditulis oleh komponen lain. App Group memecahkan isolasi ini dengan membuat direktori di sistem file yang dapat diakses oleh semua proses dengan entitlements yang benar.

Pengidentifikasi grup dimulai dengan awalan group. dan ditentukan dalam file entitlements proyek. Di Xcode, pengidentifikasi ini ditambahkan melalui Capabilities — sistem secara otomatis memasukkannya ke dalam tanda tangan aplikasi. Setelah konfigurasi, semua anggota grup mendapatkan akses ke direktori bersama di jalur Library/Application Support/ di dalam container.

Menurut Apple WWDC 2020 Session 10026, App Group mencakup tiga skenario utama: sinkronisasi pengaturan melalui NSUserDefaults, akses bersama ke file melalui FileManager, dan penggunaan bersama Core Data dengan satu penyimpanan. Untuk setiap skenario, cukup menentukan pengidentifikasi grup di API yang sesuai.

Bagaimana cara kerja container bersama App Group

iOS membuat container bersama saat pertama kali menjalankan proses apa pun yang memiliki entitlement com.apple.security.application-groups. Secara fisik, container berada di direktori sistem — jalurnya berbeda dari sandbox aplikasi utama dan ekstensi, tetapi semua proses yang berwenang memiliki hak baca dan tulis.

Hak akses dan keamanan

Apple menjamin keamanan App Group melalui hubungan antara team ID dan tanda tangan kode. Proses yang tidak ditandatangani dengan sertifikat pengembang yang sama tidak dapat mengakses container grup. Ini mencegah kebocoran data antara aplikasi dari pengembang yang berbeda.

Pengidentifikasi grup

Format pengidentifikasi: group.<team-id>.<name>. Misalnya, group.ABC123DEFG.widget-data. Pada satu perangkat, beberapa grup dapat dibuat, masing-masing dengan kumpulan peserta sendiri. Satu aplikasi dapat menjadi anggota beberapa App Group secara bersamaan — ini berguna untuk memisahkan data dari ekstensi yang berbeda.

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

// Buat file di container bersama
let fileURL = containerURL.appendingPathComponent("shared.data")
try "Hello from main app".write(to: fileURL, atomically: true, encoding: .utf8)

FileManager menyediakan metode containerURL(forSecurityApplicationGroupIdentifier:) yang mengembalikan URL direktori bersama. Penting untuk memanggil metode ini di setiap proses secara terpisah — jalurnya secara fisik sama, tetapi setiap proses melihatnya melalui prisma keamanannya sendiri.

Konfigurasi App Group di Xcode

Mengaktifkan App Group di Xcode dimulai dari Capabilities — saklar App Groups menambahkan entitlement ke proyek. Apple Developer Portal juga mensyaratkan bahwa pengidentifikasi aplikasi menyertakan capability ini. Tanpanya, tanda tangan kode tidak akan berfungsi di perangkat nyata.

Konfigurasi langkah demi langkah

Buka proyek di Xcode, pilih target aplikasi dan buka tab Signing & Capabilities. Tekan + dan pilih App Groups. Buat atau pilih grup yang sudah ada. Ulangi langkah yang sama untuk setiap ekstensi yang harus memiliki akses ke container bersama. Semua peserta harus menggunakan pengidentifikasi grup yang sama.

Memeriksa entitlements

Setelah mengaktifkan Capabilities, Xcode secara otomatis membuat file .entitlements dengan kunci com.apple.security.application-groups dan array pengidentifikasi. Pastikan semua ekstensi yang diperlukan memiliki file ini dengan team ID yang benar di pengidentifikasi grup.

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

Jika proyek Anda memiliki beberapa ekstensi (Today Widget, Share Extension, Notification Service), masing-masing harus memiliki file entitlements sendiri dengan grup yang sama. Ketiadaan entitlements di target mana pun adalah penyebab umum mengapa ekstensi tidak melihat data bersama.

Menggunakan UserDefaults dengan App Group

Cara paling sederhana untuk menyinkronkan data antara aplikasi dan ekstensi — UserDefaults dengan menentukan suite name. Alih-alih UserDefaults.standard standar, Anda membuat instance dengan pengidentifikasi App Group dan semua proses membaca pengaturan yang sama.

Menurut Apple Human Interface Guidelines, mekanisme ini cocok untuk menyinkronkan status: tema yang dipilih, item favorit, flag onbording. Namun, ini tidak dirancang untuk volume data besar atau operasi tulis bersamaan — untuk itu gunakan file atau Core Data.

// Tulis ke UserDefaults App Group (aplikasi utama)
let defaults = UserDefaults(suiteName: "group.com.example.shared")
defaults?.set(true, forKey: "isDarkMode")
defaults?.synchronize()

// Baca dari UserDefaults App Group (ekstensi widget)
let sharedDefaults = UserDefaults(suiteName: "group.com.example.shared")
let isDark = sharedDefaults?.bool(forKey: "isDarkMode") ?? false

Perhatikan: instance UserDefaults dengan suiteName dibuat di setiap proses secara terpisah, tetapi membaca dari satu file plist di container bersama. Metode synchronize() menjamin penulisan segera ke disk — di iOS 13+ dapat dihilangkan karena sistem menyinkronkan data secara periodik.

Akses bersama ke file dan Core Data

Untuk skenario yang lebih kompleks, App Group menyediakan akses ke sistem file bersama. File apa pun yang dibuat di direktori container dapat diakses oleh semua proses dalam grup. Ini memungkinkan implementasi database Core Data bersama, cache gambar, atau file sementara.

Konfigurasi Core Data dengan App Group

Untuk menggunakan penyimpanan Core Data bersama, buat NSPersistentContainer dengan URL file .sqlite yang terletak di direktori App Group. Pastikan hanya satu proses yang menulis ke database pada satu waktu — penulisan bersamaan dapat merusak data. Arsitektur tipikal: aplikasi utama menulis, ekstensi membaca.

// Siapkan Core Data dengan container 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
}()

Pendekatan alternatif — cache file gambar. NSCache hanya hidup di memori, tetapi melalui App Group Anda dapat menyimpan gambar yang di-cache ke disk di direktori bersama. Ekstensi widget mendapatkan akses ke file yang sama dan menampilkan data terkini tanpa pemuatan tambahan dari jaringan.

Saat bekerja dengan file bersama, pertimbangkan bahwa sistem dapat membongkar ekstensi kapan saja. Gunakan NSFileCoordinator untuk koordinasi akses guna menghindari kerusakan data saat penulisan bersamaan oleh proses yang berbeda.