目录

应用被用户主动退出/清理时如何保存数据

问题现象

编辑页面内容时,如果应用被用户主动退出或者应用进程被清理时,应该如何保存当前页面未提交信息?

背景知识

解决方案

用户主动退出应用有以下几种场景:

退出方式

触发事件

多任务中心一键清理

系统会发送公共事件:名称event为RECENT_EVENT,数据data为RECENT_CLEAR_ALL。

多任务中心上滑清理

系统会触发onWindowStageWillDestroy()回调

注意:无论是通过多任务中心上滑退出应用还是通过一键清理退出应用都会杀死应用进程,所以在收到onWindowStageWillDestroy回调或是公共事件回调时仅有短暂的时间(约几毫秒)可供应用保存数据,因此该方案仅适用于保存少量数据,不适用于保存大数据或耗时操作。

以下为使用首选项实现的应用退出时保存页面数据的完整示例代码:

import { AbilityLifecycleCallback, common } from '@kit.AbilityKit';
import { preferences } from '@kit.ArkData';
import { BusinessError, commonEventManager } from '@kit.BasicServicesKit';

@Observed
class UserInfo {
  name: string = '';
  cardId: string = '';
  phone: string = '';
  email: string = '';

  setName(value: string) {
    this.name = value;
  }

  setCardId(value: string) {
    this.cardId = value;
  }

  setPhone(value: string) {
    this.phone = value;
  }

  setEmail(value: string) {
    this.email = value;
  }
}

@Entry
@Component
struct Index {
  @State userInfo: UserInfo = new UserInfo();
  isSaving: boolean = false;
  context = this.getUIContext().getHostContext() as common.UIAbilityContext;
  appContext = this.context.getApplicationContext();
  dataPreferences: preferences.Preferences | null = null;

  aboutToAppear(): void {
    this.getPreferenceInfo();
    this.subscribeMultitaskCleanup();
    this.subscribeMultitaskSlipUpDelete();
  }

  subscribeMultitaskCleanup() {
    // 定义订阅者,用于保存创建成功的订阅者对象,后续使用其完成订阅及退订的动作
    let subscriber: commonEventManager.CommonEventSubscriber;
    // 订阅者信息
    let subscribeInfo: commonEventManager.CommonEventSubscribeInfo = {
      events: ['RECENT_EVENT'] // 多任务事件
    };
    // 创建订阅者
    try {
      commonEventManager.createSubscriber(subscribeInfo,
        (err: BusinessError, commonEventSubscriber: commonEventManager.CommonEventSubscriber) => {
          if (!err) {
            console.info(`Succeeded in creating subscriber.`);
            subscriber = commonEventSubscriber;
            // 订阅公共事件
            try {
              commonEventManager.subscribe(subscriber,
                (err: BusinessError, eventData: commonEventManager.CommonEventData) => {
                  if (err) {
                    console.error(`Failed to subscribe. Code is ${err.code}, message is ${err.message}`);
                    return;
                  }
                  // 多任务点击一键清理事件
                  if (eventData.data === 'RECENT_CLEAR_ALL') {
                    // 监听多任务视图一键清理事件,进行业务处理
                    this.saveAppData();
                  }
                  console.info(`Succeeded in subscribing, eventData is ${JSON.stringify(eventData)}`);
                });
            } catch (error) {
              let err: BusinessError = error as BusinessError;
              console.error(`Failed to subscribe. Code is ${err.code}, message is ${err.message}`);
            }
            return;
          }
          console.error(`Failed to create subscriber. Code is ${err.code}, message is ${err.message}`);
        });
    } catch (error) {
      let err: BusinessError = error as BusinessError;
      console.error(`Failed to create subscriber. Code is ${err.code}, message is ${err.message}`);
    }
  }

  subscribeMultitaskSlipUpDelete() {
    let _this = this;
    let abilityLifecycleCallback: AbilityLifecycleCallback = {
      onWindowStageWillDestroy() {
        console.info(`AbilityLifecycleCallback onWindowStageWillDestroy.`);
        // 监听onWindowStageWillDestroy回调,进行业务处理
        _this.saveAppData();
      },
      onAbilityCreate() {
        console.info(`AbilityLifecycleCallback onAbilityCreate.`);
      },
      onWindowStageCreate() {
        console.info(`AbilityLifecycleCallback onWindowStageCreate.`);
      },
      onWindowStageActive() {
        console.info(`AbilityLifecycleCallback onWindowStageActive.`);
      },
      onWindowStageInactive() {
        console.info(`AbilityLifecycleCallback onWindowStageInactive.`);
      },
      onWindowStageDestroy() {
        console.info(`AbilityLifecycleCallback onWindowStageDestroy.`);
      },
      onAbilityDestroy() {
        console.info(`AbilityLifecycleCallback onAbilityDestroy.`);
      },
      onAbilityForeground() {
        console.info(`AbilityLifecycleCallback onAbilityForeground.`);
      },
      onAbilityBackground() {
        console.info(`AbilityLifecycleCallback onAbilityBackground.`);
      },
      onAbilityContinue() {
        console.info(`AbilityLifecycleCallback onAbilityContinue.`);
      }
    };
    try {
      // 通过applicationContext注册监听应用内生命周期
      let lifecycleId = this.appContext.on('abilityLifecycle', abilityLifecycleCallback);
      console.info(`registerAbilityLifecycleCallback lifecycleId: ${lifecycleId}`);
    } catch (paramError) {
      console.error(`registerAbilityLifecycleCallback failed,error code: ${(paramError as BusinessError).code}, error msg: ${(paramError as BusinessError).message}`);
    }
  }

