阿东写代码也种花
2026-11-17 13:17:30 发布跨端迁移是 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 上给出明确的进度提示,避免用户误以为迁移失败而手动取消。
暂无评论数据
发布
相关推荐
sky_Qian
0
0
张妍希
0
0
码上调用
0
0
程序山河
0
0
folra
1
0
阿东写代码也种花
我还没有写个人简介......
帖子
提问
粉丝
新能力不知道从哪里下手?用 HarmonyOS 开发助手拆解功能实现路径
2026-11-17 15:37:03 发布Aqara 携手深开鸿达成战略合作,共建智慧空间新范式
2026-10-28 11:25:34 发布



京公网安备:11010502051901号