已开启
【社区学习赛】docs: 修改错误的print说明developer_guide_zh.md #1241
2501_93903183创建于 8月25日
【社区学习赛】docs: 修改错误的print说明developer_guide_zh.md #1241
已开启
2501_93903183创建于 8月25日
共 1 个文件变更+4-4
xuanjzxuanjz9月11日

PR&issue 合规检查结果 / PR & Issue Compliance Check Results

Item Target Result Notes
PR template Cangjie/cangjie_tools#1241 FAIL 缺失关联issue及编译测试自检子项 / missing Related Issues & compile/test self-check subsections
Issue template Cangjie/cangjie_tools#664 PASS 必填字段齐全 / required fields filled
PR-Issue consistency Cangjie/cangjie_tools#1241 SKIP 声明为空,实际关联#664 / no declaration; actual #664

检查结论 / Conclusion: FAIL

likedislike
@@ -3,7 +3,7 @@
3## 系统架构3## 系统架构
4 4 
5`HLE (HyperlangExtension)` 是一个仓颉调用ArkTS互操作代码模板自动生成工具。5`HLE (HyperlangExtension)` 是一个仓颉调用ArkTS互操作代码模板自动生成工具。
6-该工具的输入是ArkTS接口声明文件,例如后缀.d.ts或者.d.ets结尾的文件,输出为包含BUILD.gn文件和src文件夹。src文件夹中包含的cj文件中存放生成的互操作代码。工具也会输出包含ArkTS文件的所有信息的json文件。为了提升互操作易用性,在DevEco Studio提供了两个工具,一个是ArkTS调用仓颉的Bindings generator,即通过@Interop宏展开,自动生产ArkTS调用仓颉的代码和ArkTS侧的接口文件,另外一个工具是仓颉调用ArkTS的Bindings generator(即HLE工具),其整体技术架构如下图所示:6+该工具的输入是ArkTS接口声明文件,例如后缀.d.ts或者.d.ets结尾的文件,输出为包含BUILD.gn文件和src文件夹。src文件夹中包含的cj文件中存放生成的互操作代码。工具也会输出包含ArkTS文件的所有信息的json文件。为了提升互操作易用性,在DevEco Studio提供了两个工具,一个是ArkTS调用仓颉的Bindings generator,即通过@Interop宏展开,自动生成ArkTS调用仓颉的代码和ArkTS侧的接口文件,另外一个工具是仓颉调用ArkTS的Bindings generator(即HLE工具),其整体技术架构如下图所示:
7 7 
8![HLE架构设计图](../figures/HLE.png)8![HLE架构设计图](../figures/HLE.png)
9 9 
@@ -12,7 +12,7 @@
12 12 
13- 接口抽象描述生成:在解析 ArkTS 接口的基础上,将接口信息进行抽象化处理,生成统一、简洁的接口抽象描述,便于后续进行接口依赖分析等操作,为代码生成过程中对接口关系的处理提供清晰的抽象模型。13- 接口抽象描述生成:在解析 ArkTS 接口的基础上,将接口信息进行抽象化处理,生成统一、简洁的接口抽象描述,便于后续进行接口依赖分析等操作,为代码生成过程中对接口关系的处理提供清晰的抽象模型。
14 14 
15-- 代码生成:基于互操作库,自动生产仓颉封装层代码。15+- 代码生成:基于互操作库,自动生成仓颉封装层代码。
16 16 
17架构图中依赖部件引入说明:17架构图中依赖部件引入说明:
18 18 
@@ -141,7 +141,7 @@ hyperlangExtension/
141 ${WORKDIR}/cangjie-tools/hyperlangExtension/output/hle -i ${WORKDIR}/cangjie-tools/hyperlangExtension/tests/cases/class.d.ts -o out --module-name=ohos.hilog --lib141 ${WORKDIR}/cangjie-tools/hyperlangExtension/output/hle -i ${WORKDIR}/cangjie-tools/hyperlangExtension/tests/cases/class.d.ts -o out --module-name=ohos.hilog --lib
142 ```142 ```
143 143 
144- 在Windows环境,文件目录当前不支持符号“\\”,仅支持使用“/”。144+ 在Windows环境,文件路径当前不支持符号“\\”,仅支持使用“/”。
145 ```sh145 ```sh
146 ${WORKDIR}/cangjie-tools/hyperlangExtension/output/hle.exe -i ${WORKDIR}/cangjie-tools/hyperlangExtension/tests/cases/class.d.ts -o out --module-name=ohos.hilog --lib146 ${WORKDIR}/cangjie-tools/hyperlangExtension/output/hle.exe -i ${WORKDIR}/cangjie-tools/hyperlangExtension/tests/cases/class.d.ts -o out --module-name=ohos.hilog --lib
147 ```147 ```
@@ -160,7 +160,7 @@ python3 build.py build --target windows-x86_64
160python3 build.py install --prefix output160python3 build.py install --prefix output
161```161```
162 162 
163-执行该命令后,构建产物默认位于 `hyperlangExtension/output` 目录下。163+执行该命令后,构建产物位于 `hyperlangExtension/output` 目录下。
164 164 
165### 更多构建选项165### 更多构建选项
166 166