1. 背景

当前鸿蒙 Flutter 平台支持 impeller-vulkan 和 Skia 两种渲染模式,可通过配置文件控制是否开启 impeller。

渲染引擎 支持版本
Impeller Flutter OH 3.22.0 以上
Skia Flutter OH 3.7.12 以上

2. 配置文件位置

渲染模式通过项目 ohos 目录下的配置文件控制:

ohos/entry/src/main/resources/base/profile/buildinfo.json5

该文件是鸿蒙 Flutter 项目自动生成的渲染配置文件,包含 enable_impeller 字段。

3. 切换步骤

3.1 启用 Impeller(默认模式)

编辑 buildinfo.json5,将 enable_impeller 的值设为 "true"

{
  "string": [
    {
      "name": "enable_impeller",
      "value": "true"
    }
  ]
}

3.2 切换为 Skia 渲染模式

编辑 buildinfo.json5,将 enable_impeller 的值设为 "false"

{
  "string": [
    {
      "name": "enable_impeller",
      "value": "false"
    }
  ]
}

注意:修改配置后需要重新构建项目才能生效,仅热重载(Hot Reload)不会切换渲染引擎。

3.3 工程初始化说明

新建工程默认开启 Impeller。 对于旧工程,可将 buildinfo.json5 文件复制到工程目录的对应路径下,并修改 value 值实现开关功能。如果不添加开关,则默认开启 Impeller 渲染模式。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