From 70547ce4c16c83b9a51f78db8c998d5af50702d6 Mon Sep 17 00:00:00 2001 From: junyi233 Date: Wed, 30 Aug 2023 11:30:37 +0800 Subject: [PATCH] =?UTF-8?q?=E8=B5=84=E6=96=99=E4=B8=80=E8=87=B4=E6=80=A7?= =?UTF-8?q?=E6=95=B4=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: junyi233 --- .../reference/apis/js-apis-appControl.md | 6 +- .../reference/apis/js-apis-bundleManager.md | 10 ++-- .../reference/apis/js-apis-zlib.md | 56 +++++++++++++++++-- 3 files changed, 58 insertions(+), 14 deletions(-) diff --git a/zh-cn/application-dev/reference/apis/js-apis-appControl.md b/zh-cn/application-dev/reference/apis/js-apis-appControl.md index 4727e13554..4350c950da 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-appControl.md +++ b/zh-cn/application-dev/reference/apis/js-apis-appControl.md @@ -124,7 +124,7 @@ try { } ``` -## appControl.setDisposedStatusSync +## appControl.setDisposedStatusSync10+ setDisposedStatusSync(appId: string, disposedWant: Want): void; @@ -273,7 +273,7 @@ try { } ``` -## appControl.getDisposedStatusSync +## appControl.getDisposedStatusSync10+ getDisposedStatusSync(appId: string): Want; @@ -425,7 +425,7 @@ try { } ``` -## appControl.deleteDisposedStatusSync +## appControl.deleteDisposedStatusSync10+ deleteDisposedStatusSync(appId: string) : void diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md index 9a0a121305..9901a03e35 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager.md @@ -1183,7 +1183,7 @@ try { } ``` -### bundleManager.queryAbilityInfoSync +### bundleManager.queryAbilityInfoSync10+ queryAbilityInfoSync(want: Want, abilityFlags: [number](#abilityflag), userId?: number): Array\<[AbilityInfo](js-apis-bundleManager-abilityInfo.md)>; @@ -1470,7 +1470,7 @@ try { } ``` -### bundleManager.queryExtensionAbilityInfoSync +### bundleManager.queryExtensionAbilityInfoSync10+ queryExtensionAbilityInfoSync(want: Want, extensionAbilityType: [ExtensionAbilityType](#extensionabilitytype), extensionAbilityFlags: [number](#extensionabilityflag), userId?: number): Array\<[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)>; @@ -2792,7 +2792,7 @@ try { ``` -### bundleManager.getLaunchWantForBundleSync +### bundleManager.getLaunchWantForBundleSync10+ getLaunchWantForBundleSync(bundleName: string, userId?: number): Want; @@ -3333,7 +3333,7 @@ try { } ``` -### bundleManager.getPermissionDefSync +### bundleManager.getPermissionDefSync10+ getPermissionDefSync(permissionName: string): [PermissionDef](js-apis-bundleManager-permissionDef.md); @@ -3498,7 +3498,7 @@ try { } ``` -### bundleManager.getAbilityLabelSync +### bundleManager.getAbilityLabelSync10+ getAbilityLabelSync(bundleName: string, moduleName: string, abilityName: string): string; diff --git a/zh-cn/application-dev/reference/apis/js-apis-zlib.md b/zh-cn/application-dev/reference/apis/js-apis-zlib.md index 7d388c9072..7c54a25e2a 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-zlib.md +++ b/zh-cn/application-dev/reference/apis/js-apis-zlib.md @@ -221,9 +221,7 @@ try { } ``` - - -## zlib.decompressFile9+ +## zlib.decompressFile10+ decompressFile(inFile: string, outFile: string, options: Options, callback: AsyncCallback\): void; @@ -237,8 +235,8 @@ decompressFile(inFile: string, outFile: string, options: Options, callback: Asyn | ----------------------- | ------------------- | ---- | ------------------------------------------------------------ | | inFile | string | 是 | 指定的待解压缩文件的文件路径，文件后缀需要以.zip结尾。文件路径必须为沙箱路径，沙箱路径可以通过context获取，可参考[FA模型](js-apis-inner-app-context.md)，[Stage模型](js-apis-inner-application-context.md)。 | | outFile | string | 是 | 指定的解压后的文件夹路径，文件夹目录路径需要在系统中存在，不存在则会解压失败。路径必须为沙箱路径，沙箱路径可以通过context获取，具体方法可参考[application/context（Stage模型）](js-apis-inner-application-context.md)或 [app/context（FA模型）](js-apis-inner-app-context.md)。如果待解压的文件或文件夹在解压后的路径下已经存在，则会直接覆盖同名文件或同名文件夹中的同名文件。 | -| options | [Options](#options) | 否 | 解压的配置参数。 | -| AsyncCallback<**void**> | callback | 否 | 解压的回调函数。 | +| options | [Options](#options) | 是 | 解压的配置参数。 | +| AsyncCallback<**void**> | callback | 是 | 解压的回调函数。 | **错误码：** @@ -275,7 +273,7 @@ try { ## zlib.decompressFile9+ -decompressFile(inFile: string, outFile: string, options: Options): Promise\; +decompressFile(inFile: string, outFile: string, options?: Options): Promise\; 解压文件，解压的结果通过promise返回，成功时返回null，失败时返回错误码。 @@ -320,6 +318,52 @@ try { } ``` +## zlib.decompressFile10+ + +decompressFile(inFile: string, outFile: string, callback: AsyncCallback\): void; + +解压文件，解压的结果通过callback返回，成功时返回null，失败时返回错误码。 + +**系统能力：** SystemCapability.BundleManager.Zlib + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| ----------------------- | ------------------- | ---- | ------------------------------------------------------------ | +| inFile | string | 是 | 指定的待解压缩文件的文件路径，文件后缀需要以.zip结尾。文件路径必须为沙箱路径，沙箱路径可以通过context获取，可参考[FA模型](js-apis-inner-app-context.md)，[Stage模型](js-apis-inner-application-context.md)。 | +| outFile | string | 是 | 指定的解压后的文件夹路径，文件夹目录路径需要在系统中存在，不存在则会解压失败。路径必须为沙箱路径，沙箱路径可以通过context获取，具体方法可参考[application/context（Stage模型）](js-apis-inner-application-context.md)或 [app/context（FA模型）](js-apis-inner-app-context.md)。如果待解压的文件或文件夹在解压后的路径下已经存在，则会直接覆盖同名文件或同名文件夹中的同名文件。 | +| AsyncCallback<**void**> | callback | 是 | 解压的回调函数。 | + +**错误码：** + +以下错误码的详细介绍请参见[ohos.zlib错误码](../errorcodes/errorcode-zlib.md)。 + +| 错误码ID | 错误信息 | +| -------- | --------------------------------------| +| 900001 | The input source file is invalid. | +| 900002 | The input destination file is invalid. | +| 900003 | The input source file is not ZIP format or damaged. | + +**示例** + +```typescript +// 【解压缩 例子1】 +// 代码中使用的路径需为应用的沙箱路径，如/data/storage/el2/base/haps,也可以通过context获取 +import zlib from '@ohos.zlib'; +let inFile = '/xx/xxx.zip'; +let outFileDir = '/xxx'; + +try { + zlib.decompressFile(inFile, outFileDir, (errData) => { + if (errData !== null) { + console.log(`errData is errCode:${errData.code} message:${errData.message}`); + } + }) +} catch(errData) { + console.log(`errData is errCode:${errData.code} message:${errData.message}`); +} +``` + ## Options **系统能力：** SystemCapability.BundleManager.Zlib -- GitLab