如何在Jetpack Compose Kotlin中仅在应用首次启动时执行代码？

一、安装后永久仅执行一次（卸载重装才会再次触发） #

推荐使用Jetpack DataStore替代SharedPreferences，适配现代Android开发规范，持久化存储状态。

1. 添加DataStore依赖 #

在模块级build.gradle.kts中引入依赖：

dependencies {
    implementation("androidx.datastore:datastore-preferences:1.0.0")
}

2. 定义DataStore实例与状态键 #

import androidx.datastore.core.DataStore
import androidx.datastore.preferences.core.Preferences
import androidx.datastore.preferences.core.booleanPreferencesKey
import androidx.datastore.preferences.core.edit
import androidx.datastore.preferences.preferencesDataStore
import kotlinx.coroutines.flow.first

// 扩展Context获取DataStore实例
val Context.dataStore: DataStore<Preferences> by preferencesDataStore(name = "app_launch_prefs")

// 标记首次启动的键
private val IS_FIRST_LAUNCH = booleanPreferencesKey("is_first_launch")

3. 在Compose中实现逻辑 #

在应用根Composable中检查状态并执行初始化：

@Composable
fun AppRoot() {
    val context = LocalContext.current
    
    LaunchedEffect(Unit) {
        // 读取是否为首次启动，默认值为true
        val isFirstLaunch = context.dataStore.data.first()[IS_FIRST_LAUNCH] ?: true
        
        if (isFirstLaunch) {
            // 执行仅需一次的初始化操作：列表初始化、默认配置设置等
            initializeDefaultList()
            setupDefaultAppSettings()
            
            // 标记为已完成首次启动，持久化到DataStore
            context.dataStore.edit { prefs ->
                prefs[IS_FIRST_LAUNCH] = false
            }
        }
    }

    // 应用UI内容
    // ...
}

// 示例初始化函数
private fun initializeDefaultList() {
    // 仅执行一次的列表初始化逻辑
}

private fun setupDefaultAppSettings() {
    // 设置应用默认配置
}

二、每次应用进程启动仅执行一次（进程重启后重新触发） #

如果需要在每次应用进程启动时执行一次初始化（比如进程被杀重启后重新初始化），可以选择以下两种方式：

方法1：在Application类中执行 #

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        // 此代码仅在进程启动时执行一次
        runProcessStartupLogic()
    }

    private fun runProcessStartupLogic() {
        // 进程启动时的初始化操作
    }
}

记得在AndroidManifest.xml中注册自定义Application类：

<application
    android:name=".MyApplication"
    <!-- 其他属性 -->
    >
    <!-- 应用组件配置 -->
</application>

方法2：在Compose中使用remember+LaunchedEffect #

@Composable
fun AppRoot() {
    // remember保持状态，仅在Compose树首次创建时为true
    val isProcessFirstLaunch = remember { mutableStateOf(true) }

    LaunchedEffect(isProcessFirstLaunch.value) {
        if (isProcessFirstLaunch.value) {
            // 执行进程启动初始化逻辑
            runProcessStartupLogic()
            // 标记已执行，避免重复触发
            isProcessFirstLaunch.value = false
        }
    }

    // 应用UI内容
    // ...
}

关键注意事项 #

• 跨进程保持首次启动状态必须使用DataStore/SharedPreferences这类持久化存储，内存状态（如remember）无法跨进程或进程重启后保留。
• 避免在首次启动逻辑中执行耗时操作，建议将耗时任务放入协程异步执行，或使用WorkManager后台处理，防止应用启动卡顿。

内容的提问来源于stack exchange，提问作者jakeprog123