diff --git a/zh-cn/application-dev/arkts-utils/arkts-bytecode-overview.md b/zh-cn/application-dev/arkts-utils/arkts-bytecode-overview.md index 732777fba8d77ee463d7658b7fab776ac8c2c024..5050e5ae5051b7b99a000e125ca4bc37c404d429 100644 --- a/zh-cn/application-dev/arkts-utils/arkts-bytecode-overview.md +++ b/zh-cn/application-dev/arkts-utils/arkts-bytecode-overview.md @@ -4,8 +4,8 @@ - 方舟字节码文件格式:介绍字节码文件中包含的各个部分的结构信息,以及各种结构的存储方式和映射关系。 -- 方舟字节码基本原理:介绍字节码中构成指令的重要概念和具体的指令格式及含义,帮助开发者了解方舟字节码指令,进行指令相关的特性开发工作。 +- 方舟字节码基本原理:介绍字节码中构成指令的重要概念、指令格式及含义,帮助开发者了解方舟字节码指令,进行相关特性开发。 -- 方舟字节码函数命名规则:介绍字节码文件中函数名字的字符串的命名规则。 +- 方舟字节码函数命名规则:介绍字节码文件中函数名字的命名规则。 -- 编译期自定义修改方舟字节码:介绍如何修改字节码文件的内容。 +- 编译期自定义修改方舟字节码:介绍修改字节码文件的内容。 diff --git a/zh-cn/application-dev/arkts-utils/compilation-tool-chain-overview.md b/zh-cn/application-dev/arkts-utils/compilation-tool-chain-overview.md index 4d3c7472c42b6e8def15b93df85a51590338c912..f11021c397eb0930452eab85f4d2eae8a0cff0a0 100644 --- a/zh-cn/application-dev/arkts-utils/compilation-tool-chain-overview.md +++ b/zh-cn/application-dev/arkts-utils/compilation-tool-chain-overview.md @@ -14,9 +14,9 @@ ArkTS编译工具链当前主要包括如下功能: 4. 字节码编译:使用方舟编译器生成方舟字节码文件(\*.abc)。 -5. 自定义修改方舟字节码:提供开发者修改字节码能力的入口,在字节码编译落盘前调用。 +5. 自定义修改方舟字节码:提供开发者修改字节码的能力入口,在字节码编译落盘前调用。 -6. 反汇编:使用Disassembler反汇编工具将字节数据反汇编成可阅读的汇编指令。 +6. 反汇编:使用Disassembler反汇编工具将字节数据反汇编成可读的汇编指令。 ArkTS编译工具链在构建hap流程参考下图: diff --git a/zh-cn/application-dev/arkts-utils/customize-bytecode-during-compilation.md b/zh-cn/application-dev/arkts-utils/customize-bytecode-during-compilation.md index 48a42430474ce856d3b81fe7d2a12c3e67e8a929..df7edd52f2e3b2ea40b6e73a046fc75fce44765d 100644 --- a/zh-cn/application-dev/arkts-utils/customize-bytecode-during-compilation.md +++ b/zh-cn/application-dev/arkts-utils/customize-bytecode-during-compilation.md @@ -1,14 +1,14 @@ # 编译期自定义修改方舟字节码 -开发者如果希望自定义修改方舟字节码文件的内容,可以使用ArkTS编译工具链提供的自定义修改方舟字节码文件能力。 +开发者可以使用ArkTS编译工具链自定义修改方舟字节码文件。 ## 能力配置说明 -准备一个操作方舟字节码文件的动态库文件,在工程的配置文件build-profile.json5中[配置编译选项transformLib](arkoptions-guide.md),选项值为这个动态库的路径,编译器会在指定的时机加载这个动态库,并且执行其中特定的Transform方法。 +准备一个操作方舟字节码的动态库文件,在工程配置文件build-profile.json5中[配置编译选项transformLib](arkoptions-guide.md),值为动态库路径,编译器将加载并执行Transform方法。 ## 能力执行机制 -如果配置了transformLib且对应的动态库文件能正确加载,编译器将先生成方舟字节码文件到默认目标位置,然后调用动态库中的Transform方法,并将方舟字节码文件的路径作为参数传入。Transform方法包含开发者自定义的修改逻辑,用于重新生成方舟字节码文件,同时更新字节码文件的落盘操作是由用户执行。 +配置transformLib且动态库文件正确加载后,编译器生成方舟字节码到默认目标位置,调用动态库中的Transform方法,传入方舟字节码路径。Transform方法包含自定义修改逻辑,重新生成方舟字节码,同时更新字节码的落盘操作是由用户执行。 下面是一个动态库的模板,开发者可根据需求实现Transform的具体逻辑。 @@ -30,7 +30,7 @@ } ``` -2. 使用c语言编译工具(这里使用g++)编译动态库。 +2. 使用c语言编译工具(如g++)编译动态库。 Windows平台: @@ -50,10 +50,10 @@ g++ --shared -o example.so example.cpp ``` -3. 在DevEco Studio中配置build-profile.json5的transformLib选项(以windows环境为例)。 +3. 在DevEco Studio中配置build-profile.json5的transformLib选项(以Windows环境为例)。 - 选项中配置的路径为步骤2生成的链接库文件在项目中的路径(这里是dll目录下)。 + 在选项中配置的路径应为步骤2生成的动态库文件在项目中的路径(这里是dll目录下)。 ![zh-cn_image_0000002079773605](figures/zh-cn_image_0000002079773605.png) -4. 重新编译项目,即可完成自定义修改方舟字节码。 +4. 重新编译项目,完成自定义修改方舟字节码。 diff --git a/zh-cn/application-dev/arkts-utils/tool-disassembler.md b/zh-cn/application-dev/arkts-utils/tool-disassembler.md index 00c0b09d49699c31c99037eb12baa835fbe04387..f44e8053999c2441f472acc0bd492fe96cde9fd5 100644 --- a/zh-cn/application-dev/arkts-utils/tool-disassembler.md +++ b/zh-cn/application-dev/arkts-utils/tool-disassembler.md @@ -2,9 +2,9 @@ ## 简介 -Disassembler是ArkTS反汇编工具。如果需要分析方舟字节码文件(\*.abc)相关问题,开发者可以使用Disassembler将字节数据反编译为可读的汇编指令。 +Disassembler是ArkTS反汇编工具。开发者可以使用Disassembler将方舟字节码文件(\*.abc)反编译为可读的汇编指令,以便分析相关问题。 -工具随DevEco Studio SDK发布。以Windows平台为例,Disassembler工具位于DevEco Studio/sdk/default/openharmony/toolchains/ark_disasm.exe。 +工具随DevEco Studio SDK发布。在Windows平台上,Disassembler工具位于DevEco Studio/sdk/default/openharmony/toolchains/ark_disasm.exe。 ## 命令行说明 @@ -36,7 +36,7 @@ options选项说明: ## 使用示例 -假设已存在方舟字节码文件:test.abc,其源代码如下: +假设已存在方舟字节码文件test.abc: ``` let i = 99; @@ -45,13 +45,13 @@ show(); ``` -执行如下命令生成反汇编文件:test.txt,文件内包含操作码及格式等信息。 +执行如下命令生成反汇编文件:test.txt,文件包含操作码和格式等信息。 ``` ark_disasm.exe test.abc test.txt ``` -查看反汇编文件的内容。 +查看反汇编文件。 ``` @@ -108,7 +108,7 @@ L_ESSlotNumberAnnotation: [offset:0x88, name_value:i] ``` -使用参数--verbose,可打印偏移量等更多详细信息。 +使用参数--verbose,打印偏移量等详细信息。 ```