Version 1.1.0

- Added support for file attachments and annotations
- Added battery level and status attributes
- Added screen brightness attribute
- Fixed Android version attribute
- Fixed bug with negative number of lines in stacktrace
- Filtered out the frames from the Backtrace library
- Simplified BacktraceClient class, removed 'send' and 'async' methods overwrites
- Replaced spaces with underscore in all enums strings

Author: BartoszLitwiniuk

.gitignore

@@ -1,17 +1,86 @@
+# [Android] ========================
+# Built application files
+*.apk
+*.ap_
+
+# Files for the Dalvik VM
+*.dex
+
+# Java class files
 *.class
 
+# Generated files
+bin/
+gen/
+
+# Gradle files
+.gradle/
+build/
+
+# Local configuration file (sdk path, etc)
+local.properties
+
+# Proguard folder generated by Eclipse
+proguard/
+
+# Log Files
+*.log
+
+
+## Directory-based project format:
+.idea/
+
+## File-based project format:
+*.ipr
+*.iws
+
+## Plugin-specific files:
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+
+
+# [Maven] ========================
+target/
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+
+
+# [Gradle-Android] ========================
+
+# Ignore Gradle GUI config
+gradle-app.setting
+
+# Gradle Signing
+signing.properties
+trestle.keystore
+
 # Mobile Tools for Java (J2ME)
 .mtj.tmp/
 
 # Package Files #
+*.jar
 *.war
 *.ear
 
 # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
 hs_err_pid*
 
