feat(event) implement ErrorOptions and CaptureOptions class

Author: YYChen01988

bugsnag-android-core/api/bugsnag-android-core.api

@@ -82,6 +82,7 @@ public final class com/bugsnag/android/Bugsnag {
 	public static fun leaveBreadcrumb (Ljava/lang/String;Ljava/util/Map;Lcom/bugsnag/android/BreadcrumbType;)V
 	public static fun markLaunchCompleted ()V
 	public static fun notify (Ljava/lang/Throwable;)V
+	public static fun notify (Ljava/lang/Throwable;Lcom/bugsnag/android/ErrorOptions;Lcom/bugsnag/android/OnErrorCallback;)V
 	public static fun notify (Ljava/lang/Throwable;Lcom/bugsnag/android/OnErrorCallback;)V
 	public static fun pauseSession ()V
 	public static fun removeOnBreadcrumb (Lcom/bugsnag/android/OnBreadcrumbCallback;)V
@@ -111,6 +112,35 @@ public class com/bugsnag/android/BugsnagVmViolationListener : android/os/StrictM
 	public fun onVmViolation (Landroid/os/strictmode/Violation;)V
 }
 
+public final class com/bugsnag/android/CaptureOptions {
+	public static final field CAPTURE_BREADCRUMBS I
+	public static final field CAPTURE_FEATURE_FLAGS I
+	public static final field CAPTURE_STACKTRACE I
+	public static final field CAPTURE_THREADS I
+	public static final field CAPTURE_USER I
+	public static final field Companion Lcom/bugsnag/android/CaptureOptions$Companion;
+	public fun <init> ()V
+	public static final fun captureNothing ()Lcom/bugsnag/android/CaptureOptions;
+	public static final fun captureOnly (I)Lcom/bugsnag/android/CaptureOptions;
+	public final fun getBreadcrumbs ()Z
+	public final fun getFeatureFlags ()Z
+	public final fun getMetadata ()Ljava/util/Set;
+	public final fun getStacktrace ()Z
+	public final fun getThreads ()Z
+	public final fun getUser ()Z
+	public final fun setBreadcrumbs (Z)V
+	public final fun setFeatureFlags (Z)V
+	public final fun setMetadata (Ljava/util/Set;)V
+	public final fun setStacktrace (Z)V
+	public final fun setThreads (Z)V
+	public final fun setUser (Z)V
+}
+
+public final class com/bugsnag/android/CaptureOptions$Companion {
+	public final fun captureNothing ()Lcom/bugsnag/android/CaptureOptions;
+	public final fun captureOnly (I)Lcom/bugsnag/android/CaptureOptions;
+}
+
 public class com/bugsnag/android/Client : com/bugsnag/android/CallbackAware, com/bugsnag/android/FeatureFlagAware, com/bugsnag/android/MetadataAware, com/bugsnag/android/UserAware {
 	public fun <init> (Landroid/content/Context;)V
 	public fun <init> (Landroid/content/Context;Lcom/bugsnag/android/Configuration;)V
@@ -139,6 +169,7 @@ public class com/bugsnag/android/Client : com/bugsnag/android/CallbackAware, com
 	public fun leaveBreadcrumb (Ljava/lang/String;Ljava/util/Map;Lcom/bugsnag/android/BreadcrumbType;)V
 	public fun markLaunchCompleted ()V
 	public fun notify (Ljava/lang/Throwable;)V
+	public fun notify (Ljava/lang/Throwable;Lcom/bugsnag/android/ErrorOptions;Lcom/bugsnag/android/OnErrorCallback;)V
 	public fun notify (Ljava/lang/Throwable;Lcom/bugsnag/android/OnErrorCallback;)V
 	public fun pauseSession ()V
 	public fun removeOnBreadcrumb (Lcom/bugsnag/android/OnBreadcrumbCallback;)V
@@ -355,6 +386,14 @@ public class com/bugsnag/android/Error : com/bugsnag/android/JsonStream$Streamab
 	public fun toStream (Lcom/bugsnag/android/JsonStream;)V
 }
 
