HarmonyOS鸿蒙Next中获取用户手机download目录下文件

1、访问Download目录下的自己包名下的文件或文件夹

• 使用DOWNLOAD模式保存的文件，其URI已具备持久化权限，应用自身可通过系统已规划好的用户文件目录直接使用@ohos.file.fs (文件管理)的能力进行访问。
• 若需要访问其他公共目录，请使用FilePicker、授权持久化、申请使用受限权限。

示例代码_使用DOWNLOAD模式保存文件后进行访问：

import { fileIo as fs, fileUri, ListFileOptions } from '@kit.CoreFileKit';
import { bundleManager } from '@kit.AbilityKit';

@Entry
@Component
struct VisitDownloadDir {
  build() {
    Column({ space: 5 }) {
      Button('DOWNLOAD模式访问')
        .onClick(() => {
          // 获取bundleName
          let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION |
          bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_METADATA;
          let data = bundleManager.getBundleInfoForSelfSync(bundleFlags);
          console.info('getBundleInfoForSelfSync successfully: ', JSON.stringify(data));
          let bundleName = data.name;
          // 获取Download目录下应用包名对应的path
          let uri = 'file://docs/storage/Users/currentUser/Download/' + bundleName;
          let fileUriObject = new fileUri.FileUri(uri);
          let path = fileUriObject.path;
          // 递归遍历出目录下的文件,进行业务操作(保证目录下有文件)
          let listFileOption: ListFileOptions = {
            recursion: true,
          };
          let filenames = fs.listFileSync(path, listFileOption);
          for (let i = 0; i < filenames.length; i++) {
            let file: fs.File | null = null;
            try {
              file = fs.openSync(path + '/' + filenames[i], fs.OpenMode.READ_WRITE);
              console.info('file path is :', file.path);
            } catch (e) {
              console.error('fs.openSync failed error is : ', JSON.stringify(e));
            } finally {
              if (file !== null) {
                fs.closeSync(file);
              }
            }
          }
        })
    }
    .height('100%')
    .width('100%')
  }
}

2、通过 ArkTS 接口获取并访问公共目录【设备目录包含的所有】

• 目录环境能力接口（ohos.file.environment）提供获取公共目录路径的能力，支持三方应用在公共文件用户目录下进行文件访问操作。

  约束限制：

  • 使用此方式，需确认设备具有以下系统能力：SystemCapability.FileManagement.File.Environment.FolderObtain，当前仅支持2in1设备。

  权限申请：

  • 访问控制-向用户申请授权

  "requestPermissions" : [
      "ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY",
      "ohos.permission.READ_WRITE_DOCUMENTS_DIRECTORY",
  ]
  

示例代码_访问 Download 目录下的文件：

import { BusinessError } from '@kit.BasicServicesKit';
import { Environment } from '@kit.CoreFileKit';
import { fileIo as fs } from '@kit.CoreFileKit';
import { common } from '@kit.AbilityKit';

// 请在组件内获取context，确保this.getUIContext().getHostContext()返回结果为UIAbilityContext
let context = this.getUIContext().getHostContext() as common.UIAbilityContext;

function readUserDownloadDirExample(context: common.UIAbilityContext) {
    // 检查是否具有 READ_WRITE_DOWNLOAD_DIRECTORY 权限，无权限则需要向用户申请授予权限。
    try {
        // 获取 Download 目录
        const downloadPath = Environment.getUserDownloadDir();
        console.info(`success to getUserDownloadDir: ${downloadPath}`);
        const dirPath = context.filesDir;
        console.info(`success to get filesDir: ${dirPath}`);
        // 查看 Download 目录下的文件并拷贝到沙箱目录中
        let fileList: string[] = fs.listFileSync(downloadPath);
        fileList.forEach((file, index) => {
            console.info(`${downloadPath} ${index}: ${file}`);
            fs.copyFileSync(`${downloadPath}/${file}`, `${dirPath}/${file}`);
        });
        // 查看沙箱目录下对应的文件
        fileList = fs.listFileSync(dirPath);
        fileList.forEach((file, index) => {
            console.info(`${dirPath} ${index}: ${file}`);
        });
    } catch (error) {
        const err: BusinessError = error as BusinessError;
        console.error(`Error code: ${err.code}, message: ${err.message}`);
    }
}

相关文档：

• 【获取并使用公告目录】
• 【访问DOWNLOAD模式保存的文件】

在HarmonyOS Next中，获取用户手机download目录下的文件，需要使用@ohos.file.fs和@ohos.file.environment模块。首先通过environment.getExternalStoragePublicDirectory获取公共下载目录路径，然后使用fs.listFile列出目录中的文件。注意，应用需在module.json5中声明ohos.permission.READ_MEDIA权限。