分享好友 最新动态首页 最新动态分类 切换频道
鸿蒙OpenHarmony【ArkGuard源码混淆工具】 ArkTS运编译工具链
2024-12-28 00:15

针对工程源码的混淆可以降低工程被破解攻击的风险,缩短代码的类与成员的名称,减小应用的大小。

说明

  1. 在 DevEco Studio5.0.3.600之前,新建工程的默认设置是开启代码混淆功能,它会自动对 API10及更高版本的 Stage 模型进行代码混淆。此操作仅适用于以[release模式]编译的代码,并且混淆仅限于参数名和局部变量名。
  2. 在 DevEco Studio5.0.3.600及之后,新建工程的默认设置已更改为关闭代码混淆功能。如果开发者希望开启代码混淆,需要将模块的文件中的字段的值设置为 true。此外,混淆规则配置文件默认开启了四项推荐的混淆选项:、、和,开发者可以根据需要进一步修改混淆配置。需要注意的是,开启这四项规则可能会导致应用在运行时崩溃来修正应用功能。

使用约束

  • 仅支持Stage工程
  • 编译模式为release
  • 模块及模块依赖的HAR均未配置关闭混淆的规则

混淆范围

在应用工程中,代码混淆支持以下格式文件混淆,混淆后的缓存文件保存在模块目录下的build/[…]/release目录下。

  • ArkTS文件
  • TS文件
  • JS文件

代码混淆能力已在系统中集成,可通过以下方式在DevEco Studio开启使用。

代码混淆目前只提供名称混淆的能力(因为其它混淆能力会劣化性能)。 开启代码混淆可以混淆以下名称:

  • 参数名和局部变量名
  • 顶层作用域的名称
  • 属性名称
  • 导出名称
  • 文件名称

混淆开启后,默认使能对参数名和局部变量名的混淆,无需选项配置。顶层作用域名称混淆、属性名称的混淆、导出名称混淆、文件名混淆打开可能会导致运行时错误,这些混淆功能通过混淆配置选项来开启/关闭它们。

创建一个模块的时候,模块级中会自动生成以下内容:

 

创建一个新的library的时候,还会额外生成consumerFiles属性:

 

混淆功能被关闭希望重新开启混淆需要满足条件: 属性ruleOptions.enable的值为true。

属性ruleOptions.files中指定的混淆配置文件会在构建HAP、HSP或HAR的时候生效。
属性consumerFiles中指定的混淆配置文件会在构建依赖这个library的模块时生效。这些混淆配置文件的内容还会被合并到HAR包中的obfuscation.txt文件。

当构建HAP、HSP和HAR的时候,最终的混淆规则是当前构建模块的ruleOptions.files属性,依赖library的consumerFiles属性,以及依赖HAR包中的obfuscation.txt文件的合并。
如果构建的是HAR,HAR包中的obfuscation.txt是自身的consumerFiles属性, 依赖library的consumerFiles属性,以及依赖HAR包中的obfuscation.txt文件的合并。构建HAP、HSP不会生成obfuscation.txt。混淆规则配置文件

在创建工程或library的时候,DevEco Studio会自动生成和文件。混淆规则可以写到这些文件中,或者其它自定义文件,然后将文件路径放到和中,如下面的例子所示。

 
 

混淆规则分为两种类型,一种是[混淆选项],一种是[保留选项];前者是提供顶层作用域名称、属性名称、文件名称等多种混淆功能配置开关,后者是提供各种混淆功能的白名单配置能力。

注意

若修改应用混淆配置,新配置需要重新全量编译应用才能生效。

混淆选项

-disable-obfuscation

关闭所有混淆。如果使用这个选项,那么构建出来的HAP、HSP或HAR将不会被混淆。

-enable-property-obfuscation