+public final class com/bugsnag/android/ErrorOptions {
+	public fun <init> ()V
+	public fun <init> (Lcom/bugsnag/android/CaptureOptions;)V
+	public synthetic fun <init> (Lcom/bugsnag/android/CaptureOptions;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public final fun getCapture ()Lcom/bugsnag/android/CaptureOptions;
+	public final fun setCapture (Lcom/bugsnag/android/CaptureOptions;)V
+}
+
 public final class com/bugsnag/android/ErrorType : java/lang/Enum {
 	public static final field ANDROID Lcom/bugsnag/android/ErrorType;
 	public static final field C Lcom/bugsnag/android/ErrorType;

bugsnag-android-core/detekt-baseline.xml

@@ -22,6 +22,7 @@
     <ID>LongParameterList:DeviceWithState.kt$DeviceWithState$( buildInfo: DeviceBuildInfo, jailbroken: Boolean?, id: String?, locale: String?, totalMemory: Long?, runtimeVersions: MutableMap&lt;String, Any>, /** * The number of free bytes of storage available on the device */ var freeDisk: Long?, /** * The number of free bytes of memory available on the device */ var freeMemory: Long?, /** * The orientation of the device when the event occurred: either portrait or landscape */ var orientation: String?, /** * The timestamp on the device when the event occurred */ var time: Date? )</ID>
     <ID>LongParameterList:EventFilenameInfo.kt$EventFilenameInfo.Companion$( obj: Any, uuid: String = UUID.randomUUID().toString(), apiKey: String?, timestamp: Long = System.currentTimeMillis(), config: ImmutableConfig, isLaunching: Boolean? = null )</ID>
     <ID>LongParameterList:EventInternal.kt$EventInternal$( apiKey: String, logger: Logger, breadcrumbs: MutableList&lt;Breadcrumb> = mutableListOf(), discardClasses: Set&lt;Pattern> = setOf(), errors: MutableList&lt;Error> = mutableListOf(), metadata: Metadata = Metadata(), featureFlags: FeatureFlags = FeatureFlags(), originalError: Throwable? = null, projectPackages: Collection&lt;String> = setOf(), severityReason: SeverityReason = SeverityReason.newInstance(SeverityReason.REASON_HANDLED_EXCEPTION), threads: MutableList&lt;Thread> = mutableListOf(), user: User = User(), redactionKeys: Set&lt;Pattern>? = null, isAttemptDeliveryOnCrash: Boolean = false )</ID>
+    <ID>LongParameterList:EventInternal.kt$EventInternal$( originalError: Throwable? = null, config: ImmutableConfig, severityReason: SeverityReason, data: Metadata = Metadata(), featureFlags: FeatureFlags = FeatureFlags(), captureStacktrace: Boolean = true, captureThreads: Boolean = true, withOptions: Boolean? = null )</ID>
     <ID>LongParameterList:EventStorageModule.kt$EventStorageModule$( contextModule: ContextModule, configModule: ConfigModule, dataCollectionModule: DataCollectionModule, bgTaskService: BackgroundTaskService, trackerModule: TrackerModule, systemServiceModule: SystemServiceModule, notifier: Notifier, callbackState: CallbackState )</ID>
     <ID>LongParameterList:NativeStackframe.kt$NativeStackframe$( /** * The name of the method that was being executed */ var method: String?, /** * The location of the source file */ var file: String?, /** * The line number within the source file this stackframe refers to */ var lineNumber: Number?, /** * The address of the instruction where the event occurred. */ var frameAddress: Long?, /** * The address of the function where the event occurred. */ var symbolAddress: Long?, /** * The address of the library where the event occurred. */ var loadAddress: Long?, /** * Whether this frame identifies the program counter */ var isPC: Boolean?, /** * The type of the error */ var type: ErrorType? = null, /** * Identifies the exact build this frame originates from. */ var codeIdentifier: String? = null, )</ID>
     <ID>LongParameterList:StateEvent.kt$StateEvent.Install$( @JvmField val apiKey: String, @JvmField val autoDetectNdkCrashes: Boolean, @JvmField val appVersion: String?, @JvmField val buildUuid: String?, @JvmField val releaseStage: String?, @JvmField val lastRunInfoPath: String, @JvmField val consecutiveLaunchCrashes: Int, @JvmField val sendThreads: ThreadSendPolicy, @JvmField val maxBreadcrumbs: Int )</ID>
@@ -64,9 +65,9 @@
     <ID>MagicNumber:JsonHelper.kt$JsonHelper$8</ID>
     <ID>MagicNumber:JsonStream.kt$JsonStream$128</ID>
     <ID>MagicNumber:JsonStream.kt$JsonStream$32</ID>
-    <ID>MagicNumber:JsonStream.kt$JsonStream.Companion$128</ID>
     <ID>MagicNumber:LastRunInfoStore.kt$LastRunInfoStore$3</ID>
     <ID>MagicNumber:SessionStore.kt$SessionStore$60</ID>
+    <ID>MaxLineLength:ErrorTest.kt$ErrorTest$val err = Error.createError(IllegalStateException("Some err", RuntimeException("Whoops")), setOf(), NoopLogger, false)</ID>
     <ID>MaxLineLength:LastRunInfo.kt$LastRunInfo$return "LastRunInfo(consecutiveLaunchCrashes=$consecutiveLaunchCrashes, crashed=$crashed, crashedDuringLaunch=$crashedDuringLaunch)"</ID>
     <ID>MaxLineLength:ThreadState.kt$ThreadState$"[${allThreads.size - maxThreadCount} threads omitted as the maxReportedThreads limit ($maxThreadCount) was exceeded]"</ID>
     <ID>NestedBlockDepth:FileStore.kt$FileStore$fun deleteStoredFiles(storedFiles: Collection&lt;File>?)</ID>

bugsnag-android-core/src/main/java/com/bugsnag/android/Bugsnag.java

@@ -255,6 +255,20 @@ public static void notify(@NonNull final Throwable exception,
         getClient().notify(exception, onError);
     }
 
+    /**
+     * Notify Bugsnag of a handled exception
+     *
+     * @param exception the exception to send to Bugsnag
+     * @param onError   callback invoked on the generated error report for
+     *                  additional modification
+     * @param options the error options
+     */
+    public static void notify(@NonNull final Throwable exception,
+                              @Nullable final ErrorOptions options,
+                              @Nullable final OnErrorCallback onError) {
+        getClient().notify(exception, options, onError);
+    }
+
     /**
      * Adds a map of multiple metadata key-value pairs to the specified section.
      */