Files

T

Antigravity Agent 93ec7e9056 [G1-Sync] Manual knowledge update

2026-05-09 21:08:02 +09:00

4.0 KiB

Raw Blame History

id, title, category, status, source_trust_level, verification_status, created_at, updated_at, tags, tech_stack, applied_in, aliases

title

Android DataStore

SharedPreferences 는 deprecated. Preferences DataStore (Map<String, Any>) 또는 Proto DataStore (typed) 사용. Coroutines + Flow 기반. 비밀은 EncryptedSharedPreferences 또는 Keystore.

📖 핵심 개념

Preferences DataStore: key-value, type-unsafe. SharedPreferences 1:1 대체.
Proto DataStore: 타입 안전 schema. 복잡 객체.
비밀: EncryptedSharedPreferences 또는 SQLCipher Room.

💻 코드 패턴

Preferences DataStore

val Context.dataStore: DataStore<Preferences> by preferencesDataStore(name = "settings")

class SettingsRepo(private val ds: DataStore<Preferences>) {
    private val keyTheme = stringPreferencesKey("theme")
    private val keyOnboarded = booleanPreferencesKey("onboarded")

    val theme: Flow<String> = ds.data.map { it[keyTheme] ?: "system" }
    val onboarded: Flow<Boolean> = ds.data.map { it[keyOnboarded] ?: false }

    suspend fun setTheme(t: String) {
        ds.edit { prefs -> prefs[keyTheme] = t }
    }
    suspend fun setOnboarded(v: Boolean) {
        ds.edit { it[keyOnboarded] = v }
    }
}

Proto DataStore (타입 안전)

// app/src/main/proto/settings.proto
syntax = "proto3";
option java_package = "com.example.app";
option java_multiple_files = true;

message Settings {
  string theme = 1;
  bool onboarded = 2;
  int32 launch_count = 3;
}

object SettingsSerializer : Serializer<Settings> {
    override val defaultValue = Settings.getDefaultInstance()
    override suspend fun readFrom(input: InputStream): Settings = Settings.parseFrom(input)
    override suspend fun writeTo(t: Settings, output: OutputStream) = t.writeTo(output)
}

val Context.settings: DataStore<Settings> by dataStore(
    fileName = "settings.pb",
    serializer = SettingsSerializer
)

// 사용
val theme: Flow<String> = ctx.settings.data.map { it.theme }
ctx.settings.updateData { it.toBuilder().setTheme("dark").build() }

Encrypted (비밀)

val masterKey = MasterKey.Builder(ctx).setKeyScheme(MasterKey.KeyScheme.AES256_GCM).build()

val securePrefs = EncryptedSharedPreferences.create(
    ctx, "secure_prefs", masterKey,
    EncryptedSharedPreferences.PrefKeyEncryptionScheme.AES256_SIV,
    EncryptedSharedPreferences.PrefValueEncryptionScheme.AES256_GCM
)
securePrefs.edit().putString("token", "...").apply()

(EncryptedDataStore 는 정식 X — 위 패턴 또는 SQLCipher.)

🤔 의사결정 기준

데이터	저장
단순 설정 (theme, locale)	Preferences DataStore
복잡 객체 (다수 필드, nested)	Proto DataStore
검색 / 쿼리 필요	Room
비밀 (token)	EncryptedSharedPreferences / Keystore
큰 파일	File API
인메모리 임시	ViewModel 또는 SavedStateHandle

❌ 안티패턴

SharedPreferences 신규 사용: deprecated. DataStore.
DataStore 작업을 main thread: suspend / Flow 만 — 자동.
MutableStateFlow 로 캐시 + DataStore 둘 다 변경: 동기화 깨짐. 한 진실원.
큰 데이터를 Preferences DataStore: 매 변경 전체 rewrite. Proto 또는 Room.
비밀을 Preferences DataStore: 평문. Encrypted.
runBlocking 으로 동기 read: 메인 스레드 block. Flow + collectAsStateWithLifecycle.
migration 안 함 (SharedPrefs → DataStore): 옛 데이터 사라짐. SharedPreferencesMigration 사용.

🤖 LLM 활용 힌트

신규 = DataStore. 비밀은 EncryptedSharedPreferences.
복잡 schema 면 Proto.

4.0 KiB Raw Blame History