uniapp启动时如何去除App图标转圈动画？

Question

在使用 UniApp 开发 App 时，启动过程中原生宿主应用图标常会出现转圈加载动画（尤其在 Android 平台），影响用户体验。开发者普遍关心如何去除该默认的启动加载指示器（如 Android 的 splash screen 转圈）。常见问题为：**在 HBuilderX 打包的 UniApp 项目中，为何即使配置了 "splashscreen": false 或修改 manifest.json，App 启动时仍显示图标下方的进度圈？** 此问题多源于对原生启动屏机制理解不足，未正确配置 Android 原生层的启动主题或 SplashScreen 设置，导致系统默认加载动画依然生效。

Answer 1

一、现象解析：为何 UniApp 启动时仍显示原生加载圈？

在使用 HBuilderX 构建的 UniApp 项目中，即使开发者已在 manifest.json 中设置 "splashscreen": false，Android 设备启动时仍可能看到应用图标下方出现系统默认的进度动画（即“转圈”）。这并非 H5 层面的加载指示器，而是 Android 原生系统的 SplashScreen 机制自动触发的表现。

该行为源于 Android 12（API 级别 31）引入的 SplashScreen API，它会为所有应用默认启用启动动画，包括图标缩放与淡入效果，并伴随一个系统级的加载指示器。若未显式配置主题或禁用此功能，即便 H5 层关闭了 splashscreen，原生层依然会展示默认动画。

二、技术分层：从 H5 到原生的启动流程剖析

UniApp 的启动过程涉及多个层级：

1. Native Layer（原生层）：Android 系统调用 Activity，加载启动主题（Theme）。
2. SplashScreen API（Android 12+）：自动显示基于主题的启动画面。
3. WebView 初始化：加载引擎，准备运行 JavaScript。
4. H5 层 splashscreen 配置：控制的是 WebView 内部的首屏渲染等待页，不影响原生启动动画。

层级	控制项	是否影响转圈动画
H5 层 (manifest.json)	splashscreen: false	否
Android 主题 (themes.xml)	windowSplashScreenAnimatedIcon	是
SplashScreen API 调用	SplashScreen.setKeepOnScreenCondition()	是
自定义启动 Activity	主题继承与样式覆盖	是

三、根本原因：HBuilderX 打包机制与原生配置脱节

HBuilderX 在构建 App 时，虽然支持部分 manifest 配置映射到原生工程，但对 Android 12+ 的 SplashScreen API 支持有限。其默认生成的 AndroidManifest.xml 和主题资源并未主动禁用系统级动画，导致：

• 系统使用默认的 Window.SplashScreen 主题。
• windowSplashScreenAnimatedIcon 被设为应用图标，自动启用旋转动画。
• 即使 H5 层无 splash 页面，原生层仍完成整个启动流程。

四、解决方案：从配置到代码的全链路干预

要彻底去除转圈动画，需在原生层进行干预。以下是三种有效路径：

方案 1：修改 Android 主题（推荐用于低版本兼容）

编辑 resources/base/res/values/themes.xml，定义无动画启动主题：

<style name="AppTheme.Launcher" parent="Theme.AppCompat.DayNight.NoActionBar">
    <item name="android:windowBackground">@drawable/splash_background</item>
    <item name="android:windowNoTitle">true</item>
    <item name="android:windowIsTranslucent">true</item>
    <!-- 禁用 SplashScreen 动画 -->
    <item name="android:windowSplashScreenAnimatedIcon">@null</item>
</style>

方案 2：针对 Android 12+ 显式禁用 SplashScreen API

在主 Activity 的 onCreate 中提前关闭 SplashScreen：

@Override
protected void onCreate(Bundle savedInstanceState) {
    // 必须在 super.onCreate 前调用
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        SplashScreen splashScreen = SplashScreen.installActivity(this);
        splashScreen.setKeepOnScreenCondition(() -> false); // 立即结束
    }
    super.onCreate(savedInstanceState);
}

方案 3：使用 DCloud 插件或自定义原生插件接管启动流程

通过编写原生插件，在 Application 初始化阶段动态替换主题或拦截 SplashScreen 显示逻辑，实现更精细控制。

五、验证流程与调试建议

为确保配置生效，建议按以下步骤验证：

1. 检查生成的 APK 是否包含修改后的 themes.xml。
2. 使用 aapt dump badging your_app.apk 查看实际使用的启动主题。
3. 在 Android Studio 中启用 Layout Inspector，观察启动时的 View 层级。
4. 在不同 API 级别设备上测试（尤其是 Android 12+）。
5. 确认 HBuilderX 版本是否支持原生资源覆盖功能。
6. 查看 logcat 输出中是否有 SplashScreen 相关日志。
7. 使用 adb shell am start -W 测量启动时间，判断动画是否仍存在。
8. 对比原生 Flutter/React Native 项目处理方式，借鉴其 SplashScreen 管理策略。
9. 考虑使用 android:background 替代动画图标，实现静态启动图。
10. 评估是否可通过延迟初始化非关键模块来缩短感知加载时间。

六、未来趋势：UniApp 与原生融合的演进方向

随着 Android 系统不断强化启动体验标准化，跨平台框架需更深度集成原生能力。DCloud 已在 HBuilderX 3.6+ 版本中增强对 SplashScreen 的支持，未来可能提供可视化配置项。但现阶段，高级开发者仍需掌握原生干预技巧，以实现极致用户体验。

七、流程图：启动动画控制决策路径

graph TD
    A[App 启动] --> B{Android API >= 31?}
    B -- 是 --> C[调用 SplashScreen.installActivity()]
    C --> D[系统显示默认动画]
    D --> E[检查主题配置]
    E --> F[windowSplashScreenAnimatedIcon 是否为 null?]
    F -- 否 --> G[显示转圈动画]
    F -- 是 --> H[仅显示静态背景]
    B -- 否 --> I[使用传统 Theme 控制]
    I --> J[检查 windowIsTranslucent]
    J --> K[决定是否显示过渡动画]