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

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修改
收藏
回复
举报
回复
    相关推荐