通过文件管理器使用三方应用对文件进行读写

场景描述：

我们经常通过文件管理器使用三方应用对文件进行读写，具体该如下。

场景一：

从文件管理器打开文件，选择三方应用打开。

后缀名	MIMEType
txt	text/plain
xlsx	application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
png	image/png
mp3	audio/mpeg
java	text/x-java

1 、应用需要在module.json5配置文件的actions标签的值配置为"ohos.want.action.viewData"，表示接收应用分享文件，配置uris字段，表示接收URI的类型，即只接收其他应用分享该类型的URI，如下表示本应用只接收scheme为file，类型为txt的文件。

2 、被分享方的UIAbility被启动后，可以在其onCreate()或者onNewWant回调中获取传入的Want参数信息，通过接口want的参数获取分享文件的URI，获取文件URI后通过fs.open接口打开文件，获取对应的file对象后，可对文件进行读写操作。

3 、引用了三方库@changwei/chardet，实现对特定编码格式进行自动识别。

效果图

关键步骤

第一步：被分享应用需要在module.json5配置文件的actions标签的值配置为"ohos.want.action.viewData"，表示接收应用分享文件，配置uris字段，表示接收URI的类型，即只接收其他应用分享该类型的URI，如下表示本应用只接收scheme为file，类型为txt的文件。（type值设置查看文章顶部链接，scheme同一设置为file，表示接受文件）。

"module": {
  ...
  "abilities": [
    {
      ...
      "skills": [
        {
          ...
          "actions": [
            "ohos.want.action.viewData"
          ],
          "uris": [
            {
              "scheme": "file",
              "type": "text/plain"
            }，
            {
              "scheme": "file",
              "type": "image/png"
            },
            {
              "scheme": "file",
              "type": "text/h323"
            },
          ]
        }
      ]
    }
  ]
}

第二步：被分享方的UIAbility被启动后，可以在其onCreate()或者onNewWant回调中获取传入的Want参数信息。

通过接口want的参数获取分享文件的URI，获取文件URI后通过fs.open接口打开文件，获取对应的file对象后，可对文件进行读写操作。此处引用了三方库@changwei/chardet，详情见识别并显示特定编码格式的文件部分。

import fs from '@ohos.file.fs';
import Want from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';
import { util } from '@kit.ArkTS';
import * as chardet from '@changwei/chardet';
 
getShareFileText(Uri: string):string {
  // let want: Want = Uri; // 此处实际使用时应该修改为获取到的分享方传递过来的want信息
  // 从want信息中获取uri字段
  let uri = Uri;
  if (uri == null || uri == undefined) {
    console.info('uri is invalid');
    return "";
  }
  let point = uri.lastIndexOf(".")
  let typ = uri.slice(point)
  // 根据需要对被分享文件的URI进行相应操作。例如读写的方式打开URI获取file对象
  let file = fs.openSync(uri, fs.OpenMode.READ_WRITE);
  let arrayBuffer = new ArrayBuffer(1024)
  fs.readSync(file.fd,arrayBuffer)
  let charset = chardet.detect(new Uint8Array(arrayBuffer, 0, 512));
  let textDecoder = util.TextDecoder.create(charset);
  let result = new Uint8Array(arrayBuffer);
  return textDecoder.decodeWithStream(result);
}

场景二：

识别并显示特定编码格式的文件

效果图

编码	介绍
Unicode	Unicode是一种多语言编码格式，用于表示和传输各种语言的文本数据。
UTF-8	UTF-8是一种变长编码格式，用于表示和传输Unicode文本数据。
GB2312	GB2312是一种中文编码格式，用于表示和传输中文文本数据。
UTF-16	UTF-16是一种变长编码格式，用于表示和传输Unicode文本数据。
ANSI	ANSI是一种美国国家标准协会制定的编码格式，用于表示和传输美国英语文本数据。
GBK	是指中国的中文字符，其它它包含了简体中文与繁体中文字符，另外还有一种字符“gb2312”，这种字符仅能存储简体中文字符。
ASCII	ASCII是一种通用的编码格式，用于表示和传输文本数据

关键步骤

第一步：安装三方库依赖。

ohpm install @changwei/chardet

第二步：在代码中引入使用，返回最可能的字符编码。

import fs from '@ohos.file.fs'
 
let file=fs.openSync('/path/to/file',fs.OpenMode.READ_ONLY);
let arrayBuffer=new ArrayBuffer(1024);// 读取文本文件内容
let readLen = fs.readSync(file.fd, arrayBuffer,{
  offset: 0,
  length: arrayBuffer.length
});
// 提取前512个字节内容以提高性能，长文本建议这样做
let charset = chardet.detect(new Uint8Array(arrayBuffer, 0, 512));
// or
const encoding = await chardet.detectFile('/path/to/file');
// or
const encoding = chardet.detectFileSync('/path/to/file');

常见问题

Q：如何通过文件后缀获取对应的MIMEType列表？

A：下面以通过“.mp3”文件后缀获取对应的MIMEType列表为例，说明如何通过文件后缀获取对应的MIMEType列表。

1、导入@ohos.data.uniformTypeDescriptor模块。

2、可根据 “.mp3” 文件后缀查询对应UTD数据类型。

3、根据UTD数据类型查询对应的MIMEType列表。

import uniformTypeDescriptor from '@ohos.data.uniformTypeDescriptor';
try {
  // 可根据.mp3文件后缀查询对应UTD数据类型。
  let fileExtention = '.mp3';
  let typeId = uniformTypeDescriptor.getUniformDataTypeByFilenameExtension(fileExtention);
  // 根据UTD数据类型查询对应的MIMEType列表。
  let typeObj = uniformTypeDescriptor.getTypeDescriptor(typeId);
  let mimeTypes = typeObj.mimeTypes;
  console.info('mimeTypes:' + mimeTypes);
} catch (err) {
  console.error('err message:' + err.message + ', err code:' + err.code);
}

Q：如何通过MIMEType获取对应的后缀列表？

A：下面以通过“audio/mp3”MIMEType获取对应文件后缀列表为例，说明如何通过MIMEType获取对应的后缀列表。

1、导入@ohos.data.uniformTypeDescriptor模块。

2、可根据 “audio/mp3” MIMEType查询对应UTD数据类型。

3、根据UTD数据类型查询对应的后缀列表。

import uniformTypeDescriptor from '@ohos.data.uniformTypeDescriptor';
try {
  // 可根据audio/mp3MIMEType查询对应UTD数据类型。
  let mineType = 'audio/mp3';
  let typeId = uniformTypeDescriptor.getUniformDataTypeByMIMEType(mineType);
  // 根据UTD数据类型查询对应的MIMEType列表
  let typeObj = uniformTypeDescriptor.getTypeDescriptor(typeId);
  let filenameExtensions = typeObj.filenameExtensions;
  console.info('filenameExtensions:' + filenameExtensions);
} catch (err) {
  console.error('err message:' + err.message + ', err code:' + err.code);
}

Q：如何控制文件读写权限？

A：基于URI分享方式，应用可分享单个文件，通过ohos.app.ability.wantConstant的wantConstant.Flags接口以只读或读写权限授权给其他应用。应用可通过ohos.file.fs的open接口打开URI，并进行读写操作。当前仅支持临时授权，分享给其他应用的文件在被分享应用退出时权限被收回。

基于FD分享方式，应用可分享单个文件，通过ohos.file.fs的open接口以指定权限授权给其他应用。应用从Want中解析拿到FD后可通过ohos.file.fs的读写接口对文件进行读写。