OpenHarmony实战开发-管理外置存储设备（仅对系统应用开放）

外置存储设备具备可插拔属性，因此系统提供了设备插拔事件的监听及挂载功能，用于管理外置存储设备。

外置存储设备的管理由StorageManager和StorageDaemon两个服务完成。StorageDaemon实现底层的的监听挂载等功能；StorageManager则对系统应用提供状态变更通知、查询和管理能力。

图1 外置存储设备管理示意图

• 插入外卡时，StorageDaemon进程通过netlink监听获取到外卡插入事件，创建对应的磁盘设备以及卷设备，此时，已创建的卷设备状态为卸载状态（UNMOUNTED）。
• StorageDaemon进程在创建完卷设备后，会对卷设备进行检查，此时卷状态为检查状态（CHECKING）。
• 检查成功：对卷设备进行挂载，挂载成功后，卷状态更改为挂载状态（MOUNTED），并通知StorageManager发送COMMON_EVENT_VOLUME_MOUNTED广播。
• 检查失败：则返回卸载状态（UNMOUNTED）。
• 当卷设备处于挂载状态时：
• 用户选择弹出：卷状态设备更改为正在弹出状态（EJECTING），并发送COMMON_EVENT_VOLUME_EJECT广播。StorageDaemon进程将卷设备卸载成功后，卷状态更改为卸载状态（UNMOUNTED），并发送COMMON_EVENT_VOLUME_UNMOUNTED广播。当卷设备处于卸载状态后，拔出卷设备会删除相关卷设备信息，并发送COMMON_EVENT_VOLUME_REMOVED广播。
• 拔出外卡：卷设备状态同样会经历正在弹出状态（EJECTING）和卸载状态（UNMOUNTED），并发送对应阶段的广播。在拔出后，删除相关卷设备信息，发送COMMON_EVENT_VOLUME_BAD_REMOVAL广播。

接口说明

外置存储设备管理相关API的详细介绍请参见API参考。

各类广播传递的相关参数，请见下表。

表1 广播传递的参数

开发步骤

开发者通过订阅卷设备相关的广播事件来感知外置存储的插入，通过广播传递的信息获取卷设备信息后可以对卷设备进行查询以及管理操作。

1.获取权限。 订阅卷设备广播事件需要申请ohos.permission.STORAGE_MANAGER权限，配置方式请参见申请应用权限。
2.订阅广播事件。 需订阅的事件如下：

• 卷设备移除：“usual.event.data.VOLUME_REMOVED”
• 卷设备卸载：“usual.event.data.VOLUME_UNMOUNTED”
• 卷设备挂载：“usual.event.data.VOLUME_MOUNTED”
• 卷设备异常移除：“usual.event.data.VOLUME_BAD_REMOVAL”
• 卷设备正在弹出：“usual.event.data.VOLUME_EJECT”

import CommonEvent from '@ohos.commonEventManager';
import volumeManager from '@ohos.file.volumeManager';
import { BusinessError } from '@ohos.base';

let subscriber: CommonEvent.CommonEventSubscriber;
async function example() {
  const subscribeInfo: CommonEvent.CommonEventSubscribeInfo = {
    events: [
      "usual.event.data.VOLUME_REMOVED",
      "usual.event.data.VOLUME_UNMOUNTED",
      "usual.event.data.VOLUME_MOUNTED",
      "usual.event.data.VOLUME_BAD_REMOVAL",
      "usual.event.data.VOLUME_EJECT"
    ]
  };
  subscriber = await CommonEvent.createSubscriber(subscribeInfo);
}

3.收到广播通知后获取卷设备信息。

CommonEvent.subscribe(subscriber, (err: BusinessError, data: CommonEvent.CommonEventData) => {
  if (data.event === 'usual.event.data.VOLUME_MOUNTED') {
    // 开发者可以通过广播传递的卷设备信息来管理卷设备
    let volId: string = data.parameters.id;
    volumeManager.getVolumeById(volId, (error: BusinessError, vol: volumeManager.Volume) => {
      if (error) {
        console.error('volumeManager getVolumeById failed for ' + JSON.stringify(error));
      } else {
        console.info('volumeManager getVolumeById successfully, the volume state is ' + vol.state);
      }
    })
  }
})

如果大家还没有掌握鸿蒙，现在想要在最短的时间里吃透它，我这边特意整理了《鸿蒙语法ArkTS、TypeScript、ArkUI、相关教学视频》以及《鸿蒙生态应用开发白皮书V2.0PDF》《鸿蒙开发学习手册》（共计890页）鸿蒙开发资料等…希望对大家有所帮助：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

鸿蒙语法ArkTS、TypeScript、ArkUI等…视频教程：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

OpenHarmony APP开发教程步骤：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

鸿蒙生态应用开发白皮书V2.0PDF：https://docs.qq.com/doc/DZVVkRGRUd3pHSnFG

南北双向高工技能基础：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

应用开发中高级就业技术：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

全网首发-工业级 南向设备开发就业技术：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

《鸿蒙开发学习手册》：

如何快速入门：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.基本概念
2.构建第一个ArkTS应用
3.……

开发基础知识：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.应用基础知识
2.配置文件
3.应用数据管理
4.应用安全管理
5.应用隐私保护
6.三方应用调用管控机制
7.资源分类与访问
8.学习ArkTS语言
9.……

基于ArkTS 开发：https://docs.qq.com/doc/DZVVBYlhuRkZQZlB3

1.Ability开发
2.UI开发
3.公共事件与通知
4.窗口管理
5.媒体
6.安全
7.网络与链接
8.电话服务
9.数据管理
10.后台任务(Background Task)管理
11.设备管理
12.设备使用信息统计
13.DFX
14.国际化开发
15.折叠屏系列
16.……