用户在应用中选择下载非图片、视频类的文件后,在应用内可以看到文件已下载到"已下载"的目录下,但是进行查看,却找不到该路径和已经下载的文件。
但是对于图片、视频等媒体类型的文件,在应用内下载后,可以在用户的相册中看到对应的文件。
07-15 13:56:49.070 51395-51395 C01406/com.hm.example/OHOS::RS com.hm.example I RSUIDirector::PostTask messageId:78, cmdCount:2, instanceId:100000 07-15 13:56:49.172 51395-52404 C015B0/com.hm.example/NETSTACK com.hm.example I [http_exec.cpp:418] taskid=-2147483647, size:1179024, dns:0.079, connect:0.486, tls:0.000, firstSend:0.201, firstRecv:131.338, total:503.940, redirect:0.000, errCode:0, RespCode:200, httpVer:2, method:GET, osErr:0 07-15 13:56:49.174 51395-51395 C03F01/com.hm.example/NAPI com.hm.example I [(:467)(HandleTaskResultCallback)] taskpool:: Task PerformTask End: taskId : 394970511104, performResult : Successful 07-15 13:56:49.175 51395-51395 A03D00/com.hm.example/JSAPP com.hm.example I 沙箱路径 根路径已存在: /data/storage/el2/base/haps/entry/files 07-15 13:56:49.175 51395-51395 A03D00/com.hm.example/JSAPP com.hm.example I file exists 07-15 13:56:49.175 51395-51395 A03D00/com.hm.example/JSAPP com.hm.example I file exists 07-15 13:56:49.175 51395-51395 A03D00/com.hm.example/JSAPP com.hm.example I file exists 07-15 13:56:49.175 51395-51395 A03D00/com.hm.example/JSAPP com.hm.example I file exists 07-15 13:56:49.176 51395-51395 A03D00/com.hm.example/JSAPP com.hm.example I file exists
目录名 | Context属性名称 | 类型 | 说明 |
|---|---|---|---|
base | NA | 本设备文件路径 | 应用在本设备上存放持久化数据的目录,子目录包含files/、cache/、temp/和haps/;随应用卸载而清理。 |
通过调用DocumentViewPicker的save()接口保存文件并获得用户文件的uri,将此uri作为request.agent的config中的saveas字段值进行下载。核心步骤如下:
注意:config中的overwrite字段必须设置为true,表示允许覆盖已存在的同名文件;mode字段必须设置为request.agent.Mode.FOREGROUND,表示在前台执行下载任务。
import { BusinessError, request } from '@kit.BasicServicesKit';
import { picker } from '@kit.CoreFileKit';
import { common } from '@kit.AbilityKit';
@Entry
@Component
struct Index {
build() {
Row() {
Column() {
Button("下载文档").width("50%").margin({ top: 20 }).height(40).onClick(async () => {
// 创建文件管理器选项实例。
const documentSaveOptions = new picker.DocumentSaveOptions();
// 保存文件名(可选)。 默认为空。
documentSaveOptions.newFileNames = ["xxxx.txt"];
// 保存文件类型['后缀类型描述|后缀类型'],选择所有文件:'所有文件(*.*)|.*'(可选),如果选择项存在多个后缀(最大限制100个过滤后缀),默认选择第一个。如果不传该参数,默认无过滤后缀。
documentSaveOptions.fileSuffixChoices = ['文档|.txt', '.pdf'];
let uri: string = '';
// 请在组件内获取context,确保this.getUIContext().getHostContext()返回结果为UIAbilityContext
let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
const documentViewPicker = new picker.DocumentViewPicker(context);
await documentViewPicker.save(documentSaveOptions).then((documentSaveResult: Array<string>) => {
uri = documentSaveResult[0];
}).catch((err: BusinessError) => {
console.error(`Invoke documentViewPicker.save failed, code is ${err.code}, message is ${err.message}`);
});
if (uri != '') {
let config: request.agent.Config = {
action: request.agent.Action.DOWNLOAD,
url: 'https://xxxx/xxxx.txt',
// saveas字段是DocumentViewPicker保存的文件的uri
saveas: uri,
gauge: true,
// overwrite字段必须为true
overwrite: true,
network: request.agent.Network.WIFI,
// mode字段必须为request.agent.Mode.FOREGROUND
mode: request.agent.Mode.FOREGROUND,
};
try {
request.agent.create(context, config).then((task: request.agent.Task) => {
task.start((err: BusinessError) => {
if (err) {
console.error(`Failed to start the download task, Code: ${err.code} message: ${err.message}`);
return;
}
});
task.on('progress', async (progress) => {
console.warn(`Request download status ${progress.state}, downloaded ${progress.processed}`);
});
task.on('completed', async () => {
// 该方法需用户管理任务生命周期,任务结束后调用remove释放task对象
request.agent.remove(task.tid);
});
}).catch((err: BusinessError) => {
console.error(`Failed to operate a download task, Code: ${err.code}, message is ${err.message}`);
});
} catch (err) {
console.error(`Failed to create a download task, err: ${err}`);
}
}
})
}
.width('100%')
.alignItems(HorizontalAlign.Center)
}
}
} 在从网络下载文件到本地或将已有用户文件另存为新的文件路径等场景下,需要使用FilePicker提供的保存用户文件的能力。
详情请参考保存文档类文件。
Q:应用内下载文件后,如何跳转到文件所在目录以便转发到其他应用?
A:通过保存文档类文件的方式获取文件保存的uri,打印该uri即可获取文件路径。uri本身不具备跳转能力,需要通过拉起系统应用(如文件管理器或分享面板)并传递该uri来实现跳转或转发。可以使用openLink的方式打开,在openLink接口的link字段中传入系统文件管理页面的URL信息,具体请参考如何跳转到系统文件管理App界面。