网站导航
> 文档中心 > 鸿蒙应用迁移类型

鸿蒙应用迁移类型

网友: 文档中心 2022-03-31 14:49:56

在这里插入图片描述
鸿蒙应用迁移是鸿蒙系统的亮点之一，是为了在装有同一款应用的不同设备之间架起快速切换的桥梁。以上图为例，设备A（源设备）可将应用无缝迁移到设备B（目标设备，安装有同款应用）上，就和投影差不多，无非是这里的投影可以有和设备A上拥有相同的交互。迁移可以跨设备，分为单项和双向，就是可撤回迁移和不可撤回迁移，对于细节不太了解的可以看看鸿蒙应用迁移，这里主要对迁移类型进行粗略阐述。

准备工作

使用应用迁移就必须实现IAbilityContinuation接口，这里的实现不仅仅是指能够迁移的AbilitySlice，还包括其所属的Ability。以MainAbilitySlice为例：

public class MainAbilitySlice extends AbilitySlice implements IAbilityContinuation {...}

同时在MainAbility也要有相同的操作：

public class MainAbility extends Ability implements IAbilityContinuation {...}

IAbilityContinuation是关键部分：

public interface IAbilityContinuation {    boolean onStartContinuation();    boolean onSaveData(IntentParams var1);    boolean onRestoreData(IntentParams var1);    void onCompleteContinuation(int var1);    default void onRemoteTerminated() { throw new RuntimeException("Stub!");    }}

当实现了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是对迁移发生异常后处理，比如弹框提示用户。

  1. 当原设备请求迁移时，系统会调用源设备上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onStartContinuation()方法，以确认当前是否可以立即迁移。
  2. 如果可以立即迁移，则系统回调源设备上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onSaveData()方法，以便保存迁移后恢复状态必须的数据。
  3. 如果保存数据成功，则系统在目标设备上启动同一个Page，并恢复AbilitySlice栈，然后回调IAbilityContinuation.onRestoreData()方法，传递此前保存的数据；此后目标设备上此Page从onStart()开始其生命周期回调。
  4. 系统回调设备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){     ...  }    });

详细流程如下：

  1. 当源设备请求撤回迁移，系统会调用目标设备上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onStartContinuation()方法，以确认当前是否可以立即迁移。
  2. 如果可以立即迁移，则系统会调用目标设备上Page及其AbilitySlice栈中所有AbilitySlice实例的IAbilityContinuation.onSaveData()方法，以便保存回迁后恢复状态必须的数据。
  3. 如果保存数据成功，则系统在源设备上Page恢复AbilitySlice栈，然后回调IAbilityContinuation.onRestoreData()方法，传递此前保存的数据。
  4. 如果数据恢复成功，则系统终止目标设备上Page的生命周期。

其实可撤回迁移相当于目标设备向源设备迁移了一次，但触发点在源设备上。

区别

不可撤回迁移源设备和目标设备可以相互迁移，即源设备和目标设备都可以调用continueAbility，把应用迁移到对方身上。源设备调用continueAbility把应用迁移到目标设备上，目标设备想改变一下主次位置，然后调用continueAbility，此时目标设备就是原来的源设备，而源设备变成了目标设备。
鸿蒙应用迁移类型

可撤回迁移无法相互迁移，当源设备调用continueAbilityReversibly将应用迁移至目标设备上，若此时目标设备调用continueAbilityReversibly会退出当前应用，无法将应用再迁移到源设备上，既然可以撤回，在目标设备上向源设备进行迁移也相当于撤回，没有必要。
鸿蒙应用迁移类型
由上可知，应用迁移时设备之间的迁移通道应该只有一条，不可撤回迁移迁移动作完成后通道被释放，目标设备结束后再次创建通道进行数据同步；而可撤回迁移目标迁移动作完成后迁移通道一直维持着以保证可以随时撤回，若目标设备想迁移到源设备身上没有迁移通道可用，故无法迁移，所以迁移通道只有一条。
由于迁移通道只有一条，所以目前设备迁移只限于两台设备之间。若将来弄一个迁移中心点类似于云迁移，到时候可以进行多设备迁移。纯属瞎想，欢迎纠正。

注

以上部分素材来自于华为鸿蒙Harmony。

网络标签：

相关问题