diff --git a/zh-cn/application-dev/dfx/hiappevent-guidelines.md b/zh-cn/application-dev/dfx/hiappevent-guidelines.md index cd5a98b3f5c220ac36cf0a0fa00eea59e3df4b2b..bb23eb28ec274be32387628b355d44894242486f 100644 --- a/zh-cn/application-dev/dfx/hiappevent-guidelines.md +++ b/zh-cn/application-dev/dfx/hiappevent-guidelines.md @@ -17,7 +17,7 @@ | write(string eventName, EventType type, object keyValues, AsyncCallback\ callback): void | void | 应用事件异步打点方法，使用callback方式作为异步回调。 | | write(string eventName, EventType type, object keyValues): Promise\ | Promise\ | 应用事件异步打点方法，使用promise方式作为异步回调。 | -当采用callback作为异步回调时，可以在callback中进行下一步处理。当采用Promise对象返回时，可以在Promise对象中类似地处理接口返回值。具体结果码说明见[事件校验结果码](hiappevent-overview.md#事件校验结果码)。 +当采用callback作为异步回调时，可以在callback中进行下一步处理。当采用Promise对象返回时，可以在Promise对象中类似地处理接口返回值。具体结果码说明见[事件校验结果码](#事件校验结果码)。 **打点配置接口功能介绍：** @@ -25,6 +25,24 @@ | ------------------------------ | ------- | ------------------------------------------------------------ | | configure(ConfigOption config) | boolean | 应用事件打点配置方法，可以对打点功能进行自定义配置。返回true表示配置成功，false表示配置失败。 | + +### 事件校验结果码 + +| 错误码 | 原因 | 校验规则 | 处理结果 | +| ------ | --------------------------- | ------------------------------------------------------------ | ----------------------------------------------------- | +| 0 | 无 | 事件校验成功 | 事件正常打点。 | +| -1 | 无效的事件名称 | 非空且长度在48个字符以内（含）。
只由以下字符组成：0-9、a-z、_。
非数字以及下划线开头。 | 忽略该事件，不执行打点。 | +| -2 | 无效的事件基本参数类型 | 事件名称参数必须为string。
事件类型参数必须为number类型。
keyValues参数必须为object类型。 | 忽略该事件，不执行打点。 | +| -99 | 应用打点功能被关闭 | 应用打点功能被关闭。 | 忽略该事件，不执行打点。 | +| -100 | 未知错误 | 无。 | 忽略该事件，不执行打点。 | +| 1 | 无效的key参数名称 | 非空且长度在16个字符以内（含）。
只由以下字符组成：0-9、a-z、_。
非数字以及下划线开头。
非下划线结尾。 | 忽略该键值对参数后，继续执行打点。 | +| 2 | 无效的key参数类型 | Key参数必须为字符串类型。 | 忽略该键值对参数后，继续执行打点。 | +| 3 | 无效的value参数类型 | value参数只支持以下类型：
boolean、number、string、Array[基本类型]。
| 忽略该键值对参数后，继续执行打点。 | +| 4 | value参数值过长 | 参数值长度必须在8*1024个字符以内（含）。 | 忽略该键值对参数后，继续执行打点。 | +| 5 | key-value参数对数过多 | key-value参数对数必须在32对以内（含）。 | 忽略后面多余的键值对参数后，继续执行打点。 | +| 6 | List类型的value参数容量过大 | List类型的value参数容量必须在100个以内（含）。 | 对List进行截断（只保留前100个元素）后，继续执行打点。 | +| 7 | 无效的List类型value参数 | List的泛型类型只能为基本类型。
List内的参数必须为同一类型。 | 忽略该键值对参数后，继续执行打点。 | + ## 开发步骤 在应用启动执行页面加载后，执行一个应用事件打点，用于记录应用的初始页面加载事件。 diff --git a/zh-cn/application-dev/dfx/hiappevent-overview.md b/zh-cn/application-dev/dfx/hiappevent-overview.md index e4965580756d232ec0edf3cc48411b90c890c2a2..8dfe1d52999e3a9f55bf111ed3bcb9378197f27c 100644 --- a/zh-cn/application-dev/dfx/hiappevent-overview.md +++ b/zh-cn/application-dev/dfx/hiappevent-overview.md @@ -6,21 +6,4 @@ HiAppEvent提供了应用事件打点接口，为应用提供事件打点的功 HiAppEvent模块支持应用事件业务的开发，提供应用事件相关的功能，主要包括应用事件落盘、查询历史应用事件数据等功能。 -**打点**：记录由用户操作引起的变化，提供业务数据信息，以供开发、产品、运维分析。 - -## 事件校验结果码 - -| 错误码 | 原因 | 校验规则 | 处理结果 | -| ------ | --------------------------- | ------------------------------------------------------------ | ----------------------------------------------------- | -| 0 | 无 | 事件校验成功 | 事件正常打点。 | -| -1 | 无效的事件名称 | 非空且长度在48个字符以内（含）。
只由以下字符组成：0-9、a-z、_。
非数字以及下划线开头。 | 忽略该事件，不执行打点。 | -| -2 | 无效的事件基本参数类型 | 事件名称参数必须为string。
事件类型参数必须为number类型。
keyValues参数必须为object类型。 | 忽略该事件，不执行打点。 | -| -99 | 应用打点功能被关闭 | 应用打点功能被关闭。 | 忽略该事件，不执行打点。 | -| -100 | 未知错误 | 无。 | 忽略该事件，不执行打点。 | -| 1 | 无效的key参数名称 | 非空且长度在16个字符以内（含）。
只由以下字符组成：0-9、a-z、_。
非数字以及下划线开头。
非下划线结尾。 | 忽略该键值对参数后，继续执行打点。 | -| 2 | 无效的key参数类型 | Key参数必须为字符串类型。 | 忽略该键值对参数后，继续执行打点。 | -| 3 | 无效的value参数类型 | value参数只支持以下类型：
boolean、number、string、Array[基本类型]。
| 忽略该键值对参数后，继续执行打点。 | -| 4 | value参数值过长 | 参数值长度必须在8*1024个字符以内（含）。 | 忽略该键值对参数后，继续执行打点。 | -| 5 | key-value参数对数过多 | key-value参数对数必须在32对以内（含）。 | 忽略后面多余的键值对参数后，继续执行打点。 | -| 6 | List类型的value参数容量过大 | List类型的value参数容量必须在100个以内（含）。 | 对List进行截断（只保留前100个元素）后，继续执行打点。 | -| 7 | 无效的List类型value参数 | List的泛型类型只能为基本类型。
List内的参数必须为同一类型。 | 忽略该键值对参数后，继续执行打点。 | \ No newline at end of file +**打点**：记录由用户操作引起的变化，提供业务数据信息，以供开发、产品、运维分析。 \ No newline at end of file diff --git a/zh-cn/application-dev/dfx/hitracemeter-overview.md b/zh-cn/application-dev/dfx/hitracemeter-overview.md index a6144101ad710c69bf7a8833580c2a4142438df0..8c7b503c7705153663ed598923bb510fc5bb6fdb 100644 --- a/zh-cn/application-dev/dfx/hitracemeter-overview.md +++ b/zh-cn/application-dev/dfx/hitracemeter-overview.md @@ -6,7 +6,7 @@ hiTraceMeter是开发者用于追踪进程轨迹，度量程序执行性能的 - **hiTraceMeter Tag** - 跟踪数据使用类别分类，称作hiTraceMeter Tag或hiTraceMeter Category，一般每个软件子系统对应一个Tag，该Tag在打点API中以类别TAg参数传入。hiTraceMeter命令行工具采集跟踪数据时，只采集给定的Tag类别选项指定的跟踪数据。 + 跟踪数据使用类别分类，称作hiTraceMeter Tag或hiTraceMeter Category，一般每个软件子系统对应一个Tag，该Tag在打点API中以类别Tag参数传入。hiTraceMeter命令行工具采集跟踪数据时，只采集给定的Tag类别选项指定的跟踪数据。 ## 运作机制 diff --git a/zh-cn/application-dev/reference/apis/Readme-CN.md b/zh-cn/application-dev/reference/apis/Readme-CN.md index bb00bb805514c965257261975a25d6630fe0ea62..858a799b0fdbe0a8010f87a45bbd743f78944fcb 100644 --- a/zh-cn/application-dev/reference/apis/Readme-CN.md +++ b/zh-cn/application-dev/reference/apis/Readme-CN.md @@ -122,10 +122,10 @@ - [@ohos.environment (目录环境能力)](js-apis-environment.md) - [@ohos.fileio (文件管理)](js-apis-fileio.md) - [@ohos.fileManager (公共文件访问与管理)](js-apis-filemanager.md) + - [@ohos.securityLabel (数据标签)](js-apis-securityLabel.md) - [@ohos.statfs (statfs)](js-apis-statfs.md) - [@ohos.storageStatistics (应用空间统计)](js-apis-storage-statistics.md) - [@ohos.volumeManager (卷管理)](js-apis-volumemanager.md) - - [@ohos.securityLabel (数据标签)](js-apis-securityLabel.md) - 电话服务 - [@ohos.contact (联系人)](js-apis-contact.md) diff --git a/zh-cn/application-dev/reference/apis/js-apis-document.md b/zh-cn/application-dev/reference/apis/js-apis-document.md index 4218d25e7491b2fb60659416f0dd91648b8aa6bc..01d6e24a1c50a71f3e42bdf383315a6fc48e43d6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-document.md +++ b/zh-cn/application-dev/reference/apis/js-apis-document.md @@ -1,8 +1,8 @@ # 文件交互 > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -- 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 -- 本模块接口后续将废弃。不建议在OpenHarmony使用以下接口，调用以下接口将抛出异常。 +> - 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +> - 本模块接口后续将废弃。不建议在OpenHarmony使用以下接口，调用以下接口将抛出异常。 ## 导入模块 diff --git a/zh-cn/application-dev/reference/apis/js-apis-fileio.md b/zh-cn/application-dev/reference/apis/js-apis-fileio.md index f04103f1e8b72a2e166db480680504996b57963a..fc4205ce6cf0407ba851aceff378213e2abf89f6 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-fileio.md +++ b/zh-cn/application-dev/reference/apis/js-apis-fileio.md @@ -14,11 +14,11 @@ import fileio from '@ohos.fileio'; ## 使用说明 -使用该功能模块对文件/目录进行操作前，需要先获取其绝对路径，获取方式及其接口用法请参考：[Context模块的接口getOrCreateLocalDir](js-apis-Context.md)。 +使用该功能模块对文件/目录进行操作前，需要先获取其应用沙箱路径，获取方式及其接口用法请参考：[Context模块的接口getOrCreateLocalDir](js-apis-Context.md)。 -“文件/目录绝对路径”=“应用目录路径”+“文件/目录名” +“文件/目录应用沙箱路径”=“应用目录路径”+“文件/目录名” -通过上述接口获取到应用目录路径dir，文件名为“xxx.txt”，文件所在绝对路径为： +通过上述接口获取到应用目录路径dir，文件名为“xxx.txt”，文件所在应用沙箱路径为： ```js let path = dir + "/xxx.txt"; @@ -43,9 +43,9 @@ stat(path: string): Promise<Stat> **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ----------- | - | path | string | 是 | 待获取文件的绝对路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------- | +| path | string | 是 | 待获取文件的应用沙箱路径。 | **返回值：** @@ -72,10 +72,10 @@ stat(path:string, callback:AsyncCallback<Stat>): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ---------------------------------- | ---- | --------------- | - | path | string | 是 | 待获取文件的绝对路径。 | - | callback | AsyncCallback<[Stat](#stat)> | 是 | 异步获取文件的信息之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ---------------------------------- | ---- | ------------------------------ | +| path | string | 是 | 待获取文件的应用沙箱路径。 | +| callback | AsyncCallback<[Stat](#stat)> | 是 | 异步获取文件的信息之后的回调。 | **示例：** ```js @@ -94,9 +94,9 @@ statSync(path:string): Stat **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ----------- | - | path | string | 是 | 待获取文件的绝对路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------- | +| path | string | 是 | 待获取文件的应用沙箱路径。 | **返回值：** @@ -120,9 +120,9 @@ opendir(path: string): Promise<Dir> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ------------- | - | path | string | 是 | 待打开文件目录的绝对路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------ | +| path | string | 是 | 待打开文件目录的应用沙箱路径。 | **返回值：** | 类型 | 说明 | @@ -149,10 +149,10 @@ opendir(path: string, callback: AsyncCallback<Dir>): void **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | -------------------------------- | ---- | -------------- | - | path | string | 是 | 待打开文件目录的绝对路径。 | - | callback | AsyncCallback<[Dir](#dir)> | 是 | 异步打开文件目录之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | -------------------------------- | ---- | ------------------------------ | +| path | string | 是 | 待打开文件目录的应用沙箱路径。 | +| callback | AsyncCallback<[Dir](#dir)> | 是 | 异步打开文件目录之后的回调。 | **示例：** ```js @@ -174,9 +174,9 @@ opendirSync(path: string): Dir **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ------------- | - | path | string | 是 | 待打开文件目录的绝对路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------ | +| path | string | 是 | 待打开文件目录的应用沙箱路径。 | **返回值：** | 类型 | 说明 | @@ -201,10 +201,10 @@ access(path: string, mode?: number): Promise<void> **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ---------------------------------------- | - | path | string | 是 | 待访问文件的绝对路径。 | - | mode | number | 否 | 访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。
确认当前进程是否具有对应权限：
- 0：确认文件是否存在。
- 1：确认当前进程是否具有可执行权限。
- 2：确认当前进程是否具有写权限。
- 4：确认当前进程是否具有读权限。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待访问文件的应用沙箱路径。 | +| mode | number | 否 | 访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。
确认当前进程是否具有对应权限：
- 0：确认文件是否存在。
- 1：确认当前进程是否具有可执行权限。
- 2：确认当前进程是否具有写权限。
- 4：确认当前进程是否具有读权限。 | **返回值：** | 类型 | 说明 | @@ -230,11 +230,11 @@ access(path: string, mode: number, callback: AsyncCallback<void>): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ---------------------------------------- | - | path | string | 是 | 待访问文件的绝对路径。 | - | mode | number | 否 | 访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。
确认当前进程是否具有对应权限：
- 0：确认文件是否存在。
- 1：确认当前进程是否具有可执行权限。
- 2：确认当前进程是否具有写权限。
- 4：确认当前进程是否具有读权限。 | - | callback | AsyncCallback<void> | 是 | 异步检查当前进程是否可访问某文件之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待访问文件的应用沙箱路径。 | +| mode | number | 否 | 访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。
确认当前进程是否具有对应权限：
- 0：确认文件是否存在。
- 1：确认当前进程是否具有可执行权限。
- 2：确认当前进程是否具有写权限。
- 4：确认当前进程是否具有读权限。 | +| callback | AsyncCallback<void> | 是 | 异步检查当前进程是否可访问某文件之后的回调。 | **示例：** ```js @@ -253,10 +253,10 @@ accessSync(path: string, mode?: number): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ---------------------------------------- | - | path | string | 是 | 待访问文件的绝对路径。 | - | mode | number | 否 | 访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。
确认当前进程是否具有对应权限：
- 0：确认文件是否存在。
- 1：确认当前进程是否具有可执行权限。
- 2：确认当前进程是否具有写权限。
- 4：确认当前进程是否具有读权限。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待访问文件的应用沙箱路径。 | +| mode | number | 否 | 访问文件时的选项，可给定如下选项，以按位或的方式使用多个选项，默认给定0。
确认当前进程是否具有对应权限：
- 0：确认文件是否存在。
- 1：确认当前进程是否具有可执行权限。
- 2：确认当前进程是否具有写权限。
- 4：确认当前进程是否具有读权限。 | **示例：** ```js @@ -467,10 +467,10 @@ mkdir(path:string, mode?: number): Promise<void> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ---------------------------------------- | - | path | string | 是 | 待创建目录的绝对路径。 | - | mode | number | 否 | 创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。
- 0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待创建目录的应用沙箱路径。 | +| mode | number | 否 | 创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。
- 0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | **返回值：** | 类型 | 说明 | @@ -496,11 +496,11 @@ mkdir(path: string, mode: number, callback: AsyncCallback<void>): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ---------------------------------------- | - | path | string | 是 | 待创建目录的绝对路径。 | - | mode | number | 否 | 创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。
- 0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | - | callback | AsyncCallback<void> | 是 | 异步创建目录操作完成之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待创建目录的应用沙箱路径。 | +| mode | number | 否 | 创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。
- 0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | +| callback | AsyncCallback<void> | 是 | 异步创建目录操作完成之后的回调。 | **示例：** ```js @@ -519,10 +519,10 @@ mkdirSync(path: string, mode?: number): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ---------------------------------------- | - | path | string | 是 | 待创建目录的绝对路径。 | - | mode | number | 否 | 创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。
- 0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待创建目录的应用沙箱路径。 | +| mode | number | 否 | 创建目录的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o775。
- 0o775：所有者具有读、写及可执行权限，其余用户具有读及可执行权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | **示例：** ```js @@ -539,11 +539,11 @@ open(path: string, flags?: number, mode?: number): Promise<number> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ----- | ------ | ---- | ---------------------------------------- | - | path | string | 是 | 待打开文件的绝对路径。 | - | flags | number | 否 | 打开文件的选项，必须指定如下选项中的一个，默认以只读方式打开：
- 0o0：只读打开。
- 0o1：只写打开。
- 0o2：读写打开。
同时，也可给定如下选项，以按位或的方式追加，默认不给定任何额外选项：
- 0o100：若文件不存在，则创建文件。使用该选项时必须指定第三个参数 mode。
- 0o200：如果追加了0o100选项，且文件已经存在，则出错。
- 0o1000：如果文件存在且以只写或读写的方式打开文件，则将其长度裁剪为零。
- 0o2000：以追加方式打开，后续写将追加到文件末尾。
- 0o4000：如果path指向FIFO、块特殊文件或字符特殊文件，则本次打开及后续 IO 进行非阻塞操作。
- 0o200000：如果path指向目录，则出错。
- 0o400000：如果path指向符号链接，则出错。
- 0o4010000：以同步IO的方式打开文件。 | - | mode | number | 否 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。
- 0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待打开文件的应用沙箱路径。 | +| flags | number | 否 | 打开文件的选项，必须指定如下选项中的一个，默认以只读方式打开：
- 0o0：只读打开。
- 0o1：只写打开。
- 0o2：读写打开。
同时，也可给定如下选项，以按位或的方式追加，默认不给定任何额外选项：
- 0o100：若文件不存在，则创建文件。使用该选项时必须指定第三个参数 mode。
- 0o200：如果追加了0o100选项，且文件已经存在，则出错。
- 0o1000：如果文件存在且以只写或读写的方式打开文件，则将其长度裁剪为零。
- 0o2000：以追加方式打开，后续写将追加到文件末尾。
- 0o4000：如果path指向FIFO、块特殊文件或字符特殊文件，则本次打开及后续 IO 进行非阻塞操作。
- 0o200000：如果path指向目录，则出错。
- 0o400000：如果path指向符号链接，则出错。
- 0o4010000：以同步IO的方式打开文件。 | +| mode | number | 否 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。
- 0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | **返回值：** | 类型 | 说明 | @@ -569,12 +569,12 @@ open(path: string, flags: number, mode: number, callback: AsyncCallback<numbe **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------------- | ---- | ---------------------------------------- | - | path | string | 是 | 待打开文件的绝对路径。 | - | flags | number | 是 | 打开文件的选项，必须指定如下选项中的一个，默认以只读方式打开：
- 0o0：只读打开。
- 0o1：只写打开。
- 0o2：读写打开。
同时，也可给定如下选项，以按位或的方式追加，默认不给定任何额外选项：
- 0o100：若文件不存在，则创建文件。使用该选项时必须指定第三个参数 mode。
- 0o200：如果追加了0o100选项，且文件已经存在，则出错。
- 0o1000：如果文件存在且以只写或读写的方式打开文件，则将其长度裁剪为零。
- 0o2000：以追加方式打开，后续写将追加到文件末尾。
- 0o4000：如果path指向FIFO、块特殊文件或字符特殊文件，则本次打开及后续 IO 进行非阻塞操作。
- 0o200000：如果path指向目录，则出错。
- 0o400000：如果path指向符号链接，则出错。
- 0o4010000：以同步IO的方式打开文件。 | - | mode | number | 是 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。
- 0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | - | callback | AsyncCallback <void> | 是 | 异步打开文件之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------------- | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待打开文件的应用沙箱路径。 | +| flags | number | 是 | 打开文件的选项，必须指定如下选项中的一个，默认以只读方式打开：
- 0o0：只读打开。
- 0o1：只写打开。
- 0o2：读写打开。
同时，也可给定如下选项，以按位或的方式追加，默认不给定任何额外选项：
- 0o100：若文件不存在，则创建文件。使用该选项时必须指定第三个参数 mode。
- 0o200：如果追加了0o100选项，且文件已经存在，则出错。
- 0o1000：如果文件存在且以只写或读写的方式打开文件，则将其长度裁剪为零。
- 0o2000：以追加方式打开，后续写将追加到文件末尾。
- 0o4000：如果path指向FIFO、块特殊文件或字符特殊文件，则本次打开及后续 IO 进行非阻塞操作。
- 0o200000：如果path指向目录，则出错。
- 0o400000：如果path指向符号链接，则出错。
- 0o4010000：以同步IO的方式打开文件。 | +| mode | number | 是 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。
- 0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | +| callback | AsyncCallback <void> | 是 | 异步打开文件之后的回调。 | **示例：** ```js @@ -593,11 +593,11 @@ openSync(path:string, flags?:number, mode?:number): number **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ----- | ------ | ---- | ---------------------------------------- | - | path | string | 是 | 待打开文件的绝对路径。 | - | flags | number | 否 | 打开文件的选项，必须指定如下选项中的一个，默认以只读方式打开：
- 0o0：只读打开。
- 0o1：只写打开。
- 0o2：读写打开。
同时，也可给定如下选项，以按位或的方式追加，默认不给定任何额外选项：
- 0o100：若文件不存在，则创建文件。使用该选项时必须指定第三个参数 mode。
- 0o200：如果追加了0o100选项，且文件已经存在，则出错。
- 0o1000：如果文件存在且以只写或读写的方式打开文件，则将其长度裁剪为零。
- 0o2000：以追加方式打开，后续写将追加到文件末尾。
- 0o4000：如果path指向FIFO、块特殊文件或字符特殊文件，则本次打开及后续 IO 进行非阻塞操作。
- 0o200000：如果path指向目录，则出错。
- 0o400000：如果path指向符号链接，则出错。
- 0o4010000：以同步IO的方式打开文件。 | - | mode | number | 否 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。
- 0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。
创建出的文件权限受umask影响，umask随进程启动确定，其修改当前不开放。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待打开文件的应用沙箱路径。 | +| flags | number | 否 | 打开文件的选项，必须指定如下选项中的一个，默认以只读方式打开：
- 0o0：只读打开。
- 0o1：只写打开。
- 0o2：读写打开。
同时，也可给定如下选项，以按位或的方式追加，默认不给定任何额外选项：
- 0o100：若文件不存在，则创建文件。使用该选项时必须指定第三个参数 mode。
- 0o200：如果追加了0o100选项，且文件已经存在，则出错。
- 0o1000：如果文件存在且以只写或读写的方式打开文件，则将其长度裁剪为零。
- 0o2000：以追加方式打开，后续写将追加到文件末尾。
- 0o4000：如果path指向FIFO、块特殊文件或字符特殊文件，则本次打开及后续 IO 进行非阻塞操作。
- 0o200000：如果path指向目录，则出错。
- 0o400000：如果path指向符号链接，则出错。
- 0o4010000：以同步IO的方式打开文件。 | +| mode | number | 否 | 若创建文件，则指定文件的权限，可给定如下权限，以按位或的方式追加权限，默认给定0o666。
- 0o666：所有者具有读、写权限，所有用户组具有读、写权限，其余用户具有读、写权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。
创建出的文件权限受umask影响，umask随进程启动确定，其修改当前不开放。 | **返回值：** | 类型 | 说明 | @@ -722,9 +722,9 @@ rmdir(path: string): Promise<void> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ----------- | - | path | string | 是 | 待删除目录的绝对路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------- | +| path | string | 是 | 待删除目录的应用沙箱路径。 | **返回值：** | 类型 | 说明 | @@ -750,10 +750,10 @@ rmdir(path: string, callback:AsyncCallback<void>): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ------------ | - | path | string | 是 | 待删除目录的绝对路径。 | - | callback | AsyncCallback<void> | 是 | 异步删除目录之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | -------------------------- | +| path | string | 是 | 待删除目录的应用沙箱路径。 | +| callback | AsyncCallback<void> | 是 | 异步删除目录之后的回调。 | **示例：** ```js @@ -773,9 +773,9 @@ rmdirSync(path: string): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ----------- | - | path | string | 是 | 待删除目录的绝对路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------- | +| path | string | 是 | 待删除目录的应用沙箱路径。 | **示例：** ```js @@ -792,9 +792,9 @@ unlink(path:string): Promise<void> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ----------- | - | path | string | 是 | 待删除文件的绝对路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------- | +| path | string | 是 | 待删除文件的应用沙箱路径。 | **返回值：** | 类型 | 说明 | @@ -820,10 +820,10 @@ unlink(path:string, callback:AsyncCallback<void>): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ------------ | - | path | string | 是 | 待删除文件的绝对路径。 | - | callback | AsyncCallback<void> | 是 | 异步删除文件之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | -------------------------- | +| path | string | 是 | 待删除文件的应用沙箱路径。 | +| callback | AsyncCallback<void> | 是 | 异步删除文件之后的回调。 | **示例：** ```js @@ -842,9 +842,9 @@ unlinkSync(path: string): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ----------- | - | path | string | 是 | 待删除文件的绝对路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------- | +| path | string | 是 | 待删除文件的应用沙箱路径。 | **示例：** ```js @@ -961,10 +961,10 @@ hash(path: string, algorithm: string): Promise<string> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | --------- | ------ | ---- | ---------------------------------------- | - | path | string | 是 | 待计算哈希值文件的绝对路径。 | - | algorithm | string | 是 | 哈希计算采用的算法。可选 "md5"、"sha1" 或 "sha256"。建议采用安全强度更高的 "sha256"。 | +| 参数名 | 类型 | 必填 | 说明 | +| --------- | ------ | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待计算哈希值文件的应用沙箱路径。 | +| algorithm | string | 是 | 哈希计算采用的算法。可选 "md5"、"sha1" 或 "sha256"。建议采用安全强度更高的 "sha256"。 | **返回值：** | 类型 | 说明 | @@ -990,11 +990,11 @@ hash(path: string, algorithm: string, callback: AsyncCallback<string>): vo **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | --------- | --------------------------- | ---- | ---------------------------------------- | - | path | string | 是 | 待计算哈希值文件的绝对路径。 | - | algorithm | string | 是 | 哈希计算采用的算法。可选 "md5"、"sha1" 或 "sha256"。建议采用安全强度更高的 "sha256"。 | - | callback | AsyncCallback<string> | 是 | 异步计算文件哈希操之后的回调函数（其中给定文件哈希值表示为十六进制数字串，所有字母均大写）。 | +| 参数名 | 类型 | 必填 | 说明 | +| --------- | --------------------------- | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待计算哈希值文件的应用沙箱路径。 | +| algorithm | string | 是 | 哈希计算采用的算法。可选 "md5"、"sha1" 或 "sha256"。建议采用安全强度更高的 "sha256"。 | +| callback | AsyncCallback<string> | 是 | 异步计算文件哈希操之后的回调函数（其中给定文件哈希值表示为十六进制数字串，所有字母均大写）。 | **示例：** ```js @@ -1015,10 +1015,10 @@ chmod(path: string, mode: number):Promise<void> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ---------------------------------------- | - | path | string | 是 | 待改变文件权限的绝对路径。 | - | mode | number | 是 | 改变文件权限，可给定如下权限，以按位或的方式追加权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待改变文件权限的应用沙箱路径。 | +| mode | number | 是 | 改变文件权限，可给定如下权限，以按位或的方式追加权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | **返回值：** | 类型 | 说明 | @@ -1044,11 +1044,11 @@ chmod(path: string, mode: number, callback: AsyncCallback<void>): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ---------------------------------------- | - | path | string | 是 | 待改变文件权限的绝对路径。 | - | mode | number | 是 | 改变文件权限，可给定如下权限，以按位或的方式追加权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | - | callback | AsyncCallback<void> | 是 | 异步改变文件权限之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待改变文件权限的应用沙箱路径。 | +| mode | number | 是 | 改变文件权限，可给定如下权限，以按位或的方式追加权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | +| callback | AsyncCallback<void> | 是 | 异步改变文件权限之后的回调。 | **示例：** ```js @@ -1067,10 +1067,10 @@ chmodSync(path: string, mode: number): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ---------------------------------------- | - | path | string | 是 | 待改变文件权限的绝对路径。 | - | mode | number | 是 | 改变文件权限，可给定如下权限，以按位或的方式追加权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待改变文件权限的应用沙箱路径。 | +| mode | number | 是 | 改变文件权限，可给定如下权限，以按位或的方式追加权限。
- 0o700：所有者具有读、写及可执行权限。
- 0o400：所有者具有读权限。
- 0o200：所有者具有写权限。
- 0o100：所有者具有可执行权限。
- 0o070：所有用户组具有读、写及可执行权限。
- 0o040：所有用户组具有读权限。
- 0o020：所有用户组具有写权限。
- 0o010：所有用户组具有可执行权限。
- 0o007：其余用户具有读、写及可执行权限。
- 0o004：其余用户具有读权限。
- 0o002：其余用户具有写权限。
- 0o001：其余用户具有可执行权限。 | **示例：** ```js @@ -1236,10 +1236,10 @@ truncate(path: string, len?: number): Promise<void> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ---------------- | - | path | string | 是 | 待截断文件的绝对路径。 | - | len | number | 是 | 文件截断后的长度，以字节为单位。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------------- | +| path | string | 是 | 待截断文件的应用沙箱路径。 | +| len | number | 是 | 文件截断后的长度，以字节为单位。 | **返回值：** | 类型 | 说明 | @@ -1265,11 +1265,11 @@ truncate(path: string, len: number, callback:AsyncCallback<void>): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ---------------- | - | path | string | 是 | 待截断文件的绝对路径。 | - | len | number | 是 | 文件截断后的长度，以字节为单位。 | - | callback | AsyncCallback<void> | 是 | 异步截断文件的信息之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | -------------------------------- | +| path | string | 是 | 待截断文件的应用沙箱路径。 | +| len | number | 是 | 文件截断后的长度，以字节为单位。 | +| callback | AsyncCallback<void> | 是 | 异步截断文件的信息之后的回调。 | **示例：** ```js @@ -1288,10 +1288,10 @@ truncateSync(path: string, len?: number): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ---------------- | - | path | string | 是 | 待截断文件的绝对路径。 | - | len | number | 否 | 文件截断后的长度，以字节为单位。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------------- | +| path | string | 是 | 待截断文件的应用沙箱路径。 | +| len | number | 否 | 文件截断后的长度，以字节为单位。 | **示例：** ```js @@ -1312,10 +1312,10 @@ readText(filePath: string, options?: { **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------ | ---- | ---------------------------------------- | - | filePath | string | 是 | 待读取文件的绝对路径。 | - | options | Object | 否 | 支持如下选项：
- position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。
- length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。
- encoding，string类型，当数据是 string 类型时有效，表示数据的编码方式，默认 'utf-8'，仅支持 'utf-8'。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------ | ---- | ------------------------------------------------------------ | +| filePath | string | 是 | 待读取文件的应用沙箱路径。 | +| options | Object | 否 | 支持如下选项：
- position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。
- length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。
- encoding，string类型，当数据是 string 类型时有效，表示数据的编码方式，默认 'utf-8'，仅支持 'utf-8'。 | **返回值：** | 类型 | 说明 | @@ -1345,11 +1345,11 @@ readText(filePath: string, options: { **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | --------------------------- | ---- | ---------------------------------------- | - | filePath | string | 是 | 待读取文件的绝对路径。 | - | options | Object | 否 | 支持如下选项：
- position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。
- length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。
- encoding，string类型，当数据是 string 类型时有效，表示数据的编码方式，默认 'utf-8'，仅支持 'utf-8'。 | - | callback | AsyncCallback<string> | 是 | 异步通过文本方式读取文件之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------- | ---- | ------------------------------------------------------------ | +| filePath | string | 是 | 待读取文件的应用沙箱路径。 | +| options | Object | 否 | 支持如下选项：
- position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。
- length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。
- encoding，string类型，当数据是 string 类型时有效，表示数据的编码方式，默认 'utf-8'，仅支持 'utf-8'。 | +| callback | AsyncCallback<string> | 是 | 异步通过文本方式读取文件之后的回调。 | **示例：** ```js @@ -1372,10 +1372,10 @@ readTextSync(filePath: string, options?: { **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------ | ---- | ---------------------------------------- | - | filePath | string | 是 | 待读取文件的绝对路径。 | - | options | Object | 否 | 支持如下选项：
- position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。
- length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。
- encoding，string类型，当数据是 string 类型时有效，表示数据的编码方式，默认 'utf-8'，仅支持 'utf-8'。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------ | ---- | ------------------------------------------------------------ | +| filePath | string | 是 | 待读取文件的应用沙箱路径。 | +| options | Object | 否 | 支持如下选项：
- position，number类型，表示期望读取文件的位置。可选，默认从当前位置开始读取。
- length，number类型，表示期望读取数据的长度。可选，默认缓冲区长度减去偏移长度。
- encoding，string类型，当数据是 string 类型时有效，表示数据的编码方式，默认 'utf-8'，仅支持 'utf-8'。 | **返回值：** | 类型 | 说明 | @@ -1397,9 +1397,9 @@ lstat(path: string): Promise<Stat> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ----------------- | - | path | string | 是 | 目标文件的绝对路径，指向链接状态。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------------------- | +| path | string | 是 | 目标文件的应用沙箱路径，指向链接状态。 | **返回值：** | 类型 | 说明 | @@ -1425,10 +1425,10 @@ lstat(path:string, callback:AsyncCallback<Stat>): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ---------------------------------- | ---- | ----------------- | - | path | string | 是 | 目标文件的绝对路径，指向链接状态。 | - | callback | AsyncCallback<[Stat](#stat)> | 是 | 异步获取链接状态信息之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ---------------------------------- | ---- | -------------------------------------- | +| path | string | 是 | 目标文件的应用沙箱路径，指向链接状态。 | +| callback | AsyncCallback<[Stat](#stat)> | 是 | 异步获取链接状态信息之后的回调。 | **示例：** ```js @@ -1447,9 +1447,9 @@ lstatSync(path:string): Stat **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ----------------- | - | path | string | 是 | 目标文件的绝对路径，指向链接状态。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------------------- | +| path | string | 是 | 目标文件的应用沙箱路径，指向链接状态。 | **返回值：** | 类型 | 说明 | @@ -1536,10 +1536,10 @@ rename(oldPath: string, newPath: string): Promise<void> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------- | ------ | ---- | ------------------------ | - | oldPath | string | 是 | 目标文件的当前绝对路径。 | - | newPath | String | 是 | 目标文件的新绝对路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ---------------------------- | +| oldPath | string | 是 | 目标文件的当前应用沙箱路径。 | +| newPath | String | 是 | 目标文件的新应用沙箱路径。 | **返回值：** | 类型 | 说明 | @@ -1565,11 +1565,11 @@ rename(oldPath: string, newPath: string, callback: AsyncCallback<void>): v **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ------------- | - | oldPath | string | 是 | 目标文件的当前绝对路径。 | - | newPath | String | 是 | 目标文件的新绝对路径。 | - | Callback | AsyncCallback<void> | 是 | 异步重命名文件之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ---------------------------- | +| oldPath | string | 是 | 目标文件的当前应用沙箱路径。 | +| newPath | String | 是 | 目标文件的新应用沙箱路径。 | +| Callback | AsyncCallback<void> | 是 | 异步重命名文件之后的回调。 | **示例：** ```js @@ -1587,10 +1587,10 @@ renameSync(oldPath: string, newPath: string): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------- | ------ | ---- | ------------ | - | oldPath | string | 是 | 目标文件的当前绝对路径。 | - | newPath | String | 是 | 目标文件的新绝对路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ---------------------------- | +| oldPath | string | 是 | 目标文件的当前应用沙箱路径。 | +| newPath | String | 是 | 目标文件的新应用沙箱路径。 | **示例：** ```js @@ -1745,10 +1745,10 @@ symlink(target: string, srcPath: string): Promise<void> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------- | ------ | ---- | ------------ | - | target | string | 是 | 目标文件的绝对路径。 | - | srcPath | string | 是 | 符号链接文件的绝对路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ---------------------------- | +| target | string | 是 | 目标文件的应用沙箱路径。 | +| srcPath | string | 是 | 符号链接文件的应用沙箱路径。 | **返回值：** | 类型 | 说明 | @@ -1774,11 +1774,11 @@ symlink(target: string, srcPath: string, callback: AsyncCallback<void>): v **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | ---------------- | - | target | string | 是 | 目标文件的绝对路径。 | - | srcPath | string | 是 | 符号链接文件的绝对路径。 | - | callback | AsyncCallback<void> | 是 | 异步创建符号链接信息之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | -------------------------------- | +| target | string | 是 | 目标文件的应用沙箱路径。 | +| srcPath | string | 是 | 符号链接文件的应用沙箱路径。 | +| callback | AsyncCallback<void> | 是 | 异步创建符号链接信息之后的回调。 | **示例：** ```js @@ -1797,10 +1797,10 @@ symlinkSync(target: string, srcPath: string): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ------- | ------ | ---- | ------------ | - | target | string | 是 | 目标文件的绝对路径。 | - | srcPath | string | 是 | 符号链接文件的绝对路径。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ---------------------------- | +| target | string | 是 | 目标文件的应用沙箱路径。 | +| srcPath | string | 是 | 符号链接文件的应用沙箱路径。 | **示例：** ```js @@ -1817,11 +1817,11 @@ chown(path: string, uid: number, gid: number): Promise<void> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | --------------- | - | path | string | 是 | 待改变文件的绝对路径。 | - | uid | number | 是 | 新的UID（UserID）。 | - | gid | number | 是 | 新的GID（GroupID）。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------- | +| path | string | 是 | 待改变文件的应用沙箱路径。 | +| uid | number | 是 | 新的UID（UserID）。 | +| gid | number | 是 | 新的GID（GroupID）。 | **返回值：** | 类型 | 说明 | @@ -1848,12 +1848,12 @@ chown(path: string, uid: number, gid: number, callback: AsyncCallback<void> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | --------------- | - | path | string | 是 | 待改变文件的绝对路径。 | - | uid | number | 是 | 新的UID。 | - | gid | number | 是 | 新的GID。 | - | callback | AsyncCallback<void> | 是 | 异步改变文件所有者之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ------------------------------ | +| path | string | 是 | 待改变文件的应用沙箱路径。 | +| uid | number | 是 | 新的UID。 | +| gid | number | 是 | 新的GID。 | +| callback | AsyncCallback<void> | 是 | 异步改变文件所有者之后的回调。 | **示例：** ```js @@ -1873,11 +1873,11 @@ chownSync(path: string, uid: number, gid: number): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ----------- | - | path | string | 是 | 待改变文件的绝对路径。 | - | uid | number | 是 | 新的UID。 | - | gid | number | 是 | 新的GID。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------- | +| path | string | 是 | 待改变文件的应用沙箱路径。 | +| uid | number | 是 | 新的UID。 | +| gid | number | 是 | 新的GID。 | **示例：** ```js @@ -2041,10 +2041,10 @@ createStream(path: string, mode: string): Promise<Stream> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ---------------------------------------- | - | path | string | 是 | 待打开文件的绝对路径。 | - | mode | string | 是 | - r：打开只读文件，该文件必须存在。
- r+：打开可读写的文件，该文件必须存在。
- w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。
- w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。
- a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。
- a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待打开文件的应用沙箱路径。 | +| mode | string | 是 | - r：打开只读文件，该文件必须存在。
- r+：打开可读写的文件，该文件必须存在。
- w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。
- w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。
- a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。
- a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 | **返回值：** | 类型 | 说明 | @@ -2070,11 +2070,11 @@ createStream(path: string, mode: string, callback: AsyncCallback<Stream>): **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | --------------------------------------- | ---- | ---------------------------------------- | - | path | string | 是 | 待打开文件的绝对路径。 | - | mode | string | 是 | - r：打开只读文件，该文件必须存在。
- r+：打开可读写的文件，该文件必须存在。
- w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。
- w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。
- a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。
- a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 | - | callback | AsyncCallback<[Stream](#stream7)> | 是 | 异步打开文件流之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------------------- | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待打开文件的应用沙箱路径。 | +| mode | string | 是 | - r：打开只读文件，该文件必须存在。
- r+：打开可读写的文件，该文件必须存在。
- w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。
- w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。
- a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。
- a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 | +| callback | AsyncCallback<[Stream](#stream7)> | 是 | 异步打开文件流之后的回调。 | **示例：** ```js @@ -2093,10 +2093,10 @@ createStreamSync(path: string, mode: string): Stream **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ---------------------------------------- | - | path | string | 是 | 待打开文件的绝对路径。 | - | mode | string | 是 | - r：打开只读文件，该文件必须存在。
- r+：打开可读写的文件，该文件必须存在。
- w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。
- w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。
- a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。
- a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| path | string | 是 | 待打开文件的应用沙箱路径。 | +| mode | string | 是 | - r：打开只读文件，该文件必须存在。
- r+：打开可读写的文件，该文件必须存在。
- w：打开只写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。
- w+：打开可读写文件，若文件存在则文件长度清0，即该文件内容会消失。若文件不存在则建立该文件。
- a：以附加的方式打开只写文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾，即文件原先的内容会被保留。
- a+：以附加方式打开可读写的文件。若文件不存在，则会建立该文件，如果文件存在，写入的数据会被加到文件尾后，即文件原先的内容会被保留。 | **返回值：** | 类型 | 说明 | @@ -2273,11 +2273,11 @@ lchown(path: string, uid: number, gid: number): Promise<void> **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ----------- | - | path | string | 是 | 待打开文件的绝对路径。 | - | uid | number | 是 | 新的UID。 | - | gid | number | 是 | 新的GID。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------- | +| path | string | 是 | 待打开文件的应用沙箱路径。 | +| uid | number | 是 | 新的UID。 | +| gid | number | 是 | 新的GID。 | **返回值：** | 类型 | 说明 | @@ -2304,12 +2304,12 @@ lchown(path: string, uid: number, gid: number, callback: AsyncCallback<void&g **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | ------------------------- | ---- | --------------- | - | path | string | 是 | 待打开文件的绝对路径。 | - | uid | number | 是 | 新的UID。 | - | gid | number | 是 | 新的GID。 | - | callback | AsyncCallback<void> | 是 | 异步改变文件所有者之后的回调。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------------------------- | ---- | ------------------------------ | +| path | string | 是 | 待打开文件的应用沙箱路径。 | +| uid | number | 是 | 新的UID。 | +| gid | number | 是 | 新的GID。 | +| callback | AsyncCallback<void> | 是 | 异步改变文件所有者之后的回调。 | **示例：** ```js @@ -2329,11 +2329,11 @@ lchownSync(path: string, uid: number, gid: number): void **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | ---- | ------ | ---- | ----------- | - | path | string | 是 | 待打开文件的绝对路径。 | - | uid | number | 是 | 新的UID。 | - | gid | number | 是 | 新的GID。 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------- | +| path | string | 是 | 待打开文件的应用沙箱路径。 | +| uid | number | 是 | 新的UID。 | +| gid | number | 是 | 新的GID。 | **示例：** ```js @@ -2351,11 +2351,11 @@ createWatcher(filename: string, events: number, callback: AsyncCallback<numbe **系统能力**：SystemCapability.FileManagement.File.FileIO **参数：** - | 参数名 | 类型 | 必填 | 说明 | - | -------- | --------------------------------- | ---- | ---------------------------------------- | - | filename | string | 是 | 待监视文件的绝对路径。 | - | events | Number | 是 | - 1: 监听文件或者目录是否发生重命名。
- 2：监听文件或者目录内容的是否修改。
- 3：两者都有。 | - | callback | AsyncCallback<number > | 是 | 每发生变化一次，调用一次此函数。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | --------------------------------- | ---- | ------------------------------------------------------------ | +| filename | string | 是 | 待监视文件的应用沙箱路径。 | +| events | Number | 是 | - 1: 监听文件或者目录是否发生重命名。
- 2：监听文件或者目录内容的是否修改。
- 3：两者都有。 | +| callback | AsyncCallback<number > | 是 | 每发生变化一次，调用一次此函数。 | **返回值：** | 类型 | 说明 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-image.md b/zh-cn/application-dev/reference/apis/js-apis-image.md index 363e126481d843771b3fd269e27b85946450ba3a..10b7f03f511b1fae3193ed77058e07a7005b30d2 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-image.md +++ b/zh-cn/application-dev/reference/apis/js-apis-image.md @@ -470,7 +470,7 @@ createImageSource(uri: string): ImageSource | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ---------------------------------- | -| uri | string | 是 | 图片路径，当前仅支持本地绝对路径。 | +| uri | string | 是 | 图片路径，当前仅支持应用沙箱路径。 | **返回值：** @@ -481,7 +481,8 @@ createImageSource(uri: string): ImageSource **示例：** ```js -const imageSourceApi = image.createImageSource('/data/local/tmp/test.jpg') +let path = this.context.getApplicationContext().fileDirs + "test.jpg"; +const imageSourceApi = image.createImageSource(path); ``` ## image.createImageSource7+ diff --git a/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md b/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md index 991a9d453da10152a276ee47f6e63693523f278f..aa9bb303c06f71c640ecd51f1c4d760fccb47a82 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md +++ b/zh-cn/application-dev/reference/apis/js-apis-medialibrary.md @@ -2237,11 +2237,11 @@ async function example() { **系统能力：** 以下各项对应的系统能力均为SystemCapability.Multimedia.MediaLibrary.Core -| 名称 | 类型 | 必填 | 描述 | -| ------------ | ------ | ---- | ---------------------------------------- | -| src | string | 是 | 应用本地文件绝对路径。 | -| mimeType | string | 是 | 媒体MIME（Multipurpose Internet Mail Extensions）类型。
包括：'image/\*'、'video/\*'、'audio/\*'、 'file\*'。 | -| relativePath | string | 否 | 自定义媒体资源保存位置，例：Pictures/ 不填则保存到默认路径。
image类型默认路径Pictures/
video类型默认路径Videos/
audio类型默认路径Audios/
file类型默认路径Documents/ 。 | +| 名称 | 类型 | 必填 | 描述 | +| ------------ | ------ | ---- | ------------------------------------------------------------ | +| src | string | 是 | 本地文件应用沙箱路径。 | +| mimeType | string | 是 | 媒体MIME（Multipurpose Internet Mail Extensions）类型。
包括：'image/\*'、'video/\*'、'audio/\*'、 'file\*'。 | +| relativePath | string | 否 | 自定义媒体资源保存位置，例：Pictures/ 不填则保存到默认路径。
image类型默认路径Pictures/
video类型默认路径Videos/
audio类型默认路径Audios/
file类型默认路径Documents/ 。 | ## MediaSelectOption(deprecated) diff --git a/zh-cn/application-dev/reference/apis/js-apis-securityLabel.md b/zh-cn/application-dev/reference/apis/js-apis-securityLabel.md index 8138d844a602118b83de7857efac46f098d5754b..57c60a57dde6901bc8314eca730cd5037489516f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-securityLabel.md +++ b/zh-cn/application-dev/reference/apis/js-apis-securityLabel.md @@ -13,11 +13,11 @@ import securityLabel from '@ohos.securityLabel'; ## 使用说明 -使用该功能模块对文件/目录进行操作前，需要先获取其绝对路径，获取方式及其接口用法请参考：[Context模块的接口getOrCreateLocalDir](js-apis-Context.md)。 +使用该功能模块对文件/目录进行操作前，需要先获取其应用沙箱路径，获取方式及其接口用法请参考：[Context模块的接口getOrCreateLocalDir](js-apis-Context.md)。 -“文件/目录绝对路径”=“应用目录路径”+“文件/目录名” +“文件/目录应用沙箱路径”=“应用目录路径”+“文件/目录名” -通过上述接口获取到应用目录路径dir，文件名为“xxx.txt”，文件所在绝对路径为： +通过上述接口获取到应用目录路径dir，文件名为“xxx.txt”，文件所在的应用沙箱路径为： ```js let path = dir + "/xxx.txt"; diff --git a/zh-cn/application-dev/reference/apis/js-apis-statfs.md b/zh-cn/application-dev/reference/apis/js-apis-statfs.md index 31ebb1e04290ce9d962d6aed2fa7feb625ec2a0b..af6d89fa861643e7e10f66a2aafaa07ed0092434 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-statfs.md +++ b/zh-cn/application-dev/reference/apis/js-apis-statfs.md @@ -13,11 +13,11 @@ import statfs from '@ohos.statfs'; ## 使用说明 -使用该功能模块对文件/目录进行操作前，需要先获取其绝对路径，获取方式及其接口用法请参考：[Context模块的接口getOrCreateLocalDir](js-apis-Context.md)。 +使用该功能模块对文件/目录进行操作前，需要先获取其应用沙箱路径，获取方式及其接口用法请参考：[Context模块的接口getOrCreateLocalDir](js-apis-Context.md)。 -“文件/目录绝对路径”=“应用目录路径”+“文件/目录名” +“文件/目录的应用沙箱路径”=“应用目录路径”+“文件/目录名” -通过上述接口获取到应用目录路径dir，以文件名“xxx.txt”为例，文件所在绝对路径为： +通过上述接口获取到应用目录路径dir，以文件名“xxx.txt”为例，文件所在的应用沙箱路径为： ```js let path = dir + "xxx.txt"; diff --git a/zh-cn/release-notes/OpenHarmony-v3.2-beta1.md b/zh-cn/release-notes/OpenHarmony-v3.2-beta1.md new file mode 100644 index 0000000000000000000000000000000000000000..7f812b9bf4a34bc3d1666c84a150c16ec987559c --- /dev/null +++ b/zh-cn/release-notes/OpenHarmony-v3.2-beta1.md @@ -0,0 +1,208 @@ +# OpenHarmony 3.2 Beta1 + +## 版本概述 + +当前版本在OpenHarmony 3.1 Release的基础上，更新支持以下能力： + +**轻量系统基础能力增强** + +轻量LiteOS系统和Linux系统IPC归一，构建和完善了进程间通信能力，包括分布式进程间通信，为分布式业务及APP提供本地和分布式的进程间通信能力。 + +**标准系统基础能力增强** + +新增支持针对Arm 64位的系统版本编译构建能力。 + +图形支持安全截图、安全录屏；支持嵌入其他应用界面显示能力。 + +窗口支持快速切换桌面和恢复应用窗口、窗口唤醒屏幕、保持屏幕常亮/窗口调整屏幕亮度、安全图层等能力。 + +方舟虚拟机支持多实例调试，以及条件断点和watch表达式能力。 + +多模输入支持遥控器、鼠标、键盘输入设备热插拔监听能力。 + +安全支持OpenHarmony跨设备之间的同帐号互信认证能力。 + +**标准系统分布式能力增强** + +系统服务管理支持群组校验机制能力。 + +**标准系统应用程序框架能力增强** + +ArkUI支持AbilityComponent组件将应用界面（Ability）作为控件嵌入其他应用显示；增强分栏与侧边栏组件能力，支持拖拽自动隐藏等能力。 + +包管理支持沙箱应用的安装、卸载、查询，拆包工具支持Stage模型能力。 + +元能力支持Stage模型支持Worker机制，新增ANR、应用主线程卡死检测等DFX能力。 + +**标准系统应用能力增强** + +图库支持基础动效，支持图片编辑保存能力，提供OEM定制开发能力。 + +**标准系统应用开发样例** + +新增图形GPU资源绘制、扫雷游戏、2048数字游戏等Demo样例，为开发者提供SDK使用的样例程序，方便开发者快速上手使用OpenHarmony系统基础能力。 + + +## 配套关系 + + **表1** 版本软件和工具配套关系 + +| 软件 | 版本 | 备注 | +| -------- | -------- | -------- | +| OpenHarmony | 3.2 Beta1 | NA | +| SDK | Ohos_sdk 3.2 Beta1（API Version 9） | NA | +| HUAWEI DevEco Studio（可选） | 3.2 Beta1 for OpenHarmony | OpenHarmony应用开发推荐使用 | +| HUAWEI DevEco Device Tool（可选） | 3.2 Beta1 | OpenHarmony智能设备集成开发环境推荐使用 | + + +## 源码获取 + + +### 前提条件 + +1. 注册码云gitee账号。 + +2. 注册码云SSH公钥，请参考[码云帮助中心](https://gitee.com/help/articles/4191)。 + +3. 安装[git客户端](https://gitee.com/link?target=https%3A%2F%2Fgit-scm.com%2Fbook%2Fzh%2Fv2%2F%25E8%25B5%25B7%25E6%25AD%25A5-%25E5%25AE%2589%25E8%25A3%2585-Git)和[git-lfs](https://gitee.com/vcs-all-in-one/git-lfs?_from=gitee_search#downloading)并配置用户信息。 + + ``` + git config --global user.name "yourname" + git config --global user.email "your-email-address" + git config --global credential.helper store + ``` + +4. 安装码云repo工具，可以执行如下命令。 + + ``` + curl -s https://gitee.com/oschina/repo/raw/fork_flow/repo-py3 > /usr/local/bin/repo #如果没有权限，可下载至其他目录，并将其配置到环境变量中chmod a+x /usr/local/bin/repo + pip3 install -i https://repo.huaweicloud.com/repository/pypi/simple requests + ``` + + +### 通过repo获取 + +**方式一（推荐）** + +通过repo + ssh 下载（需注册公钥，请参考[码云帮助中心](https://gitee.com/help/articles/4191)）。 + + +``` +repo init -u git@gitee.com:openharmony/manifest.git -b OpenHarmony-3.2-Beta1 --no-repo-verify +repo sync -c +repo forall -c 'git lfs pull' +``` + +**方式二** + +通过repo + https 下载。 + + +``` +repo init -u https://gitee.com/openharmony/manifest -b OpenHarmony-3.2-Beta1 --no-repo-verify +repo sync -c +repo forall -c 'git lfs pull' +``` + + +### 从镜像站点获取 + +*待补充* + + +## 更新说明 + +本版本在OpenHarmony 3.1 Release的基础上有如下变更。 + + +### 特性变更 + +**表2** 版本特性变更表 + + | 子系统名称 | 标准系统 | 轻量、小型系统 | +| -------- | -------- | -------- | +| 公共 | 新增支持Arm架构64位版本编译构建。 | 轻量、小型系统IPC接口与标准系统归一化。 | +| 资源调度 | 新增卡片使用记录信息统计能力。
主要涉及如下需求：
I531ST 支持卡片卸载时，删除对应的卡片使用记录
I531SU 支持查询获取卡片使用记录
I531SV 支持记录卡片的使用计数以及使用时间 | NA | +| 多模输入 | 新增遥控器、鼠标、键盘输入设备热插拔监听能力。
主要涉及如下需求：
I530U7 三方件json版本升级
I530UH 启动优化
I530UU 支持裁剪鼠标光标显示特
I530UL 支持不可触摸窗口
I530W5 支持通过JS API监听遥控器输入设备的热插拔
I530W9 支持通过JS API监听鼠标输入设备的热插拔
I530WB 支持通过JS API查看触摸板输入设备扩展信息
I530WF 支持通过JS API监听键盘输入设备的热插拔
I530UW 支持裁剪配置组合按键特性 | NA | +| 系统服务管理 | 新增群组校验机制。
主要涉及如下需求：
I59XYB 添加群组校验机制
I53NZQ 处理远端应用安装情况和版本号
I568AO DMS上报分布式组件关联关系
I58ZSB 采集OS类型信息 | NA | +| 包管理 | - 支持沙箱应用的安装、卸载、查询。
- 拆包工具支持Stage模型，打包工具能力增强。
主要涉及如下需求：
I524WG 支持系统应用不允许清除的能力
I524WP 查询指定应用是否安装
I524UF 支持系统feature的升级（已安装entry的情况下）
I524VP 支持隐式查询的优先级
I56W2U 包管理支持BackupExtension类型
I56W68 将pack.info打到hap包中
I56W6W 支持将新旧hap包打包到同一个app包中
I56W4O 拆包工具将hap包中的rpcid文件提出
I56W59 拆包工具对stage模型包的解析
I56W7H bms扫描完成后，发送扫描完成事件
I56WIG 包管理模块对外提供沙箱应用的安装能力
I56WIS 包管理模块提供对外沙箱应用的卸载能力
I56WJ7 包管理模块提供沙箱应用的包信息的查询能力 | NA | +| 基础通信 | 蓝牙支持人机接口设备接入能力。
主要涉及如下需求：
I58ZUA 支持人机接口设备接入能力，如蓝牙键盘、鼠标、游戏手柄等 | NA | +| 元能力 | - FA模型支持查询/设置组件横竖屏状态、组件锁屏显示和组件启动亮屏。
- 新增ANR、应用主线程卡死检测等DFX功能。
- 新增Stage模型支持Worker机制。
主要涉及如下需求：
I58ZRH FA模型支持查询/设置组件横竖屏状态
I58ZRI FA模型支持组件锁屏显示
I58ZRJ FA模型支持组件启动亮屏
I58ZRD ZIDL工具自动生成Extension Js服务端及客户端接口文件
I58ZR5 支持拦截uncatchedexception
I58ZR6 支持ANR处理
I58ZR7 运行管理服务线程卡死检测
I58ZR9 应用主线程卡死检测
I58ZRA 通用组件生命周期切换超时检测
I58ZR1 FA卡片能力补齐-支持删除无效卡片
I58ZR2 FA卡片能力补齐-支持卡片可见状态与更新状态单独设置
I58ZQR 提供Ability监听器
I58ZQW 提供调度组件生命周期相关的功能
I50DOL Stage模型支持Worker机制 | NA | +| 媒体 | - 新增OpenSL ES录音接口能力。
- HiStreamer引擎支持标准设备音频播放。
主要涉及如下需求：
I58ZOI 支持系统设置和获取总音量
I58ZOJ 支持音频用户权限控制
I58ZOM 支持OpenSL ES基础录音接口
I59H9F HiStreamer引擎支持标准设备音频播放 | NA | +| 图形 | - 支持安全截图、安全录屏。
- 支持嵌入其他应用界面显示。
主要涉及如下需求：
I58ZOX RenderService侧支持GPU合成
I58ZOU 支持安全截图、安全录屏（安全图层）
I58ZOW 支持窗口跨屏的扩展屏、拼接屏
I58ZOT 支持嵌入其他应用界面 | NA | +| 窗口 | - 支持快速切换桌面和恢复应用窗口功能。
- 支持窗口唤醒屏幕。
- 支持窗口保持屏幕常亮/窗口调整屏幕亮度。
- 支持安全图层。
- 支持窗口可获焦属性/窗口可触摸属性。
- 支持窗口方向设置。
- 支持应用窗口显示在锁屏之上。
- 支持窗口装饰（decoration）。
- 应用主窗口支持全屏显示。
- 支持应用启动退出窗口控制。
- 支持为系统应用提供应用界面组合能力。
主要涉及如下需求：
I58ZP0 支持Display显示大小（Density）设置
I58ZP1 提供快速切换桌面和恢复应用窗口功能
I58ZP4 支持窗口唤醒屏幕
I58ZP5 支持窗口保持屏幕常亮  支持窗口调整屏幕亮度
I58ZP6 支持安全图层
I58ZP7 支持窗口可获焦属性 支持窗口可触摸属性
I58ZP8 支持窗口方向设置
I58ZPA 支持应用窗口显示在锁屏之上
I58ZPD 支持窗口装饰
I58ZPE 应用主窗口支持全屏显示
I58ZPG 支持应用启动退出窗口控制
I58ZPI 支持应用启动窗口
I58ZPJ 支持为系统应用提供应用界面组合能力 | NA | +| 网络管理 | - 新增WebSocket JS API。
- 兼容system.fetch。
- 兼容system.network。
主要涉及以下需求：
I53CKH 支持兼容system.fetch
I53CKT 支持WebSocket
I53CJX 支持兼容system.network | NA | +| 全球化 | - 支持获取资源的同步接口，支持按资源名称获取资源，支持获取float等类型资源。
- 新增对MCC/MNC类型限定词资源的支持。
- 支持应用内不同模块独立编译。
- 支持获取区域偏好的年月日顺序。
- 获取本地文字的读音表达，例如汉字转拼音。
主要涉及如下需求：
I596AO 支持MCC/MNC限定词
I58ZSE 资源管理接口能力增强
I58ZSG 资源ID生成
I4WM02 音译
I4WK2O 日期顺序获取 | NA | +| ArkUI | - 支持组件布局边界显示。
- 增强XComponent组件的鼠标操作，并且优化了输入法弹出时的布局调整，在应用性能方面进行了优化。
- 增强分栏与侧边栏组件能力，支持拖拽自动隐藏功能。
- AbilityComponent组件支持，支持将应用界面（Ability）作为控件嵌入其他应用显示。
主要涉及需求如下：
I58ZPY 支持解码降采样图片性能化
I58ZPX 支持CPU提频优化动画性能
I58ZPW 新增AbilityComponent组件
I58ZPS XComponent组件鼠标事件
I58ZPR 支持输入框拉起输入法应用时自动布局
I58ZPQ 分栏、侧边栏支持自由拖拽到小于最小宽度后自动隐藏功能
I58ZPP 图形绘制/辅助类组件支持显示布局边界
I58ZPO 按钮/选择/信息展示/动效类组件支持显示布局边界
I58ZPN 文本/输入/图片/视频/媒体类组件支持显示布局边界 | NA | +| 程序访问控制 | - 新增SELinux针对service、hdf_service的标签保护能力。
- 新增Native服务的权限配置及校验能力。
主要涉及需求如下：
I58ZO1 针对service，提供selinux标签保护能力
I58ZO2 针对hdf_service，提供selinux标签保护能力
I58ZO3 accessToken支持native服务的权限校验机制 | NA | +| 公共基础类库 | TypedArray和SharedArrayBuffer支持ECMA 2021规范。
主要涉及如下需求：
I58ZPZ 支持TypeArray 2021规范
I58ZQ0 支持 shard array buffer 2021规范 | NA | +| 语言编译运行时 | - 方舟虚拟机支持多实例调试，以及条件断点和watch表达式。
主要涉及如下需求：
I58ZQE 方舟支持多实例调试
I58ZQD 方舟支持条件断点
I58ZQB 方舟支持watch变量及表达式
I58ZQ8 支持TSAOT优化编译器生成代码支持ArkJS运行时GC特性
I58ZQ7 支持TSAOT优化编译器后端机器码生成框架适配 | NA | +| 升级服务 | 新增适配RK 3568。
主要涉及如下需求：
I58ZSM update_service部件支持RK 3568升级适配
I58ZSO updater部件支持RK 3568升级适配 | NA | +| Misc软件服务 | 补齐API6前的http文件上传、下载接口。
主要涉及如下需求：
I58ZSC 【download】支持\@system.request接口
I53J82  【upload】支持\@system.request接口 | NA | +| 文件管理 | - 支持特殊沙箱的可配置能力。
- 三方应用存储查询能力。
主要涉及如下需求：
I58ZS6 支持应用沙箱差异化配置的能力
I58ZS9 支持为三方应用提供存储查询的能力
I58ZSA 适配HUKS HAL层新接口
I58ZS3 支持分布式公共数据访问框架的版本升级能力 | NA | +| 事件通知 | - 新增支持代理通知，提供代理三方应用发送通知能力。
- 增强通知渠道信息查询和设置的能力。
主要涉及如下需求：
I582UB 支持代理通知
I582TF 通知渠道信息设置和查询增强 | NA | +| 泛Sensor服务子系统 | 泛sensor新增适配环境光传感器。
主要涉及如下需求：
I53784 泛sensor能力持续集成-环境光传感器
I538PX SystemAPI同步相关实现 | NA | +| 分布式数据管理 | 新增提供分布式对象sample。
主要涉及如下需求：
I4WO0S 提供分布式对象sample | NA | +| 驱动 | - 支持动态加载内核驱动能力。
- 外设模块HAL能力增强及HDI接口完善。
主要涉及如下需求：
I4UD9W 支持内核态动态驱动加载机制，提高设备驱动开发、调试效率
I54566 相机服务和HDI循环依赖整改
I50I6S Audio新增IPC模式与直调模式接口调用统一
I54FQG 提供codec设备驱动模型，支持codec类型设备
I544XP 支持HDF服务SELinux权限检查
I4UL98 ADC适配Linux内核IIO框架 | NA | +| 编译构建 | - 新增支持Stage新模型的各种HAP包随版本代码编译
- 支持三方开源软件作为单独部件，当其被其他部件依赖时，编译系统自动安装到镜像，不需要配置到产品列表中
- 对python、jinja2、markupsafe做了版本升级
- 支持编译时定制设备类型
- 支持区分编译user/root版本
- 支持预编译的模块配置删除符号表
- 归一化轻富设备产品配置
主要涉及如下需求：
I53FCL 兼容支持Stage新模型HAP包随版本编译
I54ZLX 支持三方开源软件作为单独部件，当其被其他部件依赖时，编译系统自动安装到镜像，不需要配置到产品列表中
I54ERB/I52MRL/I52KTV 对被cleansource 3.1识别EOM的开源软件进行版本升级
I5714O 支持编译定制化ohos.para
I4Q9MI 支持预编译的模块配置删除符号表
I56M93 归一化轻富设备产品配置 | - 对python、jinja2、markupsafe进行版本升级
- 支持区分编译user/root版本
主要涉及如下需求：
I54ZLX 支持三方开源软件作为单独部件，当其被其他部件依赖时，编译系统自动安装到镜像，不需要配置到产品列表中
I54ERB/I52MRL/I52KTV 对被cleansource 3.1识别EOM的开源软件进行版本升级
I4Q9MI 支持预编译的模块配置删除符号表 | +| 测试 | - 测试用例执行支持筛选，按类型、粒度、级别筛选。
- UI测试框架新增滑动查找等接口能力。
- 执行器支持部件化执行、支持错误用例复测。
- 稳定性工具支持报告解析、生成与展示，支持控件注入。
主要涉及如下需求：
I58ZUJ 用例执行筛选能力
I58ZUK UI测试框架能力增强：API接口补充增强
I58ZUM UI测试框架能力增强：UI-dump功能开发
I58ZUR UI测试框架能力增强：自定义UI操作参数支持
I58ZUS 测试调度框架支持配置
I58ZUU 测试调度框架支持部件化
I58ZUV 稳定性工具支持稳定性报告解析、生成与展示
I58ZUW 稳定性工具支持控件注入 | NA | +| 安全基础能力 | 新增OpenHarmony跨设备之间的同帐号互信认证能力。
主要涉及如下需求：
I58ZNS 支持登录帐号的OpenHarmony设备之间执行同帐号互信认证
I58ZNR 支持OpenHarmony设备（登出帐号或被移除帐号后）移除本设备帐号认证凭据
I58ZNP 支持OpenHarmony设备导入/移除跨（同厂商或OEM厂商）帐号互信记录
I58ZNT 支持OpenHarmony设备（登录帐号或被绑定到帐号后）导入本设备帐号认证凭据（非对称凭据） | NA | +| 应用 | 图库应用支持图片编辑、动效能力。
主要涉及如下需求：
I58ZQ3 【图库】图片编辑
I58ZQ1 【图库】动效
I58ZQ4 【联系人】基础能力-2D能力 | NA | + + +### API变更 + +*待补充* + + +### 仓库变更 + +*待补充* + + +### 芯片及开发板适配 + +芯片及开发板适配状态请参考[SIG-Devboard](https://gitee.com/openharmony/community/blob/master/sig/sig-devboard/sig_devboard_cn.md)信息。 + + +### Samples + +**表2 **新增Samples + + | 子系统 | 名称 | 简介 | 开发语言 | +| -------- | -------- | -------- | -------- | +| ArkUI | MouseEvent | 本示例模拟了简单的扫雷游戏调用了鼠标事件的相关接口 | eTS | +| ArkUI | Vibrator | 本示例模拟倒计时场景，展示振动接口的使用方法。 | eTS | +| DFX | FaultLogger | 本示例展示了在eTS中如何获取应用故障相关信息。 | eTS | +| ArkUI | Gallery | 本Demo通过不同示例向用户介绍通用事件、通用属性、手势处理等不同组件的功能。 | eTS | +| 图形 | JsWebGL | 本示例调用GPU资源绘制了五角星和矩形，展示WebGL相关接口的使用方法。 | JS | +| ArkUI | Clock | 本示例使用eTS UI能力实现一个简单的时钟应用。 | eTS | +| 网络管理 | Http | 本示例仿postman输入API接口地址，获取相应数据，介绍数据请求接口的用法。 | eTS | +| ArkUI | FlishLight | 本示例通过屏幕的亮度变化来模拟手电筒功能，屏幕变亮模拟手电筒打开，屏幕变暗模拟手电筒关闭。 | eTS | +| 网络管理 | Socket | 本示例主要演示了Socket在网络通信方面的应用，展示了Socket在两端设备的连接验证、聊天通信方面的应用。 | eTS | +| 分布式数据管理 | DistributedRdb | 本示例展示了在eTS中分布式关系型数据库的使用，在增、删、改、查的基本操作外，还包括分布式数据库的数据同步能力。 | eTS | +| 元能力 | BackgroundTaskManager | 本示例模拟下载功能，将下载任务通过后台任务管理进行处理，实现退出应用后任务仍能够执行，直至任务结束。 | eTS | +| 元能力 | BringApp | 本示例使用FeatureAbility接口，通过应用的包名与Ability名，拉起系统应用。 | eTS | +| 媒体 | VideoPlayer | 本示例展示了在eTS中如何VideoPlayer播放视频，同时提供一个可供其他应用调用播放视频的Ability。 | eTS | +| 元能力 | DistributeCalc | 本示例使用JS分布式能力实现了一个简单的计算器应用，可以进行简单的数值计算，支持远程拉起另一个计算器FA，两个FA进行协同计算。 | eTS | +| 媒体 | JSRecorder | 本示例通过调用媒体相关接口来实现音频录制和播放的功能。 | eTS | +| Web | Browser | 本示例运用OpenHarmony系统提供的Stage模型与相关接口展示了一个简易的浏览器。 | eTS | +| 元能力 | DeviceUsageStatistics | 本示例主要展示了设备使用信息情况。 | eTS | +| ArkUI | AdaptiveCapabilities | 本示例展示在eTS中的多设备自适应能力，包括资源限定词、原子布局和响应式布局。 | eTS | +| ArkUI | Game2048 | 2048是一款比较流行的数字游戏，此游戏demo是grid组件基础上进行开发完成的。 | eTS | +| 窗口 | Window | 本示例展示了创建新窗口，将应用悬浮在其他界面，及应用分屏等功能 | eTS | +| 分布式数据管理 | Preference | 本示例主要展示了首选项在主题切换方面的功能。 | eTS | +| ArkUI | NativeAPI | 本示例展示了在eTS中如何调用C++的接口以及C++如何回调JS，完成了一个简单的五子棋游戏，在native层完成计算逻辑，eTS完成界面绘制和刷新。 | eTS/C++ | +| 全球化 | International | 本示例展示了i18n，intl，resourceManager在eTS中的使用，使用相关api实现系统语言和地区设置、时间和时区设置，展示了区域格式化示例。 | eTS | + +请访问[Samples](https://gitee.com/openharmony/app_samples)仓了解更多信息。 + + +## 修复缺陷列表 + +*待补充* + + +## 遗留缺陷列表 + +*待补充* diff --git a/zh-cn/release-notes/Readme.md b/zh-cn/release-notes/Readme.md index f76a095b5ab2ea92c4cf4e0a03215cad8eb80dc5..48e1d0980b468f53500958793361b5f3f6d63355 100644 --- a/zh-cn/release-notes/Readme.md +++ b/zh-cn/release-notes/Readme.md @@ -1,5 +1,6 @@ # OpenHarmony Release Notes ## OpenHarmony 3.x Releases +- [OpenHarmony v3.2 Beta1 (2022-05-31)](OpenHarmony-v3.2-beta1.md) - [OpenHarmony v3.1 Release (2022-03-30)](OpenHarmony-v3.1-release.md) - [OpenHarmony v3.1 Beta (2021-12-31)](OpenHarmony-v3.1-beta.md) - [OpenHarmony v3.0.3 LTS (2022-04-08)](OpenHarmony-v3.0.3-LTS.md) diff --git a/zh-cn/website.md b/zh-cn/website.md index 837df280dd1b14bb834b69357834fd031e5aa2a9..c54f57550f054851d8c01f24b206dd105114eb23 100644 --- a/zh-cn/website.md +++ b/zh-cn/website.md @@ -5,6 +5,7 @@ - 版本说明 - OpenHarmony 3.x Releases + - [OpenHarmony v3.2 Beta1 (2022-05-31)](release-notes/OpenHarmony-v3.2-beta1.md) - [OpenHarmony v3.1 Release (2022-03-30)](release-notes/OpenHarmony-v3.1-release.md) - [OpenHarmony v3.1 Beta (2021-12-31)](release-notes/OpenHarmony-v3.1-beta.md) - [OpenHarmony v3.0.3 LTS (2022-04-08)](release-notes/OpenHarmony-v3.0.3-LTS.md) @@ -23,7 +24,7 @@ - [OpenHarmony 1.1.1 LTS (2021-06-22)](release-notes/OpenHarmony-1-1-1-LTS.md) - [OpenHarmony 1.1.0 LTS (2021-04-01)](release-notes/OpenHarmony-1-1-0-LTS.md) - [OpenHarmony 1.0 (2020-09-10)](release-notes/OpenHarmony-1-0.md) - + - 贡献 - [参与贡献](contribute/参与贡献.md) - [行为准则](contribute/行为准则.md)