Android Studio发布构建因Compose Preview报错：NonExistentClass无法转Annotation

问题重现 #

执行Release构建时出现以下编译错误：

error: incompatible types: NonExistentClass cannot be converted to Annotation
@error.NonExistentClass()

错误指向包含@Preview注解的Compose预览函数：

@Preview("Drawer contents")
@Preview("Drawer contents (dark)", uiMode = UI_MODE_NIGHT_YES)
@Composable
fun PreviewAppDrawer() {
    AppTheme {
        Surface {
            AppDrawer(
                currentScreen = Screen.Home,
                onTopLevelScreenNavigate = {},
                closeDrawer = { }
            )
        }
    }
}

Debug构建可正常运行，仅Release构建触发该错误。

原因分析 #

@Preview注解属于androidx.compose.ui:ui-tooling-preview库，该依赖默认以debugImplementation方式引入，仅在Debug构建中生效。Release构建时，编译器找不到该注解类，会自动生成NonExistentClass占位符，进而引发类型转换错误。

解决方法 #

方法1：将预览代码隔离到Debug源码目录（推荐） #

把包含PreviewAppDrawer函数的文件移动到模块的src/debug/java/[你的包路径]目录下。这样Release构建不会编译这部分仅用于Debug预览的代码，从根源避免错误。

方法2：调整依赖配置，让Release构建识别注解 #

在Module级别的build.gradle（或build.gradle.kts）中，为Release变体添加预览库的编译依赖：

dependencies {
    // Debug构建保留预览依赖
    debugImplementation "androidx.compose.ui:ui-tooling-preview:1.6.0"
    // Release构建添加编译时依赖，提供注解类的定义
    releaseCompileOnly "androidx.compose.ui:ui-tooling-preview:1.6.0"
}

同步Gradle后重新执行Release构建即可。

方法3：通过ProGuard/R8移除预览代码 #

在proguard-rules.pro中添加规则，让R8在Release构建时移除带有@Preview注解的函数：

// 保留预览注解的类成员（用于识别）
-keepclassmembers class * {
    @androidx.compose.ui.tooling.preview.Preview <methods>;
}
// 告知R8预览注解相关代码无副作用，可安全移除
-assumenosideeffects class androidx.compose.ui.tooling.preview.Preview { *; }

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