鸿蒙开发往期必看:
一分钟了解”纯血版!鸿蒙HarmonyOS Next应用开发!
“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线!(从零基础入门到精通)
“一杯冰美式的时间” 了解鸿蒙HarmonyOS Next应用开发路径!
使用场景
开发者可以通过调用startAbility接口,由系统从已安装的应用中寻找符合要求的应用来实现打开特定文件的意图,例如:浏览器下应用下载PDF文件,可以调用此接口选择文件处理应用打开此PDF文件。开发者需要在请求中设置待打开文件的URI路径(uri)、文件格式(type)等字段,以便系统能够识别,直接拉起文件打开应用或弹出一个选择框,让用户选择合适的应用来打开文件,效果示意如下图所示。
图1 效果示意图
接口关键参数说明
开发者通过调用startAbility接口即可实现由已安装的垂域应用来打开文件。
表1 startAbility请求中want相关参数说明
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
uri | string | 是 | 表示待打开文件的URI路径,一般配合type使用。 uri格式为:file://bundleName/path - file:文件URI的标志。 - bundleName:该文件资源的属主。 - path:文件资源在应用沙箱中的路径。 |
type | string | 否 | 表示MIME type类型描述,打开文件的类型。比如:‘text/xml’ 、 'image/*'等,MIME定义请参见https://www.iana.org/assignments/media-types/media-types.xhtml?utm_source=ld246.com。 |
parameters | Record<string, Object> | 否 | 表示由系统定义,由开发者按需赋值的自定义参数,文件打开场景请参考表2。 |
flags | number | 否 | 表示处理方式,文件打开场景请参考表3。 |
表2 parameters相关参数说明
参数名称 | 类型 | 说明 |
---|---|---|
ability.params.stream | string | 指示携带的文件URI要授权给目标方,用于待打开的文件存在其他文件依赖的场景。例如打开本地html文件依赖本地其余资源文件的场景等。对应的value必须是string类型的文件URI数组。文件URI的获取参考表1中uri参数。 |
ohos.ability.params.showDefaultPicker | string | 表示在系统仅找到一个应用打开文件的场景下,是否需要展示选择文件打开方式的弹框来给用户选择。 - false:表示由系统策略或默认应用设置决定直接拉起文件打开应用还是展示弹框。 - true:表示始终展示弹框。缺省为false。 |
表3 flags相关参数说明
参数名称 | 值 | 说明 |
---|---|---|
FLAG_AUTH_READ_URI_PERMISSION | 0x00000001 | 指对URI执行读取操作的授权。 |
FLAG_AUTH_WRITE_URI_PERMISSION | 0x00000002 | 指对URI执行写入操作的授权。 |
接入步骤
调用方接入步骤
-
导入相关模块。
// xxx.ets import { fileUri } from '@kit.CoreFileKit'; import { UIAbility, Want, wantConstant } from '@kit.AbilityKit'; import { window } from '@kit.ArkUI'; import { BusinessError } from '@kit.BasicServicesKit';
-
获取应用文件路径。
// xxx.ets // 假设应用bundleName值为com.example.demo export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage: window.WindowStage) { // 获取文件沙箱路径 let filePath = this.context.filesDir + '/test1.txt'; // 将沙箱路径转换为uri let uri = fileUri.getUriFromPath(filePath); // 获取的uri为"file://com.example.demo/data/storage/el2/base/files/test.txt" } // ... }
-
构造请求数据。
// xxx.ets export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage: window.WindowStage) { // 获取文件沙箱路径 let filePath = this.context.filesDir + '/test.txt'; // 将沙箱路径转换为uri let uri = fileUri.getUriFromPath(filePath); // 构造请求数据 let want: Want = { uri: uri, type: 'text/plain', // 表示待打开文件的类型 // 配置被分享文件的读写权限,例如对文件打开应用进行读写授权 flags: wantConstant.Flags.FLAG_AUTH_WRITE_URI_PERMISSION | wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION }; } // ... }
-
调用接口启动。
// xxx.ets export default class EntryAbility extends UIAbility { onWindowStageCreate(windowStage: window.WindowStage) { // 获取文件沙箱路径 let filePath = this.context.filesDir + '/test.txt'; // 将沙箱路径转换为uri let uri = fileUri.getUriFromPath(filePath); // 构造请求数据 let want: Want = { uri: uri, type: 'text/plain', // 表示待打开文件的类型 // 配置被分享文件的读写权限,例如对文件打开应用进行读写授权 flags: wantConstant.Flags.FLAG_AUTH_WRITE_URI_PERMISSION | wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION }; // 调用接口启动 this.context.startAbility(want) .then(() => { console.info('Succeed to invoke startAbility.'); }) .catch((err: BusinessError) => { console.error(`Failed to invoke startAbility, code: ${err.code}, message: ${err.message}`); }); } // ... }
目标方接入步骤
-
声明文件打开能力
支持打开文件的应用需要在module.json5配置文件中声明文件打开能力。其中uris字段表示接收URI的类型,其中scheme固定为file。type字段表示支持打开的文件类型(请参见MIME定义),如下举例中类型为txt文件。
{ "module": { // ... "abilities": [ { // ... "skills": [ { "actions": [ "ohos.want.action.viewData" // 必填,声明数据处理能力 ], "uris": [ { // 允许打开uri中以file://协议开头标识的本地文件 "scheme": "file", // 必填,声明协议类型为文件 "type": "text/plain", // 必填,表示支持打开的文件类型 "linkFeature": "FileOpen" // 必填,表示此URI的功能为文件打开 } // ... ] // ... } ] } ] } }
-
应用处理待打开文件。
声明了文件打开的应用在被拉起后,获取传入的Want参数信息,从中获取待打开文件的URI,在打开文件并获取对应的file对象后,可对文件进行读写操作。
// xxx.ets import { fileIo } from '@kit.CoreFileKit'; import { Want, UIAbility, AbilityConstant } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; export default class EntryAbility extends UIAbility { onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { // 从want信息中获取uri字段 let uri = want.uri; if (uri == null || uri == undefined) { console.info('uri is invalid'); return; } try { // 根据待打开文件的URI进行相应操作。例如同步读写的方式打开URI获取file对象 let file = fileIo.openSync(uri, fileIo.OpenMode.READ_WRITE); console.info('Succeed to open file.'); } catch (err) { let error: BusinessError = err as BusinessError; console.error(`Failed to open file openSync, code: ${error.code}, message: ${error.message}`); } } }
最后
小编在之前的鸿蒙系统扫盲中,我明显感觉到一点,那就是许多人参与鸿蒙开发,但是又不知道从哪里下手,有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)路线图、文档、视频、用来跟着学习是非常有必要的。
如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员
→ 鸿蒙全栈开发学习笔记 希望这一份鸿蒙学习文档能够给大家带来帮助~