HarmonyOS开发：跨设备文件访问的使用

目录

• 前言
• 跨设备文件访问技术
• 关于跨设备文件访问
• 实现跨设备文件访问
• 自定义跨设备文件访问
• 结束语

前言

在多设备协同的智能生态中，跨设备文件访问是一个重要的功能，它允许用户在不同设备间无缝地共享和访问文件，尤其是现在多设备协同场景更是如此。而HarmonyOS的分布式能力，为跨设备文件访问提供了强大的支持，也得到越来越多开发者的实践，效果非常的不错。那么本文就来详细介绍如何在HarmonyOS应用中实现跨设备文件访问，包括技术选型、实现步骤和代码示例，方便大家查阅使用。

跨设备文件访问技术

先来介绍关于跨设备文件访问技术的介绍，分布式文件系统为应用提供了跨设备文件访问的能力，开发者在两个设备安装同一应用时，通过基础文件接口，可跨设备读写另一个设备该应用分布式文件路径（/data/storage/el2/distributedfiles/）下的文件，比如：多设备数据流转的场景，设备组网互联之后，设备A上的应用可访问设备B同应用分布式路径下的文件，当期望应用文件被其他设备访问时，只需将文件移动到分布式文件路径即可。
另外，HarmonyOS的跨设备文件访问基于分布式文件系统（Distributed File System），它允许应用访问同一用户账户下其他设备上的文件，就像访问本地文件一样简单。这项技术利用了HarmonyOS的分布式软总线能力，实现了设备间的高效数据传输。

关于跨设备文件访问

在HarmonyOS中，跨设备文件访问的使用中，通常涉及以下的步骤：
1.设备发现与连接：发现同一账户下的其他设备，并建立连接。
2.文件访问授权：请求用户授权访问其他设备的文件。
3.文件操作：在授权后，进行文件的读取、写入、删除等操作。
4.数据同步：确保跨设备间的文件数据保持同步。

实现跨设备文件访问

步骤1：分布式组网

首先需要完成分布式组网，将需要跨设备访问的两个设备登录同一账号，保证设备蓝牙和Wi-Fi功能开启，蓝牙无需互连，Wi-Fi无需接入同一个局域网。使用HarmonyOS提供的分布式能力发现并连接其他设备。

步骤2：访问跨设备文件

然后是同一应用不同设备之间实现跨设备文件访问，只需要将对应的文件放在应用沙箱的分布式文件路径即可，设备A上在分布式路径下创建测试文件，并写入内容。具体操作如下所示：

import { fileIo as fs } from '@kit.CoreFileKit';
import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

let context = getContext(this) as common.UIAbilityContext; // 获取设备A的UIAbilityContext信息
let pathDir: string = context.distributedFilesDir;
// 获取分布式目录的文件路径
let filePath: string = pathDir + '/test.txt';

try {
  // 在分布式目录下创建文件
  let file = fs.openSync(filePath, fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE);

  // 向文件中写入内容
  fs.writeSync(file.fd, 'content');
  // 关闭文件
  fs.closeSync(file.fd);
} catch (error) {
  let err: BusinessError = error as BusinessError;

} 

然后设备B主动向设备A发起建链，建链成功后设备B可在分布式路径下读取测试文件，这里需要说明一下，这里通过分布式设备管理的接口获取设备networkId，具体操作如下所示：

import { fileIo as fs } from '@kit.CoreFileKit';
import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { buffer } from '@kit.ArkTS';
import { distributedDeviceManager } from '@kit.DistributedServiceKit'

// 通过分布式设备管理的接口获取设备A的networkId信息
let dmInstance = distributedDeviceManager.createDeviceManager("com.example.hap");
let deviceInfoList: Array<distributedDeviceManager.DeviceBasicInfo> = dmInstance.getAvailableDeviceListSync();
let networkId = deviceInfoList[0].networkId;

// 定义访问公共文件目录的回调
let listeners : fs.DfsListeners = {
  onStatus: (networkId: string, status: number): void => {

  }
}

// 访问并挂载公共文件目录
fs.connectDfs(networkId, listeners).then(() => {
  console.info("Success to connectDfs");
  let context = getContext(); // 获取设备B的UIAbilityContext信息
  let pathDir: string = context.distributedFilesDir;
  // 获取分布式目录的文件路径
  let filePath: string = pathDir + '/test.txt';

  try {
    // 打开分布式目录下的文件
    let file = fs.openSync(filePath, fs.OpenMode.READ_WRITE);
    // 定义接收读取数据的缓存
    let arrayBuffer = new ArrayBuffer(4096);
    // 读取文件的内容，返回值是读取到的字节个数
    class Option {
        public offset: number = 0;
        public length: number = 0;
    }
    let option = new Option();
    option.length = arrayBuffer.byteLength;
    let num = fs.readSync(file.fd, arrayBuffer, option);
    // 打印读取到的文件数据
    let buf = buffer.from(arrayBuffer, 0, num);

  } catch (error) {
    let err: BusinessError = error as BusinessError;

  }
}).catch((error: BusinessError) => {
  let err: BusinessError = error as BusinessError;

});

步骤3：断开链路

然后B设备访问跨设备文件完成，断开链路。具体如下所示：

import { BusinessError } from '@kit.BasicServicesKit';
import { distributedDeviceManager } from '@kit.DistributedServiceKit'
import { fileIo as fs } from '@kit.CoreFileKit';

// 获取设备A的networkId
let dmInstance = distributedDeviceManager.createDeviceManager("com.example.hap");
let deviceInfoList: Array<distributedDeviceManager.DeviceBasicInfo> = dmInstance.getAvailableDeviceListSync();
let networkId = deviceInfoList[0].networkId;

// 取消公共文件目录挂载
fs.disconnectDfs(networkId).then(() => {
  console.info("Success to disconnectDfs");
}).catch((error: BusinessError) => {
  let err: BusinessError = error as BusinessError;
  console.error(`Failed to disconnectDfs Code: ${err.code}, message: ${err.message}`)
})

自定义跨设备文件访问

除了基本的文件访问功能，开发者还可以根据应用的需求自定义跨设备文件访问行为，比如：

• 文件传输：实现跨设备的文件传输功能。
• 文件共享：创建文件共享会话，允许多个设备访问同一文件。

结束语

不用多说，想必也知道了在鸿蒙开发中跨设备文件访问是HarmonyOS开发中的一项强大功能，它为应用提供了无缝的多设备协同能力，也是核心的特点之一。通过本文的介绍，大家应该了解了如何在HarmonyOS应用中实现跨设备文件访问功能，在鸿蒙原生开发中也会经常去应用这个功能。随着技术的不断发展，跨设备文件访问将在HarmonyOS生态中扮演越来越重要的角色，同时它也是鸿蒙原生开发中的关键技术，越来越多的为用户带来更加丰富和“丝滑”的体验。