From 5b69f2da5f81e4aec43aa85edc37ff5ed6043832 Mon Sep 17 00:00:00 2001 From: zhouoaoteng Date: Mon, 30 Jun 2025 21:22:07 +0800 Subject: [PATCH] add uri Signed-off-by: zhouoaoteng --- .../js-apis-file-backup-sys.md | 2 +- .../apis-core-file-kit/js-apis-file-fileuri.md | 18 +++++++++--------- .../js-apis-fileAccess-sys.md | 8 ++++---- 3 files changed, 14 insertions(+), 14 deletions(-) diff --git a/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-file-backup-sys.md b/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-file-backup-sys.md index 284e734b594..0b2b5d7b193 100644 --- a/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-file-backup-sys.md +++ b/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-file-backup-sys.md @@ -15,7 +15,7 @@ import backup from '@ohos.file.backup'; ## FileMeta -文件的元数据，包含一个应用名称以及文件uri。FileMeta在执行备份/恢复时是不可缺少的对象。 +文件的元数据，包含一个应用名称以及文件URI。FileMeta在执行备份/恢复时是不可缺少的对象。 **系统能力**：SystemCapability.FileManagement.StorageService.Backup diff --git a/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-file-fileuri.md b/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-file-fileuri.md index 21d30c4ad09..8b80ff4604b 100644 --- a/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-file-fileuri.md +++ b/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-file-fileuri.md @@ -34,8 +34,8 @@ import { fileUri } from '@kit.CoreFileKit'; | 名称 | 类型 | 必填 | 说明| | -------- | --------| -------- |----------------| -| path10+ | string | 是 | 将uri转换成对应的沙箱路径path。 1、uri转path过程中会将uri中存在的ASCII码进行解码后拼接在原处，非系统接口生成的uri中可能存在ASCII码解析范围之外的字符，导致字符串无法正常拼接；2、转换处理为系统约定的字符串替换规则（规则随系统演进可能会发生变化），转换过程中不进行路径校验操作，无法保证转换结果的一定可以访问。 | -| name10+ | string | 是 | 通过传入的uri获取到对应的文件名称。（如果文件名中存在ASCII码将会被解码处理后拼接在原处）
**原子化服务API**：从API version 15开始，该接口支持在原子化服务中使用。| +| path10+ | string | 是 | 将URI转换成对应的沙箱路径path。 1、URI转path过程中会将URI中存在的ASCII码进行解码后拼接在原处，非系统接口生成的URI中可能存在ASCII码解析范围之外的字符，导致字符串无法正常拼接；2、转换处理为系统约定的字符串替换规则（规则随系统演进可能会发生变化），转换过程中不进行路径校验操作，无法保证转换结果的一定可以访问。 | +| name10+ | string | 是 | 通过传入的URI获取到对应的文件名称。（如果文件名中存在ASCII码将会被解码处理后拼接在原处）
**原子化服务API**：从API version 15开始，该接口支持在原子化服务中使用。| ### constructor10+ @@ -51,7 +51,7 @@ constructor是FileUri的构造函数。 | 参数名 | 类型 | 必填 | 说明| | -------- | -------- | -------- |--------| -| uriOrPath | string | 是 | uri或路径。uri类型：
-  应用沙箱uri：file://\/\
-  公共目录文件类uri：file://docs/storage/Users/currentUser/\
-  公共目录媒体类uri：file://media/\/IMG_DATATIME_ID/\ | +| uriOrPath | string | 是 | URI或路径。URI类型：
-  应用沙箱URI：file://\/\
-  公共目录文件类URI：file://docs/storage/Users/currentUser/\
-  公共目录媒体类URI：file://media/\/IMG_DATATIME_ID/\ | **错误码：** @@ -98,11 +98,11 @@ toString(): string getFullDirectoryUri(): string -获取所在路径uri。uri指向文件则返回所在路径的uri，uri指向目录则不处理直接返回原串；uri指向的文件不存在或属性获取失败则返回空串。 +获取所在路径URI。URI指向文件则返回所在路径的URI，URI指向目录则不处理直接返回原串；URI指向的文件不存在或属性获取失败则返回空串。 -如果当前FileUri指向文件，将返回文件所在路径uri。如`xxx/example.txt`，将返回`xxx`。 +如果当前FileUri指向文件，将返回文件所在路径URI。如`xxx/example.txt`，将返回`xxx`。 -如果当前FileUri指向目录，将返回当前路径的uri。 +如果当前FileUri指向目录，将返回当前路径的URI。 **原子化服务API**：从API version 15开始，该接口支持在原子化服务中使用。 @@ -142,7 +142,7 @@ getFullDirectoryUri(): string isRemoteUri(): boolean -判断当前uri是否是远端uri。 +判断当前URI是否是远端URI。 **原子化服务API**：从API version 15开始，该接口支持在原子化服务中使用。 @@ -180,7 +180,7 @@ isRemoteUri(): boolean getUriFromPath(path: string): string -通过传入的路径path生成应用自己的uri；将path转uri时，路径中的中文及非数字字母的特殊字符将会被编译成对应的ASCII码，拼接在uri中。 +通过传入的路径path生成应用自己的URI；将path转URI时，路径中的中文及非数字字母的特殊字符将会被编译成对应的ASCII码，拼接在uri中。 **原子化服务API**：从API version 15开始，该接口支持在原子化服务中使用。 @@ -196,7 +196,7 @@ getUriFromPath(path: string): string | 类型 | 说明| | ------- |------| - | string | 通过传入的路径path生成应用自己的uri；将path转uri时，路径中的中文及非数字字母的特殊字符将会被编译成对应的ASCII码，拼接在uri中。 | + | string | 通过传入的路径path生成应用自己的URI；将path转URI时，路径中的中文及非数字字母的特殊字符将会被编译成对应的ASCII码，拼接在URI中。 | **错误码：** diff --git a/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-fileAccess-sys.md b/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-fileAccess-sys.md index 6d324dec8b0..819eb6f57bc 100644 --- a/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-fileAccess-sys.md +++ b/zh-cn/application-dev/reference/apis-core-file-kit/js-apis-fileAccess-sys.md @@ -409,7 +409,7 @@ next() : { value: FileInfo, done: boolean } | 名称 | 类型 | 只读 | 可选 | 说明 | | ------ | ------ | -------- | ------ | -------- | | deviceType | number | 否 | 否 |设备类型。 | -| uri | string | 否 | 否 | 设备根目录Uri。 | +| uri | string | 否 | 否 | 设备根目录uri。 | | relativePath10+ | string | 否 | 否 | 根目录的相对路径。 | | displayName | string | 否 | 否 | 设备名称。 | | deviceFlags | number | 否 | 否 | 设备支持的能力。 | @@ -693,7 +693,7 @@ createFile(uri: string, displayName: string) : Promise<string> | 参数名 | 类型 | 必填 | 说明 | | --- | --- | --- | -- | -| uri | string | 是 | 表示需要创建文件的父目录的Uri。 | +| uri | string | 是 | 表示需要创建文件的父目录的uri。 | | displayName | string | 是 | 待创建文件的名称。默认本地文件需要添加后缀。 | **返回值：** @@ -1392,7 +1392,7 @@ getFileInfoFromUri(uri: string) : Promise\ | 参数名 | 类型 | 必填 | 说明 | | --- | --- | --- | -- | -| uri | string | 是 | 文件(夹)的Uri。 | +| uri | string | 是 | 文件(夹)的uri。 | **返回值：** @@ -1436,7 +1436,7 @@ getFileInfoFromUri(uri: string, callback: AsyncCallback\) : void | 参数名 | 类型 | 必填 | 说明 | | --- | --- | --- | -- | -| uri | string | 是 | 文件(夹)的Uri。 | +| uri | string | 是 | 文件(夹)的uri。 | | callback | AsyncCallback<[FileInfo](#fileinfo)> | 是 | uri对应的FileInfo对象。 | **示例：** -- Gitee