HarmonyOS鸿蒙Next中用@Sendable注释的类再打包har时怎么编写混淆规则？

问题核心分析

[@Sendable](/user/Sendable) 是鸿蒙（HarmonyOS）中用于标记可跨线程安全传递的类 / 接口的注解，打包 HAR（鸿蒙归档包）时混淆该类，核心问题是：

1. [@Sendable](/user/Sendable) 类的属性 / 方法被混淆后，鸿蒙运行时无法识别其跨线程安全特性；
2. Cannot add property in prevent extensions 报错本质是：混淆规则破坏了类的「不可扩展（prevent extensions）」特性（[@Sendable](/user/Sendable) 类默认被标记为不可动态扩展属性），导致运行时尝试添加属性失败。

正确的混淆规则编写（针对 @Sendable 类）

1. 核心混淆规则模板（proguard-rules.pro）

# 1. 保留[@Sendable](/user/Sendable)注解本身（关键）
-keep @ohos.annotation.Sendable class * {*;}

# 2. 保留目标[@Sendable](/user/Sendable)类的完整结构（类名、所有属性、方法，不混淆）
# 替换为你的[@Sendable](/user/Sendable)类全路径（支持通配符*）
-keep class com.xxx.your.SendableClass {
    <fields>;      # 保留所有属性
    <methods>;     # 保留所有方法
    <init>();      # 保留所有构造方法
}

# 3. 禁止混淆该类的属性名/方法名（全局保留）
# 若用-keep-property-name-keep-global-name，需仅保留该类的属性，而非全局
-keep-property-name-keep-global-name class com.xxx.your.SendableClass {
    *;
}

# 4. 关键：禁止对该类执行「prevent extensions」相关混淆（解决核心报错）
-dontoptimize class com.xxx.your.SendableClass
-dontshrink class com.xxx.your.SendableClass
-dontwarn com.xxx.your.SendableClass

# 5. 若该类实现了特定接口/继承父类，需同步保留
-keep class com.xxx.your.SendableClass implements com.xxx.ParentInterface {*;}

2. 错误规则修正（你之前的问题）

你报错的核心原因是：-keep-property-name-keep-global-name 配置了全局属性保留，而非仅目标 [@Sendable](/user/Sendable) 类，导致其他类的属性也被强制保留，触发「不可扩展类添加属性」冲突。

✅ 修正前（错误）：

# 错误：全局保留所有类的属性名，导致冲突
-keep-property-name-keep-global-name * {*;}

✅ 修正后（正确）：

# 仅保留[@Sendable](/user/Sendable)类的属性名
-keep-property-name-keep-global-name class com.xxx.your.SendableClass {*;}

关键规则解释

额外注意事项（必看）

1. HAR 包混淆的特殊要求：

   • HAR 包的混淆规则需在 build-profile.json5 中明确指定：

     {
       "apiType": "stageMode",
       "buildOption": {
         "proguard": {
           "enable": true,
           "rules": ["proguard-rules.pro"] // 指向你的混淆规则文件
         }
       }
     }
     

2. 避免过度混淆：

   • [@Sendable](/user/Sendable) 类通常用于跨线程通信，其属性 / 方法名必须与调用方（如 UI 线程、后台线程）保持一致，绝对不能混淆名称；
   • 若该类有内部类，需同步保留内部类结构：

     -keep class com.xxx.your.SendableClass$* {*;}
     

3. 报错验证：

   • 配置完规则后，先执行 gradlew clean assembleHar 打包 HAR，检查是否有混淆警告；
   • 集成 HAR 后，运行时若仍报错，需检查：
     • 类是否被误标记为 sealed/final（不可扩展）；
     • 是否有动态代码（如反射）修改该类属性。

总结

1. 核心规则：必须保留[@Sendable](/user/Sendable)注解本身 + 目标类的完整结构（类名、属性、方法），禁止全局保留属性名，仅精准保留目标类；
2. 报错根源：-keep-property-name-keep-global-name 全局配置导致不可扩展类被强制添加属性，需缩小保留范围到目标[@Sendable](/user/Sendable)类；
3. 关键配置：添加-dontoptimize/-dontshrink禁止对该类优化，避免破坏「不可扩展」特性。