开启属性混淆。 如果使用这个选项,那么所有的属性名都会被混淆,除了下面场景:

  • 被直接导入或导出的类、对象的属性名不会被混淆。例如下面例子中的属性名不会被混淆。

     
  • ArkUI组件中的属性名不会被混淆。例如下面例子中的和不会被混淆。

     
  • 被[保留选项]指定的属性名不会被混淆。

  • SDK API列表中的属性名不会被混淆。SDK API列表是构建时从SDK中自动提取出来的一个名称列表,其缓存文件为systemApiCache.json,路径为工程目录下build/default/cache/{…}/release/obfuscation中

  • 字符串字面量属性名不会被混淆。例如下面例子中的和不会被混淆。

     

    如果想混淆字符串字面量属性名,需要在该选项的基础上再使用选项。例如

     

    注意

    1. 如果代码里面有字符串属性名包含特殊字符(除了之外的字符),例如,建议不要开启选项,因为可能无法通过[保留选项]来指定保留这些名字。
    2. SDK API的属性白名单中不包含声明文件中使用的字符串常量值,例如示例中的字符串’ohos.want.action.home’未包含在属性白名单中

     

    因此在开启了选项时,如果想保留代码中使用的SDK API字符串常量的属性不被混淆,例如obj[‘ohos.want.action.home’], 那么需要使用keep选项保留。

-enable-toplevel-obfuscation

开启顶层作用域名称混淆。如果使用这个选项,那么所有的顶层作用域的名称都会被混淆,除了下面场景:

  • 被的名称不会被混淆。
  • 当前文件找不到声明的名称不会被混淆。
  • 被[保留选项]指定的顶层作用域名称不会被混淆。
  • SDK API列表中的顶层作用域名称不会被混淆。
-enable-filename-obfuscation

开启文件/文件夹名称混淆。如果使用这个选项,那么所有的文件/文件夹名称都会被混淆,例如

 

