This document describes the process of obtaining crash reports for our PhilipsDictationRecorder (PDR) App.
The iOS operating system automatically generates a crash report file if an app crashes for some reason. We have developed following app for your testing convenience:
Please install the CrashTestApp.ipa using iTunes and run the application ‘CrashTestApp’ as follows:
- Run iTunes
- Connect you iPhone
Go to ‘Apps’ as shown below
Double click on ‘CrashTestApp.ipa’ and it will appear under tab ‘Apps> iPhone’
- Click on ‘Install’ and ‘Apply’
- Wait for the sync process to finish
Start the app and hit the Crash Now button to force a crash:
How to collect the bug report
- Make sure you have iTuns installed and running
- Connect your iOS device to your Windows-PC or MacOS
Typically iTunes should automatically sync your iOS device data, but sometimes it is necessary to manually sync the device. Switch to the iPhone Tab and hit the Sync button:
Depending on your OperatingSystem you can find the crash report in this folder:
Mac OS X:
Windows 7 or higher
The filename of the crashreport contains the app-name, a timestamp and “crash” as extension:
Please be aware that crash reports of our PDR always start with “recorder”, so an example crash report of the PDR would be:
The logging on Android is permanently turned on, but you have to enable the “Developer options” manually in order to retrieve the bug reports.
The screenshots below have been captures on a Nexus6P which uses the native implementation of Android. Different vendors may implement some settings with different names, but the basic principles should stay the same.
Open the device settings, scroll to the bottom and tap on “About phone”.
Scroll to the bottom and tap on “Build number” several times:
After several taps, a toast (little grey pop-up at the bottom of the screen) will open, informing you about the remaining numbers of taps you’ll have to do:
If you now hit return, you should see the menu item “Developer options” at the bottom of the list:
Open the “Developer options” and make sure the Developer opitons are “On” and the “USB debugging” mode is enabled.
Only if both options are enabled, you should be able to hit “Take bug report” at the top of the “Developer options”.
After pressing “Take bug report”, a pop-up will inform you about some consequences, simply press “REPORT”:
The OS will now gather some data, this may take a while. You will receive a notification when the bug-report is ready to send:
If you tap on this notification, you will be informed about some security issues. Simply hit “OK”:
If you have not already configured a standard option for sharing data, a pop-up will ask you to do so. Gmail would be the best option. However, some phones are not capable of sending large files via the Gmail-client (eg Samsung S6), so you would have to choose Google-Drive as sending option.
The bug report will be sent to the application you have selected.
Considerations for the SpeechAir
If you take a bug report on a SpeechAir, you will find the bugreport on the mass-storage-drive of the SpeechAir in the “bugreports” directory.