HarmonyOS 鸿蒙Next want使用系统软件方式打开文件

应用可以通过调用元能力的startAbility接口传入隐式Want来打开文件，若匹配到一个满足条件的应用则直接启动该应用；若匹配到多个满足条件的应用（UIAbility）则弹出选择框让用户选择，以下以打开Word文件为例。

宿主应用开发步骤
宿主应用即文件打开的发起者，通过调用系统接口打开指定文件。

调用接口启动

// 调用元能力提供的startAbility接口启动应用
context.startAbility(wantInfo).then(() => {
  // ...
}).catch((err: BusinessError) => {
  // ...
})

目标应用开发步骤
目标应用即文件打开能力的提供者，需要在应用中声明应用打开能力并构建相关的能力，使得包管理服务可以识别到应用支持文件打开的能力。

// 导入相关模块
import common from '@ohos.app.ability.common';
import { Want } from '@ohos.app.ability.Want';
import { BusinessError } from '@ohos.base';

//构造请求数据
// 构造请求数据Want
let wantInfo: Want = {
  action: 'ohos.want.action.viewData', // 查看数据的action
  uri: 'file://.../test.docx', // 表示打开文件的URI路径，一般配合type使用
  type: 'application/msword', // 表示MIME type类型描述，打开文件的类型
  flags: 2, // 1:表示对URI执行读取操作的授权; 2:表示对URI执行写入操作的授权
  parameters: {
    // 开发者传入的键值对，以下仅为示例
    fileName: 'test.docx'
  }
}

module.json5注册文件打开能力

{
  "module": {
  ...
  "abilities": [
  {
    ...
    "skills": [
    {
      ...
      "actions": [
      "ohos.want.action.viewData" // 声明文件打开能力
      ...
      ],
      "uris": [
      {
        // 允许打开uri中以file://协议开头标识本地的word文件
        "scheme": "file",
      "type": "application/msword" // 表示MIME type类型描述，打开文件的类型
      }
      ...
      ]
      ...
    }
    ]
  }
  ]
}

实现UIAbility

import { AbilityConstant } from '@ohos.app.ability.AbilityConstant';
import { UIAbility } from '@ohos.app.ability.UIAbility';
import { Want } from '@ohos.app.ability.Want';
import { window } from '@ohos.window';

export default class DemoUIAbility extends UIAbility {
  private storage: LocalStorage = new LocalStorage();

  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    console.info('DemoUIAbility, onCreate');
    // 从want中获取打开文件的相关参数信息，以下仅为示例
    let fileName: string = want.parameters?.fileName as string ?? '';
    this.storage.setOrCreate('fileName', fileName);
    ...
  }

  onDestroy(): void {
    console.info('DemoUIAbility, onDestroy');
  }

  onWindowStageCreate(windowStage: window.WindowStage): void {
    console.info('DemoUIAbility, onWindowStageCreate');
    // 加载页面
    windowStage.loadContent('pages/Index', this.storage, (err, data) => {
      if (err.code) {
        console.error('DemoUIAbility, failed to load the content. Cause: %{public}s',
          JSON.stringify(err) ?? '');
        return;
      }

      console.info('DemoUIAbility, succeeded in loading the content. Data: %{public}s',
        JSON.stringify(data) ?? '');
      ...
    });
  }

  onWindowStageDestroy(): void {
    console.info('DemoUIAbility, onWindowStageDestroy');
  }

  ...
}