It does what every Sentry client needs to do
Below is an example of how to register Sentry-Android to handle uncaught exceptions
<!-- REQUIRED to send captures to Sentry -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- OPTIONAL but makes Sentry-Android smarter -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
public class MainActivity extends Activity {
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// Sentry will look for uncaught exceptions from previous runs and send them
Sentry.init(this.getApplicationContext(), "YOUR-SENTRY-DSN");
}
}
Version | Changes |
---|---|
1.1.2 | Bug fixed - Setting a captureListener was required to send a report (thanks mathzol) |
1.1.1 | Uncaught exception handler now calls SentryEventCaptureListener |
1.1.0 | Saves requests that were captured offline or failed and tries to resend them when it can |
1.0.0 | Removed dependency to Protocol ; allows capture of message from background thread |
0.1.0 | Initial release |
- Download the Sentry-Android JAR - v1.1.2
- Place the JAR in the Android project's "libs" directory
- Code
The AndroidManifest.xml requires the permission android.permission.INTERNET
and would like the permission android.permission.ACCESS_NETWORK_STATE
even though optional.
<!-- REQUIRED to send captures to Sentry -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- OPTIONAL but makes Sentry-Android smarter -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Sentry.captureMessage("Something significant may have happened");
try {
JSONObject obj = new JSONObjet();
} catch (JSONException e) {
Sentry.captureException(e);
}
Sentry.captureEvent(new Sentry.SentryEventBuilder()
.setMessage("Being awesome")
.setCulprit("Josh Holtz")
.setTimestamp(System.currentTimeMillis())
);
// CALL THIS BEFORE CALLING Sentry.init
// Sets a listener to intercept the SentryEventBuilder before
// each capture to set values that could change state
Sentry.setCaptureListener(new SentryEventCaptureListener() {
@Override
public SentryEventBuilder beforeCapture(SentryEventBuilder builder) {
// Needs permission - <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
ConnectivityManager connManager = (ConnectivityManager) getSystemService(CONNECTIVITY_SERVICE);
NetworkInfo mWifi = connManager.getNetworkInfo(ConnectivityManager.TYPE_WIFI);
// Sets extra key if wifi is connected
try {
builder.getExtra().put("wifi", String.valueOf(mWifi.isConnected()));
builder.getTags().put("tag_1", "value_1");
} catch (JSONException e) {}
return builder;
}
});
Sentry.init(this, "http://your-base-url.com" "YOUR-SENTRY-DSN");
Email: josh@rokkincat.com
Twitter: @joshdholtz
Sentry-Android is available under the MIT license. See the LICENSE file for more info.