Sentry SDK for Java and Android
Java SDK 3.0 Docs
The Java SDK documentation can be found on docs.sentry.io.
Java SDK version 1.x can still be found here.
Javadocs generated from source code.
Android Docs
That's the initial page of the release 2.x and its docs.
Releases from sentry-android 2.x and its changelogs.
Migration page from sentry-android 1.x and 2.x to sentry-android 3.x.
Sentry Android Gradle Plugin repo sits on another repo
Blog posts
Adding Native support to our Android SDK.
Samples
Sample App. with Sentry Android SDK and Sentry Gradle Plugin.
Development
This repository includes sentry-native
as a git submodule. To build against sentry-native
checked-out elsewhere in your file system, create a symlink sentry-android-ndk/sentry-native-local
that points to your sentry-native
directory. For example, if you had sentry-native
checked-out in a sibling directory to this repo:
ln -s ../../sentry-native sentry-android-ndk/sentry-native-local
which will be picked up by gradle
and used instead of the git submodule. This directory is also included in .gitignore
not to be shown as pending changes.
Android: Note on multiple crash reporting SDKs
Installing multiple crash reporting SDKs isn't supported. They race each other on taking the signal handler (for native crashes) and it often results in only 1 of the SDKs capturing the error. This is also due to the limitations of what can run there (like allocating memory etc) and how long the app lives. This limitation also affects the Java layer, given that the operating system will kill the app before more than one SDK is able to process the crash and save the error to storage.
Sentry Self Hosted Compatibility
Since version 3.0.0 of this SDK, Sentry version >= v20.6.0 is required. This only applies to on-premise Sentry, if you are using sentry.io no action is needed.