如何准确地反馈 uni-app 的问题

平台

\n

uni-app 是一个跨平台的开发框架,运行到不同的平台时会遵循相关平台的规范也会受平台的限制。
因此,当开发 uni-app 出现问题时,一定要确认的是在哪个平台存在问题。

App

\n

在 HBuilderX 中运行,选择『运行到手机或模拟器』,对应的平台就是 App/5+App。

App 又划分为 Android 和 iOS 两个平台,以及真机调试和打包之后两种环境。

无论是 Android 还是 iOS,操作系统版本的不同同样会引发一些差异性的问题。因此遇到问题后,多测试几个设备可以进一步帮助定位问题。

那么,如果是在 App 平台出现了问题,首先要明确是真机调试环境还是打包之后,然后是 Android、iOS,最后附带上手机设备的信息截图。

小程序

\n

目前支持微信小程序,百度等小程序平台的支持,也在开发中。

微信小程序

\n

在 HBuilderX 中运行,选择『运行到小程序模拟器』,对应的平台就是微信小程序。

微信小程序其实也划分为模拟器环境和真机环境。

如果通过微信开发者工具开发出现了问题,请先运行到 App 平台对比一下是否也存在同样的问题,因为有些问题可能是微信小程序本身的限制或存在的 bug。有些具体的问题,可能还需要通过微信开发者工具的真机调试来对比测试。

H5

\n

在 HBuilderX 中运行,选择『运行到浏览器』,对应的平台就是 H5。

这就是普通的 Web 项目,运行在浏览器环境的,因此一些常见问题可以通过搜索来直接定位确认。

最为典型的问题,就是开发期间的跨域请求。App 和小程序已经通过原生引擎处理过了,开发者不需要再做处理。但是在浏览器环境,这个限制是始终存在的。开发期间,可以参考:https://ask.dcloud.net.cn/article/35232 中提供的方案来处理。

问题描述

\n

主要描述重现问题的操作步骤,这样有利于其他人快速重现问题。

除了文字描述,还可以选择截图以及短视频来更加明确地展示问题。

代码

\n

通过上传的项目源码,再配合前面的问题描述,其他人拿到代码后就可以直接运行并尝试重现问题了。如果不方便直接上传项目源码,也请精简一下提供一个可以直接运行起来的 demo。

有些问题,单靠贴代码片段,是无法定位的。在上传 demo 的时候要注意,尽量不要只上传一个页面的文件,而遗漏了其引入的图片以及组件等资源。所以,最好还是摘出来一个单独的项目。

最后

\n

以上这些信息,对于测试定位问题都十分关键,大家在反馈问题时不要嫌麻烦而遗漏一些关键信息。不然还需要回复提醒补充信息,进而降低了测试定位问题的效率。

由于 QQ 群比较多而且聊天信息更多,一些问题可能会被遗漏掉。因此,大家遇到一些问题或疑惑时,请尽可能在社区发帖进行交流。感谢大家的理解与配合。


0 分享 关注

要回复文章请先登录注册