1. 消失的表单

用户正在填写一个长长的注册表单,填了一半,切出去回了个短信。
过了半小时回来,发现应用重启了!表单里的数据全部清空,回到了登录页。
用户愤怒地卸载了应用。

这是移动开发中经典的"应用状态丢失"问题。在鸿蒙系统上,由于内存管理机制,后台应用随时可能被系统回收(Kill)。

2. 生命周期不匹配

Qt应用的生命周期(QApplication)通常假设应用会一直运行直到用户关闭。
而鸿蒙的Ability生命周期包含 OnForeground, OnBackground 以及不可见的 OnDestroy (被回收时可能甚至不调用)。

鸿蒙提供了一个关键的回调:onSaveAbilityState,用于在系统回收Ability之前保存状态。

生命周期流程图

User Home
Low Memory
Save Data?
User Relaunch
Read Data
Active / Foreground
Background
Process Killed
WantAgent / Storage
Restore Ability
AppRunning

3. 解决方案:状态保存与恢复

我们需要在ArkTS层监听状态保存事件,并将Qt层的关键数据序列化后传递给鸿蒙系统。

第一步:定义Qt侧的数据导出接口

// StateManager.h
class StateManager : public QObject {
    Q_OBJECT
public:
    // 返回JSON格式的当前状态
    Q_INVOKABLE QString dumpState() {
        QJsonObject root;
        root["username"] = m_username;
        root["step"] = m_currentStep;
        // ...
        return QJsonDocument(root).toJson();
    }

    // 恢复状态
    Q_INVOKABLE void restoreState(const QString &json) {
        // 解析JSON并恢复界面
    }
};

第二步:ArkTS层监听 onSaveAbilityState

EntryAbility.ets 中:

import UIAbility from '@ohos.app.ability.UIAbility';
import Want from '@ohos.app.ability.Want';

export default class EntryAbility extends UIAbility {
    onSaveAbilityState(outState: { [key: string]: Object }) {
        console.log('EntryAbility onSaveAbilityState');
        
        // 调用Qt的方法获取状态
        // 假设我们通过globalThis或其他方式暴露了Qt对象
        let qtState = globalThis.qtApp.dumpState();
        
        // 保存到outState
        outState['qt_app_state'] = qtState;
    }

    onRestoreAbilityState(inState: { [key: string]: Object }) {
        console.log('EntryAbility onRestoreAbilityState');
        // 保存这个inState,等Qt启动好了再传给它
        globalThis.savedState = inState['qt_app_state'];
    }
    
    onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
        // ...
    }
}

第三步:Qt启动时检查恢复

当应用被重建时,Qt重新初始化。我们需要在初始化完成后,检查是否有保存的状态。

// main.cpp
int main(int argc, char *argv[]) {
    QGuiApplication app(argc, argv);
    // ...
    
    // 检查是否有恢复数据
    QString savedJson = NativeInterface::getSavedState();
    if (!savedJson.isEmpty()) {
        StateManager::instance()->restoreState(savedJson);
    }
    
    return app.exec();
}

4. 实战技巧:实时保存 (Auto-Save)

依赖 onSaveAbilityState 有时并不靠谱(极端情况下系统可能直接Kill进程来不及回调)。
更好的策略是实时保存周期性保存

对于表单类应用,可以在 QLineEdit::editingFinished 时写入本地临时文件(使用 QSettings 或 SQLite)。

void FormWidget::onTextChange() {
    // 存入 QSettings (SharedPreferences)
    QSettings settings;
    settings.setValue("draft_username", ui->editUser->text());
}

void FormWidget::init() {
    // 恢复
    QSettings settings;
    ui->editUser->setText(settings.value("draft_username").toString());
}

这种"实时草稿"模式比依赖系统生命周期更稳健。

5. 总结

不要假设你的应用能永远活着。
在移动端(鸿蒙/Android/iOS),应用随时可能被杀。

  1. 轻量数据(滚动位置、Tab页签):利用 onSaveAbilityState 恢复,体验最丝滑。
  2. 核心数据(用户输入):利用 QSettings 或数据库实时写入磁盘
  3. 架构设计:UI层与数据层分离,确保随时可以通过数据重建UI。

做好状态恢复,是区分"Demo级应用"和"产品级应用"的重要标志。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