From 48ac64f47db5474db4dcd798649c56351534a0e7 Mon Sep 17 00:00:00 2001 From: zt147369 Date: Wed, 13 Dec 2023 15:53:44 +0800 Subject: [PATCH 1/3] =?UTF-8?q?=E4=BF=AE=E6=94=B9readme?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: zt147369 --- README_zh.md | 36 +++++++++++++++++++++++++++++++++++- 1 file changed, 35 insertions(+), 1 deletion(-) diff --git a/README_zh.md b/README_zh.md index 87d17df..56406fc 100644 --- a/README_zh.md +++ b/README_zh.md @@ -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生成。
id_defined.json包含资源类型、名称及其ID的列表。
开发者可以自定义id_defined.json中的资源ID。 | | --dependEntry | 可缺省 | 带参数 | FA模型下单独编译feature时，指定entry模块的编译结果目录。 | +| --icon-check | 可缺省 | 不带参数 | 开启icon和startWindowIcon的PNG图片校验功能。 | +| --target-config | 可缺省 | 带参数 | 与“-i”命令同时使用，支持选择编译。
[参数说明](#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) From fc60d918b7a6a2de53f5a2b02aae9795befe4395 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=BC=A0=E5=A9=B7?= Date: Wed, 13 Dec 2023 12:38:28 +0000 Subject: [PATCH 2/3] update README_zh.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 张婷 --- README_zh.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README_zh.md b/README_zh.md index 56406fc..9f1e9c8 100644 --- a/README_zh.md +++ b/README_zh.md @@ -63,10 +63,10 @@ Locale匹配规则：Locale匹配需满足以下三条规则 2、脚本存在空时默认匹配，否则必须相等 3、地区存在空时默认匹配，否则必须相等 -参数说明举例：参数 Locale[zh_CN,en_US];Device[phone] - 说明 过滤其他语言，保留能匹配上zh_CN和en_US的语言 - 过滤其他设备，保留phone - 其他类型配置均保留 +参数举例说明：参数 Locale[zh_CN,en_US];Device[phone] + 说明 过滤其他语言，保留能匹配上zh_CN和en_US的语言 + 过滤其他设备，保留phone + 其他类型配置均保留 ``` From 7bb8f32072ea2be8d3285a7eb4561492cb6f6a75 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=BC=A0=E5=A9=B7?= Date: Wed, 13 Dec 2023 12:41:13 +0000 Subject: [PATCH 3/3] update README_zh.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 张婷 --- README_zh.md | 38 ++++++++++++-------------------------- 1 file changed, 12 insertions(+), 26 deletions(-) diff --git a/README_zh.md b/README_zh.md index 9f1e9c8..dc6c0e7 100644 --- a/README_zh.md +++ b/README_zh.md @@ -46,29 +46,25 @@ restool当前支持以下命令选项: | --defined-ids | 可缺省 | 带参数 | 指定id_defined.json文件路径，一般都是通过--ids生成。
id_defined.json包含资源类型、名称及其ID的列表。
开发者可以自定义id_defined.json中的资源ID。 | | --dependEntry | 可缺省 | 带参数 | FA模型下单独编译feature时，指定entry模块的编译结果目录。 | | --icon-check | 可缺省 | 不带参数 | 开启icon和startWindowIcon的PNG图片校验功能。 | -| --target-config | 可缺省 | 带参数 | 与“-i”命令同时使用，支持选择编译。
[参数说明](#target-config)：参数指定要包含的配置，默认值为所有配置。| +| --target-config | 可缺省 | 带参数 | 与“-i”命令同时使用，支持选择编译。
[参数说明](#target-config参数说明)：指定要包含的配置。| -### target-config -``` ---target-config 参数说明 +#### target-config参数说明 -支持参数类型：MccMnc、Locale、Orientation、Device、ColorMode、Density +支持参数配置类型：MccMnc、Locale、Orientation、Device、ColorMode、Density -参数格式说明：配置之间用“;”分割，配置中的值用“[]”封装，并使用“,”分割 +参数格式说明：配置之间用“;”分割，配置中的值用“[]”封装，并使用“,”分割。 -MccMnc匹配规则：Mcc值必须相等，Mnc值存在空时默认匹配，否则Mnc值必须相等才匹配 +MccMnc匹配规则：Mcc（国家码）必须相同；Mnc（网络码）不存在时默认匹配，否则Mnc须相同才匹配。 -Locale匹配规则：Locale匹配需满足以下三条规则 - 1、语言值必须相等 - 2、脚本存在空时默认匹配，否则必须相等 - 3、地区存在空时默认匹配，否则必须相等 +Locale匹配规则：Locale匹配需满足以下三条规则。 -参数举例说明：参数 Locale[zh_CN,en_US];Device[phone] - 说明 过滤其他语言，保留能匹配上zh_CN和en_US的语言 - 过滤其他设备，保留phone - 其他类型配置均保留 -``` +1、语言须相同。 +2、脚本（文字）不存在时默认匹配，否则必须相同。 + +3、国家或地区不存在时默认匹配，否则必须相同。 + +参数举例说明：Locale[zh_CN,en_US];Device[phone]，该参数过滤其他语言，保留能匹配上zh_CN和en_US的语言；过滤其他设备，保留phone；其他参数（如MccMnc、Orientation等）配置不过滤均保留。 ### 使用实例 @@ -117,16 +113,6 @@ 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)