Files
phs_v1.0.1.0/build/tools/module_dependence/README.md

132 lines
3.7 KiB
Markdown
Raw Normal View History

2024-09-27 19:16:49 +08:00
## 模块依赖分析
### 生成部件依赖
生成步骤:
1. 编译代码生成中间文件只执行gn阶段并打开check_deps属性
```shell
./build.sh --product-name Hi3516DV300 --ccache --gn-args pycache_enable=true --gn-args check_deps=true --build-only-gn
```
2. 运行依赖生成脚本
```shell
# 比如在源码根目录下执行
build/tools/module_dependence/part_deps.py --deps-files-path out/ohos-arm-release/deps_files
```
3. 脚本参数说明
```
--deps-files-path # 必选 模块依赖数据文件目录gn执行完成后输出在out/ohos-arm-release/deps_files目录下如果不在源码目录执行需要配置到正确的路径。
--graph # 可选 生成部件依赖图。使用该选项,需要安装对应的库
```
4. 关于依赖图的生成
如果需要生成部件依赖图,使用--graph参数指定
本地机器需要安装依赖库pyecharts
```
# 使用pip安装python3的依赖库
pip3 install pyecharts
# 如果pip3没有安装请先安装pip3
sudo apt install python3-pip
```
5. 输出
脚本运行后会在 `--deps-files-path` 指定的deps_files的同级目录下创建parts_deps_info文件夹输出结果数据。
parts_deps_info/
```
parts_deps_info/all_deps_data.json # 生成的模块依赖信息
parts_deps_info/part_deps_info.json # 生成的部件依赖
parts_deps_info/part-deps-grahp.html # 生成的部件依赖图,只有指定--graph参数时才生成
```
### 生成模块依赖
生成步骤:
1. 编译代码生成中间文件只执行gn阶段并打开check_deps属性
```shell
./build.sh --product-name Hi3516DV300 --ccache --gn-args pycache_enable=true --gn-args check_deps=true --build-only-gn
```
2. 运行依赖生成脚本
```shell
# 比如在源码根目录下执行
build/tools/module_dependence/module_deps.py --deps-files-path out/ohos-arm-release/deps_files
```
3. 脚本参数说明
```
--deps-files-path # 必选 模块依赖数据文件目录gn执行完成后输出在out/ohos-arm-release/deps_files目录下如果不在源码目录执行需要配置到正确的路径。
```
4. 输出
脚本运行后会在 `--deps-files-path` 指定的deps_files的同级目录下创建module_deps_info文件夹输出结果数据。
```
module_deps_info/all_deps_data.json # 生成的模块依赖信息
module_deps_info/module_deps_info.json # 生成的模块依赖
```
5. 生成单个模块的依赖树
(1) 依赖pyecharts组件需要安装:
```
pip3 install pyecharts
```
(2) 生成命令:
```
# 比如在源码根目录下执行
build/tools/module_dependence/module_deps_tree.py --module-name 部件名:模块名 --module-deps-file out/ohos-arm-release/module_deps_info/module_deps_info.json
```
(3) 参数说明:
```
--module-name # 必选 要生成模块的名称,结构为"部件名:模块名"
--module-deps-file # 必选 模块依赖信息文件module_deps_info.json所在路径
```
(4) 输出:
脚本运行后会在module_deps_info.json的同级目录下输出模块依赖树图
```
module_deps_info/部件名__模块名.html
```
用浏览器打开这个文件,会展示模块依赖树,默认展开第一层依赖。
实心点表示一个模块还有未展开的其它模块依赖,点击实心点可以展开它的依赖。
一个模块第一次出现时显示为黑色,之后出现显示为红色。
**注意:**
*工具能力在完善中,使用脚本和步骤会随时变化。*