HarmonyOS鸿蒙Next中当应用在后台运行后，再回到前台运行时，需要更新所有控件的状态，用arkts写代码怎么实现？

HarmonyOS鸿蒙Next中当应用在后台运行后，再回到前台运行时，需要更新所有控件的状态，用arkts写代码怎么实现？ 需求是当应用从后台运行到前台时，需要更新Text的文本内容，代码如下

@Entry
@Component
struct Index {
  @State status: string = '';

  aboutToAppear(): void {
    console.log('aboutToAppear called')
    this.status = '处于前台状态'
  }

  aboutToDisappear(): void {
    console.log('aboutToDisappear called')
    this.status = '处于后台状态'
  }

  build() {
    Column() {
      Text(this.status)
        .fontSize($r('app.float.page_text_font_size'))
        .fontWeight(FontWeight.Bold)
    }
    .height('100%')
    .width('100%')
  }
}

我用aboutToAppear并不能解决问题，查阅资料查到应用前后台切换时会触发UIAbility中的onForeground和onBackground事件，

我怎么从entry/src/main/ets/entryability/EntryAbility.ets的onForeground方法调用到entry/src/main/ets/pages/Index.ets而去修改Text的内容？


更多关于HarmonyOS鸿蒙Next中当应用在后台运行后，再回到前台运行时，需要更新所有控件的状态，用arkts写代码怎么实现？的实战教程也可以访问 https://www.itying.com/category-93-b0.html

6 回复

【背景知识】

  • UIAbility是包含UI界面的应用组件，当应用首次启动到前台或者从后台转入到前台时，系统触发UIAbility.onForeground回调；当应用从前台转入到后台时，系统触发UIAbility.onBackground回调。
  • Emitter模块提供了在同一进程不同线程间，或同一进程同一线程内，发送和处理事件的能力，包括持续订阅事件、单次订阅事件、取消订阅事件，以及发送事件到事件队列的能力。

【解决方案】

使用Emitter模块实现onForeground方法调用。

  1. 在Index.ets的aboutToAppear中使用emitter.on实现事件持续订阅。
import { emitter } from '@kit.BasicServicesKit';

@Entry
@Component
struct Index {
  @State status: string = '处于前台状态';

  aboutToAppear(): void {
    let onForegroundCallback: Callback<emitter.EventData> = (eventData: emitter.EventData) => {
      console.log('onForeground called')
      this.status = '处于前台状态'
    }
    // 收到eventId为"onForegroundEvent"的事件后执行回调函数
    emitter.on(`onForegroundEvent`, onForegroundCallback);

    let onBackgroundCallback: Callback<emitter.EventData> = (eventData: emitter.EventData) => {
      console.log('onBackground called')
      this.status = '处于后台状态'
    }
    // 收到eventId为"onBackgroundEvent"的事件后执行回调函数
    emitter.on(`onBackgroundEvent`, onBackgroundCallback);
  }

  aboutToDisappear(): void {
    emitter.off(`onForegroundEvent`);
    emitter.off(`onBackgroundEvent`);
  }

  build() {
    Column() {
      Text(this.status)
        .fontSize($r('app.float.page_text_font_size'))
        .fontWeight(FontWeight.Bold)
    }
    .height('100%')
    .width('100%')
  }
}
  1. 在EntryAbility.ets中的onForeground和onBackground事件中发送指定事件。
  onForeground(): void {
    // Ability has brought to foreground
    emitter.emit('onForegroundEvent')
    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onForeground');
  }

  onBackground(): void {
    // Ability has back to background
    emitter.emit('onBackgroundEvent')
    hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onBackground');
  }

更多关于HarmonyOS鸿蒙Next中当应用在后台运行后，再回到前台运行时，需要更新所有控件的状态，用arkts写代码怎么实现？的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


【背景知识】

onPageShow：router路由页面（仅@Entry装饰的自定义组件）每次显示时触发一次，包括路由跳转、应用进入前台等场景。

【参考方案】

