IAbilityContinuation

所有已知实现类:

AceAbility, AceDataAbility, AceServiceAbility
```
public interface IAbilityContinuation
```
Enables an Ability to implement migration in a distributed system.
You can use the migration capability provided by the Ability to migrate data between a local device and a remote device in a distributed system. The ability or ability slice that implements this interface has the migration capability. You can initiate a migration request by calling Ability#continueAbility() or AbilitySlice#continueAbility() on the local device, and then implement the methods provided in this interface to save or restore application data. The saved data is managed by the distributed data management module. The remote device can obtain and restore the saved data when starting the ability. In this way, the ability on the local device is migrated to the remote device.

从以下版本开始:

1

SystemCapability

SystemCapability.Aafwk#ABILITY

字段概要

字段
限定符和类型	字段	说明
`static int`	`ERR_ABILITY_QUERY_FAILED`	Indicates that the HAP package of the application cannot be found.
`static int`	`ERR_CONTINUE_TIMEOUT`	Indicates that the migration times out.
`static int`	`ERR_DEVICE_OFFLINE`	Indicates that the device goes offline during the migration.
`static int`	`ERR_INSTALL_FREE_NOT_SUPPORTED`	Indicates that the ability to be migrated does not support the installation-free feature.
`static int`	`ERR_NETWORK_UNAVAILABLE`	Indicates that the network of the peer device is unavailable.
`static int`	`ERR_PARAMETER_INVALID`	Indicates that the parameter verification fails.
`static int`	`ERR_PERMISSION_DENIED`	Indicates that the permission verification fails.
`static int`	`ERR_REMOTE_DEVICE_INCOMPATIBLE`	Indicates that the OS version of the peer device is incompatible.
`static int`	`ERR_UNKNOWN`	Indicates that the migration fails.
`static int`	`SUCCESS`	Indicates that the migration is successful.

方法概要

所有方法实例方法抽象方法默认方法
限定符和类型	方法	说明
`void`	`onCompleteContinuation(int result)`	Called back when a local ability migration is complete.
`default void`	`onFailedContinuation(int errorCode)`	Called when an error occurred during the migration process of a local ability.
`default void`	`onRemoteTerminated()`	Called to notify the local device when a running ability on the remote device is destroyed after a reversible migration is performed for the ability from the local device to the remote device.
`boolean`	`onRestoreData(IntentParams restoreData)`	Restores the user data saved during the migration for an ability on the remote device immediately after the ability is created on the remote device.
`boolean`	`onSaveData(IntentParams saveData)`	Saves the user data (carried in the `IntentParams` object) of a local ability generated during runtime.
`boolean`	`onStartContinuation()`	Asks a user whether to start the migration.

- 字段详细资料
  - ERR_ABILITY_QUERY_FAILED
```
static final int ERR_ABILITY_QUERY_FAILED
```
    Indicates that the HAP package of the application cannot be found.
    This constant is an error code returned to the application via onFailedContinuation(int) when an error occurred during the ability migration process.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - ERR_CONTINUE_TIMEOUT
```
static final int ERR_CONTINUE_TIMEOUT
```
    Indicates that the migration times out. The timeout duration is 50 seconds.
    This constant is an error code returned to the application via onFailedContinuation(int) when an error occurred during the ability migration process.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - ERR_DEVICE_OFFLINE
```
static final int ERR_DEVICE_OFFLINE
```
    Indicates that the device goes offline during the migration.
    This constant is an error code returned to the application via onFailedContinuation(int) when an error occurred during the ability migration process.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - ERR_INSTALL_FREE_NOT_SUPPORTED
```
static final int ERR_INSTALL_FREE_NOT_SUPPORTED
```
    Indicates that the ability to be migrated does not support the installation-free feature.
    This constant is an error code returned to the application via onFailedContinuation(int) when an error occurred during the ability migration process.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - ERR_NETWORK_UNAVAILABLE
```
static final int ERR_NETWORK_UNAVAILABLE
```
    Indicates that the network of the peer device is unavailable.
    This constant is an error code returned to the application via onFailedContinuation(int) when an error occurred during the ability migration process.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - ERR_PARAMETER_INVALID
