OpenHarmony开发者论坛

标题: OpenHarmony系统之UDMF Demo介绍 [打印本页]

---

作者: 深开鸿_赵军霞    时间: 2024-7-5 15:51
标题: OpenHarmony系统之UDMF Demo介绍
[md]# OpenHarmony系统之UDMF Demo介绍

## 介绍

本示例主要使用[@ohos.data.uniformTypeDescriptor](https://gitee.com/openharmony/do ... rmTypeDescriptor.md)
[@ohos.data.unifiedDataChannel](https://gitee.com/openharmony/in ... iedDataChannel.d.ts)展示了标准化数据定义与描述的功能，在新增预置文件后，对文件的utd标准类型获取、utd类型归属类型查询、获取文件对应的utd类型的默认图标等功能。 实现过程中还使用到[@ohos.file.fs](https://gitee.com/openharmony/do ... /js-apis-file-fs.md) 等接口。
另外，展示了ArkTS控件[拖拽事件](https://gitee.com/openharmony/do ... events-drag-drop.md)中使用UDMF数据结构相关实现。

## 应用场景

#### 场景一：下拉列表选择不同数据类型可以进行过滤文件

* 预置条件：应用中设置不同类型的文件数据到沙箱内
* 输入：指定文件类型
* 输出：筛选出指定文件类型，过滤后的文件图标排列到文件呈现区域。

#### 场景二：实现选择出来的文件/文本信息能够被拖拽到另一个设备的应用内落为文件

##### 文件

* 输入：选定文件
* 输出：拖拽文件到落入框后, 落入文件另存为文件，另存为的文件名显示在落入框。

##### 文本

* 输入：选定文本
* 输出：拖拽文本到落入框后, 落入文本另存为文件，另存为的文件名显示在落入框。

## 环境

1. 本示例仅支持标准系统上运行，支持设备：RK3568。
2. 本示例为Stage模型，仅支持API12版本SDK，SDK版本号(API Version 12 Release),镜像版本号(OpenHarmony 5.0.0.25及更高版本)。
3. 本示例需要使用DevEco Studio 版本号(4.1Release)及以上版本才可编译运行。

## 实现效果

### 代码展示

#### 文件过滤

```
.onSelect((index: number, text?: string | undefined) => {
  this.index = index;
  if (text) {
    this.text = text;
    logger.info(TAG, 'Select type:' + text);
    this.UpdateSelectedFiles();
  }
})
```

#### 文件拖拽

```
.onDragStart((event) => {
  this.textContentTarget = '';
  let fileTestDirPath = filesDir + '/' + item.filename;
  logger.info(TAG, 'onDragStart begin!')

  let file = new UDC.File();
  file.details = {
    name: item.filename,
  };
  file.uri = fileUri.getUriFromPath(fileTestDirPath);
  this.backGroundColor = Color.Transparent;
  (event as DragEvent).setData(new UDC.UnifiedData(file));
})
```

#### 文件落入

```
if(type == UTD.UniformDataType.FILE) {
  logger.info(TAG, 'general.file is true!');
  let file: UDC.File = records[0] as UDC.File;
  let name: string = randomString(6, 'UDMFDemo');

  let details: Record<string, string> | undefined = file.details
  if (details == undefined) {
    return;
  }

  let fileNewName: string = 'copy' + '_' + time.toString() + '_' + details.name;
  let fileTestDirPathNew: string = filesDir + "/" + fileNewName;
  logger.info(TAG, 'fileTestDirPathNew: ' + fileTestDirPathNew);

  let content: ArrayBuffer = this.fileFs.getFileContentBuffer(file.uri);
  saveAsFileContent(fileTestDirPathNew, content);
  this.UpdateSelectedFiles();
  this.textContentTarget = 'Save as ' + fileNewName;
```

#### 文本拖拽

```
    .onDragStart((event) => {
      this.textContentTarget = '';
      this.backGroundColor = Color.Transparent;
      let data: UDC.PlainText = new UDC.PlainText();
      data.abstract = 'this is abstract';
      data.textContent = this.textContent;
      (event as DragEvent).setData(new UDC.UnifiedData(data));
    })
```

#### 文本落入

```
} else if (type == UTD.UniformDataType.PLAIN_TEXT) {
  logger.info(TAG, 'general.plain-text is true!');
  let plainText: UDC.PlainText = records[0] as UDC.PlainText;

  let name: string = randomString(6, 'UDMFDemo') + '.txt';
  let fileNewName: string = time.toString() + '_' + name;
  let fileTestDirPathNew = filesDir + "/" + fileNewName;

  logger.info(TAG, `textContentTarget onDrop fileTestDirPathNew：` + fileTestDirPathNew);
  logger.info(TAG, `textContentTarget onDrop  plainText.textContent：` +  plainText.textContent);

  saveAsFileContent(fileTestDirPathNew, plainText.textContent);
  this.UpdateSelectedFiles();
  this.textContentTarget = 'Content save as ' + fileNewName;
  logger.info(TAG, `textContentTarget onDrop  this.textContentTarget：` +  this.textContentTarget);
}
```

### 界面展示

首页


文件过滤




文件拖拽结果


### 使用方法

1. 在主界面，类型过滤下拉框中，选择某一文件类型后，文件呈现区域展示对应类型的所有文件；
2. 在主界面，点击txt后缀的文件，文本呈现区域可展示文件内容；
3. 在主界面，对于txt后缀的文件，长按拖拽到右上角的文本控件区域，被拖拽的文件会被另存为新的文件，新生成的文件名会在组件内显示，如果文件名过长会在组件内滚动显示；
4. 在主界面，在“文本呈现区域”右边长按拖拽到右上角的文本控件区域，被拖拽的文本会被另存为新的文件，新生成的文件名会在组件内显示，如果文件名过长会在组件内滚动显示；

## 相关权限

普通用户权限即可，不需要系统权限。

## 样例参考路径

见sample仓的code/BasicFeature/DataManagement/UDMF/UDMFDemo目录。
[/md]

---

欢迎光临 OpenHarmony开发者论坛 (https://forums.openharmony.cn/)

Powered by Discuz! X3.5