Skip to content

D
Docs

OpenHarmony / Docs
1 年多 前同步成功

通知 159
Star 292
Fork 28
D
Docs
提交 ac4df16f 编写于 作者: Z zt147369
浏览文件
操作

资源changlog 

Signed-off-by: Nzt147369 <zhangting201@huawei.com>
上级 8999395d
隐藏空白更改
内联 并排
Showing with 65 addition and 40 deletion
zh-cn/application-dev/reference/apis/js-apis-resource-manager.md
浏览文件 @ ac4df16f
...@@ -2059,9 +2059,9 @@ getStringSync(resId: number): string ...@@ -2059,9 +2059,9 @@ getStringSync(resId: number): string
### getStringSync<sup>10+</sup> ### getStringSync<sup>10+</sup>
getStringSync(resId: number, ...args): string getStringSync(resId: number, ...args: Array<string | number>): string
用户获取指定资源ID对应的字符串，根据args参数判断是否进行格式化，使用同步方式返回相应字符串。 用户获取指定资源ID对应的字符串，根据args参数进行格式化，使用同步方式返回相应字符串。
**系统能力**：SystemCapability.Global.ResourceManager **系统能力**：SystemCapability.Global.ResourceManager
...@@ -2070,14 +2070,13 @@ getStringSync(resId: number, ...args): string ...@@ -2070,14 +2070,13 @@ getStringSync(resId: number, ...args): string
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----- | ------ | ---- | ----- | | ----- | ------ | ---- | ----- |
| resId | number | 是 | 资源ID值 | | resId | number | 是 | 资源ID值 |
| args | ... | 否 | 格式化字符串资源参数 <br> 支持参数类型：<br /> -%d、%f、%s、%% <br> 说明：%%转译符，转译%<br>举例：%%d格式化后为%d字符串| | args | Array<string \| number> | 否 | 格式化字符串资源参数 <br> 支持参数类型：<br /> -%d、%f、%s、%% <br> 说明：%%转译符，转译%<br>举例：%%d格式化后为%d字符串|
**返回值：** **返回值：**
|前提| 类型 | 说明 | | 类型 | 说明 |
|----| ------ | ---------------------------- | | ------ | ---------------------------- |
|args不传参| string | 资源ID值对应的字符串| | string | 资源ID值对应的格式化字符串|
|args传参| string | 资源ID值对应的格式化字符串|
以下错误码的详细介绍请参见[资源管理错误码](../errorcodes/errorcode-resource-manager.md)。 以下错误码的详细介绍请参见[资源管理错误码](../errorcodes/errorcode-resource-manager.md)。
...@@ -2092,12 +2091,6 @@ getStringSync(resId: number, ...args): string ...@@ -2092,12 +2091,6 @@ getStringSync(resId: number, ...args): string
**示例：** **示例：**
```ts ```ts
try {
this.context.resourceManager.getStringSync($r('app.string.test').id);
} catch (error) {
console.error(`getStringSync failed, error code: ${error.code}, message: ${error.message}.`)
}
try { try {
this.context.resourceManager.getStringSync($r('app.string.test').id, "format string", 10, 98.78); this.context.resourceManager.getStringSync($r('app.string.test').id, "format string", 10, 98.78);
} catch (error) { } catch (error) {
...@@ -2151,9 +2144,9 @@ getStringSync(resource: Resource): string ...@@ -2151,9 +2144,9 @@ getStringSync(resource: Resource): string
### getStringSync<sup>10+</sup> ### getStringSync<sup>10+</sup>
getStringSync(resource: Resource, ...args): string getStringSync(resource: Resource, ...args: Array<string | number>): string
用户获取指定resource对象对应的字符串，根据args参数判断是否进行格式化，使用同步方式返回相应字符串。 用户获取指定resource对象对应的字符串，根据args参数进行格式化，使用同步方式返回相应字符串。
**系统能力**：SystemCapability.Global.ResourceManager **系统能力**：SystemCapability.Global.ResourceManager
...@@ -2162,14 +2155,13 @@ getStringSync(resource: Resource, ...args): string ...@@ -2162,14 +2155,13 @@ getStringSync(resource: Resource, ...args): string
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------- | ---- | ---- | | -------- | ---------------------- | ---- | ---- |
| resource | [Resource](#resource9) | 是 | 资源信息 | | resource | [Resource](#resource9) | 是 | 资源信息 |
| args | ... | 否 | 格式化字符串资源参数 <br> 支持参数类型：<br /> -%d、%f、%s、%% <br> 说明：%%转译符，转译%<br>举例：%%d格式化后为%d字符串| | args | Array<string \| number> | 否 | 格式化字符串资源参数 <br> 支持参数类型：<br /> -%d、%f、%s、%% <br> 说明：%%转译符，转译%<br>举例：%%d格式化后为%d字符串|
**返回值：** **返回值：**
|前提| 类型 | 说明 | | 类型 | 说明 |
|----| ------ | ---------------------------- | | ------ | ---------------------------- |
|args不传参| string | resource对象对应的字符串| | string | resource对象对应的格式化字符串|
|args传参| string | resource对象对应的格式化字符串|
以下错误码的详细介绍请参见[资源管理错误码](../errorcodes/errorcode-resource-manager.md)。 以下错误码的详细介绍请参见[资源管理错误码](../errorcodes/errorcode-resource-manager.md)。
...@@ -2189,12 +2181,6 @@ getStringSync(resource: Resource, ...args): string ...@@ -2189,12 +2181,6 @@ getStringSync(resource: Resource, ...args): string
moduleName: "entry", moduleName: "entry",
id: $r('app.string.test').id id: $r('app.string.test').id
}; };
try {
this.context.resourceManager.getStringSync(resource);
} catch (error) {
console.error(`getStringSync failed, error code: ${error.code}, message: ${error.message}.`)
}
try { try {
this.context.resourceManager.getStringSync(resource, "format string", 10, 98.78); this.context.resourceManager.getStringSync(resource, "format string", 10, 98.78);
} catch (error) { } catch (error) {
...@@ -2243,9 +2229,9 @@ getStringByNameSync(resName: string): string ...@@ -2243,9 +2229,9 @@ getStringByNameSync(resName: string): string
### getStringByNameSync<sup>10+</sup> ### getStringByNameSync<sup>10+</sup>
getStringByNameSync(resName: string, ...args): string getStringByNameSync(resName: string, ...args: Array<string | number>): string
用户获取指定资源名称对应的字符串，根据args参数判断是否进行格式化，使用同步方式返回相应字符串。 用户获取指定资源名称对应的字符串，根据args参数进行格式化，使用同步方式返回相应字符串。
**系统能力**：SystemCapability.Global.ResourceManager **系统能力**：SystemCapability.Global.ResourceManager
...@@ -2254,14 +2240,13 @@ getStringByNameSync(resName: string, ...args): string ...@@ -2254,14 +2240,13 @@ getStringByNameSync(resName: string, ...args): string
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | ---- | | ------- | ------ | ---- | ---- |
| resName | string | 是 | 资源名称 | | resName | string | 是 | 资源名称 |
| args | ... | 否 | 格式化字符串资源参数 <br> 支持参数类型：<br /> -%d、%f、%s、%% <br> 说明：%%转译符，转译%<br>举例：%%d格式化后为%d字符串| | args | Array<string \| number> | 否 | 格式化字符串资源参数 <br> 支持参数类型：<br /> -%d、%f、%s、%% <br> 说明：%%转译符，转译%<br>举例：%%d格式化后为%d字符串|
**返回值：** **返回值：**
|前提| 类型 | 说明 | | 类型 | 说明 |
|----| ------ | ---------------------------- | | ------ | ---------------------------- |
|args不传参| string | 资源名称对应的字符串| | string | 资源名称对应的格式化字符串|
|args传参| string | 资源名称对应的格式化字符串|
以下错误码的详细介绍请参见[资源管理错误码](../errorcodes/errorcode-resource-manager.md)。 以下错误码的详细介绍请参见[资源管理错误码](../errorcodes/errorcode-resource-manager.md)。
...@@ -2276,16 +2261,10 @@ getStringByNameSync(resName: string, ...args): string ...@@ -2276,16 +2261,10 @@ getStringByNameSync(resName: string, ...args): string
**示例：** **示例：**
```ts ```ts
try {
this.context.resourceManager.getStringByNameSync("test");
} catch (error) {
console.error(`getStringByNameSync failed, error code: ${error.code}, message: ${error.message}.`)
}
try { try {
this.context.resourceManager.getStringByNameSync("test", "format string", 10, 98.78); this.context.resourceManager.getStringByNameSync("test", "format string", 10, 98.78);
} catch (error) { } catch (error) {
console.error(`getStringSync failed, error code: ${error.code}, message: ${error.message}.`) console.error(`getStringByNameSync failed, error code: ${error.code}, message: ${error.message}.`)
} }
``` ```
......
zh-cn/release-notes/changelogs/OpenHarmony_4.0.6.2/changelogs-global.md 0 → 100755
浏览文件 @ ac4df16f
# 全球化子系统ChangeLog
## cl.resourceManager.1 getStringSync、getStringByNameSync新增接口
相较于之前的版本，在4.0.6.2 版本中，为扩展getStringSync、getStringByNameSync接口字符串匹配功能，新增了接口以及相应的错误码。
| 包名 | 新增接口 |
| --------------- | ---------------------------------------------------- |
| ohos.resourceManager.d.ts | getStringSync(resId: number, ...args: Array<string \| number>): string; |
| ohos.resourceManager.d.ts | getStringSync(resource: Resource, ...args: Array<string \| number>): string; |
| ohos.resourceManager.d.ts | getStringByNameSync(resName: string, ...args: Array<string \| number>): string; |
**变更影响**
之前只能直接获取resources中的string资源的value值，在4.0.6.2 及以上版本中可用通过参数格式化string资源的value值，扩展了格式化字符串的查询能力。
新增错误码：
9001007 根据当前id获取的资源格式化失败
9001008 根据当前名称获取的资源格式化失败
**示例代码**
以调用接口getStringSync为例，变更前只支持示例1，变更后示例1、示例2都支持。
```
示例1：
try {
this.context.resourceManager.getStringSync($r('app.string.test').id);
} catch (error) {
console.error(`getStringSync failed, error code: ${error.code}, message: ${error.message}.`)
}
示例2：
try {
this.context.resourceManager.getStringSync($r('app.string.test').id, "format string", 787, 98.78);
} catch (error) {
console.error(`getStringSync failed, error code: ${error.code}, message: ${error.message}.`)
}
```
**适配指导**
请参考接口说明：
[新增接口参考](../../../application-dev/reference/apis/js-apis-resource-manager.md)
[新增错误码参考](../../../application-dev/reference/errorcodes/errorcode-resource-manager.md)
\ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或