openharmony/developtools_global_resource_tool
1
0
Fork 0
mirror of https://github.com/openharmony/developtools_global_resource_tool.git synced 2026-07-19 19:33:46 -04:00
Code Issues Packages Projects Releases Wiki Activity

修改readme

Browse Source 
Signed-off-by: zt147369 <zhangting201@huawei.com>
This commit is contained in:
zt147369
2023-12-13 15:53:44 +08:00
parent 0f137fe407
commit 48ac64f47d
1 changed files with 35 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README_zh.md
+35 -1
View File
@@ -39,12 +39,36 @@ restool当前支持以下命令选项:
| -h/--help | 可缺省 | 不带参数 | 查看工具帮助信息。 |
| -m/--modules | 可缺省 | 带参数 | 多模块联合编译时，指定多个模块名。用“，”连接。 |
| -x/--append | 可缺省 | 带参数 | 指定生成中间文件的资源目录或单个资源路径。同一个命令可以多次指定。 |
| -z/--combine | 可缺省 | 不带参数 | 针对资源终将文件目录，生成编译结果。 |
| -z/--combine | 可缺省 | 不带参数 | 针对资源中间文件目录，生成编译结果。 |
| -v/--version | 可缺省 | 不带参数 | 查看工具版本号。 |
| -l/--fileList | 可缺省 | 带参数 | 指定命令选项的集合json文件，例如：resConfig.json。详细格式查看开发文档。 |
| --ids | 可缺省 | 带参数 | 指定生成id_defined.json的输出目录。 |
| --defined-ids | 可缺省 | 带参数 | 指定id_defined.json文件路径，一般都是通过--ids生成。<br>id_defined.json包含资源类型、名称及其ID的列表。<br>开发者可以自定义id_defined.json中的资源ID。 |
| --dependEntry | 可缺省 | 带参数 | FA模型下单独编译feature时，指定entry模块的编译结果目录。 |
| --icon-check | 可缺省 | 不带参数 | 开启icon和startWindowIcon的PNG图片校验功能。 |
| --target-config | 可缺省 | 带参数 | 与“-i”命令同时使用，支持选择编译。<br>[参数说明](#target-config)：参数指定要包含的配置，默认值为所有配置。|
### target-config
```
--target-config 参数说明
支持参数类型：MccMnc、Locale、Orientation、Device、ColorMode、Density
参数格式说明：配置之间用“;”分割，配置中的值用“[]”封装，并使用“,”分割
MccMnc匹配规则：Mcc值必须相等，Mnc值存在空时默认匹配，否则Mnc值必须相等才匹配
Locale匹配规则：Locale匹配需满足以下三条规则
1、语言值必须相等
2、脚本存在空时默认匹配，否则必须相等
3、地区存在空时默认匹配，否则必须相等
参数说明举例：参数 Locale[zh_CN,en_US];Device[phone]
说明 过滤其他语言，保留能匹配上zh_CN和en_US的语言
过滤其他设备，保留phone
其他类型配置均保留
```
### 使用实例
@@ -93,6 +117,16 @@ restool -i entry/src/main -j entry/src/main/module.json -p com.ohos.demo -o out
restool -i entry/src/main -j entry/src/main/module.json -p com.ohos.demo -o out1 -r out1/ResourceTable.txt --defined-ids out/id_defined.json -f
```
选择资源编译的两种使用：
方式一：全量编译
```
restool -i entry/src/main -j entry/src/main/module.json -p com.ohos.demo -o out1 -r out1/ResourceTable.txt --defined-ids out/id_defined.json -f --target-config Locale[zh_CN,en_US];Device[phone]
```
方式二：增量编译
```
restool -i out1 -i out2 -o out -p com.ohos.demo -r out/ResourceTable.txt -j entry/src/main/module.json -f -z --target-config Locale[zh_CN,en_US];Device[phone]
```
### 资源类型介绍
[资源类型介绍](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/resource-categories-and-access.md)