报告错误/崩溃的指南
报告错误或崩溃是为GDevelop做出贡献的好方法,同时也可以解决您在GDevelop中遇到的一些问题。以下是撰写出色错误报告的指南。
首先,您应该检查是否使用的是最新版本。可能存在bug/崩溃已经在最新版本中修复的情况。
在顶部工具栏中,转到 帮助→关于 GDevelop → 点击 检查更新。
您可以查看最新版本在这里。一些发布可能是预发布版本,标签会说明是预发布版还是最新版本。
警告
如果您使用的版本早于beta98,可能需要重新安装GDevelop,因为它可能无法更新。
同时,请检查bug/崩溃是否已经在官方论坛上报告。如果已经有报告的话,请回复该主题/报告,并可以通过提供更多信息来帮助解决问题。
警告
请注意检查报告是否是最新的。您不希望回复5年前的帖子!
撰写出色的错误报告
一个出色的错误报告清晰、明了地传达问题。它还应该清楚地提供有关错误的所有相关信息以及以结构化方式提供的所有信息。应该尽量用较少的句子来撰写(但不要排除任何可能有用的信息),因为开发人员可能不会耐心阅读您整篇文章。如果您撰写了一份糟糕或非描述性的错误报告,可能导致无法修复该问题。
需要的内容
以下是报告中可能需要的一些内容。请记住,并非所有bug/崩溃都是相同的。因此,如果需要,请添加更多信息。
GDevelop的版本
首先看看您使用的是web版本还是桌面版本(您需要将此信息添加到报告中)。
- 如果您使用的是桌面版本:
- 在顶部工具栏中,转到 帮助→关于 GDevelop
一个窗口将打开显示版本。它应该类似于GDevelop-beta110。
一些问题的截图
这可能不适用于所有的bug或崩溃,但它将有助于识别问题并进行修复。
如果您使用 Windows 操作系统,则可以使用自带的截图工具,或按下 Alt+PrtScn(它将对活动窗口截图)。
如果您使用 MacOS,按 Shift+Command+3
如果您使用 Linux 发行版,应该内置有一个截图工具,或按 Alt+PrtScn(它将对活动窗口截图)
如有必要,编辑图像并添加一些标记以显示bug
复现bug的步骤
如果可能的话,添加正确的步骤来复现bug,以便开发人员可以轻松知道可能导致bug的问题。
例如:
* 进入场景事件 * 右键单击事件 * 点击编辑 * 窗口现在应该疯狂起来
问题发生时您在做什么
如果是崩溃,您将需要描述发生时正在做什么。
错误或调用堆栈
一些错误日志可能暗示问题。因此,请检查(如果可能的话)开发人员工具中是否有任何错误。
按下 Ctrl+Shift+I,将打开一个选项卡
打开 Console 选项卡,查看是否显示任何错误
还要检查 sources 以获取调用堆栈
注意
如果GDevelop已崩溃或冻结,您可能无法获取任何错误,甚至无法打开开发人员工具
撰写报告的模板
以下是您撰写报告时可以使用的模板。
## 描述错误 对错误的清晰而简明的描述。任何错误或控制台日志 ## 复现步骤 重现行为的步骤: 1. 进入 '...' 2. 点击 '....' 3. 滚动至 '....' 4. 查看错误 * 如果可能,请添加指向游戏的链接! * 如适用,添加截图以帮助解释您的问题。 ## 其他详细信息 * 包括您使用的操作系统/浏览器版本/智能手机 * 您使用的是哪个版本的GDevelop?桌面应用程序还是Web应用程序? * 在此处添加有关问题的任何其他上下文。```
**以下是一个可能不够有用的报告示例**
![示例](https://wiki.gdevelop.io/gdevelop5/community/guide-to-reporting-a-bug/exampleofbadreport.png)
**以下是一个尚可的报告示例**
> ![示例](https://wiki.gdevelop.io/gdevelop5/community/guide-to-reporting-a-bug/exampleofgoodreport.png)
### 在哪里报告bug?
可以在[官方论坛](https://github.com/4ian/GDevelop/issues)上报告bug。
提示
建议在[官方论坛](https://forum.gdevelop.io)上报告bug,而不是在GitHub上报告。
### 在论坛上报告bug
报告bug的第一选择应该是在[官方论坛](https://forum.gdevelop.io)上报告。
* 进入论坛,点击 **+ 新主题**
* 一个面板会打开,从类别中选择 **Bug报告**,然后您可以开始描述您的问题。
* 完成后,别忘了单击 **
创建主题**
### 在Github上报告bug
您也可以在[GDevelop的Github仓库](https://github.com/4ian/GDevelop/issues)上报告bug,但建议在论坛上报告。只有当您确定拥有所有所需信息时才这样做。
* 点击 **新问题**。
* 会询问您问题是否是bug报告还是功能请求。点击Bug报告。
现在,您将得到一个空间,可以在其中描述您的bug。有一些文本已经写好。有些要求您写什么,用您修饰句子替换它们。
例如:如果有句子“对错误的清晰而简明的描述。”,请删除该句子并添加关于bug的描述。![](https://wiki.gdevelop.io/gdevelop5/community/guide-to-reporting-a-bug/rg6.png)