目录

应用重启

应用重启用于在不同场景下重新初始化应用或恢复应用正常状态。系统提供了应用主动重启、元服务主动重启和应用故障恢复被动重启等，开发者可根据实际需求选择合适方案。

应用主动重启以重新初始化应用

系统提供了“不保留应用窗口的重启”和“保留应用窗口的重启”两种主动重启应用的方式。以下是两种应用主动重启方式的能力对比，开发者可根据自己的业务需求进行选择。

对比维度 不保留应用窗口的重启 保留应用窗口的重启
适用场景 应用发生内部状态问题需要完全重新初始化；应用完成动态更新需要从初始状态开始。 应用发生内部状态问题需要完全重新初始化且不想露出桌面；应用完成动态更新需要从初始状态开始且不想露出桌面。
用户体验 不具有连贯性，用户视野会看到桌面。用户在体验上可能存在割裂感。 具有连贯性，用户视野停留在应用。避免用户在体验上出现割裂感。
调用接口 ApplicationContext.restartApp12+ UIAbilityContext.restartApp22+

[h2]不保留应用窗口的重启

从API version 12开始，ApplicationContext提供了restartApp()接口，用于主动重启应用并拉起指定的UIAbility。重启过程中不保留当前应用窗口，相当于完全重新启动应用。重启过程中不会触发应用中Ability的onDestroy生命周期回调。

存在以下约束限制：

示例代码：

import { hilog } from '@kit.PerformanceAnalysisKit';
import { common, Want } from '@kit.AbilityKit';

@Entry
@Component
struct Index {
  @State message: string = 'restartApp';
  private context = this.getUIContext().getHostContext()?.getApplicationContext() as common.ApplicationContext;

  build() {
    RelativeContainer() {
      Button(this.message)
        .id('HelloWorld')
        .fontSize($r('app.float.page_text_font_size'))
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
        .onClick(() => {
          let want: Want = {
            bundleName: 'com.example.restartapp',
            abilityName: 'EntryAbility'
          };
          if (this.context) {
            try {
              this.context.restartApp(want);
            } catch (err) {
              hilog.error(0x0000, 'testTag', `restart failed: ${err.code}, ${err.message}`);
            }
          } else {
            hilog.error(0x0000, 'testTag', "%{public}s", 'AppContext is null');
          }
        })
    }
    .height('100%')
    .width('100%')
  }
}

[h2]保留应用窗口的重启

从API version 22开始，UIAbilityContext提供了restartApp()接口，用于重启当前UIAbility所在的进程，并拉起应用内的指定UIAbility。与ApplicationContext的restartApp不同，该接口可选择保留当前窗口或跳转到新窗口。重启过程中不触发进程中Ability的onDestroy生命周期回调。

存在以下约束限制：

示例代码：

  1. 指定当前UIAbility，重启后刷新当前窗口至初始状态。

    import { hilog } from '@kit.PerformanceAnalysisKit';
import { common, Want } from '@kit.AbilityKit';

@Entry
@Component
struct Index {
  @State message: string = 'restartApp with window';

  build() {
    RelativeContainer() {
      Button(this.message)
        .id('HelloWorld')
        .fontSize($r('app.float.page_text_font_size'))
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
        .onClick(async () => {
          // 指定当前UIAbility，刷新当前窗口
          let want: Want = {
            bundleName: 'com.example.restartapp',
            abilityName: 'EntryAbility'
          };
          let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
          try {
            await context.restartApp(want);
            hilog.info(0x0000, 'testTag', 'restart success');
          } catch (err) {
            hilog.error(0x0000, 'testTag', `restart failed: ${err.code}, ${err.message}`);
          }
        })
    }
    .height('100%')
    .width('100%')
  }
}

  2. 指定应用内其他UIAbility，重启后跳转并打开新的Ability窗口。

    import { hilog } from '@kit.PerformanceAnalysisKit';
import { common, Want } from '@kit.AbilityKit';

@Entry
@Component
struct Index {
  @State message: string = 'restartApp to new page';

  build() {
    RelativeContainer() {
      Button(this.message)
        .id('HelloWorld')
        .fontSize($r('app.float.page_text_font_size'))
        .fontWeight(FontWeight.Bold)
        .alignRules({
          center: { anchor: '__container__', align: VerticalAlign.Center },
          middle: { anchor: '__container__', align: HorizontalAlign.Center }
        })
        .onClick(async () => {
          // 指定应用内其他UIAbility，跳转到新窗口
          let want: Want = {
            bundleName: 'com.example.restartapp',
            abilityName: 'SecondAbility'
          };
          let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
          try {
            await context.restartApp(want);
            hilog.info(0x0000, 'testTag', 'restart success');
          } catch (err) {
            hilog.error(0x0000, 'testTag', `restart failed: ${err.code}, ${err.message}`);
          }
        })
    }
    .height('100%')
    .width('100%')
  }
}

元服务主动重启

从API version 20开始，系统为元服务（Atomic Service）提供了专用的重启接口restartSelfAtomicService()，用于触发元服务更新并重启当前元服务。重启过程中不会保留当前元服务窗口，也不会触发旧Ability的onDestroy生命周期回调。

存在以下约束限制：

元服务是应用的一种特殊形式，也可采用应用主动重启以重新初始化应用的方式进行重启。

以下是三种方式主动重启元服务的能力对比，开发者可以根据自己的业务需求进行选择。

对比维度 元服务主动重启 不保留元服务窗口的重启 保留元服务窗口的重启
适用场景 元服务主动触发更新并重新初始化；元服务发生内部状态问题需要完全重新初始化。 元服务发生内部状态问题需要完全重新初始化；元服务完成动态更新需要从初始状态开始。 元服务发生内部状态问题需要完全重新初始化且不想露出桌面；元服务完成动态更新需要从初始状态开始且不想露出桌面。
用户体验 不具有连贯性，用户视野会看到桌面。用户在体验上可能存在割裂感。 不具有连贯性，用户视野会看到桌面。用户在体验上可能存在割裂感。 具有连贯性，用户视野停留在应用。避免用户在体验上出现割裂感。
免安装更新 支持 不支持 不支持
调用接口 AbilityManager.restartSelfAtomicService20+ ApplicationContext.restartApp12+ UIAbilityContext.restartApp22+

示例代码：

import { AbilityConstant, EmbeddableUIAbility, Want, abilityManager } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';

const DOMAIN = 0x0000;

export default class DemoAbility extends EmbeddableUIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    hilog.info(DOMAIN, 'DemoAbility', 'DemoAbility onCreate');
    try {
      // 触发当前元服务重启
      abilityManager.restartSelfAtomicService(this.context);
      hilog.info(DOMAIN, 'DemoAbility', 'restartSelfAtomicService success');
    } catch (e) {
      hilog.error(DOMAIN, 'DemoAbility', `restartSelfAtomicService error: ${JSON.stringify(e as BusinessError)}`);
    }
  }
}

应用故障恢复被动重启

应用故障恢复重启接口由appRecovery模块提供，详见应用恢复开发指导。