鸿蒙Harmony应用开发—ArkTS-应用级变量的状态管理

代码与思维2024-03-24 9:50

状态管理模块提供了应用程序的数据存储能力、持久化数据管理能力、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 subscriber

AppStorage.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之前。

确定属性的类型和值的顺序如下：

  1. 如果PersistentStorage文件中存在key对应的属性，在AppStorage中创建对应的propName，并用在PersistentStorage中找到的key的属性初始化。

  2. 如果PersistentStorage文件中没有查询到key对应的属性，则在AppStorage中查找key对应的属性。如果找到key对应的属性，则将该属性持久化。

  3. 如果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学习资料****

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。

相关推荐
程序员潘Sir1 小时前
鸿蒙应用开发从入门到实战（六）：ArkTS声明式UI和组件化
harmonyos·鸿蒙
黄林晴2 小时前
如何判断手机是否是纯血鸿蒙系统
android
火柴就是我2 小时前
flutter 之真手势冲突处理
android·flutter
法的空间2 小时前
Flutter JsonToDart 支持 JsonSchema
android·flutter·ios
循环不息优化不止2 小时前
深入解析安卓 Handle 机制
android
恋猫de小郭2 小时前
Android 将强制应用使用主题图标，你怎么看？
android·前端·flutter
jctech3 小时前
这才是2025年的插件化！ComboLite 2.0：为Compose开发者带来极致“爽”感
android·开源
用户2018792831673 小时前
为何Handler的postDelayed不适合精准定时任务？
android
叽哥3 小时前
Kotlin学习第 8 课：Kotlin 进阶特性：简化代码与提升效率
android·java·kotlin
Cui晨3 小时前
Android RecyclerView展示List＜View＞ Adapter的数据源使用View
android
热门推荐
01GitHub 镜像站点02UV 工具安装与国内镜像源配置指南03UV安装并设置国内源0446个Nano-banana 精选提示词，持续更新中05A股预测还能更准？开源大模型Kronos带你跑通预测+回测全流程06KGG转MP3工具|非KGM文件|解密音频07解决 WSL Ubuntu 中 /etc/resolv.conf 自动重置问题08conda中设置镜像地址（附所有可换的地址）09Claude Code 平替：OpenAI发布 Codex CLI ，GPT-5 国内直接使用10智能库存管理的需求预测模型：从业务痛点到落地代码的完整实践