-local.properties
-build/
-.gradle/
-.idea
-*.iml
+# Misc
+/.idea/workspace.xml
+.DS_Store
+/captures
+**/*.iml
+*.class

CHANGELOG.md

@@ -0,0 +1,14 @@
+# Backtrace Android Release Notes
+
+## Version 1.1.0 - 25.02.2019
+- Added support for file attachments and annotations
+- Added battery level and status attributes
+- Added screen brightness attribute
+- Fixed Android version attribute
+- Fixed bug with negative number of lines in stacktrace
+- Filtered out the frames from the Backtrace library
+- Simplified BacktraceClient class, removed 'send' and 'async' methods overwrites
+- Replaced spaces with underscore in all enums strings
+
+## Version 1.0 - 27.01.2019
+- First release.

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 Backtrace I/O, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+ all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -11,7 +11,7 @@
 
 
 
-[Backtrace](http://backtrace.io/)'s integration with Android applications written in Java allows customers to capture and report handled and unhandled java exceptions to their Backtrace instance, instantly offering the ability to prioritize and debug software errors.
+[Backtrace](http://backtrace.io/)'s integration with Android applications written in Java or Kotlin which allows customers to capture and report handled and unhandled java exceptions to their Backtrace instance, instantly offering the ability to prioritize and debug software errors.
 
 
 ## Usage
@@ -52,39 +52,53 @@ catch (e: Exception) {
 7. [Architecture](#architecture)
 
 
-# Download
-Gradle
+# Features Summary <a name="features-summary"></a>
+* Light-weight Java client library that quickly submits exceptions and crashes to your Backtrace dashboard. Can include callstack, system metadata, custom metadata and file attachments if needed.<!--, and file attachments if needed.-->
+* Supports a wide range of Android SDKs.
+* Supports asynchronous Tasks.
+* Fully customizable and extendable event handlers and base classes for custom implementations.
+
+# Supported SDKs <a name="supported-sdks"></a>
+* Minimal SDK version 19 (Android 4.4)
+* Target SDK version 28 (Android 9.0)
+
+# Differences and limitations of the SDKs version <a name="limitations"></a>
+* Getting the status that the device is in power saving mode is available from API 21.
+
+# Installation <a name="installation"></a>
+## Download library via Gradle or Maven
+* Gradle
 ```
 dependencies {
-    implementation 'com.github.backtrace-labs.backtrace-android:backtrace-library:1.0'
+    implementation 'com.github.backtrace-labs.backtrace-android:backtrace-library:1.1.0'
 }
 ```
 
-Maven
+* Maven
 ```
 <dependency>
   <groupId>com.github.backtrace-labs.backtrace-android</groupId>
   <artifactId>backtrace-library</artifactId>
-  <version>1.0</version>
+  <version>1.1.0</version>
   <type>aar</type>
 </dependency>
 ```
 
-# Features Summary <a name="features-summary"></a>
-* Light-weight Java client library that quickly submits exceptions and crashes to your Backtrace dashboard. Can include callstack, system metadata, custom metadata.<!--, and file attachments if needed.-->
-* Supports a wide range of Android SDKs.
-* Supports asynchronous Tasks.
-* Fully customizable and extendable event handlers and base classes for custom implementations.
+## Permissions
+### Internet permission
+* To send errors to the server instance you need to add permissions for Internet connection into `AndroidManifest.xml` file in your application.
 
+```xml
+<uses-permission android:name="android.permission.INTERNET" />
+```
 
-# Differences and limitations of the SDKs version <a name="limitations"></a>
+### File access
+* To send file attachments from external storage to the server instance you need to add permissions for read external storage into `AndroidManifest.xml` file in your application.
 
-# Supported SDKs <a name="supported-sdks"></a>
-* Minimal SDK version 19 (Android 4.4)
-* Target SDK version 28 (Android 9.0)
+```xml
+<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
+```
 
-# Installation <a name="installation"></a>
-TODO
 
 # Running sample application
 ## Android Studio <a name="sample-app-android-studio"></a>
@@ -142,8 +156,8 @@ try {
     new HashMap<String, Object>() {{
         put("key", "value");
     }}, new ArrayList<String>() {{
-        add("file_path_1");
-        add("file_path2");
+        add("absoulte_file_path_1");
+        add("absoulte_file_path_2");
     }});
     backtraceClient.send(report);
 }
@@ -155,12 +169,12 @@ try {
     // throw exception here
 }
 catch (e: Exception) {
-    val report = BacktraceReport(e, mapOf("key" to "value"), listOf("file_path_1", "file_path_2"))
+    val report = BacktraceReport(e, mapOf("key" to "value"), listOf("absolute_file_path_1", "absolute_file_path_2"))
     backtraceClient.send(report)
 }
 ```
 
-#### Asynchronous Send Support
+### Asynchronous Send support
 
 Method `send` behind the mask use `AsyncTask` and wait until method `doInBackground` is not completed. Library gives you the option of not blocking code execution by using method `sendAsync` which returning the `AsyncTask<Void, Void, BacktraceResult>` object. Additionally, it is possible to specify the method that should be performed after completion `AsyncTask` by using events described in [events](#events). 
 
@@ -179,7 +193,7 @@ val sendAsyncTask = backtraceClient.sendAsync(report)
 val result = asynctask.get()
 ```
 
-### Other BacktraceReport Overloads
+### Other BacktraceReport overloads
 
 `BacktraceClient` can also automatically create `BacktraceReport` given an exception or a custom message using the following overloads of the `BacktraceClient.send` or `BacktraceClient.sendAsync` methods:
 
@@ -268,14 +282,10 @@ You can extend `BacktraceBase` to create your own Backtrace client and error rep
 
 ## BacktraceApi  <a name="architecture-BacktraceApi"></a>
 **`BacktraceApi`** is a class that sends diagnostic JSON to the Backtrace endpoint. `BacktraceApi` is instantiated when the `BacktraceClient` constructor is called. You use the following event handlers in `BacktraceApi` to customize how you want to handle JSON data:
-- `RequestHandler` - attach an event handler to this event to override the default `BacktraceApi.send` method. <!--A `RequestHandler`  TODO -->
-- `OnServerError` - attach an event handler to be invoked when the server returns with a `400 bad request`, `401 unauthorized` or other HTTP error codes. <!-- TODO -->
+- `RequestHandler` - attach an event handler to this event to override the default `BacktraceApi.send` and `BacktraceApi.sendAsync` methods.
+- `OnServerError` - attach an event handler to be invoked when the server returns with a `400 bad request`, `401 unauthorized` or other HTTP error codes.
 - `OnServerResponse` - attach an event handler to be invoked when the server returns with a valid response.
 
 
 ## BacktraceResult  <a name="architecture-BacktraceResult"></a>
-**`BacktraceResult`** is a class that holds response and result from a `send` or `sendAsync` call. The class contains a `Status` property that indicates whether the call was completed (`OK`), the call returned with an error (`ServerError`), . Additionally, the class has a `Message` property that contains details about the status.
-
-
-
-
+**`BacktraceResult`** is a class that holds response and result from a `send` or `sendAsync` call. The class contains a `Status` property that indicates whether the call was completed (`OK`), the call returned with an error (`ServerError`), . Additionally, the class has a `Message` property that contains details about the status.

backtrace-library/build.gradle

@@ -7,7 +7,7 @@ android {
         minSdkVersion 19
         targetSdkVersion 28
         versionCode 1
-        versionName "1.0"
+        versionName "1.1.0"
         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
     }
 
@@ -26,5 +26,7 @@ dependencies {
     implementation 'com.android.support:appcompat-v7:28.0.0'
     testImplementation 'junit:junit:4.12'
     androidTestImplementation 'com.android.support.test:runner:1.0.2'
+    androidTestImplementation 'com.android.support.test:rules:1.0.2'
+    androidTestImplementation 'com.android.support.test:runner:1.0.2'
     androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
 }

backtrace-library/gradle.properties

@@ -0,0 +1,3 @@
+POM_NAME=Backtrace-library
+POM_ARTIFACT_ID=backtrace-library
+POM_PACKAGING=aar

…ceio/library/EventsInstrumentedTest.java …o/library/BacktraceClientEventsTest.javabacktrace-library/src/androidTest/java/backtraceio/library/EventsInstrumentedTest.java renamed to backtrace-library/src/androidTest/java/backtraceio/library/BacktraceClientEventsTest.java backtrace-library/src/androidTest/java/backtraceio/library/EventsInstrumentedTest.java renamed to backtrace-library/src/androidTest/java/backtraceio/library/BacktraceClientEventsTest.java

@@ -1,6 +1,7 @@
 package backtraceio.library;
 
 import android.content.Context;
+import android.os.AsyncTask;
 import android.support.test.InstrumentationRegistry;
 import android.support.test.runner.AndroidJUnit4;
 
@@ -10,6 +11,7 @@
 
 import java.util.ArrayList;
 import java.util.UUID;
+import java.util.concurrent.ExecutionException;
 
 import backtraceio.library.events.OnBeforeSendEventListener;
 import backtraceio.library.events.OnServerErrorEventListener;
@@ -27,7 +29,7 @@
  * @see <a href="http://d.android.com/tools/testing">Testing documentation</a>
  */
 @RunWith(AndroidJUnit4.class)
-public class EventsInstrumentedTest {
+public class BacktraceClientEventsTest {
     private Context context;
     private BacktraceCredentials credentials;
     private final String resultMessage = "From request handler";