除了下面场景:

  • oh-package.json5文件中’main’、'types’字段配置的文件/文件夹名称不会被混淆。
  • 模块内module.json5文件中’srcEntry’字段配置的文件/文件夹名称不会被混淆。
  • 被[-keep-file-name]指定的文件/文件夹名称不会被混淆。
  • 非ECMAScript模块引用方式(ECMAScript模块示例
  • 非路径引用方式,例如例子中的json5不会被混淆

注意

由于系统会在应用运行时加载某些指定的文件,针对这类文件,开发者需要手动在[-keep-file-name]选项中配置相应的白名单,防止指定文件被混淆,导致运行失败。 上述需要手动配置白名单的情况,包括但不限于以下场景

  • 当模块中包含Ability组件时。用户需要将中'abilities’字段下所有’srcEntry’对应的路径配置到白名单中。
  • 当模块中包含Worker多线程服务时,用户需要将中,‘buildOption’-‘sourceOption’-'workers’字段下所有的路径配置到白名单中。

提醒

编译入口、Ability组件、Worker多线程,这三种不能混淆的文件名在DevEco Studio 5.0.3.500版本已被自动收集进白名单中,无需再手动配置,其它不能混淆文件名的场景仍需开发者手动配置

-enable-export-obfuscation

开启直接导入或导出的类或对象的名称和属性名混淆。如果使用这个选项,那么模块中的直接导入或导出的名称都会被混淆,除了下面场景:

  • 远程HAR(真实路径在oh_modules中的包)中导出的类或对象的名称和属性名不会被混淆。
  • 被[保留选项]指定的名称与属性名不会被混淆。
  • SDK API列表中的名称不会被混淆。

注意

  1. 混淆导入或导出的类中属性名称需要同时开启与选项。

  2. 编译HSP时,如果开启选项,需要在模块中的混淆配置文件中保留对外暴露的接口。

  3. HAP/HSP/HAR依赖HSP场景下,编译时如果开启选项,需要在模块中的混淆配置文件中保留HSP导入的接口。

     
-compact

去除不必要的空格符和所有的换行符。如果使用这个选项,那么所有代码会被压缩到一行。

注意

release模式构建的应用栈信息仅包含代码行号,不包含列号,因此compact功能开启后无法依据报错栈中的行号定位到源码具体位置。

-remove-log

删除以下场景中对 console.*语句的调用,要求console.*语句返回值未被调用。

  1. 文件顶层的调用
  2. 代码块Block中的调用
  3. 模块Module中的调用
  4. switch语句中的调用
-print-namecache filepath

将名称缓存保存到指定的文件路径。名称缓存包含名称混淆前后的映射。

注意

每次全量构建工程时都会生成新的namecache.json文件,因此您每次发布新版本时都要注意保存一个该文件的副本。

-apply-namecache filepath

复用指定的名称缓存文件。名字将会被混淆成缓存映射对应的名字,如果没有对应,将会被混淆成新的随机段名字。 该选项应该在增量编译场景中被使用。

默认情况下,DevEco Studio会在临时的缓存目录中保存缓存文件,并且在增量编译场景中自动应用该缓存文件。
缓存目录:build/default/cache/{…}/release/obfuscation

-remove-comments

删除编译生成的声明文件中的JsDoc注释。

注意

编译生成的源码文件中的注释默认会被全部删除,不支持配置保留。
可通过配置来保留编译生成的声明文件中的JsDoc注释。

保留选项

[,identifiers,…]

指定想保留的属性名,支持使用名称类通配符。例如下面的例子:

 

注意

  • 该选项在开启时生效
  • 属性白名单作用于全局。即代码中出现多个重名属性,只要与配置白名单名称相同,均不会被混淆。

哪些属性名应该被保留?

为了保障混淆的正确性,建议保留所有不通过点语法访问的属性。

例子:

 

对于间接导出的场景,例如和,如果不想混淆它们的属性名,那么需要使用[保留选项]来保留这些属性名。另外,对于直接导出的类或对象的属性的属性名,例如下面例子中的和, 如果不想混淆它们,那么也需要使用[保留选项]来保留这些属性名。

 

so库的API(例如示例中的foo,如果要在ArkTS/TS/JS文件中使用需手动保留API名称。

 

使用到的json文件中的字段,需要手动保留。

 

使用到的数据库相关的字段,需要手动保留。

 

源码中自定义装饰器修饰了成员变量、成员方法、参数,同时其源码编译的中间产物为js文件时(如编译release源码HAR或者源码包含@ts-ignore、@ts-nocheck,这些装饰器所在的成员变量/成员方法名称需要被保留。这是由于ts高级语法特性转换为js标准语法时,将上述装饰器所在的成员变量/成员方法名称硬编码为字符串常量。

示例

 
[,identifiers,…]

指定要保留的顶层作用域的名称,支持使用名称类通配符。例如

 

namespace中导出的名称也可以通过保留。

 

注意

指定的白名单作用于全局。即代码中出现多个顶层作用域名称或者导出名称,只要与配置的白名单名称相同,均不会被混淆。

哪些顶层作用域的名称应该被保留?

在JavaScript中全局变量是的属性。如果在代码中使用去访问全局变量,那么该变量名应该被保留。

示例:

 

当以命名导入的方式导入 so 库的 API时,若同时开启和选项,需要手动保留 API 的名称。

 
[,identifiers,…]

指定要保留的文件/文件夹的名称(不需要写文件后缀),支持使用名称类通配符。例如

 

哪些文件名应该被保留?

1.在使用引入文件路径时,由于不支持[CommonJS]语法,因此这种情况下路径应该被保留。

 

2.对于动态引用方式,由于无法识别函数中的参数是否为路径,因此这种情况下路径应该被保留。

 

3.在使用[动态路由]进行路由跳转时,传递给路由的路径应该被保留。动态路由提供系统路由表和自定义路由表两种方式。若采用自定义路由表进行跳转,配置白名单的方式与上述第二种动态引用场景一致。而若采用系统路由表进行跳转,则需要将模块下文件中字段对应的路径添加到白名单中。

 
[,identifiers,…]

保留编译生成的声明文件中class, function, namespace, enum, struct, interface, module, type及属性上方的JsDoc注释,支持使用名称类通配符。例如想保留声明文件中Human类上方的JsDoc注释,可进行以下配置

 

注意

  1. 该选项在开启时生效
  2. 当编译生成的声明文件中class, function, namespace, enum, struct, interface, module, type及属性的名称被混淆时,该元素上方的JsDoc注释无法通过保留。例如当在中配置了exportClass时,如果exportClass类名被混淆,其JsDoc注释无法被保留
 
filepath

指定路径的文件中的名称(例如变量名、类名、属性名等)会被添加至和白名单中。请注意,仅支持绝对路径,并且可以指定为一个目录。在这种情况下,该目录中所有文件中的名称都将被保留。

filepath

保留指定相对路径中的所有名称(例如变量名、类名、属性名等)不被混淆。这个路径可以是文件与文件夹,若是文件夹,则文件夹下的文件及子文件夹中文件都不混淆。
路径仅支持相对路径,与为相对于混淆配置文件所在目录,支持使用路径类通配符。

 

注意

  1. 被所保留的文件,其依赖链路上的文件中导出名称及其属性都会被保留。
  2. 该功能不影响文件名混淆的功能。
保留选项支持的通配符
名称类通配符

名称类通配符使用方式如下

通配符含义示例?匹配任意单个字符"AB?“能匹配"ABC"等,但不能匹配"AB”*匹配任意数量的任意字符"AB“能匹配"AB”、“aABb”、“cAB”、"ABc"等

使用示例

保留所有以a开头的属性名称

 

保留所有单个字符的属性名称

 

保留所有属性名称

 
路径类通配符

路径类通配符使用方式如下

通配符含义示例?匹配任意单个字符,除了路径分隔符“…/a?“能匹配”…/ab"等,但不能匹配”…/a/"*匹配任意数量的任意字符,除了路径分隔符“…/a*/c"能匹配”…/ab/c",但不能匹配"…/ab/d/s/c"**匹配任意数量的任意字符“…/a**/c"能匹配”…/ab/c",也能匹配"…/ab/d/s/c"!表示非,只能写在某个路径最前端,用来排除用户配置的白名单中已有的某种情况“!https://blog.csdn.net/adsjgfjha123123/article/a/b/c.ets"表示除”…/a/b/c.ets"以外

使用示例

表示路径…/a/b/中所有文件夹(不包含子文件夹)中的c.ets文件不会被混淆

 

表示路径…/a/b/中所有文件夹(包含子文件夹)中的c.ets文件不会被混淆

 

表示路径…/a/b/中,除了c.ets文件以外的其它文件都不会被混淆。其中,不可单独使用,只能用来排除白名单中已有的情况

 

表示路径…/a/中的所有文件(不包含子文件夹)不会被混淆

 

表示路径…/a/下的所有文件夹(包含子文件夹)中的所有文件不会被混淆

 

表示模块内的所有文件不会被混淆

 

注意

(1)以上选项,不支持配置通配符、、作其它含义使用。 例如

 

此时表示匹配任意数量的任意字符,配置效果为所有属性名称都不混淆,而不是只有属性不被混淆。

(2)-keep选项中只允许使用路径格式,不支持``或。

注释

可以使用在混淆规则文件中进行注释。每行以开头的文本会被当做是注释,例如下面的例子:

 

构建HAR时,注释不会被合并到最后的文件中。

混淆规则合并策略

一个工程中经常会有许多混淆规则文件,这些文件来自于:

  • 主工程的 (这里主工程指的是正在构建的工程)
  • 本地依赖的library中的选项中指定的文件
  • 远程依赖的HAR包中的文件

当构建主工程的时候,这些文件中的混淆规则会按照下面的合并策略(伪代码)进行合并:

 

最后使用的混淆规则来自于对象。

如果构建的是HAR,那么最终的文件内容来自于自身和本地依赖的library的选项,以及依赖的HAR的文件的合并。

当指定的混淆配置文件中包含以下混淆规则时,这些混淆规则会被合并到HAR包的文件中,而其他混淆规则不会。

 

library中混淆注意事项

  1. 如果指定的混淆配置文件中包含上述混淆选项,当其他模块依赖该HAR包时,这些混淆选项会与主模块的混淆规则合并,从而影响主模块。因此不建议开发者在文件中配置混淆选项,建议仅配置保留选项。
  2. 如果在指定的混淆配置文件中添加选项,会被转换成和。

经过混淆的应用程序中代码名称会发生更改,crash时打印的报错栈更难以理解,因为报错栈与源码不完全一致。开发人员可使用DevEco Studio命令工具Command Line Tools中的hstack插件来还原源码堆栈,进而分析问题。反混淆工具需要使用应用编译过程中生成的sourceMaps.map文件以及混淆名称映射文件nameCache.json文件,因此请本地备份它们。

  1. 使用混淆的前置条件

    1. 查看当前模块是否开启混淆开关及选择release构建模式。
    2. 阅读文档,了解[混淆选项的能力]与[混淆选项所需要保留白名单的场景]。
  2. 依次开启混淆选项,逐一适配与验证应用功能

    1. 开启选项,如果代码中有globalThis访问全局变量,会出现访问失败的情况,需要使用来保留此全局变量名称。

    2. 待上述选项应用适配成功后,开启选项。此选项开启后以下场景需要适配

      1. 若代码中存在静态定义,动态访问的情况或者动态定义,静态访问的情况,需要使用保留属性名称。示例

         
         
      2. 若代码中使用点语法访问未在ArkTS/TS/JS代码中定义的字段,比如访问native实现的so库,字段固定的json文件与数据库等场景

        1. 若在代码中引用so库的api,如需要使用 foo保留属性名称。
        2. 若在代码中使用json文件中的字段,需要使用保留json文件中的字段名称。
        3. 若在代码中使用数据库相关的字段,需要使用保留数据库中的字段名称。
      3. 若构建HAR模块并发布给其他模块使用的场景,要在HAR模块中的consumer-rules.txt文件中将不能被二次混淆的属性使用保留。consumer-rules.txt文件在构建HAR时会生成obfuscation.txt文件。此HAR被其它模块依赖时,Deveco Studio会解析obfuscation.txt文件,读取文件中的白名单。

      4. 验证应用功能,排查遗漏的场景。若应用出现功能异常,依据混淆后的报错栈从对应的[中间产物]中找到报错行的代码,排查需要配置的白名单并使用进行保留。

    3. 待上述选项应用适配成功后,开启选项。此选项开启后以下场景需要适配

      1. 若构建HSP模块,它会提供接口及其属性给其它模块调用,因此需要将对外接口使用来保留、将对外暴露的class/interface等语法中的属性使用保留。
      2. 若构建HAR模块并发布给其他模块使用的场景,要在HAR模块中的obfuscation-rules.txt文件中将对外接口使用来保留、将对外暴露的class/interface等语法中的属性使用保留。
      3. 若在代码中引用so库的api,如;需要使用 napiA保留so接口名称。
      4. 验证应用功能以及模块被依赖时的接口调用功能,排查遗漏的场景。若应用出现功能异常,依据混淆后的报错栈从对应的[中间产物]中找到报错行的代码,排查需要配置的白名单并进行保留。
    4. 在混淆结束后会将中间产物落盘,因此可以在编译产物build目录中找到混淆后的中间产物以查看混淆效果,同时可以找到混淆生成的名称映射表及系统API白名单文件。

      • 混淆后的文件目录

      • 混淆名称映射表及系统API白名单目录

        • 名称映射表文件:nameCache.json,该文件记录了源码名称混淆的映射关系。
        • 系统API白名单文件:systemApiCache.json,该文件记录了SDK中的接口与属性名称,与其重名的源码不会被混淆。

      如何排查功能异常

      排查功能异常步骤
      1. 先在obfuscation-rules.txt配置-disable-obfuscation选项关闭混淆,确认问题是否由混淆引起。

        1. [-enable-toplevel-obfuscation]为顶层作用域名称混淆开关。
        2. [-enable-property-obfuscation]为属性混淆开关,配置白名单的主要场景为网络数据访问、json字段访问、动态属性访问、调用so库接口等不能混淆场景,需要使用[-keep-property-name]来保留指定的属性名称。
        3. [-enable-export-obfuscation]为导出名称混淆,一般与和选项配合使用;配置白名单的主要场景为模块对外接口不能混淆,需要使用[-keep-global-name]来指定保留导出/导入名称。
        4. [-enable-filename-obfuscation]为文件名混淆,配置白名单的主要场景为动态import或运行时直接加载的文件路径,需要使用[-keep-file-name]来保留这些文件路径及名称。
      2. 参考FAQ中的[常见报错案例],若是相似场景可参考对应的解决方法快速解决。

      3. 若常见案例中未找到相似案例,建议依据各项配置功能正向定位(若不需要相应功能,可删除对应配置项)。

      4. 应用运行时崩溃分析方法: 1.打开应用运行日志或者点击DevEco Studio中出现的Crash弹窗,找到运行时崩溃栈。 2.应用运行时崩溃栈中的行号为[编译产物]的行号,方法名也可能为混淆后名称;因此排查时建议直接根据崩溃栈查看编译产物,进而分析哪些名称不能被混淆,然后将其配置进白名单中。

      5. 应用在运行时未崩溃但出现功能异常的分析方法(比如白屏: 1.打开应用运行日志:选择HiLog,检索与功能异常直接相关的日志,定位问题发生的上下文。 2.定位异常代码段:通过分析日志,找到导致功能异常的具体代码块。 3.增强日志输出:在疑似异常的功能代码中,对处理的数据字段增加日志记录。 4.分析并确定关键字段:通过对新增日志输出的分析,识别是否由于混淆导致该字段的数据异常。 5.配置白名单保护关键字段:将确认在混淆后对应用功能产生直接影响的关键字段添加到白名单中。

      排查非预期的混淆能力

      若出现预期外的混淆效果,检查是否是依赖的本地模块/三方库开启了某些混淆选项。

      示例: 假设当前模块未配置,但是混淆的中间产物中代码都被压缩成一行,可按照以下步骤排查混淆选项

      1. 查看当前模块的oh-package.json5中的dependencies,此字段记录了当前模块的依赖信息。

      2. 在依赖的模块/三方库中的混淆配置文件内检索"-comapct"

        • 在本地依赖的library中的consumer-rules.txt文件中检索"-compact"。
        • 在工程目录下的oh_modules文件夹中,对全部的obfuscation.txt文件检索"-compact"。

      说明: 三方库中obfuscation.txt不建议配置如下开关选项,这些选项会在主模块开启混淆时生效,进而出现预期外的混淆效果,甚至会出现应用运行时崩溃。因此建议联系发布此三方库方删除这些选项并重新出包。

       
      

      常见报错案例

      开启-enable-property-obfuscation选项可能出现的问题

      案例一:报错内容为 Cannot read property ‘xxx’ of undefined

       
      

      开启属性混淆后,“jsonProperty” 被混淆成随机字符 “i”,但json文件中为原始名称,从而导致值为undefined。

      解决方案 使用选项将json文件里的字段配置到白名单。

      案例二:使用了数据库相关的字段,开启属性混淆后,出现报错

      报错内容为

      代码里使用了数据库字段,混淆时该SQL语句中字段名称被混淆,但数据库中字段为原始名称,从而导致报错。

      解决方案 使用选项将使用到的数据库字段配置到白名单。

      开启-enable-export-obfuscation和-enable-toplevel-obfuscation选项可能出现的问题

      当开启这两个选项时,主模块调用其他模块方法时涉及的方法名称混淆情况如下

      主模块依赖模块导入与导出的名称混淆情况HAP/HSPHSPHSP和主模块是独立编译的,混淆后名称会不一致,因此都需要配置白名单HAP/HSP本地HAR本地HAR与主模块一起编译,混淆后名称一致HAP/HSP三方库三方库中导出的名称及其属性会被收集到白名单,因此导入和导出时都不会被混淆

      HSP需要将给其他模块用的方法配置到白名单中。因为主模块里也需要配置相同的白名单,所以推荐将HSP配置了白名单的混淆文件(假设名称为hsp-white-list.txt)添加到依赖它的模块的混淆配置项里,即下图files字段里。

      案例一:动态导入某个类,类定义的地方被混淆,导入类名时却没有混淆,导致报错

       
      

      导出的类 “Test1” 是一个顶层作用域名,当 “Test1” 被动态使用时,它是一个属性。因为没有开启选项,所以名称混淆了,但属性没有混淆。

      解决方案 使用选项将 “Test1” 配置到白名单。

      案例二:在使用namespace中的方法时,该方法定义的地方被混淆了,但使用的地方却没有被混淆,导致报错

       
      

      namespace里的 “person1” 属于顶层作用域的class名称,通过 “ns1.person1” 来调用时,它是属于一个属性,由于未开启属性混淆,所以在使用它时没有被混淆。

      解决方案

      1. 开启选项。
      2. 将namespace里导出的方法使用选项添加到白名单。

      案例三:使用了,混淆后报语法错误

       
      

      报错内容为

      解决方案 使用选项将配置到白名单中。

      未开启-enable-string-property-obfuscation混淆选项,字符串字面量属性名却被混淆,导致字符串字面量属性名的值为undefined
       
      

      解决方案

      1. 确认是否有依赖的HAR包开启了字符串属性名混淆,若开启了,则会影响主工程,需将其关闭。
      2. 若不能关闭选项,将属性名配置到白名单中。
      3. 若依赖HAR包未开启字符串属性名混淆,同时SDK版本小于4.1.5.3,请更新SDK。
      开启-enable-filename-obfuscation选项后,可能会出现的问题

      案例一:报错为 Error Failed to get a resolved OhmUrl for ‘D:code/MyApplication/f12/library1/pages/d.ets’ imported by ‘undefined’

      工程的目录结构如下图所示,模块library1的外层还有目录 “directory”,开启文件名混淆后,“directory” 被混淆为f12,导致路径找不到。

      解决方案

      1. 如果工程的目录结构和报错内容都相似,请将SDK更新至最低5.0.0.26版本。
      2. 使用将模块外层的目录名 “directory” 配置到白名单中。

      案例二:报错为 Cannot find module ‘ets/appability/AppAbility’ which is application Entry Point

      由于系统会在应用运行时加载ability文件,用户需要手动配置相应的白名单,防止指定文件被混淆,导致运行失败。

      解决方案 使用选项,将文件中'srcEntry’字段所对应的路径配置到白名单中。

       
      
      使用-keep-global-name选项配置白名单时,可能会出现的问题

      报错内容为

      解决方案 将SDK更新至最低4.1.6.3版本。

      HAP与HSP依赖相同的本地源码HAR模块,可能会出现的问题
      • 若开启文件名混淆,会出现以下问题

        • 问题一:单例功能异常问题。原因是HAP与HSP独立执行构建与混淆流程,本地源码HAR模块在HAP与HSP的包中可能会出现相同的文件名被混淆成不同文件名的情况。
        • 问题二:接口调用失败问题。原因是HAP与HSP独立执行构建与混淆流程,本地源码HAR模块在HAP与HSP的包中可能会出现不同的文件名被混淆成相同的文件名的情况。
      • 若开启和选项,在应用运行时会出现加载接口失败的问题。 原因是HAP与HSP独立执行构建与混淆流程,本地源码HAR模块中暴露的接口在HAP与HSP中被混淆成不同的名称。

最新文章
一聊新手如何从这三个技巧入手做好SEO优化,让网站排名不断上升
刚接触这个SEO行业的新手总是感到力不从心,不知从何下手。 我的网站每天都在更新文章,定期维护网站,但是过了一段时间,网站的排名还是上不去。 今天我们就来说说新手如何从这三个技巧入手,做好SEO优化,让自己的网站排名不断上升。1.内
数夜蹲守抓偷排,一群“90后”为啥如此“拼”?
转自:中国环境报第一融:把练兵融入培训之中正所谓“磨刀不误砍柴工”,培训是执法战斗力的前提和保障,要想提高执法人员的各项综合能力,必须以培训为抓手。如东局在培训之中,注重“三抓三培育”:抓专项,培育行业人才。为了突出每个人
高清美女写真生成神器:用AI技术打造你的专属女神
限时免费,点击体验最近超火的AI生图神器,坐拥3000美女的大男主就是你! https://ai.sohu.com/pc/generate/textToImg?_trans_=030001_yljdaimn 在这个数字时代,我们通过摄像头记录下瞬息万变的美丽。然而,科技的快速发展让我们拥有了更
越南某APP真开放!美女直播露PP,还将缝隙处...
越南的许多脸书用户反映,他们不断受到一系列裸体和色情直播视频的“攻击”。“当我看到来自 Facebook 广告帖子的令人反感的图片和色情视频时,我感到震惊。Facebook 怎么允许这样的宣传帖子在他们的平台上泛滥而不自知?‘”一名用户愤怒
如何从短信链接打开跳转到微信App内
H5页面想要直接跳转到微信APP内的视频号,需要利用微信提供的JSSDK(JavaScript接口安全域名)。首先,你需要在微信公众平台上申请获取微信开放平台的JS-SDK权限,并配置安全域名。以下是一个基本的步骤:1. **引入JSSDK**: 在HTML文件头部
华南理工大学“海外优青论坛”前沿软物质学院分论坛:四维扫描透射电镜叠层重构方法对电池材料的原子尺度表征
论坛时间:2024年12月16日(星期一)9:30论坛地点:华南理工大学广州国际校区C3-c204会议室报告主题:四维扫描透射电镜叠层重构方法对电池材料的原子尺度表征主办单位:前沿软物质学院论坛议程:锂离子电池已广泛用于电子设备和电动汽车中
无锡高新区:聚焦全球优质项目,打造高水平利用外资“强磁场”
近日,江苏省商务厅发布了关于认定2024年外资总部经济集聚区的通知,无锡高新区以坚实的外资总部经济基础和深厚的对外开放传统,获得“江苏省外资总部经济集聚区”认定。目前,无锡高新区共有来自57个国家或地区的各类外商投资企业超1800家
打造卓越视频平台,规划与运营全程指导攻略
《搭建高效视频网站攻略》全面解析从规划到运营的全程策略,涵盖网站架构、内容策略、用户体验优化、技术选型、流量运营等多个关键环节,助您打造高效率、用户体验佳的视频平台。规划阶段技术选型推广策略在互联网迅猛发展的今天,视频内容
免费的短链接生成平台有哪些
短链接可以说每个商家都使用过,因为短链接在网络营销中被广泛的使用是在于其使用价值。短链接可以美化链接、易于记忆、规避网址被墙、提高点击率等等。本篇文章就给大家收集了国内超好用的15个短链接在线生成器,希望对大家有所帮助!1、
ONE(ONE币)兑换南非兰特今日价格行情,ONE(ONE币)今日价格行情,最新消息,ONE24小时实时汇率K线历史走势图分析
ONE是ONE生态的通证。ONE是由BigONE发行的基于以太坊ERC20合约的代币。ONE通证凝聚了BigONE交易平台及生态的所有权益,平台将秉承区块链精神,让所有的用户共享平台收益。1. 永久享受 BigONE 平台 100% 交易手续费的返利BigONE 平台每日会
相关文章
推荐文章
发表评论
0评