福建时代中科
福建时代中科
  • 发布:2026-04-18 17:10
  • 更新:56 分钟前
  • 阅读:18

【报Bug】HBuilder更新到5.06.2026033105后,打包启动页中间出现一块横条

分类:uni-app

产品分类: uniapp/App

PC开发环境操作系统: Windows

PC开发环境操作系统版本号: win10

HBuilderX类型: 正式

HBuilderX版本号: 5.06

手机系统: Android

手机系统版本号: Android 11

手机厂商: 小米

手机机型: Redmi K30 5G

页面类型: vue

vue版本: vue3

打包方式: 云端

项目创建方式: HBuilderX

App下载地址或H5⽹址: https://sj.qq.com/appdetail/com.isdzk.swap

操作步骤:

每次打开app都会出现

预期结果:

启动页正常展示

实际结果:

启动页中间区域有一块横条遮挡

bug描述:

HBuilder更新到5.06.2026033105后,打包启动页中间出现一块横条一闪而过,最新的5.07版本问题同样存在。
启动页采用 .9.png制作

附件中分别上传了.9启动页、异常位置截图和录屏视频

2026-04-18 17:10 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

作为DCloud官方技术人员,对该bug反馈进行评审如下:

一、反馈内容完整性评估

优点:

  • 版本信息记录较为完整,明确提及了问题出现的HBuilderX版本号(5.06.2026033105)及后续版本(5.07)
  • 平台信息齐全,包含了PC开发环境(Windows 10)和移动端环境(Android 11/小米Redmi K30 5G)
  • 问题现象描述相对清晰,指出是"启动页中间出现一块横条一闪而过"
  • 提及了关键技术点:启动页采用.9.png格式制作

不足之处:

  1. 缺少项目配置详情:未提供manifest.json中splashscreen节点的配置截图或代码,无法确认启动页的配置方式(是通用启动界面还是自定义启动图)
  2. 缺少资源文件信息:虽然提到使用.9.png,但未说明图片的具体尺寸、存放路径(如是否放在static目录或hybrid目录),以及.9.png的黑线标记是否正确绘制(这是最常见的.9.png使用问题)
  3. 复现步骤过于简略:仅描述"每次打开app都会出现",缺少关键步骤如"是否使用自定义基座"、"是否云端打包"、"是否清除缓存后重新打包"等
  4. 未描述附件内容:反馈中提到上传了.9启动页、异常截图和录屏,但正文中未对附件内容进行文字描述,不利于快速理解问题

二、Bug成立性分析

根据知识库中app-splashscreen启动界面设置的文档,Android平台确实支持使用.9.png图片作为自定义启动图。该反馈描述的现象(启动页出现横条)在以下情况下可能出现:

  • .9.png图片的黑线标记绘制不正确(未在图片边缘绘制1像素的黑色标记线,或标记线位置错误)
  • 图片尺寸不符合规范(Android.9.png启动图需要针对特定分辨率制作)
  • HBuilderX版本更新后,打包引擎对.9.png的解析逻辑可能存在变更

初步判断:该bug具备成立的可能性,但需要进一步验证.9.png文件本身的规范性。

三、是否为基本概念问题

不属于基本概念错误。用户明确知道Android启动页可以使用.9.png格式(这一点符合官方文档说明),且问题是在版本更新后出现的,指向明确的版本回归问题而非使用方式错误。

四、后续处理建议

请用户补充以下信息以便定位问题:

  1. manifest.json配置:提供app-plus -> splashscreen节点的完整配置
  2. .9.png文件检查:确认是否正确绘制了黑线标记(上边缘和左边缘表示拉伸区域,右边缘和下边缘表示内容区域),并提供图片的分辨率尺寸(如1080x1920等)
  3. 对比测试:尝试使用普通png格式作为启动页,观察是否仍有横条出现,以排除.9.png解析问题
  4. 打包方式:确认是否使用云端打包,以及是否尝试过清除打包缓存(菜单栏 -> 发行 -> 原生App-云打包 -> 清除缓存)

另外,建议检查.9.png图片是否严格按照Android规范制作:使用Android Studio的9-patch工具或在线工具检查黑线标记是否正确,确保拉伸区域标记位于图片边缘1像素处。

临时解决方案建议:如急需解决,可尝试改用通用启动界面方式(通过backgroundColor和image属性配置),该方式在Android、iOS均支持且适配性更好,无需准备多张不同尺寸的.9.png图片。

内容为 AI 生成,仅供参考
福建时代中科

福建时代中科 (作者)

启动页配置:是自定义启动图
分辨率是:1082*2402
打包方式:快速安心打包

一直用的这张启动图,未更换过,5.06.2026033105版本之前都能正常展示

要回复问题请先登录注册