【FAQ】HarmonyOS SDK 闭源开放能力

1.问题描述：

主app进入后台，此时切换系统菜单暗黑模式按钮，卡片如何监听系统colorMode ，此时卡片如何做暗黑模式切换？

解决方案：

适配方案依靠资源目录，当系统对应的设置项发生变化后（如系统语言、深浅色模式等），应用会自动加载对应资源目录下的资源文件。系统为深色模式预留了dark目录，该目录在应用创建时默认不存在，在进行深色模式适配时，需要开发者在src/main/resources中手动创建出dark目录，将深色模式所需的资源放置到该目录下。对于浅色模式所需的资源，可以放入默认存在的src/main/resources/base目录下。具体步骤为：

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

  "color": [

    {

      "name": "text_color",

      "value": "#000000"

    }

  ]

}
```
在src/main/resources/dark/element/color.json文件中定义页面元素在浅色模式下的颜色值。
Json 复制代码
```
{

  "color": [

    {

      "name": "text_color",

      "value": "#FFFFFF"

    }

  ]

}
```
在代码中引用自定义的颜色资源值，使用$r加载自定义颜色资源，系统将自动在应用深浅色变化时，加载对应限定词目录下的资源文件，从而改变页面元素的颜色完成深浅色适配。
TypeScript 复制代码
```
@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，并通知服务卡片更新。

kotlin 复制代码

preferences.getPreferences(this.context, 'myPreference', (err: BusinessError, pf: preferences.Preferences) =&gt; {

    if (err) {

        console.error("Failed to get preferences. code =" + err.code + ", message =" + err.message);

        return;

    }

    pf.put("formData", data);

    pf.flush();

    formProvider.updateForm(curFormId, formMsg);

    console.info("Succeeded in getting preferences.");

})

卡片中收到更新事件如onFormEvent方法回调时，需要先通过removePreferencesFromCache清缓存的Preferences实例再重新取Preferences实例。

csharp 复制代码

async function getCache() {

    await preferences.removePreferencesFromCache(context, 'myPreference');

    const pf = await preferences.getPreferences(context, 'myPreference');

    const data = await pf.get('formData', 'fault');

    console.info("cache data: " + data);

}

【FAQ】HarmonyOS SDK 闭源开放能力 — Form Kit