HarmonyOS鸿蒙Next中真机为啥保存文档后不能再文件管理中查看

【问题现象】

应用内已完成下载的文件，在系统文件管理器中无法找到。

【背景知识】

1. 下载接口与权限要求

• 下载接口：开发者可通过ohos.request（上传下载模块）将网络资源下载到应用文件目录，需配合ohos.file.fs（基础文件 IO 接口）访问文件，仅支持下载至应用文件目录。
• 必备权限：使用ohos.request模块需声明权限ohos.permission.INTERNET。

2. 两种公共目录存储方案（解决文件可见性问题）

HarmonyOS 提供两种将文件存储到公共目录的方案，差异如下表：

【修改建议】（推荐接入下载控件）

1. 核心思路
   1. 通过接入下载控件，将文件下载至公共目录 “下载> xx 应用”，确保文件管理器可见，同时保留长期读写权限。
2. 参考代码核心逻辑
   1. 代码基于 ArkTS 编写，支持两种下载交互方式，核心功能如下：

• 方式一：系统标准下载 icon 控件：使用DownloadFileButton组件，自带标准下载图标与文本，点击触发下载；
• 方式二：三方自定义下载界面：通过自定义 Button，点击后调用DocumentViewPicker.saveAPI 触发下载。

import picker from '@ohos.file.picker';
import fs from '@ohos.file.fs';
import { BusinessError } from '@ohos.base';
import common from '@ohos.app.ability.common';
import FileUri from '@ohos.file.fileuri';
import {
  DownloadDescription,
  DownloadFileButton,
  DownloadIconStyle,
  DownloadLayoutDirection
} from '@ohos.arkui.advanced.DownloadFileButton';

const documentSaveOptions = new picker.DocumentSaveOptions();
documentSaveOptions.pickerMode = picker.DocumentPickerMode.DOWNLOAD;

@Entry
@Component
struct Index {
  @State message: string = 'Hello World';
  @State text: string = '';
  controller: TextInputController = new TextInputController();
  private constUri: string = '';

  build() {
    Row() {
      Column() {
        Text('方式一： 使用ICON控件')
          .fontSize(20)
          .border({ width: 1 })
          .borderRadius(10)
          .lineHeight(28)
          .margin(30)
        Row() {
          Text('输入文件名： ')
            .fontSize(20)
            .border({ width: 1 })
            .borderRadius(10)
            .lineHeight(28)
            .margin(10)
          TextInput({ text: this.text, placeholder: 'examples.doc', controller: this.controller })
            .placeholderColor(Color.Grey)
            .placeholderFont({ size: 20, weight: 150 })
            .caretColor(Color.Blue)
            .width('50%')
            .height(40)
            .margin(30)
            .fontSize(16)
            .fontColor(Color.Black)
            .onChange((value: string) => {
              this.text = value
            })
        }

        // 标准下载icon控件
        DownloadFileButton({
          contentOptions: {
            // 指定元素内容下载按钮
            icon: DownloadIconStyle.FULL_FILLED,
            text: DownloadDescription.DOWNLOAD
          },
          styleOptions: {
            // 指定元素样式的下载按钮
            iconSize: '20vp',
            layoutDirection: DownloadLayoutDirection.VERTICAL,
            fontSize: '16vp',
            fontStyle: FontStyle.Normal,
            fontWeight: FontWeight.Medium,
            fontFamily: 'HarmonyOS Sans',
            fontColor: '#ffffffff',
            iconColor: '#ffffffff',
            textIconSpace: '4vp'
          }
        })// .backgroundColor('#007dff')
          .onClick(() => {
            this.downloadAction();
          })

        Text('方式二： 使用DocumentViewPicker')
          .fontSize(20)
          .border({ width: 1 })
          .borderRadius(10)
          .lineHeight(28)
          .margin(30)
        Row() {
          Text('输入文件名： ')
            .fontSize(20)
            .border({ width: 1 })
            .borderRadius(10)
            .lineHeight(28)
            .margin(10)
          TextInput({ text: this.text, placeholder: 'examples.doc', controller: this.controller })
            .placeholderColor(Color.Grey)
            .placeholderFont({ size: 20, weight: 150 })
            .caretColor(Color.Blue)
            .width('50%')
            .height(40)
            .margin(30)
            .fontSize(16)
            .fontColor(Color.Black)
            .onChange((value: string) => {
              this.text = value
            })
        }

        // 三方自定义框架的下载界面
        Button("下载")
          .onClick(() => {
            this.downloadAction();
          })
      }
      .width('100%')
    }
    .height('100%')
    .backgroundColor($r('sys.color.ohos_id_color_sub_background'))
  }

  downloadAction() {
    let filePath = new FileUri.FileUri(this.constUri).path;
    filePath = filePath.replace('/data/storage/el2/share/rw/docs', '');
    console.error(`this.constUri: ` + this.constUri + filePath);
    // 判断应用专属目录是否存在
    if (!fs.accessSync(filePath)) {
      // 不存在拉起弹窗,创建应用专属目录,返回uri
      this.creatFolderAndGrant();
    } else {
      // 存在则将文件保存在该URI下
      this.writeFileInFolder(this.constUri);
    }
  }

  creatFolderAndGrant() {
    let context = getContext(this) as common.Context;
    const documentViewPicker = new picker.DocumentViewPicker(context);
    // 创建文件管理器选项实例
    const documentSaveOptions = new picker.DocumentSaveOptions();
    // 配置保存的模式为DOWNLOAD
    documentSaveOptions.pickerMode = picker.DocumentPickerMode.DOWNLOAD;
    // save接口拉起弹窗，点击同意，返回应用专属目录uri
    documentViewPicker.save(documentSaveOptions).then((documentSaveResult: Array<string>) => {
      console.error(`documentViewPicker ` + documentSaveResult[0]);
      let uri = documentSaveResult[0];
      // 保存应用专属目录uri，后续用户可以直接将文件保存在该URI下
      this.constUri = uri;
    }).catch((err: BusinessError) => {
      console.error(`Invoke documentViewPicker.save failed, code is ${err.code}, message is ${err.message}`);
    })
  }

  async writeFileInFolder(uri: string) {
    try {
      let path: string = new FileUri.FileUri(uri).path
      let filePath: string = `${path}/${this.text}`;

      // 测试权限并创建
      const testCreateFile = await fs.open(filePath, fs.OpenMode.CREATE)
        .catch((err: string) => console.error(`Invoke documentViewPicker.save failed`));
      if (testCreateFile) {
        fs.closeSync(testCreateFile.fd);
      }
      let fileContent = 'Hello, world!';
      let createRes: fs.File | BusinessError = fs.openSync(filePath, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE);
      fs.writeSync(createRes.fd, fileContent);
      fs.closeSync(createRes);
    } catch (err) {
      console.error(`create file failed, code is ${err.code}, message is ${err.message}`);
    }
  }
}

核心函数说明：

1. downloadAction()：判断应用专属目录是否存在，不存在则创建目录，存在则写入文件；
2. creatFolderAndGrant()：调用DocumentViewPicker拉起弹窗，创建应用专属目录并获取 URI；
3. writeFileInFolder(uri: string)：将文件内容写入指定目录，实现文件保存。

可以参考一下https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/save-user-file# 保存文档类文件