场景一:PersistenceV2.connect/PersistenceV2.globalConnect执行在loadContent方法之前,导致再次进入应用持久化数据读取失败,每次都会重新创建新的数据的问题。
场景二:在使用PersistenceV2进行本地数据存储时,再次进入应用部分属性读取失败的问题。
import { PersistenceV2 } from '@kit.ArkUI';
@ObservedV2
class Sample {
@Trace value?: string;
@Trace num: number = 0;
}
@Entry
@ComponentV2
struct PageOne {
@Local user: Sample =
PersistenceV2.connect(Sample, 'Sample', () => new Sample())!;
build() {
Column() {
Text(`value: ${this.user.value}, num: ${this.user.num}`)
.fontSize(30);
Button('connect')
.onClick(() => {
this.user.num = 2;
this.user.value = 'SECOND';
});
};
}
} 场景一问题效果预览:

PersistenceV2提供状态变量持久化能力,开发者可以通过connect或者globalConnect绑定同一个key,在状态变量变化和应用冷启动时,实现持久化能力。与状态管理V1版本的PersistentStorage一致,必须要在EntryAbility.ets文件中的loadContent之后调用。其它PersistenceV2使用详情可查看官方文档:PersistenceV2使用限制。
场景一细分场景 | 场景描述 | 解决方案 |
|---|---|---|
问题场景一 | 例如封装了一个AccountUtil管理类来管理PersistenceV2本地持久化(AccountUtil中初始化PersistenceV2.connect方法),且在EntryAbility.ets文件内通过import方法将导入了该管理类的实例或者依赖该管理类的实例。那么在导入的过程中就会初始化AccountUtil实例,也就会导致PersistenceV2.connect在windowStage.loadContent方法之前调用。 | 不要直接导入整个PersistenceV2的管理类,建议在使用时初始化该管理实例即可。若需要在EntryAbility.ets内使用本地持久化的数据,可以调用PersistenceV2.connect方法获取临时变量即可。 |
问题场景二 | 存在多个模块时,通过import { xxx } from 'commonlib'的方式在EntryAbility.ets中导入了“xxx”实例,若PersistenceV2的管理类存在于commonlib模块中,且同时在“commonlib/src/Index.ets”文件中与“xxx”实例一起导出,也会导致PersistenceV2的管理类提前创建。 |
|
导致该问题的原因是读取数据时由于value属性是可选属性,导致未能准确读取。
import { PersistenceV2 } from '@kit.ArkUI';
@ObservedV2
class OptionOneSample {
@Trace value?: string;
@Trace num: number = 0;
// 构建函数赋值
constructor(value: string, num: number) {
this.value = value;
this.num = num;
}
}
@Entry
@ComponentV2
struct OptionOne {
@Local user: OptionOneSample =
PersistenceV2.connect(OptionOneSample, 'Sample', () => new OptionOneSample('FIRST', 0))!;
build() {
Column() {
Text(`value: ${this.user.value}, num: ${this.user.num}`)
.fontSize(30);
Button('connect')
.onClick(() => {
this.user.num = 2;
this.user.value = 'SECOND';
});
}.width('100%');
}
} 效果预览:

import { PersistenceV2 } from '@kit.ArkUI';
@ObservedV2
class OptionTwoSample {
@Trace value: string = ''; // 赋初始值
@Trace num: number = 0;
}
@Entry
@ComponentV2
struct OptionTwo {
@Local user: OptionTwoSample =
PersistenceV2.connect(OptionTwoSample, 'Sample', () => new OptionTwoSample())!;
build() {
Column() {
Text(`value: ${this.user.value}, num: ${this.user.num}`)
.fontSize(30);
Button('connect')
.onClick(() => {
this.user.num = 2;
this.user.value = 'SECOND';
});
}.width('100%');
}
} 效果预览:

Q:PersistenceV2持久化class中基本类型的数组需要加@Type吗?
A:PersistenceV2持久化class中基本类型(如number,boolean,string)的数组时,不需要使用@Type装饰器。