This article may contain affiliate links. Learn more on our Partner Program page.
Apple has published an article on the official developer website explaining how bugs can be reported by beta testers and regular users.
Apple has published a new post on the official developer website, offering tips for bug reports. Specifically, it's about the Feedback Assistant. It's safe to assume that the company wants to prepare users for the upcoming iOS 14 beta – but the tip also appeals to those of us using final builds. The article – titled "How to Submit Great Bug Reports" – was published just two weeks before the upcoming WWDC 2020. So, it must be about the new operating systems, right? Whatever. Beta versions of iOS, iPadOS, macOS, tvOS, and watchOS often contain a number of bugs that need to be reported. The problem is, many users don't even know how to submit bug reports or how to submit them correctly. Apple has set up a special page for such bug reports, which can be found at feedbackassistant.apple.com can be reached.
Bug reports are often incomplete
Users of a final iOS and other versions can also submit their reports there. Beta testers, on the other hand, receive the Feedback Assistant as an app on their iPhone, iPad and Mac - provided that a beta version is actually installed on the device. But the problem is bigger than expected. Apple points out that even with the Feedback Assistant, not everyone knows how to fill out a bug report, which can make it difficult for Apple engineers to understand and fix the problem. This is what the Contribution:
You should always submit feedback for any bugs you find during development on Apple's platforms; after all, we can't fix problems we don't know about. But how can you be sure that the information you provide will be useful in assessing the issue and not a troubleshooting dead end? Here are some of our top tips for making sure your bug report is clear, actionable, and most importantly, fixable.
One thing is clear: the error reports must be extremely detailed and understandable. This is the only way they can be reproduced before a fix is possible. Apple points out that all steps that lead to error XY must be listed. The current result or the expected result must also be listed.
First iOS 14 beta released at the end of the month
To make the report even easier to understand, users can upload both screenshots and videos via the feedback assistant. In addition, Apple explains that developers can go a step further and submit a sample project with the code that causes the problem. This would make the engineers' work much easier and significantly speed up the fixes. The post continues:
Unfortunately, not all bugs are reproducible or have easy-to-follow steps. For trickier cases, consider providing log information like a system diagnostic: When you report a bug on your iPhone or iPad, you can use the Feedback Assistant application to capture it automatically. When you file a bug through Apple's web portal, you can install profiles that can help you capture a system diagnostic manually.
The first preview of iOS 14 and Co. is expected at the end of the month. For now, this will only be available to registered developers. A first public beta should therefore be released in July at the earliest. As soon as this is the case, I will publish an updated version of our step-by-step guide for voluntary beta testers - stay tuned and don't miss anything. (Image: Apple)
