HarmonyOS鸿蒙Next中建议完善“应用配置文件”的文档！关于backgroundModes属性。

HarmonyOS鸿蒙Next中建议完善“应用配置文件”的文档！关于backgroundModes属性。 建议完善“应用配置文件”的文档——“配置文件的元素”部分

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/basic-config-file-elements-0000000000034463#ZH-CN_TOPIC_0000001050708780__table10951165111453

module对象的内部结构中，backgroundModes表示后台服务的类型，可以为一个服务配置多个后台服务类型。该标签仅适用于service类型的Ability。

但是，举的例子中却存在"type": "page",非service类型，但是仍然有backgroundModes属性的情况。让人疑惑。建议修改例子。

原文档的例子如下：

"abilities": [
    {
        "name": ".MainAbility",
        "description": "$string:description_main_ability",
        "icon": "$media:hiworld.png",
        "label": "HiMusic",
        "type": "page",
        "formEnabled": false,
        "launchType": "standard",
        "orientation": "unspecified",
        "permissions": [],
        "visible": false,
        "skills": [
            {
                "actions": [
                    "action.system.home"
                ],
                "entities": [
                    "entity.system.home"
                ]
            }
        ],
        "configChanges": [
            "locale",
            "layout",
            "fontSize",
            "orientation"
        ],
        "directLaunch": false,
        "process": "string",
        "backgroundModes": [
            "dataTransfer",
            "audioPlayback",
            "audioRecording",
            "pictureInPicture",
            "voip",
            "location",
            "bluetoothInteraction",
            "wifiInteraction",
            "screenFetch"
        ]
    }
]

更多关于HarmonyOS鸿蒙Next中建议完善“应用配置文件”的文档！关于backgroundModes属性。的实战教程也可以访问 https://www.itying.com/category-93-b0.html

4 回复

非常感谢您的反馈，我们已经接纳您的意见。

不同类型的ability的支持的属性也不同，对page、service、data三种型的ability分别进行举例说明。

修改后的文档将会在下周更新发布。

更多关于HarmonyOS鸿蒙Next中建议完善“应用配置文件”的文档！关于backgroundModes属性。的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


感谢您的建议，这边会反馈评估哒~欢迎常来论坛玩呀

在HarmonyOS鸿蒙Next中，backgroundModes属性用于定义应用在后台运行时可以执行的任务类型。该属性在应用配置文件（config.json）中配置，允许开发者指定应用在后台时可以执行的操作，如音频播放、位置更新、数据下载等。

backgroundModes属性是一个数组，可以包含以下值：

  • audio：允许应用在后台播放音频。
  • location：允许应用在后台获取位置信息。
  • voip：允许应用在后台处理VoIP（语音 over IP）通话。
  • fetch：允许应用在后台定期获取数据。
  • remote-notification：允许应用在后台处理远程通知。

例如，配置文件中可以这样定义：

{
  "app": {
    "backgroundModes": ["audio", "location"]
  }
}

此配置表示应用在后台时可以播放音频和获取位置信息。

需要注意的是，backgroundModes属性的使用需要遵循系统的后台任务管理策略，过度使用可能会影响设备性能和电池寿命。开发者应根据实际需求合理配置该属性。

在HarmonyOS鸿蒙Next中，backgroundModes属性用于定义应用在后台运行时允许执行的任务类型。建议在文档中详细说明每种模式的具体用途和限制，例如audio、location、voip等，并明确其在不同设备上的兼容性和性能影响。此外，提供示例代码和最佳实践，帮助开发者正确配置，避免资源浪费和系统性能下降。

回到顶部