```
static final int ERR_PARAMETER_INVALID
```
    Indicates that the parameter verification fails.
    This constant is an error code returned to the application via onFailedContinuation(int) when an error occurred during the ability migration process.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - ERR_PERMISSION_DENIED
```
static final int ERR_PERMISSION_DENIED
```
    Indicates that the permission verification fails.
    This constant is an error code returned to the application via onFailedContinuation(int) when an error occurred during the ability migration process.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - ERR_REMOTE_DEVICE_INCOMPATIBLE
```
static final int ERR_REMOTE_DEVICE_INCOMPATIBLE
```
    Indicates that the OS version of the peer device is incompatible.
    This constant is an error code returned to the application via onFailedContinuation(int) when an error occurred during the ability migration process.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - ERR_UNKNOWN
```
static final int ERR_UNKNOWN
```
    Indicates that the migration fails.
    This constant is a result code returned to the application via onCompleteContinuation(int) after the migration process is complete.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - SUCCESS
```
static final int SUCCESS
```
    Indicates that the migration is successful.
    This constant is a result code returned to the application via onCompleteContinuation(int) after the migration process is complete.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
- 方法详细资料
  - onStartContinuation
```
boolean onStartContinuation()
```
    Asks a user whether to start the migration.
    This method is called back when a local ability initiates a migration request.
    
    If the Ability does not implement this method, this Ability cannot be migrated, and false is returned. If the AbilitySlice does not implement this method, it does not affect whether its host ability can be migrated, and true is returned by default.
    
    返回:
    
    Returns true if the user allows the migration; returns false otherwise.
    
    从以下版本开始:
    
    1
  - onSaveData
```
boolean onSaveData(IntentParams saveData)
```
    Saves the user data (carried in the IntentParams object) of a local ability generated during runtime. After the migration is triggered and the local ability is ready, this method is called when the Distributed Scheduler Service requests data from the local ability.
    
    参数:
    
    saveData - Indicates the user data to save.
    
    返回:
    
    Returns true if the data is successfully saved; returns false otherwise.
    
    从以下版本开始:
    
    1
  - onRestoreData
```
boolean onRestoreData(IntentParams restoreData)
```
    Restores the user data saved during the migration for an ability on the remote device immediately after the ability is created on the remote device. Lifecycle scheduling for the ability starts only after the user data is restored.
    
    参数:
    
    restoreData - Indicates the user data to restore.
    
    返回:
    
    Returns true if the data is successfully restored; returns false otherwise.
    
    从以下版本开始:
    
    1
  - onCompleteContinuation
```
void onCompleteContinuation(int result)
```
    Called back when a local ability migration is complete.
    You can define the processing logic after the migration is complete. For example, you can display a prompt to notify the user of the successful migration and then exit the local ability.
    
    参数:
    
    result - Indicates the migration result code. The value 0 indicates that the migration is successful, and -1 indicates that the migration fails.
    
    从以下版本开始:
    
    1
  - onRemoteTerminated
```
default void onRemoteTerminated()
```
    Called to notify the local device when a running ability on the remote device is destroyed after a reversible migration is performed for the ability from the local device to the remote device. A reversible migration is triggered by calling Ability#continueAbilityReversibly() or Ability#continueAbilityReversibly(String).
    
    从以下版本开始:
    
    3
  - onFailedContinuation
```
default void onFailedContinuation(int errorCode)
```
    Called when an error occurred during the migration process of a local ability.
    You can define the processing logic upon a migration error. For example, you can display a prompt message indicating that the network of the peer device is unavailable.
    
    参数:
    
    errorCode - Indicates the migration error code, which is defined in this interface.
    
    从以下版本开始:
    
    6

接口 IAbilityContinuation

字段概要

方法概要

字段详细资料

ERR_ABILITY_QUERY_FAILED

ERR_CONTINUE_TIMEOUT

ERR_DEVICE_OFFLINE

ERR_INSTALL_FREE_NOT_SUPPORTED

ERR_NETWORK_UNAVAILABLE

ERR_PARAMETER_INVALID

ERR_PERMISSION_DENIED

ERR_REMOTE_DEVICE_INCOMPATIBLE

ERR_UNKNOWN

SUCCESS

方法详细资料

onStartContinuation

onSaveData

onRestoreData

onCompleteContinuation

onRemoteTerminated

onFailedContinuation