提交 a403768c 编写于 作者: Mr-YX's avatar Mr-YX 提交者: Gitee

Merge branch 'master' of gitee.com:openharmony/docs into master

Signed-off-by: Mr-YX's avatarmr-yx <496043997@qq.com>
...@@ -3,9 +3,13 @@ ...@@ -3,9 +3,13 @@
## 场景介绍 ## 场景介绍
使用坐标描述一个位置,非常准确,但是并不直观,面向用户表达并不友好。 使用坐标描述一个位置,非常准确,但是并不直观,面向用户表达并不友好。系统向开发者提供了以下两种转化能力。
系统向开发者提供了地理编码转化能力(将地理描述转化为具体坐标),以及逆地理编码转化能力(将坐标转化为地理描述)。其中地理编码包含多个属性来描述位置,包括国家、行政区划、街道、门牌号、地址描述等等,这样的信息更便于用户理解。 - 地理编码转化:将地理描述转化为具体坐标。
- 逆地理编码转化能力:将坐标转化为地理描述。
其中地理编码包含多个属性来描述位置,包括国家、行政区划、街道、门牌号、地址描述等等,这样的信息更便于用户理解。
## 接口说明 ## 接口说明
......
...@@ -75,7 +75,7 @@ getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, call ...@@ -75,7 +75,7 @@ getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, call
**需要权限:** **需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGEDohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGEDohos.permission.GET_BUNDLE_INFO
**系统能力:** **系统能力:**
...@@ -303,7 +303,7 @@ getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\< ...@@ -303,7 +303,7 @@ getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<
**需要权限:** **需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGEDohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGEDohos.permission.GET_BUNDLE_INFO
**系统能力:** **系统能力:**
...@@ -602,7 +602,7 @@ getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback\ ...@@ -602,7 +602,7 @@ getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback\
**需要权限:** **需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGEDohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGEDohos.permission.GET_BUNDLE_INFO
**系统能力:** **系统能力:**
...@@ -757,7 +757,7 @@ getAbilityLabel(bundleName: string, abilityName: string, callback : AsyncCallbac ...@@ -757,7 +757,7 @@ getAbilityLabel(bundleName: string, abilityName: string, callback : AsyncCallbac
**需要权限:** **需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGEDohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGEDohos.permission.GET_BUNDLE_INFO
**系统能力:** **系统能力:**
...@@ -906,10 +906,6 @@ isAbilityEnabled(info : AbilityInfo, callback : AsyncCallback\<boolean>): void ...@@ -906,10 +906,6 @@ isAbilityEnabled(info : AbilityInfo, callback : AsyncCallback\<boolean>): void
以异步方法根据给定的AbilityInfo查询ability是否已经启用,使用callback形式返回结果。 以异步方法根据给定的AbilityInfo查询ability是否已经启用,使用callback形式返回结果。
**需要权限:**
**系统能力:** **系统能力:**
SystemCapability.BundleManager.BundleFramework SystemCapability.BundleManager.BundleFramework
...@@ -977,10 +973,6 @@ isApplicationEnabled(bundleName: string, callback : AsyncCallback\<boolean>): vo ...@@ -977,10 +973,6 @@ isApplicationEnabled(bundleName: string, callback : AsyncCallback\<boolean>): vo
以异步方法根据给定的bundleName查询指定应用程序是否已经启用,使用callback形式返回结果。 以异步方法根据给定的bundleName查询指定应用程序是否已经启用,使用callback形式返回结果。
**需要权限:**
**系统能力:** **系统能力:**
SystemCapability.BundleManager.BundleFramework SystemCapability.BundleManager.BundleFramework
...@@ -1099,6 +1091,10 @@ queryAbilityByWant(want: Want, bundleFlags: number, callback: AsyncCallback<Arra ...@@ -1099,6 +1091,10 @@ queryAbilityByWant(want: Want, bundleFlags: number, callback: AsyncCallback<Arra
以异步方法根据给定的意图获取Ability信息,使用callback形式返回结果。 以异步方法根据给定的意图获取Ability信息,使用callback形式返回结果。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
**系统能力:** **系统能力:**
SystemCapability.BundleManager.BundleFramework SystemCapability.BundleManager.BundleFramework
...@@ -1313,7 +1309,7 @@ getAbilityIcon(bundleName: string, abilityName: string, callback: AsyncCallback\ ...@@ -1313,7 +1309,7 @@ getAbilityIcon(bundleName: string, abilityName: string, callback: AsyncCallback\
**需要权限:** **需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED, ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED ohos.permission.GET_BUNDLE_INFO
**系统能力:** **系统能力:**
...@@ -1477,7 +1473,7 @@ queryExtensionAbilityInfos(want: Want, extensionType: number, extensionFlags: nu ...@@ -1477,7 +1473,7 @@ queryExtensionAbilityInfos(want: Want, extensionType: number, extensionFlags: nu
**需要权限:** **需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED, ohos.permission.GET_BUNDLE_INFO ohos.permission.GET_BUNDLE_INFO_PRIVILEGED ohos.permission.GET_BUNDLE_INFO
**系统能力:** **系统能力:**
......
...@@ -41,7 +41,7 @@ Ability信息 ...@@ -41,7 +41,7 @@ Ability信息
| labelId | number | 是 | 否 | Ability的标签id | | labelId | number | 是 | 否 | Ability的标签id |
| subType | AbilitySubType | 是 | 否 | Ability中枚举使用的模板的子类型 | | subType | AbilitySubType | 是 | 否 | Ability中枚举使用的模板的子类型 |
| metaData<sup>8+</sup> | Array\<[CustomizeData](js-apis-bundle-CustomizeData.md)> | 是 | 否 | ability的自定义信息 | | metaData<sup>8+</sup> | Array\<[CustomizeData](js-apis-bundle-CustomizeData.md)> | 是 | 否 | ability的自定义信息 |
| metaData<sup>9+</sup> | Array\<[Metadata](js-apis-bundle-Metadata.md)> | 是 | 否 | ability的元信息 | | metadata<sup>9+</sup> | Array\<[Metadata](js-apis-bundle-Metadata.md)> | 是 | 否 | ability的元信息 |
| enabled<sup>8+</sup> | boolean | 是 | 否 | ability是否可用 | | enabled<sup>8+</sup> | boolean | 是 | 否 | ability是否可用 |
| supportWindowMode<sup>9+</sup> | Array\<[SupportWindowMode](js-apis-Bundle.md)> | 是 | 否 | ability支持的窗口模式 | | supportWindowMode<sup>9+</sup> | Array\<[SupportWindowMode](js-apis-Bundle.md)> | 是 | 否 | ability支持的窗口模式 |
| maxWindowRatio<sup>9+</sup> | number | 是 | 否 | ability支持的最大的窗口比例 | | maxWindowRatio<sup>9+</sup> | number | 是 | 否 | ability支持的最大的窗口比例 |
......
...@@ -5,30 +5,34 @@ ...@@ -5,30 +5,34 @@
应用程序信息 应用程序信息
## ApplicationInfo
**系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------ |
| name | string | 是 | 否 | 应用程序的名称 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| description | string | 是 | 否 | 应用程序的描述 | | -------------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ |
| descriptionId | number | 是 | 否 | 应用程序的描述id | | name | string | 是 | 否 | 应用程序的名称 |
| systemApp | boolean | 是 | 否 | 判断是否为系统应用程序,默认为false | | description | string | 是 | 否 | 应用程序的描述 |
| enabled | boolean | 是 | 否 | 判断应用程序是否可以使用,默认为true | | descriptionId | number | 是 | 否 | 应用程序的描述id |
| label | string | 是 | 否 | 应用程序的标签 | | systemApp | boolean | 是 | 否 | 判断是否为系统应用程序,默认为false |
| labelId | string | 是 | 否 | 应用程序的标签id | | enabled | boolean | 是 | 否 | 判断应用程序是否可以使用,默认为true |
| icon | string | 是 | 否 | 应用程序的图标 | | label | string | 是 | 否 | 应用程序的标签 |
| iconId | string | 是 | 否 | 应用程序的图标id | | labelId | string | 是 | 否 | 应用程序的标签id |
| process | string | 是 | 否 | 应用程序的进程,如果不设置,默认为包的名称 | | icon | string | 是 | 否 | 应用程序的图标 |
| supportedModes | number | 是 | 否 | 应用程序支持的运行模式 | | iconId | string | 是 | 否 | 应用程序的图标id |
| moduleSourceDirs | Array\<string> | 是 | 否 | 应用程序的资源存放的相对路径 | | process | string | 是 | 否 | 应用程序的进程,如果不设置,默认为包的名称 |
| permissions | Array\<string> | 是 | 否 | 访问应用程序所需的权限 | | supportedModes | number | 是 | 否 | 应用程序支持的运行模式 |
| moduleInfos | Array\<[ModuleInfo](js-apis-bundle-ModuleInfo.md)> | 是 | 否 | 应用程序的模块信息 | | moduleSourceDirs | Array\<string> | 是 | 否 | 应用程序的资源存放的相对路径 |
| entryDir | string | 是 | 否 | 应用程序的文件保存路径 | | permissions | Array\<string> | 是 | 否 | 访问应用程序所需的权限 |
| codePath<sup>8+</sup> | string | 是 | 否 | 应用程序的安装目录 | | moduleInfos | Array\<[ModuleInfo](js-apis-bundle-ModuleInfo.md)> | 是 | 否 | 应用程序的模块信息 |
| metaData<sup>8+</sup> | Map\<string, Array\<[CustomizeData](js-apis-bundle-CustomizeData.md)>> | 是 | 否 | 应用程序的自定义元信息 | | entryDir | string | 是 | 否 | 应用程序的文件保存路径 |
| metaData<sup>9+</sup> | Map\<string, Array\<[Metadata](js-apis-bundle-Metadata.md)>> | 是 | 否 | 应用程序的元信息 | | codePath<sup>8+</sup> | string | 是 | 否 | 应用程序的安装目录 |
| removable<sup>8+</sup> | boolean | 是 | 否 | 应用程序是否可以被移除 | | metaData<sup>8+</sup> | Map\<string, Array\<[CustomizeData](js-apis-bundle-CustomizeData.md)>> | 是 | 否 | 应用程序的自定义元信息 |
| accessTokenId<sup>8+</sup> | number | 是 | 否 | 应用程序的accessTokenId | | metadata<sup>9+</sup> | Map\<string, Array\<[Metadata](js-apis-bundle-Metadata.md)>> | 是 | 否 | 应用程序的元信息 |
| uid<sup>8+</sup> | number | 是 | 否 | 应用程序的uid | | removable<sup>8+</sup> | boolean | 是 | 否 | 应用程序是否可以被移除 |
| entityType<sup>8+</sup> | string | 是 | 否 | 应用程序的实体类型 | | accessTokenId<sup>8+</sup> | number | 是 | 否 | 应用程序的accessTokenId |
| fingerprint<sup>9+</sup> | string | 是 | 否 | 应用程序的签名证书指纹信息,即开发者申请的签名证书的sha256值 | | uid<sup>8+</sup> | number | 是 | 否 | 应用程序的uid |
\ No newline at end of file | entityType<sup>8+</sup> | string | 是 | 否 | 应用程序的实体类型 |
| fingerprint<sup>9+</sup> | string | 是 | 否 | 应用程序的签名证书指纹信息,即开发者申请的签名证书的sha256值 |
...@@ -9,7 +9,7 @@ ...@@ -9,7 +9,7 @@
应用包的信息 应用包的信息
## BundleInfo
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
......
...@@ -9,7 +9,7 @@ ...@@ -9,7 +9,7 @@
自定义元数据 自定义元数据
## CustomizeData
**系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
......
...@@ -9,7 +9,7 @@ ...@@ -9,7 +9,7 @@
ElementName信息 ElementName信息
## ElementName
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
......
...@@ -9,7 +9,7 @@ ...@@ -9,7 +9,7 @@
ExtensionAbility信息 ExtensionAbility信息
## ExtensionAbilityInfo
**系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
...@@ -25,7 +25,7 @@ ExtensionAbility信息 ...@@ -25,7 +25,7 @@ ExtensionAbility信息
| extensionAbilityType | bundle.ExtensionAbilityType | 是 | 否 | ExtensionAbility类型 | | extensionAbilityType | bundle.ExtensionAbilityType | 是 | 否 | ExtensionAbility类型 |
| permissions | Array\<string> | 是 | 否 | 被其他应用ExtensionAbility调用时需要申请的权限集合 | | permissions | Array\<string> | 是 | 否 | 被其他应用ExtensionAbility调用时需要申请的权限集合 |
| applicationInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | 是 | 否 | 应用程序的配置信息 | | applicationInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | 是 | 否 | 应用程序的配置信息 |
| metaData | Array\<[Metadata](js-apis-bundle-Metadata.md)> | 是 | 否 | ExtensionAbility的元信息 | | metadata | Array\<[Metadata](js-apis-bundle-Metadata.md)> | 是 | 否 | ExtensionAbility的元信息 |
| enabled | boolean | 是 | 否 | ExtensionAbility是否可用 | | enabled | boolean | 是 | 否 | ExtensionAbility是否可用 |
| readPermission | string | 是 | 否 | 读取ExtensionAbility数据所需的权限 | | readPermission | string | 是 | 否 | 读取ExtensionAbility数据所需的权限 |
| writePermission | string | 是 | 否 | 向ExtensionAbility写数据所需的权限 | | writePermission | string | 是 | 否 | 向ExtensionAbility写数据所需的权限 |
\ No newline at end of file
...@@ -9,7 +9,7 @@ ...@@ -9,7 +9,7 @@
Hap模块信息 Hap模块信息
## HapModuleInfo
**系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
......
...@@ -3,13 +3,13 @@ ...@@ -3,13 +3,13 @@
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 8 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
元数据信息 元数据信息
## Metadata
**系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
......
...@@ -9,7 +9,7 @@ ...@@ -9,7 +9,7 @@
应用程序的模块信息 应用程序的模块信息
## ModuleInfo
**系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework **系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
......
...@@ -12,28 +12,28 @@ import document from '@ohos.document'; ...@@ -12,28 +12,28 @@ import document from '@ohos.document';
## document.choose ## document.choose
choose(types:string[]): Promise&lt;string&gt; choose(types? : string[]): Promise&lt;string&gt;
通过文件管理器选择文件,异步返回文件URI,使用promise形式返回结果。 通过文件管理器选择文件,异步返回文件URI,使用promise形式返回结果。
**系统能力**:SystemCapability.FileManagement.UserFileService **系统能力**:SystemCapability.FileManagement.UserFileService
- 参数: **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ---------------------------- | | ------ | ------ | ---- | ---------------------------- |
| types | string[] | 否 | 限定文件选择的类型 | | types | string[] | 否 | 限定文件选择的类型 |
- 返回值: **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | -------------- | | --------------------- | -------------- |
| Promise&lt;string&gt; | 异步返回文件URI(注:当前返回错误码) | | Promise&lt;string&gt; | 异步返回文件URI(注:当前返回错误码) |
- 示例: **示例:**
```js ```js
let tpyes = []; let types = [];
document.choose(types); document.choose(types);
``` ```
## document.choose ## document.choose
...@@ -44,13 +44,13 @@ choose(callback:AsyncCallback&lt;string&gt;): void ...@@ -44,13 +44,13 @@ choose(callback:AsyncCallback&lt;string&gt;): void
**系统能力**:SystemCapability.FileManagement.UserFileService **系统能力**:SystemCapability.FileManagement.UserFileService
- 参数: **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ---------------------------- | | -------- | --------------------------- | ---- | ---------------------------- |
| callback | AsyncCallback&lt;string&gt; | 是 | 异步获取对应文件URI(注:当前返回错误码) | | callback | AsyncCallback&lt;string&gt; | 是 | 异步获取对应文件URI(注:当前返回错误码) |
- 示例: **示例:**
```js ```js
let uri = ""; let uri = "";
...@@ -66,14 +66,14 @@ choose(types:string[], callback:AsyncCallback&lt;string&gt;): void ...@@ -66,14 +66,14 @@ choose(types:string[], callback:AsyncCallback&lt;string&gt;): void
**系统能力**:SystemCapability.FileManagement.UserFileService **系统能力**:SystemCapability.FileManagement.UserFileService
- 参数: **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ---------------------------- | | -------- | --------------------------- | ---- | ---------------------------- |
| types | string[] | 否 | 限定选择文件的类型 | | types | string[] | 否 | 限定选择文件的类型 |
| callback | AsyncCallback&lt;string&gt; | 是 | 异步获取对应文件URI(注:当前返回错误码) | | callback | AsyncCallback&lt;string&gt; | 是 | 异步获取对应文件URI(注:当前返回错误码) |
- 示例: **示例:**
```js ```js
let types = []; let types = [];
...@@ -91,20 +91,20 @@ show(uri:string, type:string):Promise&lt;void&gt; ...@@ -91,20 +91,20 @@ show(uri:string, type:string):Promise&lt;void&gt;
**系统能力**:SystemCapability.FileManagement.UserFileService **系统能力**:SystemCapability.FileManagement.UserFileService
- 参数: **参数:**
| 参数 | 类型 | 必填 | 说明 | | 参数 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | ---------------------------- | | ---- | ------ | ---- | ---------------------------- |
| uri | string | 是 | 待打开的文件URI | | uri | string | 是 | 待打开的文件URI |
| type | string | 是 | 待打开文件的类型 | | type | string | 是 | 待打开文件的类型 |
- 返回值: **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ------------ | | --------------------- | ------------ |
| Promise&lt;void&gt; | Promise回调返回void表示成功打开文件(注:当前返回错误码) | | Promise&lt;void&gt; | Promise回调返回void表示成功打开文件(注:当前返回错误码) |
- 示例: **示例:**
```js ```js
let type = ""; let type = "";
...@@ -120,7 +120,7 @@ show(uri:string, type:string, callback:AsyncCallback&lt;void&gt;): void ...@@ -120,7 +120,7 @@ show(uri:string, type:string, callback:AsyncCallback&lt;void&gt;): void
**系统能力**:SystemCapability.FileManagement.UserFileService **系统能力**:SystemCapability.FileManagement.UserFileService
- 参数: **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------- | ---- | ---------------------------- | | -------- | --------------------------- | ---- | ---------------------------- |
...@@ -128,7 +128,7 @@ show(uri:string, type:string, callback:AsyncCallback&lt;void&gt;): void ...@@ -128,7 +128,7 @@ show(uri:string, type:string, callback:AsyncCallback&lt;void&gt;): void
| type | string | 是 | 待打开文件的类型 | | type | string | 是 | 待打开文件的类型 |
| callback | AsyncCallback&lt;void&gt; | 是 | 异步打开uri对应文件(注:当前返回错误码) | | callback | AsyncCallback&lt;void&gt; | 是 | 异步打开uri对应文件(注:当前返回错误码) |
- 示例: **示例:**
```js ```js
let type = ""; let type = "";
......
# 文件管理 文件管理
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
...@@ -22,7 +22,7 @@ import fileio from '@ohos.fileio'; ...@@ -22,7 +22,7 @@ import fileio from '@ohos.fileio';
context.getFilesDir().then((data) => { context.getFilesDir().then((data) => {
path = data; path = data;
}) })
``` ```
## fileio.stat ## fileio.stat
...@@ -546,7 +546,7 @@ open(path: string, flags?: number, mode?: number): Promise&lt;number&gt; ...@@ -546,7 +546,7 @@ open(path: string, flags?: number, mode?: number): Promise&lt;number&gt;
```js ```js
fileio.open(path, 0o1, 0o0200).then(function(number){ fileio.open(path, 0o1, 0o0200).then(function(number){
console.info("open file succeed"); console.info("open file succeed");
}).catch(function(error){ }).catch(function(err){
console.info("open file failed with error:"+ err); console.info("open file failed with error:"+ err);
}); });
``` ```
...@@ -639,11 +639,11 @@ read(fd: number, buffer: ArrayBuffer, options?: { ...@@ -639,11 +639,11 @@ read(fd: number, buffer: ArrayBuffer, options?: {
```js ```js
let fd = fileio.openSync(path, 0o2); let fd = fileio.openSync(path, 0o2);
let buf = new ArrayBuffer(4096); let buf = new ArrayBuffer(4096);
fileio.read(fd, buf).then(function(readout){ fileio.read(fd, buf).then(function(readOut){
console.info("read file data succeed"); console.info("read file data succeed");
console.log(String.fromCharCode.apply(null, new Uint8Array(readOut.buffer))); console.log(String.fromCharCode.apply(null, new Uint8Array(readOut.buffer)));
}).catch(function(error){ }).catch(function(err){
console.info("read file data failed with error:"+ error); console.info("read file data failed with error:"+ err);
}); });
``` ```
...@@ -879,7 +879,7 @@ write(fd: number, buffer: ArrayBuffer | string, options?: { ...@@ -879,7 +879,7 @@ write(fd: number, buffer: ArrayBuffer | string, options?: {
**示例:** **示例:**
```js ```js
let fd = fileio.openSync(fpath, 0o100 | 0o2, 0o666); let fd = fileio.openSync(path, 0o100 | 0o2, 0o666);
fileio.write(fd, "hello, world").then(function(number){ fileio.write(fd, "hello, world").then(function(number){
console.info("write data to file succeed and size is:"+ number); console.info("write data to file succeed and size is:"+ number);
}).catch(function(err){ }).catch(function(err){
...@@ -998,7 +998,7 @@ hash(path: string, algorithm: string, callback: AsyncCallback&lt;string&gt;): vo ...@@ -998,7 +998,7 @@ hash(path: string, algorithm: string, callback: AsyncCallback&lt;string&gt;): vo
**示例:** **示例:**
```js ```js
fileio.hash(fpath, "sha256", function(err, hashStr) { fileio.hash(path, "sha256", function(err, hashStr) {
if (hashStr) { if (hashStr) {
console.info("calculate file hash succeed:"+ hashStr); console.info("calculate file hash succeed:"+ hashStr);
} }
...@@ -1074,7 +1074,7 @@ chmodSync(path: string, mode: number): void ...@@ -1074,7 +1074,7 @@ chmodSync(path: string, mode: number): void
**示例:** **示例:**
```js ```js
fileio.chmodSync(fpath, mode); fileio.chmodSync(path, mode);
``` ```
...@@ -1409,7 +1409,7 @@ lstat(path: string): Promise&lt;Stat&gt; ...@@ -1409,7 +1409,7 @@ lstat(path: string): Promise&lt;Stat&gt;
**示例:** **示例:**
```js ```js
fileio.lstat(path).then(function(stat){ fileio.lstat(path).then(function(stat){
console.info("get link status succeed:"+ number); console.info("get link status succeed:"+ JSON.stringify(stat));
}).catch(function(err){ }).catch(function(err){
console.info("get link status failed with error:"+ err); console.info("get link status failed with error:"+ err);
}); });
...@@ -1663,7 +1663,7 @@ fsyncSync(fd: number): void ...@@ -1663,7 +1663,7 @@ fsyncSync(fd: number): void
**示例:** **示例:**
```js ```js
fileio.fyncsSync(fd); fileio.fsyncSync(fd);
``` ```
...@@ -1857,7 +1857,7 @@ chown(path: string, uid: number, gid: number, callback: AsyncCallback&lt;void&gt ...@@ -1857,7 +1857,7 @@ chown(path: string, uid: number, gid: number, callback: AsyncCallback&lt;void&gt
**示例:** **示例:**
```js ```js
let stat = fileio.statSync(fpath) let stat = fileio.statSync(path)
fileio.chown(path, stat.uid, stat.gid, function (err){ fileio.chown(path, stat.uid, stat.gid, function (err){
// do something // do something
}); });
...@@ -1881,7 +1881,7 @@ chownSync(path: string, uid: number, gid: number): void ...@@ -1881,7 +1881,7 @@ chownSync(path: string, uid: number, gid: number): void
**示例:** **示例:**
```js ```js
let stat = fileio.statSync(fpath) let stat = fileio.statSync(path)
fileio.chownSync(path, stat.uid, stat.gid); fileio.chownSync(path, stat.uid, stat.gid);
``` ```
...@@ -2078,7 +2078,7 @@ createStream(path: string, mode: string, callback: AsyncCallback&lt;Stream&gt;): ...@@ -2078,7 +2078,7 @@ createStream(path: string, mode: string, callback: AsyncCallback&lt;Stream&gt;):
**示例:** **示例:**
```js ```js
fileio.createStream(path, mode, function(err, stream){ fileio.createStream(path, "r+", function(err, stream){
// do something // do something
}); });
``` ```
...@@ -2130,7 +2130,8 @@ fdopenStream(fd: number, mode: string): Promise&lt;Stream&gt; ...@@ -2130,7 +2130,8 @@ fdopenStream(fd: number, mode: string): Promise&lt;Stream&gt;
**示例:** **示例:**
```js ```js
fileio.fdopenStream(fd, mode).then(function(stream){ let fd = fileio.openSync(path);
fileio.fdopenStream(fd, "r+").then(function(stream){
console.info("openStream succeed"); console.info("openStream succeed");
}).catch(function(err){ }).catch(function(err){
console.info("openStream failed with error:"+ err); console.info("openStream failed with error:"+ err);
...@@ -2155,7 +2156,8 @@ fdopenStream(fd: number, mode: string, callback: AsyncCallback&lt;Stream&gt;): v ...@@ -2155,7 +2156,8 @@ fdopenStream(fd: number, mode: string, callback: AsyncCallback&lt;Stream&gt;): v
**示例:** **示例:**
```js ```js
fileio.fdopenStream(fd, mode, function (err, stream) { let fd = fileio.openSync(path);
fileio.fdopenStream(fd, "r+", function (err, stream) {
// do something // do something
}); });
``` ```
...@@ -2182,6 +2184,7 @@ fdopenStreamSync(fd: number, mode: string): Stream ...@@ -2182,6 +2184,7 @@ fdopenStreamSync(fd: number, mode: string): Stream
**示例:** **示例:**
```js ```js
let fd = fileio.openSync(path);
let ss = fileio.fdopenStreamSync(fd, "r+"); let ss = fileio.fdopenStreamSync(fd, "r+");
``` ```
...@@ -2235,7 +2238,7 @@ fchown(fd: number, uid: number, gid: number, callback: AsyncCallback&lt;void&gt; ...@@ -2235,7 +2238,7 @@ fchown(fd: number, uid: number, gid: number, callback: AsyncCallback&lt;void&gt;
**示例:** **示例:**
```js ```js
let stat = fileio.statSync(fpath); let stat = fileio.statSync(path);
fileio.fchown(fd, stat.uid, stat.gid, function (err){ fileio.fchown(fd, stat.uid, stat.gid, function (err){
// do something // do something
}); });
...@@ -2259,7 +2262,7 @@ fchownSync(fd: number, uid: number, gid: number): void ...@@ -2259,7 +2262,7 @@ fchownSync(fd: number, uid: number, gid: number): void
**示例:** **示例:**
```js ```js
let stat = fileio.statSync(fpath); let stat = fileio.statSync(path);
fileio.fchownSync(fd, stat.uid, stat.gid); fileio.fchownSync(fd, stat.uid, stat.gid);
``` ```
...@@ -2364,9 +2367,11 @@ createWatcher(filename: string, events: number, callback: AsyncCallback&lt;numbe ...@@ -2364,9 +2367,11 @@ createWatcher(filename: string, events: number, callback: AsyncCallback&lt;numbe
**示例:** **示例:**
```js ```js
fileio.createWatcher(filename, events, function(watcher){ let filename = path +"/test.txt";
// do something fileio.createWatcher(filename, 1, function(number){
console.info("Monitoring times: "+number);
}); });
``` ```
...@@ -2498,7 +2503,7 @@ isFile(): boolean ...@@ -2498,7 +2503,7 @@ isFile(): boolean
**示例:** **示例:**
```js ```js
let isFile = fileio.statSync(fpath).isFile(); let isFile = fileio.statSync(path).isFile();
``` ```
...@@ -2555,7 +2560,13 @@ stop(): Promise&lt;void&gt; ...@@ -2555,7 +2560,13 @@ stop(): Promise&lt;void&gt;
**示例:** **示例:**
```js ```js
fileio.stop(); let filename = path +"/test.txt";
let watcher = await fileio.createWatcher(filename, 1, function(number){
console.info("Monitoring times: "+number);
});
watcher.stop().then(function(){
console.info("close watcher succeed");
});
``` ```
...@@ -2574,13 +2585,17 @@ stop(callback: AsyncCallback&lt;void&gt;): void ...@@ -2574,13 +2585,17 @@ stop(callback: AsyncCallback&lt;void&gt;): void
**示例:** **示例:**
```js ```js
fileio.stop(function(err){ let filename = path +"/test.txt";
// do something let watcher = await fileio.createWatcher(filename, 1, function(number){
console.info("Monitoring times: "+number);
}); });
watcher.stop(function(){
console.info("close watcher succeed");
})
``` ```
## Stream<sup>7+</sup> ## Stream
文件流,在调用Stream的方法前,需要先通过createStream()方法(同步或异步)来构建一个Stream实例。 文件流,在调用Stream的方法前,需要先通过createStream()方法(同步或异步)来构建一个Stream实例。
...@@ -2600,7 +2615,7 @@ close(): Promise&lt;void&gt; ...@@ -2600,7 +2615,7 @@ close(): Promise&lt;void&gt;
**示例:** **示例:**
```js ```js
let ss= fileio.createStreamSync(path); let ss= fileio.createStreamSync(path, "r+");
ss.close().then(function(){ ss.close().then(function(){
console.info("close fileStream succeed"); console.info("close fileStream succeed");
}).catch(function(err){ }).catch(function(err){
...@@ -2624,7 +2639,7 @@ close(callback: AsyncCallback&lt;void&gt;): void ...@@ -2624,7 +2639,7 @@ close(callback: AsyncCallback&lt;void&gt;): void
**示例:** **示例:**
```js ```js
let ss= fileio.createStreamSync(path); let ss= fileio.createStreamSync(path, "r+");
ss.close(function (err) { ss.close(function (err) {
// do something // do something
}); });
...@@ -2641,7 +2656,7 @@ closeSync(): void ...@@ -2641,7 +2656,7 @@ closeSync(): void
**示例:** **示例:**
```js ```js
let ss= fileio.createStreamSync(path); let ss= fileio.createStreamSync(path, "r+");
ss.closeSync(); ss.closeSync();
``` ```
...@@ -2661,7 +2676,7 @@ flush(): Promise&lt;void&gt; ...@@ -2661,7 +2676,7 @@ flush(): Promise&lt;void&gt;
**示例:** **示例:**
```js ```js
let ss= fileio.createStreamSync(path); let ss= fileio.createStreamSync(path, "r+");
ss.flush().then(function (){ ss.flush().then(function (){
console.info("flush succeed"); console.info("flush succeed");
}).catch(function(err){ }).catch(function(err){
...@@ -2685,7 +2700,7 @@ flush(callback: AsyncCallback&lt;void&gt;): void ...@@ -2685,7 +2700,7 @@ flush(callback: AsyncCallback&lt;void&gt;): void
**示例:** **示例:**
```js ```js
let ss= fileio.createStreamSync(path); let ss= fileio.createStreamSync(path, "r+");
ss.flush(function (err) { ss.flush(function (err) {
// do something // do something
}); });
...@@ -2702,7 +2717,7 @@ flushSync(): void ...@@ -2702,7 +2717,7 @@ flushSync(): void
**示例:** **示例:**
```js ```js
let ss= fileio.createStreamSync(path); let ss= fileio.createStreamSync(path, "r+");
ss.flushSync(); ss.flushSync();
``` ```
...@@ -2733,7 +2748,7 @@ write(buffer: ArrayBuffer | string, options?: { ...@@ -2733,7 +2748,7 @@ write(buffer: ArrayBuffer | string, options?: {
**示例:** **示例:**
```js ```js
let ss= fileio.createStreamSync(fpath, "r+"); let ss= fileio.createStreamSync(path, "r+");
ss.write("hello, world",{offset: 1,length: 5,position: 5,encoding :'utf-8'}).then(function (number){ ss.write("hello, world",{offset: 1,length: 5,position: 5,encoding :'utf-8'}).then(function (number){
console.info("write succeed and size is:"+ number); console.info("write succeed and size is:"+ number);
}).catch(function(err){ }).catch(function(err){
...@@ -2764,7 +2779,7 @@ write(buffer: ArrayBuffer | string, options: { ...@@ -2764,7 +2779,7 @@ write(buffer: ArrayBuffer | string, options: {
**示例:** **示例:**
```js ```js
let ss= fileio.createStreamSync(fpath, "r+"); let ss= fileio.createStreamSync(path, "r+");
ss.write("hello, world", {offset: 1, length: 5, position: 5, encoding :'utf-8'}, function (err, bytesWritten) { ss.write("hello, world", {offset: 1, length: 5, position: 5, encoding :'utf-8'}, function (err, bytesWritten) {
if (bytesWritten) { if (bytesWritten) {
// do something // do something
...@@ -2800,7 +2815,7 @@ writeSync(buffer: ArrayBuffer | string, options?: { ...@@ -2800,7 +2815,7 @@ writeSync(buffer: ArrayBuffer | string, options?: {
**示例:** **示例:**
```js ```js
let ss= fileio.createStreamSync(fpath,"r+"); let ss= fileio.createStreamSync(path,"r+");
let num = ss.writeSync("hello, world", {offset: 1, length: 5, position: 5, encoding :'utf-8'}); let num = ss.writeSync("hello, world", {offset: 1, length: 5, position: 5, encoding :'utf-8'});
``` ```
...@@ -2830,7 +2845,7 @@ read(buffer: ArrayBuffer, options?: { ...@@ -2830,7 +2845,7 @@ read(buffer: ArrayBuffer, options?: {
**示例:** **示例:**
```js ```js
let ss = fileio.createStreamSync(fpath, "r+"); let ss = fileio.createStreamSync(path, "r+");
ss.read(new ArrayBuffer(4096), {offset: 1, length: 5, position: 5}).then(function (readout){ ss.read(new ArrayBuffer(4096), {offset: 1, length: 5, position: 5}).then(function (readout){
console.info("read data succeed"); console.info("read data succeed");
console.log(String.fromCharCode.apply(null, new Uint8Array(readOut.buffer))); console.log(String.fromCharCode.apply(null, new Uint8Array(readOut.buffer)));
...@@ -2861,7 +2876,7 @@ read(buffer: ArrayBuffer, options: { ...@@ -2861,7 +2876,7 @@ read(buffer: ArrayBuffer, options: {
**示例:** **示例:**
```js ```js
let ss = fileio.createStreamSync(fpath, "r+"); let ss = fileio.createStreamSync(path, "r+");
ss.read(new ArrayBuffer(4096),{offset: 1, length: 5, position: 5},function (err, readOut) { ss.read(new ArrayBuffer(4096),{offset: 1, length: 5, position: 5},function (err, readOut) {
if (readOut) { if (readOut) {
console.info("read data succeed"); console.info("read data succeed");
...@@ -2898,7 +2913,7 @@ readSync(buffer: ArrayBuffer, options?: { ...@@ -2898,7 +2913,7 @@ readSync(buffer: ArrayBuffer, options?: {
**示例:** **示例:**
```js ```js
let ss = fileio.createStreamSync(fpath, "r+"); let ss = fileio.createStreamSync(path, "r+");
let num = ss.readSync(new ArrayBuffer(4096), {offset: 1, length: 5, position: 5}); let num = ss.readSync(new ArrayBuffer(4096), {offset: 1, length: 5, position: 5});
``` ```
......
...@@ -20,18 +20,18 @@ getRoot(options? : {dev? : DevInfo}) : Promise&lt;FileInfo[]&gt; ...@@ -20,18 +20,18 @@ getRoot(options? : {dev? : DevInfo}) : Promise&lt;FileInfo[]&gt;
**系统能力**:SystemCapability.FileManagement.UserFileService **系统能力**:SystemCapability.FileManagement.UserFileService
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | -- | | --- | --- | --- | -- |
| options | Object | 否 | 支持如下选项:<br/>-&nbsp;dev,[DevInfo](#devinfo)类型,不填默认dev = {name: "local"}, 当前仅支持设备'local' | | options | Object | 否 | 支持如下选项:<br/>-&nbsp;dev,[DevInfo](#devinfo)类型,不填默认dev = {name: "local"}, 当前仅支持设备'local' |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --- | -- | | --- | -- |
| Promise&lt;[FileInfo](#fileinfo)[]&gt; | 第一层目录相册信息 | | Promise&lt;[FileInfo](#fileinfo)[]&gt; | 第一层目录相册信息 |
- 示例 **示例:**
```js ```js
filemanager.getRoot().then((fileInfo) => { filemanager.getRoot().then((fileInfo) => {
...@@ -53,22 +53,22 @@ getRoot(options? : {dev? : DevInfo}, callback : AsyncCallback&lt;FileInfo[]&gt;) ...@@ -53,22 +53,22 @@ getRoot(options? : {dev? : DevInfo}, callback : AsyncCallback&lt;FileInfo[]&gt;)
**系统能力**:SystemCapability.FileManagement.UserFileService **系统能力**:SystemCapability.FileManagement.UserFileService
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ----------------------------- | | -------- | ------------------------- | ---- | ----------------------------- |
| options | Object | 否 | 支持如下选项:<br/>-&nbsp;dev,[DevInfo](#devinfo)类型,不填默认dev = {name: "local"}, 当前仅支持设备'local' | | options | Object | 否 | 支持如下选项:<br/>-&nbsp;dev,[DevInfo](#devinfo)类型,不填默认dev = {name: "local"}, 当前仅支持设备'local' |
| callback | AsyncCallback&lt;[FileInfo](#fileinfo)[]&gt; | 是 | 异步获取文件的信息之后的回调 | | callback | AsyncCallback&lt;[FileInfo](#fileinfo)[]&gt; | 是 | 异步获取文件的信息之后的回调 |
- 示例 **示例:**
```js ```js
let option = { let options = {
"dev":{ "dev":{
name:"", "name":"local"
} }
}; };
filemanager.getRoot(option,(err, fileInfo)=>{ filemanager.getRoot(options, (err, fileInfo)=>{
if(Array.isArray(fileInfo)) { if(Array.isArray(fileInfo)) {
for (var i = 0; i < fileInfo.length; i++) { for (var i = 0; i < fileInfo.length; i++) {
console.log("file:"+JSON.stringify(fileInfo)); console.log("file:"+JSON.stringify(fileInfo));
...@@ -86,27 +86,28 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num ...@@ -86,27 +86,28 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num
**系统能力**:SystemCapability.FileManagement.UserFileService **系统能力**:SystemCapability.FileManagement.UserFileService
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | -- | | --- | --- | --- | -- |
| path | string | 是 | 待查询目录uri | | path | string | 是 | 待查询目录uri |
| type | string | 是 | 待查询文件类型, 支持以下类型 "file", "image", "audio", "video" | | type | string | 是 | 待查询文件类型, 支持以下类型 "file", "image", "audio", "video" |
| options | Object | 否 | 支持如下选项:<br/>-&nbsp;dev,[DevInfo](#devinfo)类型,不填默认dev = {name: "local"}, 当前仅支持设备'local'。<br/>-&nbsp;offset,number类型,待查询文件偏移个数。<br/>-&nbsp;count,number类型,待查询文件个数。 | | options | Object | 否 | 支持如下选项:<br/>-&nbsp;dev,[DevInfo](#devinfo)类型,不填默认dev = {name: "local"}, 当前仅支持设备'local'。<br/>-&nbsp;offset,number类型,待查询文件偏移个数。<br/>-&nbsp;count,number类型,待查询文件个数。 |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --- | -- | | --- | -- |
| Promise&lt;FileInfo[]&gt; | 文件信息 | | Promise&lt;FileInfo[]&gt; | 文件信息 |
- 异常 **异常:**
| 错误名称 | 错误类型 | 错误码 |说明 | | 错误名称 | 错误类型 | 错误码 |说明 |
| --- | -- | --- | -- | | --- | -- | --- | -- |
| 对应的目录、相册不存在 | No such file or directory | 2 | uri对应的目录、相册不存在 | | 对应的目录、相册不存在 | No such file or directory | 2 | uri对应的目录、相册不存在 |
| 获取FMS服务失败 | No such process | 3 | 获取FMS服务失败 | | 获取FMS服务失败 | No such process | 3 | 获取FMS服务失败 |
| path对应uri不是相册、目录 | Not a directory | 20 | path对应uri不是相册、目录 | | path对应uri不是相册、目录 | Not a directory | 20 | path对应uri不是相册、目录 |
- 示例 **示例:**
```js ```js
// 获取目录下所有文件 // 获取目录下所有文件
...@@ -120,10 +121,7 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num ...@@ -120,10 +121,7 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num
} }
} }
}).catch((err) => { }).catch((err) => {
console.log("failed to get file"+err);
console.log(err)
}); });
``` ```
...@@ -135,23 +133,24 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num ...@@ -135,23 +133,24 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num
**系统能力**:SystemCapability.FileManagement.UserFileService **系统能力**:SystemCapability.FileManagement.UserFileService
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ------------------------------------------------------------ | | -------- | ------------------------- | ---- | ------------------------------------------------------------ |
| path | string | 是 | 待查询目录uri | | path | string | 是 | 待查询目录uri |
| type | string | 是 | 待查询文件类型, 支持以下类型 "file", "image", "audio", "video" | | type | string | 是 | 待查询文件类型, 支持以下类型 "file", "image", "audio", "video" |
| options | Object | 否 | 支持如下选项:<br/>-&nbsp;dev,[DevInfo](#devinfo)类型,不填默认dev = {name: "local"}, 当前仅支持设备'local'。<br/>-&nbsp;offset,number类型,待查询文件偏移个数。<br/>-&nbsp;count,number类型,待查询文件个数。 | | options | Object | 否 | 支持如下选项:<br/>-&nbsp;dev,[DevInfo](#devinfo)类型,不填默认dev = {name: "local"}, 当前仅支持设备'local'。<br/>-&nbsp;offset,number类型,待查询文件偏移个数。<br/>-&nbsp;count,number类型,待查询文件个数。 |
| callback | AsyncCallback&lt;[FileInfo](#fileinfo)[]&gt; | 是 | 异步获取文件的信息之后的回调 | | callback | AsyncCallback&lt;[FileInfo](#fileinfo)[]&gt; | 是 | 异步获取文件的信息之后的回调 |
- 异常
| 错误名称 | 错误类型 | 错误码 | 说明 | **异常:**
| ------------------------- | ------------------------- | ------ | ------------------------- |
| 对应的目录、相册不存在 | No such file or directory | 2 | uri对应的目录、相册不存在 | | 错误名称 | 错误类型 | 错误码 | 说明 |
| 获取FMS服务失败 | No such process | 3 | 获取FMS服务失败 | | ------------------------- | ------------------------- | ------ | ------------------------- |
| path对应uri不是相册、目录 | Not a directory | 20 | path对应uri不是相册、目录 | | 对应的目录、相册不存在 | No such file or directory | 2 | uri对应的目录、相册不存在 |
| 获取FMS服务失败 | No such process | 3 | 获取FMS服务失败 |
| path对应uri不是相册、目录 | Not a directory | 20 | path对应uri不是相册、目录 |
- 示例 **示例:**
```js ```js
// 通过listFile、getRoot获取的文件path // 通过listFile、getRoot获取的文件path
...@@ -177,7 +176,7 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num ...@@ -177,7 +176,7 @@ listFile(path : string, type : string, options? : {dev? : DevInfo, offset? : num
} }
} }
}).catch((err) => { }).catch((err) => {
console.log(err) console.log("failed to get file"+err);
}); });
``` ```
...@@ -189,20 +188,21 @@ createFile(path : string, filename : string, options? : {dev? : DevInfo}) : P ...@@ -189,20 +188,21 @@ createFile(path : string, filename : string, options? : {dev? : DevInfo}) : P
**系统能力**:SystemCapability.FileManagement.UserFileService **系统能力**:SystemCapability.FileManagement.UserFileService
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | -- | | --- | --- | --- | -- |
| filename | string | 是 | 待创建的文件名 | | filename | string | 是 | 待创建的文件名 |
| path | string | 是 | 待保存目的相册uri | | path | string | 是 | 待保存目的相册uri |
| options | Object | 否 | 支持如下选项:<br/>-&nbsp;dev,[DevInfo](#devinfo)类型,不填默认dev = {name: "local"}, 当前仅支持设备'local' | | options | Object | 否 | 支持如下选项:<br/>-&nbsp;dev,[DevInfo](#devinfo)类型,不填默认dev = {name: "local"}, 当前仅支持设备'local' |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --- | -- | | --- | -- |
| string | 文件uri | | Promise&lt;string&gt; | 文件uri |
**异常:**
- 异常
| 错误名称 | 错误类型 | 错误码 |说明 | | 错误名称 | 错误类型 | 错误码 |说明 |
| --- | -- | --- | -- | | --- | -- | --- | -- |
| 创建文件不允许 | Operation not permitted | 1 | 已有重名文件 | | 创建文件不允许 | Operation not permitted | 1 | 已有重名文件 |
...@@ -210,7 +210,7 @@ createFile(path : string, filename : string, options? : {dev? : DevInfo}) : P ...@@ -210,7 +210,7 @@ createFile(path : string, filename : string, options? : {dev? : DevInfo}) : P
| 获取FMS服务失败 | No such process | 3 | 获取FMS服务失败 | | 获取FMS服务失败 | No such process | 3 | 获取FMS服务失败 |
| path对应uri不是相册、目录 | Not a directory | 20 | path对应uri不是相册、目录 | | path对应uri不是相册、目录 | Not a directory | 20 | path对应uri不是相册、目录 |
- 示例 **示例:**
```js ```js
// 创建文件,返回文件uri // 创建文件,返回文件uri
...@@ -232,7 +232,7 @@ createFile(path : string, filename: string, options? : {dev? : DevInfo}, callbac ...@@ -232,7 +232,7 @@ createFile(path : string, filename: string, options? : {dev? : DevInfo}, callbac
**系统能力**:SystemCapability.FileManagement.UserFileService **系统能力**:SystemCapability.FileManagement.UserFileService
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------- | ---- | ----------------------------- | | -------- | ------------------------- | ---- | ----------------------------- |
...@@ -241,7 +241,7 @@ createFile(path : string, filename: string, options? : {dev? : DevInfo}, callbac ...@@ -241,7 +241,7 @@ createFile(path : string, filename: string, options? : {dev? : DevInfo}, callbac
| options | Object | 否 | 支持如下选项:<br/>-&nbsp;dev,[DevInfo](#devinfo)类型,不填默认dev = {name: "local"}, 当前仅支持设备'local' | | options | Object | 否 | 支持如下选项:<br/>-&nbsp;dev,[DevInfo](#devinfo)类型,不填默认dev = {name: "local"}, 当前仅支持设备'local' |
| callback | AsyncCallback&lt;[FileInfo](#fileinfo)[]&gt; | 是 | 异步获取文件的信息之后的回调 | | callback | AsyncCallback&lt;[FileInfo](#fileinfo)[]&gt; | 是 | 异步获取文件的信息之后的回调 |
- 异常 **异常:**
| 错误名称 | 错误类型 | 错误码 | 说明 | | 错误名称 | 错误类型 | 错误码 | 说明 |
| ------------------------- | ------------------------- | ------ | ------------------------- | | ------------------------- | ------------------------- | ------ | ------------------------- |
...@@ -250,7 +250,7 @@ createFile(path : string, filename: string, options? : {dev? : DevInfo}, callbac ...@@ -250,7 +250,7 @@ createFile(path : string, filename: string, options? : {dev? : DevInfo}, callbac
| 获取FMS服务失败 | No such process | 3 | 获取FMS服务失败 | | 获取FMS服务失败 | No such process | 3 | 获取FMS服务失败 |
| path对应uri不是相册、目录 | Not a directory | 20 | path对应uri不是相册、目录 | | path对应uri不是相册、目录 | Not a directory | 20 | path对应uri不是相册、目录 |
- 示例 **示例:**
```js ```js
// 创建文件,返回文件uri // 创建文件,返回文件uri
...@@ -258,11 +258,15 @@ createFile(path : string, filename: string, options? : {dev? : DevInfo}, callbac ...@@ -258,11 +258,15 @@ createFile(path : string, filename: string, options? : {dev? : DevInfo}, callbac
let media_path = "" let media_path = ""
// 待保存文件的后缀 // 待保存文件的后缀
let name = "xxx.jpg" let name = "xxx.jpg"
let dev = ""; let options = {
filemanager.createFile(media_path, name, { DevInfo: dev }, function(err, uri) { "dev":{
// 返回uri给应用 "name":"local"
}
};
filemanager.createFile(media_path, name, options, function(err, uri) {
// 返回uri给应用
console.log("file uri:"+uri); console.log("file uri:"+uri);
}); });
``` ```
......
...@@ -1141,7 +1141,7 @@ getStringByNameSync(resName: string): string ...@@ -1141,7 +1141,7 @@ getStringByNameSync(resName: string): string
resourceManager.getStringByNameSync("test"); resourceManager.getStringByNameSync("test");
``` ```
### getBoolean<sup>9+</sup> ### getBoolean<sup>9+</sup>
getBoolean(resId: number): boolean getBoolean(resId: number): boolean
...@@ -1187,7 +1187,7 @@ getBooleanByName(resName: string): boolean ...@@ -1187,7 +1187,7 @@ getBooleanByName(resName: string): boolean
resourceManager.getBooleanByName("boolean_test"); resourceManager.getBooleanByName("boolean_test");
``` ```
### getNumber<sup>9+</sup> ### getNumber<sup>9+</sup>
getNumber(resId: number): number getNumber(resId: number): number
......
...@@ -13,7 +13,7 @@ ...@@ -13,7 +13,7 @@
import storageStatistics from "@ohos.storageStatistics"; import storageStatistics from "@ohos.storageStatistics";
``` ```
## storagestatistics.getTotalSizeOfVolume ## storageStatistics.getTotalSizeOfVolume
getTotalSizeOfVolume(volumeUuid: string): Promise&lt;number&gt; getTotalSizeOfVolume(volumeUuid: string): Promise&lt;number&gt;
...@@ -23,32 +23,34 @@ getTotalSizeOfVolume(volumeUuid: string): Promise&lt;number&gt; ...@@ -23,32 +23,34 @@ getTotalSizeOfVolume(volumeUuid: string): Promise&lt;number&gt;
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 参数
**参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ---- | | ---------- | ------ | ---- | ---- |
| volumeUuid | string | 是 | 卷id | | volumeUuid | string | 是 | 卷id |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ---------------- | | --------------------- | ---------------- |
| Promise&lt;number&gt; | 返回指定卷总空间 | | Promise&lt;number&gt; | 返回指定卷总空间 |
- 示例 **示例:**
```js ```js
let uuid = ""; let uuid = "";
storagestatistics.getTotalSizeOfVolume(uuid).then(function(number){ storageStatistics.getTotalSizeOfVolume(uuid).then(function(number){
console.info("getTotalSizeOfVolume successfully:"+ number); console.info("getTotalSizeOfVolume successfully:"+ number);
}).catch(function(err){ }).catch(function(err){
console.info("getTotalSizeOfVolume failed with error:"+ err); console.info("getTotalSizeOfVolume failed with error:"+ err);
}); });
``` ```
## storagestatistics.getTotalSizeOfVolume ## storageStatistics.getTotalSizeOfVolume
getTotalSizeOfVolume(volumeUuid: string, callback:AsyncCallback&lt;number&gt;):void getTotalSizeOfVolume(volumeUuid: string, callback:AsyncCallback&lt;number&gt;):void
...@@ -58,28 +60,28 @@ getTotalSizeOfVolume(volumeUuid: string, callback:AsyncCallback&lt;number&gt;):v ...@@ -58,28 +60,28 @@ getTotalSizeOfVolume(volumeUuid: string, callback:AsyncCallback&lt;number&gt;):v
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 参数
**参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------ | ---- | -------------------------- | | ---------- | ------------------------------------ | ---- | -------------------------- |
| volumeUuid | string | 是 | 卷id | | volumeUuid | string | 是 | 卷id |
| callback | callback:AsyncCallback&lt;number&gt; | 是 | 获取指定卷总空间之后的回调 | | callback | callback:AsyncCallback&lt;number&gt; | 是 | 获取指定卷总空间之后的回调 |
- 示例 **示例:**
```js ```js
let uuid = ""; let uuid = "";
storagestatistics.getTotalSizeOfVolume(uuid, function(error, number){ storageStatistics.getTotalSizeOfVolume(uuid, function(error, number){
// do something // do something
console.info("getTotalSizeOfVolume successfully:"+ number); console.info("getTotalSizeOfVolume successfully:"+ number);
}); });
``` ```
## storagestatistics.getFreeSizeOfVolume ## storageStatistics.getFreeSizeOfVolume
getFreeSizeOfVolume(volumeUuid: string): Promise&lt;number&gt; getFreeSizeOfVolume(volumeUuid: string): Promise&lt;number&gt;
...@@ -89,25 +91,27 @@ getFreeSizeOfVolume(volumeUuid: string): Promise&lt;number&gt; ...@@ -89,25 +91,27 @@ getFreeSizeOfVolume(volumeUuid: string): Promise&lt;number&gt;
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 参数
**参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ---- | | ---------- | ------ | ---- | ---- |
| volumeUuid | string | 是 | 卷id | | volumeUuid | string | 是 | 卷id |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ------------------ | | --------------------- | ------------------ |
| Promise&lt;number&gt; | 返回指定卷可用空间 | | Promise&lt;number&gt; | 返回指定卷可用空间 |
- 示例 **示例:**
```js ```js
let uuid = ""; let uuid = "";
storagestatistics.getFreeSizeOfVolume(uuid).then(function(number){ storageStatistics.getFreeSizeOfVolume(uuid).then(function(number){
console.info("getFreeSizeOfVolume successfully:"+ number); console.info("getFreeSizeOfVolume successfully:"+ number);
}).catch(function(err){ }).catch(function(err){
console.info("getFreeSizeOfVolume failed with error:"+ err); console.info("getFreeSizeOfVolume failed with error:"+ err);
...@@ -115,7 +119,7 @@ getFreeSizeOfVolume(volumeUuid: string): Promise&lt;number&gt; ...@@ -115,7 +119,7 @@ getFreeSizeOfVolume(volumeUuid: string): Promise&lt;number&gt;
``` ```
## storagestatistics.getFreeSizeOfVolume ## storageStatistics.getFreeSizeOfVolume
getFreeSizeOfVolume(volumeUuid: string, callback:AsyncCallback&lt;number&gt;):void getFreeSizeOfVolume(volumeUuid: string, callback:AsyncCallback&lt;number&gt;):void
...@@ -125,26 +129,28 @@ getFreeSizeOfVolume(volumeUuid: string, callback:AsyncCallback&lt;number&gt;):vo ...@@ -125,26 +129,28 @@ getFreeSizeOfVolume(volumeUuid: string, callback:AsyncCallback&lt;number&gt;):vo
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 参数
**参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------ | ---- | ---------------------------- | | ---------- | ------------------------------------ | ---- | ---------------------------- |
| volumeUuid | string | 是 | 卷id | | volumeUuid | string | 是 | 卷id |
| callback | callback:AsyncCallback&lt;number&gt; | 是 | 获取指定卷可用空间之后的回调 | | callback | callback:AsyncCallback&lt;number&gt; | 是 | 获取指定卷可用空间之后的回调 |
- 示例 **示例:**
```js ```js
let uuid = ""; let uuid = "";
storagestatistics.getFreeSizeOfVolume(uuid, function(error, number){ storageStatistics.getFreeSizeOfVolume(uuid, function(error, number){
// do something // do something
console.info("getFreeSizeOfVolume successfully:"+ number); console.info("getFreeSizeOfVolume successfully:"+ number);
}); });
``` ```
## storagestatistics.getBundleStats<sup>9+</sup> ## storageStatistics.getBundleStats<sup>9+</sup>
getBundleStats(packageName: string): Promise&lt;BundleStats&gt; getBundleStats(packageName: string): Promise&lt;BundleStats&gt;
...@@ -154,32 +160,34 @@ getBundleStats(packageName: string): Promise&lt;BundleStats&gt; ...@@ -154,32 +160,34 @@ getBundleStats(packageName: string): Promise&lt;BundleStats&gt;
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 参数
**参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | -------- | | ----------- | ------ | ---- | -------- |
| packageName | string | 是 | 应用包名 | | packageName | string | 是 | 应用包名 |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------------------------------ | -------------------------- | | ------------------------------------------ | -------------------------- |
| Promise&lt;[Bundlestats](#bundlestats)&gt; | 返回指定卷上的应用存储数据 | | Promise&lt;[Bundlestats](#bundlestats)&gt; | 返回指定卷上的应用存储数据 |
- 示例 **示例:**
```js ```js
let packageName = ""; let packageName = "";
storagestatistics.getBundleStats(packageName).then(function(BundleStats){ storageStatistics.getBundleStats(packageName).then(function(BundleStats){
console.info("getBundleStats successfully:"+ JSON.stringify(BundleStats)); console.info("getBundleStats successfully:"+ JSON.stringify(BundleStats));
}).catch(function(err){ }).catch(function(err){
console.info("getBundleStats failed with error:"+ err); console.info("getBundleStats failed with error:"+ err);
}); });
``` ```
## storagestatistics.getBundleStats<sup>9+</sup> ## storageStatistics.getBundleStats<sup>9+</sup>
getBundleStats(packageName: string, callback: AsyncCallback&lt;BundleStats&gt;): void getBundleStats(packageName: string, callback: AsyncCallback&lt;BundleStats&gt;): void
...@@ -189,28 +197,28 @@ getBundleStats(packageName: string, callback: AsyncCallback&lt;BundleStats&gt;) ...@@ -189,28 +197,28 @@ getBundleStats(packageName: string, callback: AsyncCallback&lt;BundleStats&gt;)
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 参数
**参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------------------------- | ---- | ------------------------------------ | | -------- | --------------------------------------------------------- | ---- | ------------------------------------ |
| packageName | string | 是 | 应用包名 | | packageName | string | 是 | 应用包名 |
| callback | callback:AsyncCallback&lt;[Bundlestats](#bundlestats)&gt; | 是 | 获取指定卷上的应用存储数据之后的回调 | | callback | callback:AsyncCallback&lt;[Bundlestats](#bundlestats)&gt; | 是 | 获取指定卷上的应用存储数据之后的回调 |
- 示例 **示例:**
```js ```js
let packageName = ""; let packageName = "";
storagestatistics.getBundleStats(packageName, function(error, BundleStats){ storageStatistics.getBundleStats(packageName, function(error, BundleStats){
// do something // do something
console.info("getBundleStats successfully:"+ JSON.stringify(BundleStats)); console.info("getBundleStats successfully:"+ JSON.stringify(BundleStats));
}); });
``` ```
## storageStatistics.getCurrentBundleStats<sup>9+</sup>
## storagestatistics.getCurrentBundleStats<sup>9+</sup>
getCurrentBundleStats(): Promise&lt;BundleStats&gt; getCurrentBundleStats(): Promise&lt;BundleStats&gt;
...@@ -218,50 +226,51 @@ getCurrentBundleStats(): Promise&lt;BundleStats&gt; ...@@ -218,50 +226,51 @@ getCurrentBundleStats(): Promise&lt;BundleStats&gt;
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ------------------------------------------ | -------------------------- | | ------------------------------------------ | -------------------------- |
| Promise&lt;[Bundlestats](#bundlestats)&gt; | 返回指定卷上的应用存储状态 | | Promise&lt;[Bundlestats](#bundlestats)&gt; | 返回指定卷上的应用存储状态 |
- 示例 **示例:**
```js ```js
let bundleStats = storageStatistics.getCurrentBundleStats(); let bundleStats = storageStatistics.getCurrentBundleStats();
console.info("getCurrentBundleStats successfully:"+ JSON.stringify(bundleStats)); console.info("getCurrentBundleStats successfully:"+ JSON.stringify(bundleStats));
``` ```
## storagestatistics.getCurrentBundleStats<sup>9+</sup> ## storageStatistics.getCurrentBundleStats<sup>9+</sup>
getCurrentBundleStats(callback: AsyncCallback&lt;BundleStats&gt;): void getCurrentBundleStats(callback: AsyncCallback&lt;BundleStats&gt;): void
第三方应用异步获取占用空间,以callback方式返回。 第三方应用异步获取占用空间,以callback方式返回。
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------------------------- | ---- | ------------------------------------ | | -------- | --------------------------------------------------------- | ---- | ------------------------------------ |
| callback | callback:AsyncCallback&lt;[BundleStats](#bundlestats)&gt; | 是 | 获取指定卷上的应用存储状态之后的回调 | | callback | callback:AsyncCallback&lt;[BundleStats](#bundlestats)&gt; | 是 | 获取指定卷上的应用存储状态之后的回调 |
- 示例 **示例:**
```js ```js
storagestatistics.getCurrentBundleStats(function(error, bundleStats){ storageStatistics.getCurrentBundleStats(function(error, bundleStats){
// do something // do something
console.info("getCurrentBundleStats successfully:"+ JSON.stringify(bundleStats)); console.info("getCurrentBundleStats successfully:"+ JSON.stringify(bundleStats));
}); });
``` ```
## BundleStats<sup>9+</sup> ## BundleStats<sup>9+</sup>
**系统能力**:以下各项对应的系统能力均为SystemCapability.FileManagement.StorageService.SpatialStatistics。<br> **系统能力**:以下各项对应的系统能力均为SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 属性
### 属性
| 名称 | 类型 | 说明 | | 名称 | 类型 | 说明 |
| --------- | ------ | -------------- | | --------- | ------ | -------------- |
...@@ -270,9 +279,7 @@ getCurrentBundleStats(callback: AsyncCallback&lt;BundleStats&gt;): void ...@@ -270,9 +279,7 @@ getCurrentBundleStats(callback: AsyncCallback&lt;BundleStats&gt;): void
| dataSize | number | 应用总数据大小 | | dataSize | number | 应用总数据大小 |
## storageStatistics.getTotalSize<sup>9+</sup>
## storagestatistics.getTotalSize<sup>9+</sup>
getTotalSize(): Promise&lt;number&gt; getTotalSize(): Promise&lt;number&gt;
...@@ -282,22 +289,24 @@ getTotalSize(): Promise&lt;number&gt; ...@@ -282,22 +289,24 @@ getTotalSize(): Promise&lt;number&gt;
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 返回值
**返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ------------------ | | --------------------- | ------------------ |
| Promise&lt;number&gt; | 返回内卡的总空间大小 | | Promise&lt;number&gt; | 返回内卡的总空间大小 |
- 示例 **示例:**
```js ```js
let number = storageStatistics.getTotalSize(); let number = storageStatistics.getTotalSize();
console.info("getTotalSize successfully:"+ JSON.stringify(number)); console.info("getTotalSize successfully:"+ JSON.stringify(number));
``` ```
## storagestatistics.getTotalSize<sup>9+</sup> ## storageStatistics.getTotalSize<sup>9+</sup>
getTotalSize(callback: AsyncCallback&lt;number&gt;): void getTotalSize(callback: AsyncCallback&lt;number&gt;): void
...@@ -307,25 +316,27 @@ getTotalSize(callback: AsyncCallback&lt;number&gt;): void ...@@ -307,25 +316,27 @@ getTotalSize(callback: AsyncCallback&lt;number&gt;): void
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 参数
**参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------ | ---- | ------------------------ | | -------- | ------------------------------------ | ---- | ------------------------ |
| callback | callback:AsyncCallback&lt;number&gt; | 是 | 获取内卡的总空间大小之后的回调 | | callback | callback:AsyncCallback&lt;number&gt; | 是 | 获取内卡的总空间大小之后的回调 |
- 示例 **示例:**
```js ```js
storagestatistics.getTotalSize(function(error, number){ storageStatistics.getTotalSize(function(error, number){
// do something // do something
console.info("getTotalSize successfully:"+ JSON.stringify(number)); console.info("getTotalSize successfully:"+ JSON.stringify(number));
}); });
``` ```
## storagestatistics.getFreeSize<sup>9+</sup> ## storageStatistics.getFreeSize<sup>9+</sup>
getFreeSize(): Promise&lt;number&gt; getFreeSize(): Promise&lt;number&gt;
...@@ -335,23 +346,25 @@ getFreeSize(): Promise&lt;number&gt; ...@@ -335,23 +346,25 @@ getFreeSize(): Promise&lt;number&gt;
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 返回值
**返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ------------------ | | --------------------- | ------------------ |
| Promise&lt;number&gt; | 返回内卡的可用空间大小 | | Promise&lt;number&gt; | 返回内卡的可用空间大小 |
- 示例 **示例:**
```js ```js
let number = storageStatistics.getFreeSize(); let number = storageStatistics.getFreeSize();
console.info("getFreeSize successfully:"+ JSON.stringify(number)); console.info("getFreeSize successfully:"+ JSON.stringify(number));
``` ```
## storagestatistics.getFreeSize<sup>9+</sup> ## storageStatistics.getFreeSize<sup>9+</sup>
getFreeSize(callback: AsyncCallback&lt;number&gt;): void getFreeSize(callback: AsyncCallback&lt;number&gt;): void
...@@ -361,26 +374,26 @@ getFreeSize(callback: AsyncCallback&lt;number&gt;): void ...@@ -361,26 +374,26 @@ getFreeSize(callback: AsyncCallback&lt;number&gt;): void
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 参数
**参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------ | ---- | ------------------------- | | -------- | ------------------------------------ | ---- | ------------------------- |
| callback | callback:AsyncCallback&lt;number&gt; | 是 | 获取内卡的可用空间大小之后的回调 | | callback | callback:AsyncCallback&lt;number&gt; | 是 | 获取内卡的可用空间大小之后的回调 |
- 示例 **示例:**
```js ```js
storagestatistics.getFreeSize(function(error, number){ storageStatistics.getFreeSize(function(error, number){
// do something // do something
console.info("getFreeSize successfully:"+ JSON.stringify(number)); console.info("getFreeSize successfully:"+ JSON.stringify(number));
}); });
``` ```
## storageStatistics.getSystemSize<sup>9+</sup>
## storagestatistics.getSystemSize<sup>9+</sup>
getSystemSize(): Promise&lt;number&gt; getSystemSize(): Promise&lt;number&gt;
...@@ -390,25 +403,27 @@ getSystemSize(): Promise&lt;number&gt; ...@@ -390,25 +403,27 @@ getSystemSize(): Promise&lt;number&gt;
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 返回值
**返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ---------------- | | --------------------- | ---------------- |
| Promise&lt;number&gt; | 返回系统空间大小 | | Promise&lt;number&gt; | 返回系统空间大小 |
- 示例 **示例:**
```js ```js
storagestatistics.getSystemSize().then(function(number){ storageStatistics.getSystemSize().then(function(number){
console.info("getSystemSize successfully:"+ number); console.info("getSystemSize successfully:"+ number);
}).catch(function(err){ }).catch(function(err){
console.info("getSystemSize failed with error:"+ err); console.info("getSystemSize failed with error:"+ err);
}); });
``` ```
## storagestatistics.getSystemSize<sup>9+</sup> ## storageStatistics.getSystemSize<sup>9+</sup>
getSystemSize(callback:AsyncCallback&lt;number&gt;):void getSystemSize(callback:AsyncCallback&lt;number&gt;):void
...@@ -418,28 +433,28 @@ getSystemSize(callback:AsyncCallback&lt;number&gt;):void ...@@ -418,28 +433,28 @@ getSystemSize(callback:AsyncCallback&lt;number&gt;):void
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 参数
**参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------ | ---- | -------------------------- | | ---------- | ------------------------------------ | ---- | -------------------------- |
| callback | callback:AsyncCallback&lt;number&gt; | 是 | 获取系统空间大小之后的回调 | | callback | callback:AsyncCallback&lt;number&gt; | 是 | 获取系统空间大小之后的回调 |
- 示例 **示例:**
```js ```js
storagestatistics.getSystemSize(function(error, number){ storageStatistics.getSystemSize(function(error, number){
// do something // do something
console.info("getSystemSize successfully:"+ number); console.info("getSystemSize successfully:"+ number);
}); });
``` ```
## storagestatistics.getUserStorageStats<sup>9+</sup>
getUserStorageStats(userId: number): Promise&lt;StorageStats&gt; ## storageStatistics.getUserStorageStats<sup>9+</sup>
getUserStorageStats(userId? : number): Promise&lt;StorageStats&gt;
异步获取用户各类别数据大小,以promise方式返回。 异步获取用户各类别数据大小,以promise方式返回。
...@@ -447,32 +462,34 @@ getUserStorageStats(userId: number): Promise&lt;StorageStats&gt; ...@@ -447,32 +462,34 @@ getUserStorageStats(userId: number): Promise&lt;StorageStats&gt;
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 参数
**参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------ | ---- | ---- | | ---------- | ------ | ---- | ---- |
| userId | string | 否 | 用户id <br/>确认当前用户:<br/>-&nbsp;有值:表示指定用户。<br/>-&nbsp;无值:表示当前用户。| | userId | string | 否 | 用户id <br/>确认当前用户:<br/>-&nbsp;有值:表示指定用户。<br/>-&nbsp;无值:表示当前用户。|
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ---------------- | | --------------------- | ---------------- |
| Promise&lt;[StorageStats](#StorageStats)&gt; | 返回各类别数据大小 | | Promise&lt;[StorageStats](#StorageStats)&gt; | 返回各类别数据大小 |
- 示例 **示例:**
```js ```js
let userId = ""; let userId = "";
storagestatistics.getUserStorageStats(userId).then(function(StorageStats){ storageStatistics.getUserStorageStats(userId).then(function(StorageStats){
console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats)); console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats));
}).catch(function(err){ }).catch(function(err){
console.info("getUserStorageStats failed with error:"+ err); console.info("getUserStorageStats failed with error:"+ err);
}); });
``` ```
## storagestatistics.getUserStorageStats<sup>9+</sup> ## storageStatistics.getUserStorageStats<sup>9+</sup>
getUserStorageStats(userId: number, callback:AsyncCallback&lt;StorageStats&gt;):void getUserStorageStats(userId: number, callback:AsyncCallback&lt;StorageStats&gt;):void
...@@ -482,32 +499,37 @@ getUserStorageStats(userId: number, callback:AsyncCallback&lt;StorageStats&gt;): ...@@ -482,32 +499,37 @@ getUserStorageStats(userId: number, callback:AsyncCallback&lt;StorageStats&gt;):
**系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics **系统能力**:SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 参数
**参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | ------------------------------------ | ---- | -------------------------- | | ---------- | ------------------------------------ | ---- | -------------------------- |
| userId | string | 否 | 用户id <br/>确认当前用户:<br/>-&nbsp;有值:表示指定用户。<br/>-&nbsp;无值:表示当前用户。 | | userId | string | 否 | 用户id <br/>确认当前用户:<br/>-&nbsp;有值:表示指定用户。<br/>-&nbsp;无值:表示当前用户。 |
| callback | callback:AsyncCallback&lt;[StorageStats](#StorageStats)&gt; | 是 | 返回各类别数据大小之后的回调 | | callback | callback:AsyncCallback&lt;[StorageStats](#StorageStats)&gt; | 是 | 返回各类别数据大小之后的回调 |
- 示例 **示例:**
```js ```js
let userId = ""; let userId = "";
storagestatistics.getUserStorageStats(userId, function(error, StorageStats){ storageStatistics.getUserStorageStats(userId, function(error, StorageStats){
// do something // do something
console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats)); console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats));
}); });
``` ```
## StorageStats<sup>9+</sup> ## StorageStats<sup>9+</sup>
**系统能力**:以下各项对应的系统能力均为SystemCapability.FileManagement.StorageService.SpatialStatistics。<br> **系统能力**:以下各项对应的系统能力均为SystemCapability.FileManagement.StorageService.SpatialStatistics
该接口为系统接口,三方应用不支持调用 该接口为系统接口,三方应用不支持调用
- 属性
### 属性
| 名称 | 类型 | 说明 | | 名称 | 类型 | 说明 |
| --------- | ------ | -------------- | | --------- | ------ | -------------- |
......
...@@ -24,13 +24,13 @@ getAllVolumes(): Promise&lt;Array&lt;Volume&gt;&gt; ...@@ -24,13 +24,13 @@ getAllVolumes(): Promise&lt;Array&lt;Volume&gt;&gt;
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------------- | -------------------------- | | ---------------------------------- | -------------------------- |
| Promise&lt;[Volume](#volume)[]&gt; | 返回当前所有可获得的卷信息 | | Promise&lt;[Volume](#volume)[]&gt; | 返回当前所有可获得的卷信息 |
- 示例 **示例:**
```js ```js
volumemanager.getAllVolumes().then(function(volumes){ volumemanager.getAllVolumes().then(function(volumes){
...@@ -48,13 +48,13 @@ getAllVolumes(callback: AsyncCallback&lt;Array&lt;Volume&gt;&gt;): void ...@@ -48,13 +48,13 @@ getAllVolumes(callback: AsyncCallback&lt;Array&lt;Volume&gt;&gt;): void
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------- | ---- | ------------------------------------ | | -------- | ------------------------------------------------- | ---- | ------------------------------------ |
| callback | callback:AsyncCallback&lt;[Volume](#volume)[]&gt; | 是 | 获取当前所有可获得的卷信息之后的回调 | | callback | callback:AsyncCallback&lt;[Volume](#volume)[]&gt; | 是 | 获取当前所有可获得的卷信息之后的回调 |
- 示例 **示例:**
```js ```js
let uuid = ""; let uuid = "";
...@@ -74,19 +74,19 @@ mount(volumeId: string): Promise&lt;boolean&gt; ...@@ -74,19 +74,19 @@ mount(volumeId: string): Promise&lt;boolean&gt;
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ---- | | -------- | ------ | ---- | ---- |
| volumeId | string | 是 | 卷id | | volumeId | string | 是 | 卷id |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------- | ---------- | | ---------------------- | ---------- |
| Promise&lt;boolean&gt; | 挂载指定卷 | | Promise&lt;boolean&gt; | 挂载指定卷 |
- 示例 **示例:**
```js ```js
let volumeId = ""; let volumeId = "";
...@@ -105,14 +105,14 @@ mount(volumeId: string, callback:AsyncCallback&lt;boolean&gt;):void ...@@ -105,14 +105,14 @@ mount(volumeId: string, callback:AsyncCallback&lt;boolean&gt;):void
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------- | ---- | -------------------- | | -------- | ------------------------------------- | ---- | -------------------- |
| volumeId | string | 是 | 卷id | | volumeId | string | 是 | 卷id |
| callback | callback:AsyncCallback&lt;boolean&gt; | 是 | 挂载指定卷之后的回调 | | callback | callback:AsyncCallback&lt;boolean&gt; | 是 | 挂载指定卷之后的回调 |
- 示例 **示例:**
```js ```js
let volumeId = ""; let volumeId = "";
...@@ -131,19 +131,19 @@ unmount(volumeId: string): Promise&lt;boolean&gt; ...@@ -131,19 +131,19 @@ unmount(volumeId: string): Promise&lt;boolean&gt;
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ---- | | -------- | ------ | ---- | ---- |
| volumeId | string | 是 | 卷id | | volumeId | string | 是 | 卷id |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------- | ---------- | | ---------------------- | ---------- |
| Promise&lt;boolean&gt; | 卸载指定卷 | | Promise&lt;boolean&gt; | 卸载指定卷 |
- 示例 **示例:**
```js ```js
let volumeId = ""; let volumeId = "";
...@@ -162,14 +162,14 @@ unmount(volumeId: string, callback:AsyncCallback&lt;boolean&gt;):void ...@@ -162,14 +162,14 @@ unmount(volumeId: string, callback:AsyncCallback&lt;boolean&gt;):void
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------- | ---- | -------------------- | | -------- | ------------------------------------- | ---- | -------------------- |
| volumeId | string | 是 | 卷id | | volumeId | string | 是 | 卷id |
| callback | callback:AsyncCallback&lt;boolean&gt; | 是 | 卸载指定卷之后的回调 | | callback | callback:AsyncCallback&lt;boolean&gt; | 是 | 卸载指定卷之后的回调 |
- 示例 **示例:**
```js ```js
let volumeId = ""; let volumeId = "";
...@@ -180,7 +180,7 @@ unmount(volumeId: string, callback:AsyncCallback&lt;boolean&gt;):void ...@@ -180,7 +180,7 @@ unmount(volumeId: string, callback:AsyncCallback&lt;boolean&gt;):void
## volumemanager.getVolumeByUuid ## volumemanager.getVolumeByUuid
getVolumeByUuid(uuid: string): Promise<Volume>; getVolumeByUuid(uuid: string): Promise&lt;Volume&gt;
异步通过uuid获得卷信息,以promise方式返回。 异步通过uuid获得卷信息,以promise方式返回。
...@@ -188,19 +188,19 @@ getVolumeByUuid(uuid: string): Promise<Volume>; ...@@ -188,19 +188,19 @@ getVolumeByUuid(uuid: string): Promise<Volume>;
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ---- | | -------- | ------ | ---- | ---- |
| uuid | string | 是 | 卷uuid | | uuid | string | 是 | 卷uuid |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------------- | -------------------------- | | ---------------------------------- | -------------------------- |
| Promise&lt;[Volume](#volume)&gt; | 返回当前所有可获得的卷信息 | | Promise&lt;[Volume](#volume)&gt; | 返回当前所有可获得的卷信息 |
- 示例 **示例:**
```js ```js
let uuid = ""; let uuid = "";
...@@ -209,7 +209,7 @@ getVolumeByUuid(uuid: string): Promise<Volume>; ...@@ -209,7 +209,7 @@ getVolumeByUuid(uuid: string): Promise<Volume>;
## volumemanager.getVolumeByUuid ## volumemanager.getVolumeByUuid
getVolumeByUuid(uuid: string, callback: AsyncCallback<Volume>): void; getVolumeByUuid(uuid: string, callback: AsyncCallback&lt;Volume&gt;): void
异步通过uuid获得卷信息,以callback方式返回。 异步通过uuid获得卷信息,以callback方式返回。
...@@ -217,14 +217,14 @@ getVolumeByUuid(uuid: string, callback: AsyncCallback<Volume>): void; ...@@ -217,14 +217,14 @@ getVolumeByUuid(uuid: string, callback: AsyncCallback<Volume>): void;
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------ | ---- | -------------------- | | -------- | ------------------------------------------------ | ---- | -------------------- |
| uuid | string | 是 | 卷uuid | | uuid | string | 是 | 卷uuid |
| callback | callback:AsyncCallback&lt;[Volume](#volume)&gt; | 是 | 获取卷信息之后的回调 | | callback | callback:AsyncCallback&lt;[Volume](#volume)&gt; | 是 | 获取卷信息之后的回调 |
- 示例 **示例:**
```js ```js
let uuid = ""; let uuid = "";
...@@ -235,7 +235,7 @@ getVolumeByUuid(uuid: string, callback: AsyncCallback<Volume>): void; ...@@ -235,7 +235,7 @@ getVolumeByUuid(uuid: string, callback: AsyncCallback<Volume>): void;
## volumemanager.getVolumeById ## volumemanager.getVolumeById
getVolumeById(id: string): Promise<Volume>; getVolumeById(id: string): Promise&lt;Volume&gt;
异步通过卷id获得卷信息,以promise方式返回。 异步通过卷id获得卷信息,以promise方式返回。
...@@ -243,19 +243,19 @@ getVolumeById(id: string): Promise<Volume>; ...@@ -243,19 +243,19 @@ getVolumeById(id: string): Promise<Volume>;
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ---- | | -------- | ------ | ---- | ---- |
| id | string | 是 | 卷id | | id | string | 是 | 卷id |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------------------- | -------------------------- | | ---------------------------------- | -------------------------- |
| Promise&lt;[Volume](#volume)&gt; | 返回当前所有可获得的卷信息 | | Promise&lt;[Volume](#volume)&gt; | 返回当前所有可获得的卷信息 |
- 示例 **示例:**
```js ```js
let id = ""; let id = "";
...@@ -264,7 +264,7 @@ getVolumeById(id: string): Promise<Volume>; ...@@ -264,7 +264,7 @@ getVolumeById(id: string): Promise<Volume>;
## volumemanager.getVolumeById ## volumemanager.getVolumeById
getVolumeById(id: string, callback: AsyncCallback<Volume>): void; getVolumeById(id: string, callback: AsyncCallback&lt;Volume&gt;): void
异步通过卷id获得卷信息,以callback方式返回。 异步通过卷id获得卷信息,以callback方式返回。
...@@ -272,14 +272,14 @@ getVolumeById(id: string, callback: AsyncCallback<Volume>): void; ...@@ -272,14 +272,14 @@ getVolumeById(id: string, callback: AsyncCallback<Volume>): void;
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ------------------------------------------------ | ---- | -------------------- | | -------- | ------------------------------------------------ | ---- | -------------------- |
| id | string | 是 | 卷id | | id | string | 是 | 卷id |
| callback | callback:AsyncCallback&lt;[Volume](#volume)&gt; | 是 | 获取卷信息之后的回调 | | callback | callback:AsyncCallback&lt;[Volume](#volume)&gt; | 是 | 获取卷信息之后的回调 |
- 示例 **示例:**
```js ```js
let id = ""; let id = "";
...@@ -290,7 +290,7 @@ getVolumeById(id: string, callback: AsyncCallback<Volume>): void; ...@@ -290,7 +290,7 @@ getVolumeById(id: string, callback: AsyncCallback<Volume>): void;
## volumemanager.setVolumeDescription ## volumemanager.setVolumeDescription
setVolumeDescription(uuid: string, description: string): Promise<void>; setVolumeDescription(uuid: string, description: string): Promise&lt;void&gt;
异步通过uuid设置卷描述,以promise方式返回。 异步通过uuid设置卷描述,以promise方式返回。
...@@ -298,20 +298,20 @@ setVolumeDescription(uuid: string, description: string): Promise<void>; ...@@ -298,20 +298,20 @@ setVolumeDescription(uuid: string, description: string): Promise<void>;
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| --------- | ------ | ---- | ---- | | --------- | ------ | ---- | ---- |
| uuid | string | 是 | 卷uuid | | uuid | string | 是 | 卷uuid |
| description | string | 是 | 卷描述 | | description | string | 是 | 卷描述 |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| ---------------------- | -------------------------- | | ---------------------- | -------------------------- |
| Promise&lt;void&gt; | 设置卷信息 | | Promise&lt;void&gt; | 设置卷信息 |
- 示例 **示例:**
```js ```js
let uuid = ""; let uuid = "";
...@@ -321,7 +321,7 @@ setVolumeDescription(uuid: string, description: string): Promise<void>; ...@@ -321,7 +321,7 @@ setVolumeDescription(uuid: string, description: string): Promise<void>;
## volumemanager.setVolumeDescription ## volumemanager.setVolumeDescription
function setVolumeDescription(uuid: string, description: string, callback: AsyncCallback<void>): void; setVolumeDescription(uuid: string, description: string, callback: AsyncCallback&lt;void&gt;): void
异步通过uuid设置卷描述,以callback方式返回。 异步通过uuid设置卷描述,以callback方式返回。
...@@ -329,7 +329,7 @@ function setVolumeDescription(uuid: string, description: string, callback: Async ...@@ -329,7 +329,7 @@ function setVolumeDescription(uuid: string, description: string, callback: Async
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ---------- | --------------------------------------- | ---- | ---------------- | | ---------- | --------------------------------------- | ---- | ---------------- |
...@@ -337,7 +337,7 @@ function setVolumeDescription(uuid: string, description: string, callback: Async ...@@ -337,7 +337,7 @@ function setVolumeDescription(uuid: string, description: string, callback: Async
| description | string | 是 | 卷描述 | | description | string | 是 | 卷描述 |
| callback | callback:AsyncCallback&lt;void&gt; | 是 | 设置卷描述之后的回调 | | callback | callback:AsyncCallback&lt;void&gt; | 是 | 设置卷描述之后的回调 |
- 示例 **示例:**
```js ```js
let uuid = ""; let uuid = "";
...@@ -349,7 +349,7 @@ function setVolumeDescription(uuid: string, description: string, callback: Async ...@@ -349,7 +349,7 @@ function setVolumeDescription(uuid: string, description: string, callback: Async
## volumemanager.format ## volumemanager.format
format(volId: string): Promise<void>; format(volId: string): Promise&lt;void&gt;
异步对指定卷进行格式化,以promise方式返回。 异步对指定卷进行格式化,以promise方式返回。
...@@ -357,19 +357,19 @@ format(volId: string): Promise<void>; ...@@ -357,19 +357,19 @@ format(volId: string): Promise<void>;
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---- | | ----------- | ------ | ---- | ---- |
| volId | string | 是 | 卷id | | volId | string | 是 | 卷id |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ----------------------- | | --------------------- | ----------------------- |
| Promise&lt;void&gt; | 对指定卷进行格式化 | | Promise&lt;void&gt; | 对指定卷进行格式化 |
- 示例 **示例:**
```js ```js
let volId = ""; let volId = "";
...@@ -378,7 +378,7 @@ format(volId: string): Promise<void>; ...@@ -378,7 +378,7 @@ format(volId: string): Promise<void>;
## volumemanager.format ## volumemanager.format
format(volId: string, callback: AsyncCallback<void>): void; format(volId: string, callback: AsyncCallback&lt;void&gt;): void
异步对指定卷进行格式化,以callback方式返回。 异步对指定卷进行格式化,以callback方式返回。
...@@ -386,14 +386,14 @@ format(volId: string, callback: AsyncCallback<void>): void; ...@@ -386,14 +386,14 @@ format(volId: string, callback: AsyncCallback<void>): void;
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------- | ---- | ---------------- | | -------- | --------------------------------------- | ---- | ---------------- |
| volId | string | 是 | 卷id | | volId | string | 是 | 卷id |
| callback | callback:AsyncCallback&lt;void&gt; | 是 | 对指定卷进行格式化 | | callback | callback:AsyncCallback&lt;void&gt; | 是 | 对指定卷进行格式化 |
- 示例 **示例:**
```js ```js
let volId = ""; let volId = "";
...@@ -404,7 +404,7 @@ format(volId: string, callback: AsyncCallback<void>): void; ...@@ -404,7 +404,7 @@ format(volId: string, callback: AsyncCallback<void>): void;
## volumemanager.partition ## volumemanager.partition
partition(volId: string, fstype: string): Promise<void>; partition(volId: string, fstype: string): Promise&lt;void&gt;
异步对磁盘进行分区,以promise方式返回。 异步对磁盘进行分区,以promise方式返回。
...@@ -412,20 +412,20 @@ partition(volId: string, fstype: string): Promise<void>; ...@@ -412,20 +412,20 @@ partition(volId: string, fstype: string): Promise<void>;
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
- 参数 **参数:**
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---- | | ----------- | ------ | ---- | ---- |
| volId | string | 是 | 卷所属的磁盘id | | volId | string | 是 | 卷所属的磁盘id |
| fstype | string | 是 | 分区类型 | | fstype | string | 是 | 分区类型 |
- 返回值 **返回值:**
| 类型 | 说明 | | 类型 | 说明 |
| --------------------- | ----------------------- | | --------------------- | ----------------------- |
| Promise&lt;void&gt; | 对磁盘进行分区 | | Promise&lt;void&gt; | 对磁盘进行分区 |
- 示例 **示例:**
```js ```js
let volId = ""; let volId = "";
...@@ -435,7 +435,7 @@ partition(volId: string, fstype: string): Promise<void>; ...@@ -435,7 +435,7 @@ partition(volId: string, fstype: string): Promise<void>;
## volumemanager.partition ## volumemanager.partition
partition(volId: string, fstype : string, callback: AsyncCallback<void>): void; partition(volId: string, fstype : string, callback: AsyncCallback&lt;void&gt;): void
异步对磁盘进行分区,以callback方式返回。 异步对磁盘进行分区,以callback方式返回。
...@@ -443,9 +443,7 @@ partition(volId: string, fstype : string, callback: AsyncCallback<void>): void; ...@@ -443,9 +443,7 @@ partition(volId: string, fstype : string, callback: AsyncCallback<void>): void;
**系统能力**:SystemCapability.FileManagement.StorageService.Volume **系统能力**:SystemCapability.FileManagement.StorageService.Volume
**参数:**
- 参数
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | --------------------------------------- | ---- | ---------------- | | -------- | --------------------------------------- | ---- | ---------------- |
...@@ -453,7 +451,7 @@ partition(volId: string, fstype : string, callback: AsyncCallback<void>): void; ...@@ -453,7 +451,7 @@ partition(volId: string, fstype : string, callback: AsyncCallback<void>): void;
| fstype | string | 是 | 分区类型 | | fstype | string | 是 | 分区类型 |
| callback | callback:AsyncCallback&lt;void&gt; | 是 | 对磁盘进行分区 | | callback | callback:AsyncCallback&lt;void&gt; | 是 | 对磁盘进行分区 |
- 示例 **示例:**
```js ```js
let volId = ""; let volId = "";
......
...@@ -120,14 +120,18 @@ zlib.unzipFile(inFile, outFile, options).then((data) => { ...@@ -120,14 +120,18 @@ zlib.unzipFile(inFile, outFile, options).then((data) => {
## Options ## Options
**系统能力:** SystemCapability.BundleManager.Zlib
| 参数名 | 类型 | 必填 | 说明 | | 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------- | ---- | --------------------------------------------------------- | | -------- | ---------------- | ---- | --------------------------------------------------------- |
| level | CompressLeve | 否 | [参考zip.CompressLevel枚举定义](#zip.CompressLevel) | | level | CompressLeve | 否 | [参考zip.CompressLevel枚举定义](#zip.CompressLevel) |
| memLevel | MemLevel | 否 | [参考zip.MemLevel枚举定义](#zip.MemLevel) | | memLevel | MemLevel | 否 | [参考zip.MemLevel枚举定义](#zip.MemLevel) |
| userId | CompressStrategy | 否 | [参考zip.CompressStrategy枚举定义](#zip.CompressStrategy) | | strategy | CompressStrategy | 否 | [参考zip.CompressStrategy枚举定义](#zip.CompressStrategy) |
## zip.MemLevel ## zip.MemLevel
**系统能力:** SystemCapability.BundleManager.Zlib
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ----------------- | ---- | -------------------------------- | | ----------------- | ---- | -------------------------------- |
| MEM_LEVEL_MIN | 1 | zip 接口在压缩过程中最小使用内存 | | MEM_LEVEL_MIN | 1 | zip 接口在压缩过程中最小使用内存 |
...@@ -136,6 +140,8 @@ zlib.unzipFile(inFile, outFile, options).then((data) => { ...@@ -136,6 +140,8 @@ zlib.unzipFile(inFile, outFile, options).then((data) => {
## zip.CompressLevel ## zip.CompressLevel
**系统能力:** SystemCapability.BundleManager.Zlib
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ---------------------------------- | ---- | ----------------- | | ---------------------------------- | ---- | ----------------- |
| COMPRESS_LEVEL_NO_COMPRESSION | 0 | 压缩率为0压缩等级 | | COMPRESS_LEVEL_NO_COMPRESSION | 0 | 压缩率为0压缩等级 |
...@@ -145,6 +151,8 @@ zlib.unzipFile(inFile, outFile, options).then((data) => { ...@@ -145,6 +151,8 @@ zlib.unzipFile(inFile, outFile, options).then((data) => {
## zip.CompressStrategy ## zip.CompressStrategy
**系统能力:** SystemCapability.BundleManager.Zlib
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ---------------------------------- | ---- | ------------------------ | | ---------------------------------- | ---- | ------------------------ |
| COMPRESS_STRATEGY_DEFAULT_STRATEGY | 0 | 常规数据策略 | | COMPRESS_STRATEGY_DEFAULT_STRATEGY | 0 | 常规数据策略 |
...@@ -155,6 +163,8 @@ zlib.unzipFile(inFile, outFile, options).then((data) => { ...@@ -155,6 +163,8 @@ zlib.unzipFile(inFile, outFile, options).then((data) => {
## zip.ErrorCode ## zip.ErrorCode
**系统能力:** SystemCapability.BundleManager.Zlib
| 名称 | 值 | 说明 | | 名称 | 值 | 说明 |
| ---------------- | ---- | ------------ | | ---------------- | ---- | ------------ |
| ERROR_CODE_OK | 0 | 函数调用成功 | | ERROR_CODE_OK | 0 | 函数调用成功 |
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册