uniapp 安卓配置启动图的具体步骤是什么
在uniapp中配置安卓启动图的具体步骤是什么?需要修改哪些文件?有没有需要注意的尺寸要求或者常见问题?求详细的教程和注意事项。
2 回复
- 在
manifest.json的 App启动图配置中,选择Android平台 - 上传对应尺寸的启动图(建议提供1080x1920等常见尺寸)
- 勾选“等待首页加载完毕再关闭启动图”
- 保存后重新打包生成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 配置是否正确。

