uniapp 安卓配置启动图的具体步骤是什么

在uniapp中配置安卓启动图的具体步骤是什么?需要修改哪些文件?有没有需要注意的尺寸要求或者常见问题?求详细的教程和注意事项。

2 回复
  1. manifest.json 的 App启动图配置中,选择Android平台
  2. 上传对应尺寸的启动图(建议提供1080x1920等常见尺寸)
  3. 勾选“等待首页加载完毕再关闭启动图”
  4. 保存后重新打包生成apk即可

注意:HBuilderX标准工程需在可视化界面操作,cli项目需手动配置。


在 UniApp 中配置安卓启动图(Splash Screen)的步骤如下,基于 HBuilderX 开发工具操作:

1. 准备启动图素材

  • 安卓需要不同分辨率的图片,建议提供至少以下尺寸(单位:像素):
    • xxhdpi:1242×2688(竖屏)或 2688×1242(横屏)
    • xhdpi:750×1624(竖屏)或 1624×750(横屏)
    • hdpi:480×1048(竖屏)或 1048×480(横屏)
  • 格式推荐 PNG,确保背景填充完整,避免拉伸变形。

2. 在项目中放置图片

  • 打开 UniApp 项目,在 nativeplugins 目录(如无则手动创建)或 unpackage 目录下创建对应资源文件夹:
    • 路径示例:nativeplugins/AndroidScreenSplash/images/
    • 将图片按分辨率放置:
      • drawable-xxhdpi/splash.png(高分辨率)
      • drawable-xhdpi/splash.png(中高分辨率)
      • drawable-hdpi/splash.png(中分辨率)

3. 配置 manifest.json 文件

  • 在项目根目录的 manifest.json 中,添加或修改以下内容:
    {
      "app-plus": {
        "splashscreen": {
          "autoclose": true,
          "waiting": true,
          "delay": 0
        }
      }
    }
    
  • 参数说明:
    • autoclose:是否自动关闭启动页(true 表示自动关闭)。
    • waiting:是否显示等待雪花图标。
    • delay:延迟关闭时间(单位毫秒,0 表示不延迟)。

4. 使用原生插件(可选)

  • 如果需要更精细控制(如自定义延时或动画),可通过原生插件实现:
    • 在 HBuilderX 中安装 “Android Splash Screen” 插件。
    • 参考插件文档配置 nativeplugins 目录和代码调用。

5. 编译和测试

  • 通过 HBuilderX 生成安卓安装包(发行 → 原生App-云打包或本地打包)。
  • 在真机上测试启动图显示效果,确保图片适配不同屏幕。

注意事项:

  • 图片适配:务必提供多分辨率图片,避免低分辨率设备上模糊。
  • 云打包:如果使用云打包,需在 HBuilderX 控制台提交所有图片资源。
  • 更新缓存:修改启动图后,清理项目缓存并重新打包。

完成以上步骤后,安卓启动图即可正常显示。如有问题,检查图片路径和 manifest 配置是否正确。

回到顶部