HarmonyOS鸿蒙Next中flutter_native_splash有鸿蒙版的不？

flutter_native_splash 这款官方 / 社区主流的 Flutter 启动页插件暂未原生支持鸿蒙（HarmonyOS） —— 该插件的核心逻辑是为 Android/iOS 自动生成原生启动页配置（如 Android 的 drawable/values、iOS 的 LaunchScreen.storyboard），但未适配鸿蒙的原生工程结构和启动页配置规则。

不过鸿蒙（尤其是 OpenHarmony/HarmonyOS NEXT）对 Flutter 应用的支持是通过原生工程嵌套 Flutter 模块实现的，因此可以通过手动配置鸿蒙原生启动页的方式，达到和 flutter_native_splash 一致的效果，以下是具体实现方案：

核心思路

Flutter 鸿蒙应用的启动页本质是鸿蒙原生 Ability 的启动界面，只需在鸿蒙原生工程中配置闪屏页，即可替代 flutter_native_splash 的功能，步骤如下：

步骤 1：准备鸿蒙启动页资源

鸿蒙启动页图片需适配不同设备尺寸，建议准备以下规格（以竖屏为例）：

注意：图片格式推荐 png/jpg，命名建议：splash_bg.png（避免中文 / 特殊字符）。

步骤 2：配置鸿蒙启动页布局

在鸿蒙原生工程中创建启动页布局文件，替代默认的空白启动界面：

1. 进入 Flutter 项目的鸿蒙工程目录：your_flutter_project/harmony/entry/src/main/resources/base/layout/；
2. 创建 / 修改 splash_layout.xml（无则新建）：

<?xml version="1.0" encoding="utf-8"?>
<DirectionalLayout
    xmlns:ohos="http://schemas.huawei.com/res/ohos"
    ohos:width="match_parent"
    ohos:height="match_parent"
    ohos:orientation="vertical"
    ohos:background_element="$media/splash_bg"> <!-- 引用启动页背景图 -->

    <!-- 可选：添加应用logo/文字 -->
    <Image
        ohos:width="120vp"
        ohos:height="120vp"
        ohos:layout_alignment="center"
        ohos:top_margin="200vp"
        ohos:image_src="$media/app_logo"/>

    <Text
        ohos:width="match_content"
        ohos:height="match_content"
        ohos:layout_alignment="center"
        ohos:top_margin="20vp"
        ohos:text="你的应用名称"
        ohos:text_size="30fp"
        ohos:text_color="#FFFFFF"/>

</DirectionalLayout>

步骤 3：修改 Ability 配置，绑定启动页

1. 打开鸿蒙工程的 entry/src/main/module.json5（或 module.json）；
2. 找到主 Ability（通常是 MainAbility）的配置，添加启动页相关配置：

{
  "module": {
    "abilities": [
      {
        "name": ".MainAbility",
        "srcEntry": "./ets/MainAbility/MainAbility.ts",
        "description": "$string:main_ability_desc",
        "icon": "$media:icon",
        "label": "$string:app_name",
        "type": "page",
        "launchType": "standard",
        // 关键：配置启动页
        "splashScreen": {
          "backgroundColor": "#FFFFFF", // 启动页背景色（图片加载前的兜底）
          "layout": "$layout:splash_layout", // 绑定步骤2的布局文件
          "duration": 3000, // 启动页显示时长（ms），0则自动跟随Flutter初始化完成
          "alwaysShowBeforeEnterHome": true // 确保启动页显示完成后再进入Flutter页面
        },
        "metadata": [
          {
            "name": "flutterEmbedding",
            "value": "2"
          }
        ]
      }
    ]
  }
}

步骤 4：适配 Flutter 初始化衔接

若希望启动页时长跟随 Flutter 初始化（而非固定时长），可将 duration 设为 0，并在鸿蒙原生 Ability 中监听 Flutter 初始化完成事件：

// entry/src/main/ets/MainAbility/MainAbility.ts
import Ability from '@ohos.application.Ability';
import window from '@ohos.window';

export default class MainAbility extends Ability {
  onWindowStageCreate(windowStage: window.WindowStage) {
    super.onWindowStageCreate(windowStage);
    // 隐藏启动页，进入Flutter页面
    windowStage.loadContent('pages/flutter_page', (err) => {
      if (err) {
        console.error('加载Flutter页面失败：', err);
      }
    });
  }
}

补充说明

1. 社区适配版插件：目前暂无成熟的「鸿蒙版 flutter_native_splash」插件，上述手动配置是主流方案，效果与插件一致；
2. HarmonyOS NEXT 适配：若基于鸿蒙纯血版（NEXT）开发，配置逻辑一致，仅需注意资源目录需符合 NEXT 的规范（如 resources/rawfile 替代部分旧目录）；
3. 多主题适配：如需适配深浅色模式，可在 splash_layout.xml 中通过 ohos:element="$color/splash_bg" 引用主题色，或在不同主题目录下放置对应图片；
4. 启动页优化：建议将启动页图片做压缩处理，避免因资源过大导致启动页卡顿。

综上，虽然 flutter_native_splash 无鸿蒙版，但通过手动配置鸿蒙原生启动页，完全可以实现相同的闪屏效果，且适配性更贴合鸿蒙系统特性。