UniApp 文件下载与上传的配置及使用指南

在 UniApp 开发中，文件的下载与上传是常见的需求。掌握它们的配置及使用方法，能极大提升应用的实用性和用户体验。

一、文件下载

首先是下载功能的实现。在 UniApp 里，使用 uni.downloadFile 方法来进行文件下载操作。

配置方面，需在 manifest.json 文件的 plus 节点下设置 permission 权限，添加 DOWNLOAD 权限声明，以确保应用具备下载文件的权限。

在代码中使用时，基本语法如下：

uni.downloadFile({
  url: '文件的网络地址', // 要下载的文件的链接
  success: (res) => {
    if (res.statusCode === 200) {
      console.log('下载成功', res.tempFilePath);
      // res.tempFilePath 为临时文件路径，可用于后续操作，如保存到本地等
    }
  },
  fail: (err) => {
    console.error('下载失败', err);
  }
});

这里的 url 是必填项，指向要下载的文件地址。success 回调函数在下载成功时触发，fail 则在下载失败时执行。

二、文件上传

对于文件上传，UniApp 提供了 uni.uploadFile 方法。

同样要在 manifest.json 中配置权限，在 plus 节点下添加 UPLOAD 权限声明。

代码实现如下：

uni.chooseFile({
  count: 1, // 最多选多少个文件
  success: (res) => {
    const tempFilePaths = res.tempFilePaths;
    uni.uploadFile({
      url: '上传接口地址', // 服务器接收文件的接口
      filePath: tempFilePaths[0], // 要上传的文件路径
      name: 'file', // 服务器端接收文件的字段名
      success: (uploadRes) => {
        if (uploadRes.statusCode === 200) {
          console.log('上传成功', uploadRes.data);
        }
      },
      fail: (err) => {
        console.error('上传失败', err);
      }
    });
  }
});

先使用 uni.chooseFile 让用户选择要上传的文件，获取到文件的临时路径后，再通过 uni.uploadFile 将文件上传至服务器。url 是服务器接收文件的接口地址，filePath 为要上传的文件路径，name 是服务器端接收文件的字段名。

掌握 UniApp 文件下载与上传的配置及使用，能满足应用在数据交互等方面的多种需求，助力开发者打造功能更完善的应用程序。