状态管理模块提供了应用程序的数据存储能力、持久化数据管理能力、UIAbility数据存储能力和应用程序需要的环境状态。
说明:
本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
本文中T和S的含义如下:
类型 | 描述 |
---|---|
T | Class,number,boolean,string和这些类型的数组形式。 |
S | number,boolean,string。 |
AppStorage
AppStorage具体UI使用说明,详见AppStorage(应用全局的UI状态存储)
link10+
static link(propName: string): SubscribedAbstractProperty
与AppStorage中对应的propName建立双向数据绑定。如果给定的propName在AppStorage中存在,返回与AppStorage中propName对应属性的双向绑定数据。
双向绑定数据的修改会同步回AppStorage中,AppStorage会将变化同步到所有绑定该propName的数据和自定义组件中。
如果AppStorage中不存在propName,则返回undefined。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | AppStorage中的属性名。 |
返回值:
类型 | 描述 |
---|---|
SubscribedAbstractProperty<T> | 返回双向绑定的数据,如果AppStorage不存在对应的propName,则返回undefined。 |
AppStorage.setOrCreate('PropA', 47);
let linkToPropA1:SubscribedAbstractProperty<number> = AppStorage.link('PropA');
let linkToPropA2:SubscribedAbstractProperty<number> = AppStorage.link('PropA'); // linkToPropA2.get() == 47
linkToPropA1.set(48); // 双向同步: linkToPropA1.get() == linkToPropA2.get() == 48
setAndLink10+
static setAndLink<T>(propName: string, defaultValue: T): SubscribedAbstractProperty<T>
与Link接口类似,如果给定的propName在AppStorage中存在,则返回该propName对应的属性的双向绑定数据。如果不存在,则使用defaultValue在AppStorage创建和初始化propName,返回其双向绑定数据。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | AppStorage中的属性名。 |
defaultValue | T | 是 | 当propName在AppStorage中不存在,使用defaultValue在AppStorage中初始化对应的propName。 |
返回值:
类型 | 描述 |
---|---|
SubscribedAbstractProperty<T> | SubscribedAbstractProperty<T>的实例,和AppStorage中propName对应属性的双向绑定的数据。 |
AppStorage.setOrCreate('PropA', 47);
let link1: SubscribedAbstractProperty<number> = AppStorage.setAndLink('PropB', 49); // Create PropB 49
let link2: SubscribedAbstractProperty<number> = AppStorage.setAndLink('PropA', 50); // PropA exists, remains 47
prop10+
static prop<T>(propName: string): SubscribedAbstractProperty<T>
与AppStorage中对应的propName建立单向属性绑定。如果给定的propName在AppStorage中存在,则返回与AppStorage中propName对应属性的单向绑定数据。如果AppStorage中不存在propName,则返回undefined。单向绑定数据的修改不会被同步回AppStorage中。
说明: Prop仅支持简单类型。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | AppStorage中的属性名。 |
返回值:
类型 | 描述 |
---|---|
SubscribedAbstractProperty<T> | 返回单向绑定的数据,如果AppStorage不存在对应的propName,则返回undefined。 |
AppStorage.setOrCreate('PropA', 47);
let prop1: SubscribedAbstractProperty<number> = AppStorage.prop('PropA');
let prop2: SubscribedAbstractProperty<number> = AppStorage.prop('PropA');
prop1.set(1); // one-way sync: prop1.get()=1; but prop2.get() == 47
setAndProp10+
static setAndProp<T>(propName: string, defaultValue: T): SubscribedAbstractProperty<T>
与Prop接口类似。如果给定的propName在AppStorage存在,则返回该propName对应的属性的单向绑定数据。如果不存在,则使用defaultValue在AppStorage创建和初始化propName对应的属性,返回其单向绑定数据。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | AppStorage中的属性名。 |
defaultValue | T | 是 | 当propName在AppStorage中不存在时,使用default在AppStorage中初始化对应的propName。 |
返回值:
类型 | 描述 |
---|---|
SubscribedAbstractProperty<T> | SubscribedAbstractProperty<T>的实例。 |
AppStorage.setOrCreate('PropA', 47);
let prop: SubscribedAbstractProperty<number> = AppStorage.setAndProp('PropB', 49); // PropA -> 47, PropB -> 49
has10+
static has(propName: string): boolean
判断propName对应的属性是否在AppStorage中存在。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | AppStorage中的属性名。 |
返回值:
类型 | 描述 |
---|---|
boolean | 如果propName对应的属性在AppStorage中存在,则返回true。不存在则返回false。 |
AppStorage.has('simpleProp');
get10+
static get<T>(propName: string): T | undefined
获取propName在AppStorage中对应的属性。如果不存在返回undefined。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | AppStorage中的属性名。 |
返回值:
类型 | 描述 |
---|---|
T | undefined | AppStorage中propName对应的属性,如果不存在返回undefined。 |
AppStorage.setOrCreate('PropA', 47);
let value: number = AppStorage.get('PropA') as number; // 47
set10+
static set<T>(propName: string, newValue: T): boolean
在AppStorage中设置propName对应属性的值。如果newValue的值和propName对应属性的值相同,即不需要做赋值操作,状态变量不会通知UI刷新propName对应属性的值。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | AppStorage中的属性名。 |
newValue | T | 是 | 属性值,不能为undefined或null。 |
返回值:
类型 | 描述 |
---|---|
boolean | 如果AppStorage不存在propName对应的属性,或者设置的newValue是undefined或者null,返回false。设置成功则返回true。 |
AppStorage.setOrCreate('PropA', 48);
let res: boolean = AppStorage.set('PropA', 47) // true
let res1: boolean = AppStorage.set('PropB', 47) // false
setOrCreate10+
static setOrCreate<T>(propName: string, newValue: T): void
如果propName已经在AppStorage中存在,并且newValue和propName对应属性的值不同,则设置propName对应属性的值为newValue,否则状态变量不会通知UI刷新propName对应属性的值。 如果propName不存在,则创建propName属性,值为newValue。setOrCreate只可以创建单个AppStorage的键值对,如果想创建多个AppStrage键值对,可以多次调用此方法。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | AppStorage中的属性名。 |
newValue | T | 是 | 属性值,不能为undefined或null。 |
AppStorage.setOrCreate('simpleProp', 121);
delete10+
static delete(propName: string): boolean
在AppStorage中删除propName对应的属性。
在AppStorage中删除该属性的前提是必须保证该属性没有订阅者。如果有订阅者,则返回false。删除成功返回true。
属性的订阅者为Link、Prop等接口绑定的propName,以及@StorageLink('propName')和@StorageProp('propName')。这就意味着如果自定义组件中使用@StorageLink('propName')和@StorageProp('propName')或者SubscribedAbstractProperty实例依旧对propName有同步关系,则该属性不能从AppStorage中删除。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | AppStorage中的属性名。 |
返回值:
类型 | 描述 |
---|---|
boolean | 如果AppStorage中有对应的属性,且该属性已经没有订阅者,则删除成功,返回true。如果属性不存在,或者该属性还存在订阅者,则返回false。 |
AppStorage.setOrCreate('PropA', 47);
AppStorage.link<number>('PropA');
let res: boolean = AppStorage.delete('PropA'); // false, PropA still has a subscriberAppStorage.setOrCreate('PropB', 48);
let res1: boolean = AppStorage.delete('PropB'); // true, PropB is deleted from AppStorage successfully
keys10+
static keys(): IterableIterator<string>
返回AppStorage中所有的属性名。
返回值:
类型 | 描述 |
---|---|
IterableIterator<string> | AppStorage中所有的属性名。 |
AppStorage.setOrCreate('PropB', 48);
let keys: IterableIterator<string> = AppStorage.keys();
clear10+
static clear(): boolean
清除AppStorage的所有的属性。在AppStorage中清除所有属性的前提是,已经没有任何订阅者。如果有,则什么都不做返回false;删除成功返回true。
订阅者的含义和参考Delete。
返回值:
类型 | 描述 |
---|---|
boolean | 如果AppStorage中的属性已经没有订阅者,则清除成功,返回true。否则返回false。 |
AppStorage.setOrCreate('PropA', 47);
let res: boolean = AppStorage.clear(); // true, there are no subscribers
size10+
static size(): number
返回AppStorage中的属性数量。
返回值:
类型 | 描述 |
---|---|
number | 返回AppStorage中属性的数量。 |
AppStorage.setOrCreate('PropB', 48);
let res: number = AppStorage.size(); // 1
LocalStorage9+
LocalStorage具体UI使用说明,详见LocalStorage(页面级UI状态存储)
constructor9+
constructor(initializingProperties?: Object)
创建一个新的LocalStorage实例。使用Object.keys(initializingProperties)返回的属性和其数值,初始化LocalStorage实例。
从API version 9开始,该接口支持在ArkTS卡片中使用。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
initializingProperties | Object | 否 | 用initializingProperties包含的属性和数值初始化LocalStorage。initializingProperties不能为undefined。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
getShared10+
static getShared(): LocalStorage
获取当前stage共享的LocalStorage实例。
从API version 9开始,该接口支持在ArkTS卡片中使用。
**模型约束:**此接口仅可在Stage模型下使用。
返回值:
类型 | 描述 |
---|---|
LocalStorage | 返回LocalStorage实例。 |
getShared具体使用,见在UI页面通过getShared接口获取在通过loadContent共享的LocalStorage实例
has9+
has(propName: string): boolean
判断propName对应的属性是否在LocalStorage中存在。
从API version 9开始,该接口支持在ArkTS卡片中使用。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | LocalStorage中的属性名。 |
返回值:
类型 | 描述 |
---|---|
boolean | 如果propName对应的属性在AppStorage中存在,则返回true。不存在则返回false。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
storage.has('PropA'); // true
get9+
get<T>(propName: string): T | undefined
获取propName在LocalStorage中对应的属性。
从API version 9开始,该接口支持在ArkTS卡片中使用。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | LocalStorage中的属性名。 |
返回值:
类型 | 描述 |
---|---|
T | undefined | LocalStorage中propName对应的属性,如果不存在返回undefined。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
let value: number = storage.get('PropA') as number; // 47
set9+
set<T>(propName: string, newValue: T): boolean
在LocalStorage中设置propName对应属性的值。如果newValue的值和propName对应属性的值相同,即不需要做赋值操作,状态变量不会通知UI刷新propName对应属性的值。
从API version 9开始,该接口支持在ArkTS卡片中使用。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | LocalStorage中的属性名。 |
newValue | T | 是 | 属性值,不能为undefined或者null。 |
返回值:
类型 | 描述 |
---|---|
boolean | 如果LocalStorage不存在propName对应的属性,或者设置的newValue是undefined或者null,返回false。设置成功返回true。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
let res: boolean = storage.set('PropA', 47); // true
let res1: boolean = storage.set('PropB', 47); // false
setOrCreate9+
setOrCreate<T>(propName: string, newValue: T): boolean
如果propName已经在LocalStorage中存在,并且newValue和propName对应属性的值不同,则设置propName对应属性的值为newValue,否则状态变量不会通知UI刷新propName对应属性的值。 如果propName不存在,则创建propName属性,值为newValue。setOrCreate只可以创建单个LocalStorage的键值对,如果想创建多个LocalStorage键值对,可以多次调用此方法。
从API version 9开始,该接口支持在ArkTS卡片中使用。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | LocalStorage中的属性名。 |
newValue | T | 是 | 属性值,不能为undefined或者null。 |
返回值:
类型 | 描述 |
---|---|
boolean | 如果设置的newValue是undefined或者null,返回false。 如果LocalStorage存在propName,则更新其值为newValue,返回true。 如果LocalStorage不存在propName,则创建propName,并初始化其值为newValue,返回true。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
let res: boolean =storage.setOrCreate('PropA', 121); // true
let res1: boolean =storage.setOrCreate('PropB', 111); // true
let res2: boolean =storage.setOrCreate('PropB', null); // false
link9+
link<T>(propName: string): SubscribedAbstractProperty<T>
如果给定的propName在LocalStorage实例中存在,则返回与LocalStorage中propName对应属性的双向绑定数据。
双向绑定数据的修改会被同步回LocalStorage中,LocalStorage会将变化同步到所有绑定该propName的数据和Component中。
如果LocalStorage中不存在propName,则返回undefined。
从API version 9开始,该接口支持在ArkTS卡片中使用。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | LocalStorage中的属性名。 |
返回值:
类型 | 描述 |
---|---|
SubscribedAbstractProperty<T> | SubscribedAbstractProperty<T>的实例,如果AppStorage不存在对应的propName,再返回undefined。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
let linkToPropA1: SubscribedAbstractProperty<number> = storage.link('PropA');
let linkToPropA2: SubscribedAbstractProperty<number> = storage.link('PropA'); // linkToPropA2.get() == 47
linkToPropA1.set(48); // 双向同步: linkToPropA1.get() == linkToPropA2.get() == 48
setAndLink9+
setAndLink<T>(propName: string, defaultValue: T): SubscribedAbstractProperty<T>
与Link接口类似,如果给定的propName在LocalStorage存在,则返回该propName对应的属性的双向绑定数据。如果不存在,则使用defaultValue在LocalStorage创建和初始化propName,返回其双向绑定数据。
从API version 9开始,该接口支持在ArkTS卡片中使用。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | LocalStorage中的属性名。 |
defaultValue | T | 是 | 当propName在LocalStorage中不存在,使用default在LocalStorage中初始化对应的propName。 |
返回值:
类型 | 描述 |
---|---|
SubscribedAbstractProperty<T> | SubscribedAbstractProperty<T>的实例,如果AppStorage不存在对应的propName,再返回undefined。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
let link1: SubscribedAbstractProperty<number> = storage.setAndLink('PropB', 49); // Create PropB 49
let link2: SubscribedAbstractProperty<number> = storage.setAndLink('PropA', 50); // PropA exists, remains 47
prop9+
prop<S>(propName: string): SubscribedAbstractProperty<S>
如果给定的propName在LocalStorage存在,则返回与LocalStorage中propName对应属性的单向绑定数据。如果LocalStorage中不存在propName,则返回undefined。单向绑定数据的修改不会被同步回LocalStorage中。
从API version 9开始,该接口支持在ArkTS卡片中使用。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | LocalStorage中的属性名。 |
返回值:
类型 | 描述 |
---|---|
SubscribedAbstractProperty<S> | SubscribedAbstractProperty<S>的实例,如果AppStorage不存在对应的propName,在返回undefined。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
let prop1: SubscribedAbstractProperty<number> = storage.prop('PropA');
let prop2: SubscribedAbstractProperty<number> = storage.prop('PropA');
prop1.set(1); // one-way sync: prop1.get()=1; but prop2.get() == 47
setAndProp9+
setAndProp<S>(propName: string, defaultValue: S): SubscribedAbstractProperty<S>
propName在LocalStorage存在,则返回该propName对应的属性的单向绑定数据。如果不存在,则使用defaultValue在LocalStorage创建和初始化propName对应的属性,返回其单向绑定数据。
从API version 9开始,该接口支持在ArkTS卡片中使用。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | LocalStorage中的属性名。 |
defaultValue | S | 是 | 当propName在AppStorage中不存在,使用default在AppStorage中初始化对应的propName。 |
返回值:
类型 | 描述 |
---|---|
SubscribedAbstractProperty<S> | SubscribedAbstractProperty<S>的实例,和AppStorage中propName对应属性的单向绑定的数据。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
let prop: SubscribedAbstractProperty<number> = storage.setAndProp('PropB', 49); // PropA -> 47, PropB -> 49
delete9+
delete(propName: string): boolean
在LocalStorage中删除propName对应的属性。删除属性的前提是该属性已经没有订阅者,如果有则返回false。删除成功则返回true。
属性的订阅者是link,prop接口绑定的propName,以及@LocalStorageLink('propName')和@LocalStorageProp('propName')。如果自定义组件Component中使用或者SubscribedAbstractProperty(link和prop接口的返回类型)依旧有同步关系,则该属性不能从LocalStorage中删除。
从API version 9开始,该接口支持在ArkTS卡片中使用。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
propName | string | 是 | LocalStorage中的属性名。 |
返回值:
类型 | 描述 |
---|---|
boolean | 如果LocalStorage中有对应的属性,且该属性已经没有订阅者,则删除成功返回true。如果属性不存在,或者该属性还存在订阅者,则返回false。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
storage.link<number>('PropA');
let res: boolean = storage.delete('PropA'); // false, PropA still has a subscriber
let res1: boolean = storage.delete('PropB'); // false, PropB is not in storage
storage.setOrCreate('PropB', 48);
let res2: boolean = storage.delete('PropB'); // true, PropB is deleted from storage successfully
keys9+
keys(): IterableIterator<string>
返回AppStorage中所有的属性名。
从API version 9开始,该接口支持在ArkTS卡片中使用。
返回值:
类型 | 描述 |
---|---|
IterableIterator<string> | LocalStorage中所有的属性名。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
let keys: IterableIterator<string> = storage.keys();
size9+
size(): number
返回LocalStorage中的属性数量。
从API version 9开始,该接口支持在ArkTS卡片中使用。
返回值:
类型 | 描述 |
---|---|
number | 返回键值对的数量。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
let res: number = storage.size(); // 1
clear9+
clear(): boolean
清除LocalStorage的所有的属性。在LocalStorage中清除所有属性的前提是已经没有任何订阅者。如果有则返回false;清除成功返回true。
从API version 9开始,该接口支持在ArkTS卡片中使用。
返回值:
类型 | 描述 |
---|---|
boolean | 如果LocalStorage中的属性已经没有任何订阅者,则清除成功,返回true。否则返回false。 |
let para:Record<string,number> = { 'PropA': 47 };
let storage: LocalStorage = new LocalStorage(para);
let res: boolean = storage.clear(); // true, there are no subscribers
SubscribedAbstractProperty
get9+
abstract get(): T
读取从AppStorage/LocalStorage同步属性的数据。
从API version 9开始,该接口支持在ArkTS卡片中使用。
返回值:
类型 | 描述 |
---|---|
T | AppStorage/LocalStorage同步属性的数据。 |
AppStorage.SetOrCreate('PropA', 47);
let prop1:SubscribedAbstractProperty<number> = AppStorage.Prop('PropA');
prop1.get(); // prop1.get()=47
set9+
abstract set(newValue: T): void
设置AppStorage/LocalStorage同步属性的数据。
从API version 9开始,该接口支持在ArkTS卡片中使用。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
newValue | T | 是 | 要设置的数据。 |
AppStorage.SetOrCreate('PropA', 47);
let prop1:SubscribedAbstractProperty<number> = AppStorage.Prop('PropA');
prop1.set(1); // prop1.get()=1
aboutToBeDeleted10+
abstract aboutToBeDeleted(): void
取消SubscribedAbstractProperty实例对AppStorage/LocalStorage单/双向同步关系。
AppStorage.SetOrCreate('PropA', 47);
let link = AppStorage.SetAndLink('PropB', 49); // PropA -> 47, PropB -> 49
link.aboutToBeDeleted();
link.set(50); // PropB -> 49, link.get() --> undefined
PersistentStorage
PersistentStorage具体UI使用说明,详见PersistentStorage(持久化存储UI状态)
PersistPropsOptions
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
key | string | 是 | 属性名。 |
defaultValue | number|string|boolean | 是 | 在PersistentStorage和AppStorage未查询到时,则使用默认值初始化初始化它。不允许为undefined和null。 |
persistProp10+
static persistProp<T>(key: string, defaultValue: T): void
将AppStorage中key对应的属性持久化到文件中。该接口的调用通常在访问AppStorage之前。
确定属性的类型和值的顺序如下:
-
如果PersistentStorage文件中存在key对应的属性,在AppStorage中创建对应的propName,并用在PersistentStorage中找到的key的属性初始化。
-
如果PersistentStorage文件中没有查询到key对应的属性,则在AppStorage中查找key对应的属性。如果找到key对应的属性,则将该属性持久化。
-
如果AppStorage也没查找到key对应的属性,则在AppStorage中创建key对应的属性。用defaultValue初始化其值,并将该属性持久化。
根据上述的初始化流程,如果AppStorage中有该属性,则会使用其值,覆盖掉PersistentStorage文件中的值。由于AppStorage是内存内数据,该行为会导致数据丧失持久化能力。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
key | string | 是 | 属性名。 |
defaultValue | T | 是 | 在PersistentStorage和AppStorage未查询到时,则使用默认值初始化初始化它。不允许为undefined和null。 |
示例:
persistProp具体使用,见从AppStorage中访问PersistentStorage初始化的属性
deleteProp10+
static deleteProp(key: string): void
PersistProp的逆向操作。将key对应的属性从PersistentStorage删除,后续AppStorage的操作,对PersistentStorage不会再有影响。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
key | string | 是 | PersistentStorage中的属性名。 |
PersistentStorage.deleteProp('highScore');
persistProps10+
static persistProps(props: PersistPropsOptions[]): void
行为和PersistProp类似,不同在于可以一次性持久化多个数据,适合在应用启动的时候初始化。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
props | PersistPropsOptions[] | 是 | 持久化数组。 |
PersistentStorage.persistProps([{ key: 'highScore', defaultValue: '0' }, { key: 'wightScore', defaultValue: '1' }]);
keys10+
static keys(): Array<string>
返回所有持久化属性的key的数组。
返回值:
类型 | 描述 |
---|---|
Array<string> | 返回所有持久化属性的key的数组。 |
let keys: Array<string> = PersistentStorage.keys();
Environment
Environment具体使用说明,详见Environment(设备环境查询)
EnvPropsOptions
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
key | string | 是 | 环境变量名称,支持的范围详见内置环境变量说明。 |
defaultValue | number|string|boolean | 是 | 查询不到环境变量key,则使用defaultValue作为默认值存入AppStorage中。 |
envProp10+
static envProp<S>(key: string, value: S): boolean
将Environment的内置环境变量key存入AppStorage中。如果系统中未查询到Environment环境变量key的值,则使用默认值value,存入成功,返回true。如果AppStorage已经有对应的key,则返回false。
所以建议在程序启动的时候调用该接口。
在没有调用EnvProp,就使用AppStorage读取环境变量是错误的。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
key | string | 是 | 环境变量名称,支持的范围详见内置环境变量说明。 |
value | S | 是 | 查询不到环境变量key,则使用value作为默认值存入AppStorage中。 |
返回值:
类型 | 描述 |
---|---|
boolean | 如果key对应的属性在AppStorage中存在,则返回false。不存在则在AppStorage中创建key对应的属性,返回true。 |
示例:
EnvProp具体使用,见从UI中访问Environment参数
envProps10+
static envProps(props: EnvPropsOptions[]): void
和EnvProp类似,不同点在于参数为数组,可以一次性初始化多个数据。建议在应用启动时调用,将系统环境变量批量存入AppStorage中。
参数:
参数名 | 类型 | 必填 | 参数描述 |
---|---|---|---|
props | EnvPropsOptions[] | 是 | 系统环境变量和默认值的键值对的数组。 |
Environment.envProps([{ key: 'accessibilityEnabled', defaultValue: 'default' }, {key: 'languageCode',defaultValue: 'en'
}, { key: 'prop', defaultValue: 'hhhh' }]);
keys10+
static keys(): Array<string>
返回环境变量的属性key的数组。
返回值:
类型 | 描述 |
---|---|
Array<string> | 返回关联的系统项数组。 |
Environment.envProps([{ key: 'accessibilityEnabled', defaultValue: 'default' }, {key: 'languageCode',defaultValue: 'en'
}, { key: 'prop', defaultValue: 'hhhh' }]);let keys: Array<string> = Environment.keys(); // accessibilityEnabled, languageCode, prop
内置环境变量说明
key | 类型 | 说明 |
---|---|---|
accessibilityEnabled | string | 无障碍屏幕朗读是否启用。 |
colorMode | ColorMode | 深浅色模式,可选值为: - ColorMode.LIGHT:浅色模式; - ColorMode.DARK:深色模式。 |
fontScale | number | 字体大小比例。 |
fontWeightScale | number | 字重比例。 |
layoutDirection | LayoutDirection | 布局方向类型,可选值为: - LayoutDirection.LTR:从左到右; - LayoutDirection.RTL:从右到左。 |
languageCode | string | 当前系统语言,小写字母,例如zh。 |
最后
有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有必要的。
这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!
获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
鸿蒙(HarmonyOS NEXT)最新学习路线
-
HarmonOS基础技能
- HarmonOS就业必备技能
- HarmonOS多媒体技术
- 鸿蒙NaPi组件进阶
- HarmonOS高级技能
- 初识HarmonOS内核
- 实战就业级设备开发
有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开发入门教学视频》
《鸿蒙生态应用开发V2.0白皮书》
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
- ArkTS语言
- 安装DevEco Studio
- 运用你的第一个ArkTS应用
- ArkUI声明式UI开发
- .……
《鸿蒙开发进阶》
- Stage模型入门
- 网络管理
- 数据管理
- 电话服务
- 分布式应用开发
- 通知与窗口管理
- 多媒体技术
- 安全技能
- 任务管理
- WebGL
- 国际化开发
- 应用测试
- DFX面向未来设计
- 鸿蒙系统移植和裁剪定制
- ……
《鸿蒙进阶实战》
- ArkTS实践
- UIAbility应用
- 网络案例
- ……
获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结
总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。