HarmonyOS鸿蒙Next中如何使自定义文件的"打开方式"中能被自己应用唤起

从moudle.json5里配置，

{
  "module": {
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ts",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "exported": true, // true，允许外部唤起
        "skills": [
          {
            "actions": [
              "ohos.want.action.viewData" // 声明这是一个查看/打开数据的动作
            ],
            "uris": [
              {
                "scheme": "file",              // 文件协议
                "type": "application/json",    // 对应的 MIME 类型（如果是标准格式）
                "utd": "com.example.mytext",   // 推荐：使用通用类型标识符 (UTD)
                "fileExtensions": ["json", "myext"] // 核心：支持的自定义文件后缀名列表
              }
            ]
          }
        ]
      }
    ]
  }
}

然后，再去EntryAbility的 **onCreate**和 **onNewWant**生命周期中拿这个 want，

onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {

  // 1. 应用冷启动时从 want 中获取文件 URI 
  this.handleIncomingWant(want);

}

onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam): void {

  // 2. 应用热启动时从 want 中获取文件 URI 
  this.handleIncomingWant(want);

}

补充一版可直接校验的做法：这里不是把 .family 后缀“注册到系统”，而是让文件管理器发出的隐式 Want 能匹配到你的 UIAbility。先看三点：目标 Ability 必须 exported 为 true；skills 里 action 要能匹配打开文件场景，通常是 ohos.want.action.viewData；uris 里 scheme 固定按文件打开用 file，type 要和文件管理器识别到的类型一致，linkFeature 写 FileOpen，注意大小写。

如果 .family 不是系统预置 UTD，建议先用自定义 MIME 做闭环，例如 application/x-family；真机验证通过后，再按业务决定是否补充更标准的 UTD/MIME 映射。配置示例：

{
  "module": {
    "abilities": [
      {
        "name": "EntryAbility",
        "exported": true,
        "skills": [
          {
            "actions": ["ohos.want.action.viewData"],
            "entities": ["entity.system.default"],
            "uris": [
              {
                "scheme": "file",
                "type": "application/x-family",
                "linkFeature": "FileOpen"
              }
            ]
          }
        ]
      }
    ]
  }
}

Ability 被拉起后，不要只看页面是否打开，还要从 want.uri 取文件 URI，并用文件 API 打开：

import { UIAbility, Want, AbilityConstant } from '@kit.AbilityKit';
import { fileIo as fs } from '@kit.CoreFileKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    this.handleOpenFile(want);
  }

  onNewWant(want: Want): void {
    this.handleOpenFile(want);
  }

  private handleOpenFile(want: Want): void {
    const uri = want.uri;
    if (!uri) {
      return;
    }
    try {
      const file = fs.openSync(uri, fs.OpenMode.READ_ONLY);
      // TODO: 读取 .family 内容并进入导入/预览页面
      fs.closeSync(file.fd);
    } catch (e) {
      const err = e as BusinessError;
      console.error('open family file failed: ' + err.code + ', ' + err.message);
    }
  }
}

排查时建议用 aa 命令模拟文件管理器的隐式拉起：

hdc shell "aa start -A ohos.want.action.viewData -U 'file://xxx/test.family' -t 'application/x-family'"

如果 aa 能拉起但文件管理器列表没有你的应用，重点查 type 是否匹配、linkFeature 是否为 FileOpen、是否重装了新包；如果 aa 也拉不起，就先按显式/隐式 Want 匹配规则逐项对 actions、entities、uris。参考文档：module.json5 配置文件、显式 Want 与隐式 Want 匹配规则、UTD/标准化数据定义。

文档链接：module.json5 配置文件、显式 Want 与隐式 Want 匹配规则、UTD/标准化数据定义

在HarmonyOS Next中，应用需在module.json5的abilities中配置skills，添加actions为"ohos.want.action.viewData"，并在uris中指定type（如"application/your-custom-type"）或scheme、host、port、path。例如：

"skills": [{
  "actions": ["ohos.want.action.viewData"],
  "uris": [{"type": "application/x-your-format"}],
  "entities": ["entity.system.default"]
}]

同时确保应用已注册到文件类型关联。系统会据此将应用加入“打开方式”列表。