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

mzshj

发布于 2024-8-1 16:47

浏览

0收藏

场景描述：

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

场景一：

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

后缀名	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的读写接口对文件进行读写。

分类

标签

已于2024-8-1 16:47:47修改