uniapp splashactivity 如何自定义启动页

在uniapp中如何自定义SplashActivity的启动页？我按照官方文档配置了splashscreen，但启动时仍然显示默认的空白页。需要修改哪些文件才能实现自定义背景图和延长显示时间？能否提供具体的代码示例和配置步骤？

2 回复

在UniApp中自定义启动页，需修改项目根目录下的manifest.json文件。在App启动界面配置中设置启动图片、背景色和显示时长。也可通过原生插件自定义SplashActivity，但需Android/iOS原生开发知识。


在 UniApp 中，自定义启动页（SplashActivity）主要通过修改原生配置实现，因为 UniApp 的启动页由原生平台控制。以下是针对 Android 和 iOS 的简要步骤：

Android 平台

  1. 修改启动图片：

    • 替换 nativeplugins/Android/assets 目录下的启动图文件（如 splash.png），确保分辨率匹配设备。
    • 或通过 HBuilderX 可视化操作：在 manifest.json 的 “App 启动图配置” 中上传对应尺寸的图片。

  2. 自定义背景色或延时（可选）：

    • 在 manifest.json 中配置：
      {
  "app-plus": {
    "splashscreen": {
      "autoclose": true,
      "delay": 0, // 延时关闭（单位：秒）
      "background": "#FFFFFF" // 启动页背景色
    }
  }
}

iOS 平台

  1. 替换启动图片：

    • 在 Xcode 中打开 UniApp 生成的 iOS 项目，找到 Images.xcassets 中的启动图资源，直接替换为自定义图片。
    • 或通过 HBuilderX 在 manifest.json 的 “App 启动图配置” 上传 iOS 所需尺寸图片。

  2. 修改背景色：

    • 在 manifest.json 中配置 background 字段（同 Android 示例）。

注意事项

  • 图片规范：确保图片尺寸符合各平台要求（如 Android 的 mdpi、hdpi 等，iOS 的 @2x、@3x）。
  • 重新打包：修改后需重新生成 App 安装包（通过 HBuilderX 发行原生安装包）。
  • 原生开发：如需深度自定义（如动态启动页），需通过原生插件开发（修改 SplashActivity 代码）。

通过以上步骤即可简单自定义启动页。无需代码修改时，优先使用 HBuilderX 的图形化配置。

回到顶部