HarmonyOS开发：跨设备文件详解

目录

• 前言
• 关于跨设备文件访问和拷贝
• 实现跨设备文件访问
• 实现跨设备文件拷贝

• 结束语

  前言

  在HarmonyOS的全场景智能生态中，跨设备文件访问和文件拷贝是提升用户体验的关键功能，也是鸿蒙原生生态中核心的内容，它们允许用户在不同设备间无缝地共享和传输文件，无需复杂的设置或第三方应用。那么本文就来详细介绍如何在HarmonyOS应用中实现跨设备文件访问和文件拷贝，包括技术选型、实现步骤和代码示例。

关于跨设备文件访问和拷贝

HarmonyOS的分布式能力使得跨设备文件访问和拷贝成为可能。通过分布式文件系统和分布式任务调度，应用可以轻松访问和操作远程设备上的文件，就像操作本地文件一样。
先来介绍一下跨设备文件访问，分布式文件系统为应用提供了跨设备文件访问的能力，开发者在两个设备安装同一应用时，通过基础文件接口，可跨设备读写另一个设备该应用分布式文件路径（/data/storage/el2/distributedfiles/）下的文件，比如：多设备数据流转的场景，设备组网互联之后，设备A上的应用可访问设备B同应用分布式路径下的文件，当期望应用文件被其他设备访问时，只需将文件移动到分布式文件路径即可。
再来介绍一下跨设备文件拷贝，分布式文件系统为应用提供了跨设备文件拷贝的能力，开发者在跨设备跨应用进行文件拷贝时，通过基础文件接口，可跨设备跨应用拷贝文件，比如多设备数据流转的场景，设备组网互联之后，设备A上的应用可在复制时，将A设备的沙箱文件，拷贝到A设备的分布式路径下，设备B在粘贴的时候，从设备B的分布式路径下，将文件拷贝到对应的沙箱文件中。

实现跨设备文件访问

步骤1：完成分布式组网

首先将需要跨设备访问的两个设备登录同一账号，保证设备蓝牙和Wi-Fi功能开启，蓝牙无需互连，Wi-Fi无需接入同一个局域网。

步骤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 => {
    console.info('Failed to access public directory');
  }
}

// 访问并挂载公共文件目录
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(() => {
}).catch((error: BusinessError) => {
  let err: BusinessError = error as BusinessError;

})

实现跨设备文件拷贝

步骤1：完成分布式组网

首先，将需要进行跨设备访问的设备连接到同一局域网中，同账号认证完成组网。

步骤2：拷贝跨设备文件

然后拷贝跨设备文件。同一应用不同设备之间实现跨设备文件拷贝，只需要将对应的文件放在应用沙箱的分布式文件路径即可。将A设备的待拷贝沙箱文件，拷贝到A设备的分布式路径下。具体操作如下所示：

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

let context = getContext(this) as common.UIAbilityContext; // 获取设备A的UIAbilityContext信息
let pathDir: string = context.filesDir;
let distributedPathDir: string = context.distributedFilesDir;
// 待拷贝文件沙箱路径
let filePath: string = pathDir + '/src.txt';

try {
 // 文件不存在时，需要创建文件并写入内容
 let file = fs.openSync(filePath, fs.OpenMode.CREATE | fs.OpenMode.READ_WRITE);
 fs.writeSync(file.fd, 'Create file success');
 fs.closeSync(file);
} catch (error) {

}

// 获取待拷贝文件uri
let srcUri = fileUri.getUriFromPath(filePath);

// 将待拷贝的沙箱文件，拷贝到分布式目录下
let destUri: string = fileUri.getUriFromPath(distributedPathDir + '/src.txt');

try {
 // 将沙箱路径下的文件拷贝到分布式路径下
 fs.copy(srcUri, destUri).then(()=>{


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

 })
} catch (error) {

}

接着当B设备在获取A端沙箱文件时，从B设备的分布式路径下将对应的文件拷贝走，以此完成跨设备拷贝。具体操作如下所示：

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

let context = getContext(this) as common.UIAbilityContext; // 获取设备B的UIAbilityContext信息
let pathDir: string = context.filesDir;
let distributedPathDir: string = context.distributedFilesDir;
// 待拷贝文件的目标沙箱路径
let filePath: string = pathDir + '/dest.txt';

// 获取目标路径uri
let destUri = fileUri.getUriFromPath(filePath);

// 获取分布式路径下的源文件
let srcUri: string = fileUri.getUriFromPath(distributedPathDir + '/src.txt');

// 定义拷贝回调
let progressListener: fs.ProgressListener = (progress: fs.Progress) => {

};
let options: fs.CopyOptions = {
  "progressListener" : progressListener
}

try {
 // 将分布式路径下的文件拷贝到其他沙箱路径下
 fs.copy(srcUri, destUri, options).then(()=>{


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

 })
} catch (error) {

}

结束语

上面关于跨设备文件相关的分享，不难看出跨设备文件访问和拷贝是HarmonyOS开发中的重要功能，它们为用户提供了便捷的文件共享和传输能力，而且也是鸿蒙原生开发中必备的技能，非常关键和重要。通过本文的介绍，想必都了解了如何在HarmonyOS应用中实现这些功能，在后面的鸿蒙原生开发中会有更好的使用。随着技术的不断发展，跨设备文件操作将在HarmonyOS生态中继续扮演重要的角色，为用户带来更加丰富和便捷的体验，也期待大家多多使用这些功能来应用到鸿蒙原生开发中。