每次打开app都会出现
- 发布:2026-04-18 17:10
- 更新:56 分钟前
- 阅读:18
产品分类: 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
操作步骤:
预期结果:
启动页正常展示
启动页正常展示
实际结果:
启动页中间区域有一块横条遮挡
启动页中间区域有一块横条遮挡
bug描述:
HBuilder更新到5.06.2026033105后,打包启动页中间出现一块横条一闪而过,最新的5.07版本问题同样存在。
启动页采用 .9.png制作
附件中分别上传了.9启动页、异常位置截图和录屏视频
作为DCloud官方技术人员,对该bug反馈进行评审如下:
一、反馈内容完整性评估
优点:
- 版本信息记录较为完整,明确提及了问题出现的HBuilderX版本号(5.06.2026033105)及后续版本(5.07)
- 平台信息齐全,包含了PC开发环境(Windows 10)和移动端环境(Android 11/小米Redmi K30 5G)
- 问题现象描述相对清晰,指出是"启动页中间出现一块横条一闪而过"
- 提及了关键技术点:启动页采用.9.png格式制作
不足之处:
- 缺少项目配置详情:未提供manifest.json中
splashscreen节点的配置截图或代码,无法确认启动页的配置方式(是通用启动界面还是自定义启动图) - 缺少资源文件信息:虽然提到使用.9.png,但未说明图片的具体尺寸、存放路径(如是否放在
static目录或hybrid目录),以及.9.png的黑线标记是否正确绘制(这是最常见的.9.png使用问题) - 复现步骤过于简略:仅描述"每次打开app都会出现",缺少关键步骤如"是否使用自定义基座"、"是否云端打包"、"是否清除缓存后重新打包"等
- 未描述附件内容:反馈中提到上传了.9启动页、异常截图和录屏,但正文中未对附件内容进行文字描述,不利于快速理解问题
二、Bug成立性分析
根据知识库中app-splashscreen启动界面设置的文档,Android平台确实支持使用.9.png图片作为自定义启动图。该反馈描述的现象(启动页出现横条)在以下情况下可能出现:
- .9.png图片的黑线标记绘制不正确(未在图片边缘绘制1像素的黑色标记线,或标记线位置错误)
- 图片尺寸不符合规范(Android.9.png启动图需要针对特定分辨率制作)
- HBuilderX版本更新后,打包引擎对.9.png的解析逻辑可能存在变更
初步判断:该bug具备成立的可能性,但需要进一步验证.9.png文件本身的规范性。
三、是否为基本概念问题
不属于基本概念错误。用户明确知道Android启动页可以使用.9.png格式(这一点符合官方文档说明),且问题是在版本更新后出现的,指向明确的版本回归问题而非使用方式错误。
四、后续处理建议
请用户补充以下信息以便定位问题:
- manifest.json配置:提供
app-plus->splashscreen节点的完整配置 - .9.png文件检查:确认是否正确绘制了黑线标记(上边缘和左边缘表示拉伸区域,右边缘和下边缘表示内容区域),并提供图片的分辨率尺寸(如1080x1920等)
- 对比测试:尝试使用普通png格式作为启动页,观察是否仍有横条出现,以排除.9.png解析问题
- 打包方式:确认是否使用云端打包,以及是否尝试过清除打包缓存(菜单栏 -> 发行 -> 原生App-云打包 -> 清除缓存)
另外,建议检查.9.png图片是否严格按照Android规范制作:使用Android Studio的9-patch工具或在线工具检查黑线标记是否正确,确保拉伸区域标记位于图片边缘1像素处。
临时解决方案建议:如急需解决,可尝试改用通用启动界面方式(通过backgroundColor和image属性配置),该方式在Android、iOS均支持且适配性更好,无需准备多张不同尺寸的.9.png图片。
