Jetpack Compose应用发布准备及@Preview可组合项处理相关疑问

一、发布应用是否需要删除@Preview相关代码 #

绝大多数场景下完全不需要手动删除，原因如下：

• @Preview 注解本身的保留策略为 AnnotationRetention.SOURCE，仅存在于Kotlin源码阶段，编译生成字节码时会被直接丢弃，不会进入最终的APK文件。
• 单独编写的预览专用可组合函数，只要没有被正式业务代码引用，Release构建开启默认的R8/ProGuard优化时，会被作为无效代码自动摇树移除，不会占用任何安装包体积。

只有当你需要对外交付纯净的业务源码、或者团队代码规范明确要求源码中不能留存调试类代码时，才需要对源码中的@Preview相关内容进行清理。

二、自动移除@Preview相关代码的方案 #

如果你确实需要清理，可以根据场景选择以下方案：

方案1：从构建层面自动隔离（不修改源码） #

将所有预览代码迁移到项目的 debug 源集下即可：
Android项目默认存在src/main（通用代码）、src/debug（仅Debug包生效代码）、src/release（仅Release包生效代码）三个源集，你只需要在src/debug目录下创建和main目录对应的包结构，把所有预览专用的可组合函数移动到debug源集下，Release构建时完全不会编译这部分代码，既不用修改源码，也不会让预览代码进入正式包。

方案2：批量清理源码中的@Preview内容 #

如果你需要直接修改源码移除相关内容，可以用以下两种方式：

• 如果你是直接在业务可组合函数上添加@Preview注解，只需要删除注解行：用Android Studio的全局正则替换功能，匹配正则^\s*@Preview.*\n，批量替换为空即可，操作前注意备份代码。
• 如果你是单独编写了预览专用的可组合函数，需要删除整个函数块：可以匹配正则^\s*@Preview.*\n\s*@Composable\s*\n\s*fun\s*\w*Preview\w*\s*\([^)]*\)\s*\{\s*[^}]*\}，批量替换为空；也可以自己编写简单的Shell/Python脚本遍历项目所有.kt文件，自动识别并删除带@Preview注解的代码块。

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