[原创]【FAQ】HarmonyOS SDK 闭源开放能力

1.问题描述：
主app进入后台，此时切换系统菜单暗黑模式按钮，卡片如何监听系统colorMode ，此时卡片如何做暗黑模式切换？
解决方案：
适配方案依靠资源目录，当系统对应的设置项发生变化后（如系统语言、深浅色模式等），应用会自动加载对应资源目录下的资源文件。系统为深色模式预留了dark目录，该目录在应用创建时默认不存在，在进行深色模式适配时，需要开发者在src/main/resources中手动创建出dark目录，将深色模式所需的资源放置到该目录下。对于浅色模式所需的资源，可以放入默认存在的src/main/resources/base目录下。具体步骤为：

在src/main/resources/base/element/color.json文件中定义页面元素在浅色模式下的颜色值。

"color": [

"name": "text_color",

"value": "#000000"

在src/main/resources/dark/element/color.json文件中定义页面元素在浅色模式下的颜色值。

"color": [

"name": "text_color",

"value": "#FFFFFF"

在代码中引用自定义的颜色资源值，使用$r加载自定义颜色资源，系统将自动在应用深浅色变化时，加载对应限定词目录下的资源文件，从而改变页面元素的颜色完成深浅色适配。
@Entry

@Component

struct Card {

build() {

Row() {

Text('hello')

.fontColor($r('app.color.text_color'))

.width('100%')

.height('100%')

2.问题描述：
FormExtensionAbility生命周期中提供了onConfigurationUpdate生命周期回调，该生命周期回调在系统深浅色模式发生变化时是否会触发？
解决方案：
因系统规格设计，当系统配置项变更时，仅系统应用拉活应用服务卡片对应的EntryFormAbility并触发相应的onConfigurationUpdate回调函数。
三方应用仅当FormExtensionAbility存活时才会触发onConfigurationUpdate回调。
3.问题描述：
通过mediaquery.matchMediaSync接口可以设置媒体查询的查询条件，是否可以通过mediaquery.matchMediaSync('(dark-mode: true)')直接在卡片页面注册系统深浅色监听回调？
解决方案：
由于卡片规格限制，虽然该接口支持在ArkTS卡片页面中使用，但是无法监听获取查询结果。
4.问题描述：
是否可以使用PersistentStorage和AppStorage在应用和卡片之间进行状态数据共享？
解决方案：
卡片和应用的主进程不是一个进程，而AppStorage是和进程绑定的，仅支持应用的主线程内多个UIAbility实例间的UI状态数据共享，所以卡片和应用主进程之间无法使用PersistentStorage和AppStorage进行状态数据共享。
5.问题描述：
跨进程经常需要数据共享如服务卡片和其主应用，但在主应用更新首选项数据后，在服务卡片中用取到的值错误的场景。
解决方案：
不同进程的内存不共享，同一进程中getPreferences只有首次会从持久化中取，所以要跨进程读取最新的持久化数据时，需先通过preferences.removePreferencesFromCache接口将Preferences实例移出缓存中的实例之后，再次getPreferences将会重新读取持久化文件，生成新的Preferences实例。
以主应用中更新首选项中的data，在服务卡片中通过首选项取data为例。
在主应用中更新data，并通知服务卡片更新。

---
来源: 看雪论坛
原文链接: https://bbs.kanxue.com/thread-289016.htm

[原创]【FAQ】HarmonyOS SDK 闭源开放能力 — Form Kit