Giter VIP home page Giter VIP logo

bugtags-android's Introduction

Android Gems

Bugtags Android SDK

Download ###中文文档请移步README_CN ###QQ tribe for help: 479166560

Bugtags for Android, reports bugs and their diagnosis information in one step, captures crashes automatically. Improve your apps anywhere, anytime.

Create a free account and invite your team to improve your apps.

Download demo app here: DEMO.apk

If you are using Eclipse for Android development, visit SDK for Eclipse to download SDK.

We are open for registration now!

Bugtags also support iOS !

We are going to support English language in September.

Features

  1. Take snapshot of bug, add tags to describe the bug.
  2. Automatically collect device and app context data following reporting bugs.
  3. Automatically capture crashes.
  4. Bug lifecycle management.

Usage

How to use

Install using gradle

Step 1:

  • Setup repositories in Top-level build.gradle file:
buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.2.3'
    }
}
allprojects {
    repositories {
        jcenter() //repository 1
        mavenCentral()  //repository 2
    }
}
  • Add dependency in your module's build.gradle file:
dependencies {
    compile 'com.bugtags.library:bugtags-lib:latest.integration'
}

The latest version is: 1.0.4, you can also add dependency with specific version:

compile 'com.bugtags.library:bugtags-lib:1.0.4'

Step 2:

  • Add three callbacks in your base Activity class:
      package your.package.name;

      import android.app.Activity;
      import android.os.Bundle;
      import android.view.MotionEvent;

      import com.bugtags.library.Bugtags;

      public class CustomActivity extends Activity{
          @Override
          protected void onResume() {
              super.onResume();
              //callback 1
              Bugtags.onResume(this);
          }

          @Override
          protected void onPause() {
              super.onPause();
              //callback 2
              Bugtags.onPause(this);
          }

          @Override
          public boolean dispatchTouchEvent(MotionEvent event) {
              //callback 3
              Bugtags.onDispatchTouchEvent(this, event);
              return super.dispatchTouchEvent(event);
          }
      }

Step 3:

  • Create subclass of Application,initialize Bugtags in onCreate() method:
public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        //initialize here
        Bugtags.start("YOUR APPKEY", this, Bugtags.BTGInvocationEventBubble);
    }
}
  • Modify AndroidManifest.xml,use MyApplication:
<application
    android:name=".MyApplication"
    android:label="@string/app_name"
    android:theme="@style/AppTheme" >
    ....
</application>

For more information about Android Studio and gradle, please visit: Android Developer Site.

There you go!

Explore

  1. Invoke event:
  • BTGInvocationEventBubble: Show floating circle in app.
  • BTGInvocationEventShake: Show floating circle by shake.
  • BTGInvocationEventNone: Show no floating circle, capture crash bug only(if allow), this is recommended to be used in release build.
  1. Send caught exception:
  • Bugtags.sendException(Throwable ex);
  1. Send feedback:
  • Bugtags.sendFeedback(String msg);

Canary Channel

We are offering a bleeding edge builds on canary chanel, you can enjoy the new features in the first place!

Canry: https://en.wikipedia.org/wiki/Canary

  • Add repository in your project's build.gradle
maven {
    url 'https://dl.bintray.com/bugtags/maven'
}
  • Change your dependency in your module's build.gradle
    compile 'com.bugtags.library:bugtags-lib-canary:latest.integration'

Change log

2015.09.03 1.0.4 performance improving

2015.08.26 1.0.3 send progress, simplify dependency, improve integration

2015.08.20 1.0.2 performance improving

2015.08.15 1.0.1 bug fix

2015.08.07 1.0.0 official release

2015.08.01 0.9.0 pre-release

License

This demo is BSD-licensed.

bugtags-android's People

Contributors

kevinho avatar liaohuqiu avatar

Watchers

James Cloos avatar Ray Xie avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.