可参考自定义相机定时拍摄示例，通过@ohos.multimedia.camera实现相机定时拍摄，并提供相机预览、图片保存和权限管理等功能。

  • 使用自定义组件，点击图标切换定时时间，设置定时时间为3s或7s。
Image(this.timerPic)
  .height(CameraConstants.IMAGE_HEIGHT)
  .margin(CameraConstants.MARGIN)
  .onClick(() => {
    this.index = (this.index + 1) % this.timerArray.length;
    this.timerPic = this.timerImageArray[this.index];
    this.timerShooting = this.timerArray[this.index];
    this.isVisibleTimerSet = true;
    setTimeout(()=>{
      this.isVisibleTimerSet = false;
    }, 1000)
  })
  • 相机权限管理，在aboutToAppear中申请权限，每次页面显示(onPageShow)时检查是否授权，未授权时无预览页面，点击申请权限按钮二次申请权限。
aboutToAppear(): void {
  // ...
  atManager.requestPermissionsFromUser(context, ['ohos.permission.CAMERA'])
    .then((data: PermissionRequestResult) => {
      // ...
    })
}
onPageShow() {
  if (this.checkPermissions(permissions)) {
    // ...
  } else {
    // ...
  }
}
Button($r('app.string.button_text'))
  .onClick(() => {
    atManager.requestPermissionOnSetting(context, ['ohos.permission.CAMERA'])
      .then((data: Array<abilityAccessCtrl.GrantStatus>) => {
        if (data[0] === abilityAccessCtrl.GrantStatus.PERMISSION_GRANTED) {
          // ...
        } else {
          // ...
        }
    })
  });

Index.ets：自定义组件有一个 onPageShow回调方法，在应用进入前台时触发一次。

EntryAbility里面的方法，使用EventHub添加事件通知

onBackground(): void {
  // 进入后台
  EventHub....（你封装的发送事件通知的方法，发送进入后台的通知）
}

onForeground(): void {
   // 进入前台
  EventHub....（你封装的发送事件通知的方法，发送进入前台的通知）
}

让后在你所需页面监听下对应事件通知，然后刷新UI

在ArkTS中，应用从后台返回前台时可通过onPageShow生命周期回调处理状态更新。在对应Page的aboutToAppear或自定义onPageShow方法中调用状态刷新函数，使用@State装饰器管理控件状态变量，修改这些变量会自动触发UI重新渲染。需避免在aboutToDisappear中执行耗时操作。可通过AppStorage或LocalStorage实现跨页面状态同步。

在HarmonyOS Next中，当应用从后台回到前台时，可以通过UIAbility的onForeground生命周期回调来触发页面状态更新。以下是实现步骤：

  1. 在EntryAbility.ts中注册应用前后台切换监听：
import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';

export default class EntryAbility extends UIAbility {
  onForeground(): void {
    // 应用回到前台时触发
    // 通过EventHub发送事件到页面
    this.context.eventHub.emit('foreground', '处于前台状态');
  }

  onBackground(): void {
    // 应用进入后台时触发  
    this.context.eventHub.emit('background', '处于后台状态');
  }
}
  1. 在Index.ets页面中监听事件并更新状态：
@Entry
@Component
struct Index {
  @State status: string = '';

  onPageShow(): void {
    // 注册事件监听
    this.getContext().eventHub.on('foreground', (data: string) => {
      this.status = data;
    });
    this.getContext().eventHub.on('background', (data: string) => {
      this.status = data;
    });
  }

  onPageHide(): void {
    // 取消事件监听
    this.getContext().eventHub.off('foreground');
    this.getContext().eventHub.off('background');
  }

  build() {
    Column() {
      Text(this.status)
        .fontSize($r('app.float.page_text_font_size'))
        .fontWeight(FontWeight.Bold)
    }
    .height('100%')
    .width('100%')
  }
}

这种方式通过EventHub实现了UIAbility与页面之间的通信，确保应用前后台切换时能够正确更新界面状态。aboutToAppear仅在页面首次创建时触发，而onPageShow在每次页面显示时都会触发，更适合此场景。

回到顶部