logo
积分中心
跨端迁移中的分布式数据对象实践:从手机到平板的无缝续接 原创
头像 阿东写代码也种花 2026-11-17 13:17:30    发布
0 浏览 0 收藏

跨端迁移是 HarmonyOS 分布式能力中最贴近用户感知的特性之一。官方示例中,distributedDataObject 承担了迁移过程中业务数据的载体角色,但实际落地时容易踩的坑集中在两个地方:迁移触发时机的控制和资产类数据的处理。

迁移能力的状态管理

应用并非任何时候都适合允许迁移。例如视频播放页在全屏播放时迁移到平板是合理的,但在支付确认页迁移可能导致流程中断。通过 setMissionContinueState 可以动态开关当前 Ability 的迁移能力:

typescript

// EntryAbility.ets
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';

export default class EntryAbility extends UIAbility {
  onContinue(wantParam: Record<string, Object>): AbilityConstant.OnContinueResult {
    // 检查当前页面是否允许迁移
    const currentPage = AppStorage.get<string>('currentPageName');
    if (currentPage === 'PaymentConfirm') {
      return AbilityConstant.OnContinueResult.REJECT;
    }
    // 允许迁移,并携带必要的恢复数据
    wantParam['continuePage'] = currentPage;
    return AbilityConstant.OnContinueResult.AGREE;
  }
}

在页面侧,当用户进入支付页时调用 setMissionContinueState(AbilityConstant.ContinueState.INACTIVE) 关闭迁移能力,离开时恢复为 ACTIVE。这个开关是系统级的,会影响任务卡片中的“流转”按钮状态,比在 onContinue 里做判断更及时。

分布式数据对象的资产迁移

基础数据类型(字符串、数字)通过 distributedDataObject 的自动同步即可完成迁移。但如果业务数据中包含图片、音频等文件引用,需要额外使用 distributedObject 的资产(Asset)能力。以购物清单中用户上传的凭证图片为例:

typescript

import { distributedDataObject } from '@kit.ArkData';
import { fileIo } from '@kit.CoreFileKit';

class ShoppingItem {
  id: string = '';
  name: string = '';
  // 资产数组:存储图片文件的描述信息
  images: distributedDataObject.Asset[] = [];
}

// 添加图片时创建资产描述
async function addImageToItem(item: ShoppingItem, filePath: string) {
  const file = fileIo.openSync(filePath, fileIo.OpenMode.READ_ONLY);
  const stat = fileIo.statSync(file.fd);
  const asset: distributedDataObject.Asset = {
    name: file.name,
    uri: filePath,
    path: filePath,
    createTime: stat.ctime.toString(),
    modifyTime: stat.mtime.toString(),
    size: stat.size.toString(),
    status: distributedDataObject.AssetStatus.ASSET_NORMAL,
  };
  item.images.push(asset);
  fileIo.closeSync(file);
}

迁移发生时,系统会自动将 Asset 中引用的文件同步到目标设备,并更新 uri 和 path 为目标设备上的可访问路径。开发者在目标端读取 item.images[0].path 即可直接打开文件,无需手动处理文件传输逻辑。需要留意的是,资产同步的耗时与文件大小正相关,大文件迁移时建议在 UI 上给出明确的进度提示,避免用户误以为迁移失败而手动取消。


©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255