一、跨设备迁移
是什么:是一种基于Ability框架下的Page Ability的能力
迁移动作主要步骤:
- 源侧设备上的Page请求迁移
- 源侧设备回调保存数据方法
- 目标侧设备启动Page,回调恢复数据方法
请求迁移的两种方法
- continue Ability()
- continueAbilityReversibly()
区别在于:continueAbility()不能进行回迁,continueAbilityReversibly()可以进行回迁
实现IAbilityContinuation接口
- onStartContinuation()
- onSaveData()
- onRestoreData()
- onCompleteContinuation()
- onFailedContinuation()
- onRemoteTerminated()
文字描述不够清晰和直接,故用表的形式进行输出
A作为源侧向目标侧B进行迁移其回调方法的顺序是:
二、PageAbility代码示例工程
本示例演示了同一Page Ability内和不同Page间的AbilitySlice导航,以及Page Ability的跨端迁移。
(一)项目演示
因为示例代码的字真的小得让人眼瞎,所以就调大了一点
跨设备迁移
同PA不同Page间的导航
(二)工程目录及其Slice直接的关系
(三)同一PA导航与不同Page
同Page
Page内的AbilitySlice实例是以堆栈存放的,其页内导航的数据传递是通过intent传递的,源页面调用方法setParam(),其值是键值对。在跳转页面通过getParam进行接收(intent.getParam(key:“XX”))
目标页面向源页面传递数据,构建intent实例(返回数据的载体)-赋值给intent类型的resultIntent变量-调用方法setParam()(键值对的形式)-调用方法setResult()指定实例作为参数-在原页面调用PresentForResult()(请求码非负整数作为第三个参数用于标识某一次页面导航)-重写方法onResult(处理返回数据)-
不同Page
- 显式:在触发事件中构造Intent.OperationBuilder的实例-分别链式调用
- Operation operation=new Intent.OperationBuilder()
- withBundleName(getBundleName())
- .getAbilityName(目标Ability.class.getName())
- .build();
为了把目标Page的包名和类名都封装在需要传递的Intent类型的实例navigation中,需要调用navigation的方法setOperation并指定才创建的Intent类型的实例operation为其参数。最后用startAbility且把navigation作为参数。
从目标页面跳转到源页面且处理数据,需要在目标调用getAbility.setParam并设置响应码(是用来标识一次响应)。之后在原页面把startAbility变更为startAbilityForResult(响应码)-把回调方法onResult替换为onAbilityResult(响应码),
(四)跨设备迁移
- 设备A上的Page请求迁移。
- 系统回调设备A上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onStartContinuation()方法,以确认当前是否可以立即迁移。
- 如果可以立即迁移,则系统回调设备A上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onSaveData()方法,以便保存迁移后恢复状态必须的数据。
- 如果保存数据成功,则系统在设备B上启动同一个Page,并恢复AbilitySlice栈,然后回调IAbilityContinuation.onRestoreData()方法,传递此前保存的数据;此后设备B上此Page从onStart()开始其生命周期回调。
- 系统回调设备A上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onCompleteContinuation()方法,通知数据恢复成功与否。
- 迁移过程中发生异常,系统回调设备A上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onFailedContinuation()方法,通知迁移过程中发生异常,并不是所有异常都会回调FA此方法,仅局限于该接口枚举的异常。
总结
跨设备迁移是基于分布式流转操作的。是很有趣和很值得研究的功能
同Page,不同Page,不同设备。三种情况下Page生命周期需要搞懂,需要分清楚Page生命周期回调方法,与跨设备迁移中实现IAbilityContinuation接口的回调方法。一定注意源侧与目标侧的方法调用的顺序。
对于基础的Ability与Slice的关系、Slice与Layout(xml)的关系、Intent的理解得到了提升。