如何在:app模块中运行Compose预览而不构建完整APK

核心原因 #

:app模块作为应用入口模块，默认关联了完整的构建流程（包括依赖处理、APK打包等），而Compose预览本应只编译渲染所需的最小代码单元，因此需要通过配置隔离预览与完整APK的构建链路。

解决方案 #

1. 配置Gradle，让预览任务跳过APK打包流程 #

在:app模块的build.gradle.kts（或build.gradle）中添加以下配置，让预览相关任务不依赖打包APK的步骤：

android {
    buildFeatures {
        compose true
    }
    composeOptions {
        kotlinCompilerExtensionVersion = "你的Compose版本号" // 例如 "1.5.4"
    }

    // 拦截预览任务，移除对打包APK任务的依赖
    tasks.withType<org.jetbrains.kotlin.gradle.tasks.KotlinCompile>().configureEach {
        if (name.contains("Preview")) {
            // 清除所有依赖，只编译预览所需代码
            dependsOn.clear()
            // 仅依赖必要的编译前置任务
            dependsOn(tasks.named("compileDebugKotlin"))
        }
    }

    // 仅在非预览任务时启用APK打包
    tasks.named("packageDebug").configure {
        enabled = !gradle.startParameter.taskNames.any { it.contains("Preview") }
    }
}

2. 隔离预览与App全局逻辑 #

避免预览依赖App的全局初始化逻辑（如路由、登录状态、服务器配置），创建预览专用的环境：

// 预览专用主题，不依赖App的全局主题配置
@Composable
fun PreviewOnlyTheme(content: @Composable () -> Unit) {
    MaterialTheme(
        colorScheme = lightColorScheme(),
        typography = Typography(),
        content = content
    )
}

// 修改预览函数，使用隔离的主题
@Preview
@Composable
fun MyComposableScreenPreview() {
    PreviewOnlyTheme {
        MyComposableScreen()
    }
}

如果你的Composable依赖了CompositionLocal，需要在预览中提供预览专用的Local实例，避免触发全局逻辑的初始化。

3. 启用Android Studio预览的独立进程 #

打开Compose Preview窗口右上角的齿轮设置，勾选Run in separate process，让预览在独立进程中运行，完全隔离App的完整构建流程。

4. 开启Gradle按需构建 #

在Android Studio的Settings -> Build, Execution, Deployment -> Compiler中，勾选Configure on demand，Gradle会仅构建预览所需的代码和依赖，跳过无关模块的构建。

验证效果 #

配置完成后，再次点击预览的"Run Preview"按钮，应该只会编译当前预览的Compose代码，不会触发完整APK的打包流程，运行时间会和:compose模块的预览接近。

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