讲师中心 微信公众号
AI工具推荐 视频效率加速

uni-app如何实现App启动图制作 uni-app manifest图标配置

胖伟姑娘_1256

胖伟姑娘_1256

发布时间:2026-04-28 07:54:00

|

1033人浏览过

|

来源于php中文网

原创

uni-app 的启动图和图标需通过 manifest.json 配置与 static/ 下静态资源配合实现,仅云打包或离线打包生效;Android 启动图需各密度图全提供,iOS 必须用 LaunchScreen.storyboard zip 包,图标路径必须为 static/ 开头且无透明通道。

uni-app如何实现app启动图制作 uni-app manifest图标配置

App 启动图(Splash Screen)和图标在 uni-app 中不是写代码实现的,而是通过 manifest.json 配置 + 静态资源文件组合生效的。改完不打包就看不到效果,这是最常被卡住的点。

manifest.json 里怎么配启动页(splashscreen)

启动页配置必须放在 app-plus 节点下,不能写在 h5 或 mp-weixin 里。鸿蒙和 Android 共用同一套 splashscreen 配置,iOS 则走 Storyboard 方式(后面单独说)。

  • autoclose 设为 true 才会自动关闭;设 false 就得手动调用 plus.navigator.closeSplashscreen()
  • delay 单位是毫秒,但实际关闭时机还受首页渲染速度影响,设成 0 更稳妥
  • android 下各密度图必须提供,否则低分辨率设备可能拉伸或黑屏:hdpi(480×800)、xhdpi(720×1280)、xxhdpi(1080×1920)
  • 图片路径必须是 static/ 下的相对路径,如 "static/splash/splash-xhdpi.png",不能用 assets/ 或 src/
  • 可加 background 字段统一背景色,比如 "#FFFFFF",避免图片未加载时闪白

iOS 启动页为什么不能只配图片

iOS 不支持纯图片启动页配置,manifest.json 里的 splashscreen 对 iOS 无效。它强制使用 Storyboard —— 一个 XML 描述的静态界面,由 Xcode 渲染,启动极快。

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载
  • HBuilderX 要求你提供一个 zip 包,里面**只能有且仅有**一个 LaunchScreen.storyboard 文件和它引用的 .png 图片
  • 不能有子目录,zip 解压后应直接看到 LaunchScreen.storyboard 和 bg.png 这类文件
  • Storyboard 中图片需设为 Aspect Fill 或 Center 模式,否则在 iPhone Plus 或 iPad 上容易裁切
  • 文字、Logo 等元素必须嵌入图片中,Storyboard 本身不支持动态文本渲染
  • 如果没提供 zip,HBuilderX 会 fallback 到纯白屏,不是 bug,是 iOS 系统限制

图标配置的平台差异和路径陷阱

图标路径写错、尺寸漏配、格式不兼容,是打包后图标不显示的三大主因。Android 和 iOS 的配置结构不同,不能混用。

  • Android 图标走 icons.android,键名是密度标识(hdpi、xxhdpi),不是尺寸数字
  • iOS 图标走 icons.ios,键名是尺寸字符串("60x60"、"180x180"),值是对应 PNG 路径
  • 所有图标必须是无透明通道的 PNG(iOS 官方要求),Alpha 通道会导致审核被拒
  • iOS 要求 1024×1024 大图上传 App Store Connect,但 manifest.json 里不用配它,那是云端打包后单独上传的
  • 路径别写成 /static/icon.png(带开头斜杠),uni-app 会识别失败,正确是 "static/icon.png"

改完配置后为什么还是旧图标或白屏

因为这些配置只在「云打包」或「本地离线打包」时才注入原生工程。开发时预览(运行到浏览器 / 模拟器)完全不读取 manifest.json 里的图标和启动页。

  • HBuilderX 中必须点「发行 → 原生 App-云打包」,勾选目标平台(iOS / Android / 鸿蒙),才能生成含新配置的安装包
  • CLI 项目要执行 npm run build:app-plus(Android)或 npm run build:ios,再用 Xcode 打开生成的项目编译
  • 鸿蒙平台目前只支持云打包,本地离线打包暂未开放
  • 图标文件若放在 src/assets 下,云打包时不会被识别——必须放 static/ 目录
  • 修改 manifest.json 后,HBuilderX 右上角会有「配置已更改,请重新打包」提示,忽略它等于白改

真正容易被忽略的是:iOS Storyboard zip 包的结构约束、Android 启动图各密度图的命名一致性、以及所有路径都必须基于 static/ 目录——这三个点错一个,打包出来的 App 就会回到白屏或默认图标状态。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2823

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

6163

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

7090

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

6898

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

983

2024.05.22

Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

0

2026.11.03

Docker Desktop镜像构建教程
Docker Desktop镜像构建教程

想使用Docker Desktop将本地项目构建成Docker镜像?本专题围绕镜像构建的实际操作展开,介绍Dockerfile编写、构建命令使用、镜像标签设置和构建日志查看等内容,同时整理镜像无法生成、依赖安装失败及构建缓存异常等问题的排查思路。

0

2026.11.03

Docker Desktop容器创建指南
Docker Desktop容器创建指南

本专题聚焦Docker Desktop容器创建与运行配置,介绍通过本地镜像或远程镜像创建容器的方法,以及容器启动、终端访问、日志查看和基础管理等操作。针对端口冲突、参数配置不当、容器无法启动等情况,也整理了相应的排查方向。

0

2026.11.03

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

0

2026.11.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn