Grasshopper bug reporter

Get a full report of everything that happened with screenshots from any device, Desktop/iOS-MOE/Android.

How it works

Grasshopper intercepts all uncaught exceptions and log events that are WARNING or above.

It captures all the error information, and system information with screenshots of all the windows.

It generates an email that has the error signature as the subject, this means most email providers will group the related bugs together into a single thread.

Post all the information into a form mail URL that sends the email to your special bugs email account

Setup

you will need to re-build the project with your config to use this in your app. First you will need to checkout the whole project from version control.

svn co https://svn.code.sf.net/p/jrisk/code/Grasshopper


Browse Subversion Repository

Client Setup

Configure your email and server by editing the grasshopper.properties

Use ant to build all versions (Desktop/iOS/Android) of grasshopper client lib:

• Desktop/Server - run "ant"
• iOS - run "ant ios"
• Android - run "ant android"

include the client lib with your client app.

Initialise the lib by calling:

• Desktop - net.yura.grasshopper.PopupBug.initSimple(appname, version, locale)
• iOS/Android - net.yura.grasshopper.SimpleBug.initLogFile(appname, version, locale)

If you want to add extra information about the state of the app at the point of the crash you can call

    net.yura.grasshopper.BugSubmitter.setApplicationInfoProvider( new ApplicationInfoProvider() {
        @Override
        public void addInfoForSubmit(Map map) {
            // add any extra info here
        }
        @Override
        public boolean ignoreError(LogRecord record) {
            // ignore errors you don't want to receive emails about
        }
    } );

Server Setup

Please follow the Server setup guide

Install BOTH cgi form to e-mail scripts:

• (primary) TFMail (original download)
• (backup) FormMail (original download)

Specially configured for grasshopper version of both of these can be found here.

copyright (c) 2022 yura.net