  saveAppData() {
    try {
      if (this.isSaving) {
        console.info('already saving, skip this time.');
        return;
      }
      this.isSaving = true;
      if (this.userInfo) {
        // 保存应用业务数据
        this.savePreferenceInfo();
      }
    } catch (error) {
      console.error(`saveAppData failed. code is ${(error as BusinessError)?.code} message is ${(error as BusinessError)?.message}`);
    }
  }

  // 初始化Preference
  initPreferences() {
    try {
      if (this.dataPreferences == null) {
        this.dataPreferences = preferences.getPreferencesSync(this.context, { name: 'appCache' });
      }
    } catch (error) {
      let err = error as BusinessError;
      console.error(`getPreferencesSync failed. code is ${err.code} message is ${err.message}`);
    }
  }

  // 保存数据到Preference中并持久化
  savePreferenceInfo() {
    try {
      this.initPreferences();
      this.dataPreferences?.putSync('cacheData', JSON.stringify(this.userInfo));
      this.dataPreferences?.flushSync();
      console.info(`this.userInfo => ${JSON.stringify(this.userInfo)}`);
    } catch (error) {
      let err = error as BusinessError;
      console.error(`savePreferenceInfo failed. code is ${err.code} message is ${err.message}`);
    }
  }

  // 从Preference中获取数据
  getPreferenceInfo() {
    try {
      this.initPreferences();
      let cacheData = this.dataPreferences?.getSync('cacheData', '') as string;
      console.info(`cacheData => ${JSON.stringify(cacheData)}`);
      if (cacheData) {
        let userInfo = JSON.parse(cacheData) as UserInfo;
        this.userInfo.setName(userInfo.name);
        this.userInfo.setCardId(userInfo.cardId);
        this.userInfo.setPhone(userInfo.phone);
        this.userInfo.setEmail(userInfo.email);
        console.info(`this.userInfo => ${JSON.stringify(this.userInfo)}`);
      }
    } catch (error) {
      let err = error as BusinessError;
      console.error(`getPreferenceInfo failed. code is ${err.code} message is ${err.message}`);
    }
  }

  build() {
    Navigation() {
      Column({ space: 20 }) {
        this.InputStyle('姓名', '证件号码', this.userInfo.name, (value: string) => {
          this.userInfo.setName(value);
        });

        this.InputStyle('证件号码', '联系电话', this.userInfo.cardId, (value: string) => {
          this.userInfo.setCardId(value);
        }, InputType.Number);

        this.InputStyle('联系电话', '电子邮箱', this.userInfo.phone, (value: string) => {
          this.userInfo.setPhone(value);
        }, InputType.PhoneNumber);

        this.InputStyle('电子邮箱', '', this.userInfo.email, (value: string) => {
          this.userInfo.setEmail(value);
        }, InputType.Email);
      }
      .width('100%')
      .height('100%')
      .alignItems(HorizontalAlign.Start)
      .justifyContent(FlexAlign.Start)
      .padding(20);
    }
    .backgroundColor('#F1F3F5');
  }

  // Input样式子组件封装
  @Builder
  InputStyle(text: string, next: string, val: string, setValue: Function,
    type: InputType = InputType.Normal) {
    Row() {
      Text(text)
        .fontSize(16)
        .fontWeight(500);
      TextInput({ placeholder: `请输入${text}`, text: val })
        .key(text)// 定义当前填写项的key值
        .fontSize(16)
        .width('60%')
        .layoutWeight(1)
        .type(type)
        .placeholderColor('#66000000')
        .placeholderFont({ size: 16, weight: 400 })
        .backgroundColor(Color.White)
        .enterKeyType(EnterKeyType.Next)
        .onSubmit(() => {
          focusControl.requestFocus(next); // 填写跳转目标填写项的key值
        })
        .onChange((value: string) => {
          setValue(value);
        });
    }
    .width('100%')
    .height(50)
    .backgroundColor(Color.White)
    .padding({ left: 15, right: 15 })
    .borderRadius(18);
  };
}