HarmonyOS 应用下载网络文件保存到本地公共目录

在日常开发中，文件下载是一个非常常见的业务场景。无论是从远程服务器获取资源，还是将用户生成的内容保存到本地，文件下载功能都是不可或缺的。本文将详细介绍如何实现文件下载功能，并深入解析相关的API使用方法，帮助开发者更好地理解和掌握这一技术。

---

1. 数据请求：@ohos.net.http 模块

文件下载的第一步是从远程服务器获取文件数据。@ohos.net.http 模块提供了HTTP数据请求的能力，支持常见的HTTP方法，如GET、POST、PUT、DELETE等。在发起HTTP请求之前，必须先创建一个 HttpRequest 实例。每个 HttpRequest 对象对应一个HTTP请求。如果需要发起多个HTTP请求，必须为每个请求创建对应的 HttpRequest 对象。

1.1 发起HTTP请求

通过 http.createHttp().request(url) 方法，可以根据URL地址发起HTTP网络请求。该方法返回一个 HttpResponse 对象，其中包含了服务器返回的状态码、响应头以及响应体等信息。

1.2 获取文件数据

在文件下载场景中，通常使用GET方法请求文件数据。服务器返回的文件数据通常以二进制形式（如 ArrayBuffer）存储在 HttpResponse.result 中。

示例代码

const response: http.HttpResponse = await http.createHttp().request(url);
if (response.responseCode === http.ResponseCode.OK) {
   
   
    const arrayBuffer: ArrayBuffer = response.result as ArrayBuffer;
} else {
   
   
    promptAction.showToast({
   
    message: '文件下载失败' });
}

在上述代码中，我们首先发起HTTP请求，然后检查响应状态码是否为 OK（即200）。如果请求成功，将响应体中的二进制数据存储到 arrayBuffer 中；如果请求失败，则提示用户“文件下载失败”。

---

2. 文件保存路径选择：@ohos.file.picker 模块

文件下载的第二步是确定文件的保存路径。@ohos.file.picker 模块提供了文件选择和保存的能力。本文使用 DocumentSaveOptions 和 DocumentViewPicker API 来实现文件保存路径的选择。

2.1 DocumentSaveOptions（文档保存选项）

DocumentSaveOptions 用于配置文件保存的相关选项，例如文件保存的默认路径、文件名、文件后缀等。开发者可以根据需求选择将文件保存到默认的下载目录，或者让用户自定义保存路径。

• 默认下载目录示例：

const documentSaveOptions =