## Develop Guide
### service代码生成工具使用场景
当开发人员为OpenHarmony系统框架开发某些功能时，有时需要将这个功能包装成一个独立的服务进程运行在系统中，为了其它应用进程能够调用此服务，开发人员需要基于系统IPC通信框架编写一套远程接口调用实现。 Service代码生成工具能够帮助用户生成框架代码，提升开发效率。用户只需提供一个定义远程方法的.h头文件，工具会自动生成整个Service框架的代码，包含Ability注册、proxy/stub类实现、MessageParcel数据包构造、Service子系统编译及开机自启动相关配置文件。用户可基于框架代码专注于业务功能的编写。
---
### service工具代码框架说明
~~~
napi_generator\src\cli\h2sa
h2sa
├── docs //文档
├── README_ZH.md //usage,使用说明
├── package.json //Node.js打包配置文件
└── src
├── gen
│ ├── analyze.js //包含用于分析C++头文件的逻辑。读取头文件内容；解析文件以提取类、方法、参数等信息。
│ ├── file_template.js //包含生成代码时使用的模板字符串。模板中的占位符将在代码生成过程中被实际的数据替换，以生成所需的代码文件。（之后换成inl或者tmpl模板文件，并分出不同版本的文件夹，不同类型的文件）
│ ├── generate.js //包含核心的代码生成逻辑。调用analyze.js来获取分析结果；使用fileTemplate.js中的模板和分析结果来生成代码。
│ ├── header_parser.py //脚本，与analyze.js协同工作，用于解析C++头文件
│ └── test.h //生成sa的提示文件
│ └── main.js //项目的入口。初始化日志记录和其它工具；解析命令行参数，以确定用户想要执行的操作；调用generate.js来启动代码生成过程。
└── tools
├── common.js //包含整个项目中使用的通用函数和常量
├── file_rw.js //包含文件读写操作的JavaScript模块
├── napi_log.js //日志记录模块
├── re.js //包含正则表达式相关功能的模块
└── tool.js //包含一些辅助工具函数
~~~
### 运行逻辑
main.js为脚本入口，其中使用stdio.getopt获取参数，其中,参数详情如下：
-f，定义远程服务的.h文件；
-l, 日志级别（0-3），默认为1；
-o, 生成框架代码输入到指定路径下；
-s, 指定serviceID。 -
-v, 指定版本（3.2和4.1，默认版本为3.2）
~~~
let ops = stdio.getopt({
'filename': { key: 'f', args: 1, description: '.h file', default: '' },
'out': { key: 'o', args: 1, description: 'output directory', default: '.' },
'loglevel': { key: 'l', args: 1, description: 'Log Level: 0~3', default: '1' },
'serviceId': { key: 's', args: 1, description: 'service register id: 9000~16777214', default: '9000' },
'versionTag': { key: 'v', args: 1, description: 'version tag: 4.1 / 3.2', default: '3.2' }
});
~~~
### 开发指导
#### 适配新版本
用户可对工具进行二次开发。例如：当前工具适配的源码版本是4.1，需要适配其它版本时，可修改以下文件进行适配：
1.在main.js中，在allowedVersion数组中加入适配的版本号，如4.1统一为v4_1, 5.0统一为v5_0。
2.在file_template.js中，以适配5.0源码为例，参考bundleJsonTemplate41，buildGnTemplate41 新增v5_0版本对应的bundle.json模板、BUILD.gn模板；在module.exports中新增5.0版本的bundle.json,BUILD.gn模板对应的变量名。
3.在generate.js中，在doGenerate方法、genFilesByTemplate方法、genFileNames方法中修改相应代码；当rootInfo.version为v5_0时，替换对应的BUILD.gn, bundle.json模板路径。
4.适配新版本需要增加其它配置，可在file_template.js中增加配置模板，并增加配置文件模板的路径，在generate.js中生成配置文件。
#### RoadMap
| 时间点 | 预期任务 | 验收标准 | 完成情况 |
| :----- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------- |
| 9月份 | 1，代码去重方案提供（不同版本模板，proxy-stub框架，hidumper框架，hitrace）；
2，适配5.0release版本，增加代码中hidump、hitrace等日志跟踪定位工具的使用； | 1，设计文档；
2，适配5.0时，可以编译出对应版本的工具，且编译验证成功 | 预计2024.9.24 |
| 10月份 | 增加testapp调用 sa接口，包括死亡监听； | 杀掉服务后，有信息 | |