} }
当实现了IAbilityContinuation ,onStartContinuation、onSaveData、onRestoreData、onCompleteContinuation是一定要重写的,onRemoteTerminated可选择性重写。
- onStartContinuation()
请求迁移后,系统首先回调此方法,开发者可以在此回调中决策当前是否可以执行迁移,比如,弹框让用户确认是否开始迁移,也可以准备一些数据或做一些页面调整。一般只要实现了接口,该方法的返回值一般都置为true。
@Override public boolean onStartContinuation() { return true; }
- onSaveData()
如果onStartContinuation()返回true,则系统回调此方法,开发者在此回调中保存必须传递到另外设备上以便恢复Page状态的数据。
@Override public boolean onSaveData(IntentParams intentParams) { intentParams.setParam("data",data); return true; }
data即迁移的目标设备被打开至相同页面,该页面需要的数据,具体使用和Intent一样,根据需要组装。
- onRestoreData()
源设备上Page完成保存数据后,系统在目标设备上回调此方法,开发者在此回调中接受用于恢复Page状态的数据。注意,在目标设备上的Page会重新启动其生命周期,无论其启动模式如何配置。且系统回调此方法的时机在onStart()之前。
// start之前调用 @Override public boolean onRestoreData(IntentParams intentParams) { initData = intentParams.getParam("data").toString(); return true; }
代码中的initData是源设备完成迁移后又恢复至原始状态后初始化需要的数据。因为用户可能在目标设备上进行了一些交互,页面的数据已发生改变,所以需要回传数据,不能用onSaveData里面的数据,否则两边设备可能不同步。
- onCompleteContinuation()
目标侧设备上恢复数据一旦完成,系统就会在源设备上回调Page的此方法,以便通知应用迁移流程已结束。开发者可以在此检查迁移结果是否成功,并在此处理迁移结束的动作,例如,应用可以在迁移完成后终止自身生命周期等等。
@Override public void onCompleteContinuation(int i) { // 迁移后原设备操作 // terminateAbility();
}
- onRemoteTerminated()
如果开发者使用continueAbilityReversibly()而不是continueAbility(),则此后可以在源设备上使用reverseContinueAbility()进行回迁。这种场景下,相当于同一个Page(的两个实例)同时在两个设备上运行,迁移完成后,如果目标设备上Page因任何原因终止,则源Page通过此回调接收终止通知。
迁移类型
- 不可撤回迁移
不可撤回迁移也就是单向迁移,迁出去后不需要管理,需要回来的时候接收一下就可以。单向迁移需要调用continueAbility。
findComponentById(ResourceTable.Id_button_migration).setClickedListener( component -> { String deviceId = DeviceUtils.getDeviceId(); if(deviceId != null){ try { continueAbility(deviceId); }catch (IllegalStateException e){ ... } } } );
使用try.catch是对迁移发生异常后处理,比如弹框提示用户。
- 当原设备请求迁移时,系统会调用源设备上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onStartContinuation()方法,以确认当前是否可以立即迁移。
- 如果可以立即迁移,则系统回调源设备上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onSaveData()方法,以便保存迁移后恢复状态必须的数据。
- 如果保存数据成功,则系统在目标设备上启动同一个Page,并恢复AbilitySlice栈,然后回调IAbilityContinuation.onRestoreData()方法,传递此前保存的数据;此后目标设备上此Page从onStart()开始其生命周期回调。
- 系统回调设备A上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onCompleteContinuation()方法,通知数据恢复成功与否。
- 可撤回迁移
可撤回迁移就是在源设备上有控制目标设备的功能,当源设备不想迁移了或想中断,可以使用可撤回迁移,迁移开始的步骤可不可撤回迁移差不多,主要是调用的方法不一样。
findComponentById(ResourceTable.Id_button_migration_can_back).setClickedListener( component -> { String deviceId = DeviceUtils.getDeviceId(); if(deviceId != null){ try { // 可撤回迁移 continueAbilityReversibly(deviceId); }catch (IllegalStateException e){ ... } } } );
详细的调用方法和不可撤回迁移一样。但源设备想要撤回的时候需要调用reverseContinueAbility。
findComponentById(ResourceTable.Id_button_migration_back_back1).setClickedListener(component -> { try { // 撤回迁移 reverseContinueAbility(); } catch (IllegalStateException e){ ... }
深知大多数程序员,想要提升技能,往往是自己摸索成长,但自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,涵盖了95%以上鸿蒙开发知识点,真正体系化!
由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频,并且后续会持续更新