Reporting problems

The usual way of reporting problems to Apphance on Android involves using the notification which is placed on the system status bar. Tapping it invokes the report screen where user can enter addtional information about a problem they have spotted. The message will be then posted to Apphance, along with any relevant debugging information.


While this UI solution for problem reporting is fine for most applications, some apps could use a different way. An example would be a fullscreen application or game which takes up the entire surface of device's screen. The notification bar is not visible in such case and user cannot interact with it, thus being unable to report a problem (unless they switch to Home screen).

To alleviate that, Apphance offers alternative ways of triggering a problem report. They are described below.

Shaking the device

If your application does not use accelerometer on its own, then shaking the devices becomes a feasible option for triggering a problem report. Since it doesn't rely on any on-screen element, it is always available - regardless of whether the application uses the whole screen or not.

By default, the report-on-shake functionality is disabled. To enable it , simply call Apphance.setReportOnShakeEnabled() following the startNewSession() call:

Apphance.startNewSession(this, API_KEY);
Apphance.setReportOnShakeEnabled(true);

Triggering the report programmatically

It is possible to invoke the problem report screen from application code. For that you only need to call:

Apphance.problem();

You could then bind this call to any specific UI action, like tapping an on-screen button or choosing an option from menu.
Comments