如何在闭源SDK中混淆代码同时保留Compose函数参数完整性？

问题1：配置ProGuard/R8规则，保留Compose函数签名同时混淆其余代码 #

需要结合@Keep注解和精准的R8规则，同时满足代码混淆和API签名保留的需求：

1. 给目标Compose函数添加@Keep注解：
   阻止R8混淆函数名和参数类型，后续配合规则补充参数名和合成参数的处理：

   @Keep
   @Composable
   fun BannerCarouselWithWebView(
       modifier: Modifier = Modifier,
       showWidgetTitle: Boolean = true,
       showWebViewBackButton: Boolean = true,
       configMap: Map<String, String>,
   ) {
       // 实现代码
   }
   

2. 在proguard-rules.pro中添加以下规则：

   # 保留目标Compose函数的参数名称（依赖Kotlin元数据）
   -keepnames class com.your.sdk.package.YourComposeContainerClass {
       @androidx.compose.runtime.Composable
       fun BannerCarouselWithWebView(androidx.compose.ui.Modifier, boolean, boolean, java.util.Map<java.lang.String, java.lang.String>);
   }
   
   # 保留必要的注解和Kotlin元数据，确保IDE能识别参数名和默认值
   -keepattributes RuntimeVisibleAnnotations, AnnotationDefault, KotlinMetadata
   
   # 允许混淆Compose合成参数（Composer、int等），但不暴露到公共API签名
   -keepclassmembers,allowobfuscation class * {
       @androidx.compose.runtime.Composable
       <methods>;
   }
   

   注意替换com.your.sdk.package.YourComposeContainerClass为实际的包名和类名。-keepnames确保参数名不被混淆，KotlinMetadata让IDE能读取参数名和默认值，最后一条规则让R8将合成的Composer等参数隐藏，不显示在公共API中。

问题2：Compose专属规则或编译器选项 #

Compose的合成参数（Composer、int等）是编译器自动生成的，要阻止它们暴露到API中，可配合以下配置：

1. 编译器参数配置：
   在SDK的build.gradle中添加Kotlin编译器参数，确保参数元数据正确生成：

   android {
       buildTypes {
           release {
               minifyEnabled true
               proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
               
               kotlinOptions {
                   // 保留JVM类型注解，帮助R8正确识别Compose函数
                   freeCompilerArgs += "-Xemit-jvm-type-annotations"
               }
           }
       }
   }
   

2. 依赖最新版Compose Compiler：
   旧版本的Compose Compiler可能存在合成参数处理的bug，使用最新稳定版，它自带的R8规则会自动处理大部分合成参数的隐藏逻辑。

问题3：闭源SDK暴露Compose函数的最佳实践 #

1. 隔离公共API与内部实现：
   将所有暴露的Compose函数放在单独的public子包下（比如com.your.sdk.compose.public），内部实现代码放在其他包中，方便统一配置混淆规则，避免误暴露内部逻辑。

2. 完善KDoc注释：
   给公共Compose函数添加详细的KDoc，包括参数用途、默认值含义、使用场景，即使参数名清晰，注释也能大幅降低开发者的使用成本。

3. 发布Sources Jar：
   即使SDK闭源，也可以只发布包含公共API代码和注释的Sources Jar，让IDE能提供参数名提示、注释悬浮窗等功能，提升集成体验。

4. 使用公共类型作为参数：
   避免在公共Compose函数中使用内部自定义类型，优先使用Jetpack或Android框架的公共类型（如Map<String, String>）。如果必须使用自定义类型，需将其标记为public并添加@Keep注解，确保类型和成员不被混淆。

5. 提供Demo和示例代码：
   附带简单的Demo工程，展示Compose函数的正确调用方式，避免开发者因签名误解导致集成错误。

6. 标记参数稳定性：
   给参数类型添加@Stable或@Immutable注解（如果符合条件），帮助Compose进行性能优化，同时让开发者清楚参数的更新特性。

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