{"id":13989481,"url":"https://github.com/bugtags/Bugtags-Android","last_synced_at":"2025-07-22T11:30:29.117Z","repository":{"id":35836528,"uuid":"40119743","full_name":"bugtags/Bugtags-Android","owner":"bugtags","description":"Simple and effective bug \u0026 crash reporting tool for Android apps","archived":false,"fork":false,"pushed_at":"2017-12-26T04:35:12.000Z","size":3492,"stargazers_count":344,"open_issues_count":3,"forks_count":55,"subscribers_count":19,"default_branch":"master","last_synced_at":"2024-11-29T08:39:10.956Z","etag":null,"topics":["crash-reporting","issue-tracker"],"latest_commit_sha":null,"homepage":"http://bugtags.com/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bugtags.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-03T10:49:05.000Z","updated_at":"2024-07-25T15:09:59.000Z","dependencies_parsed_at":"2022-08-24T13:38:10.168Z","dependency_job_id":null,"html_url":"https://github.com/bugtags/Bugtags-Android","commit_stats":null,"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"purl":"pkg:github/bugtags/Bugtags-Android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bugtags%2FBugtags-Android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bugtags%2FBugtags-Android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bugtags%2FBugtags-Android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bugtags%2FBugtags-Android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bugtags","download_url":"https://codeload.github.com/bugtags/Bugtags-Android/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bugtags%2FBugtags-Android/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266483408,"owners_count":23936334,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crash-reporting","issue-tracker"],"created_at":"2024-08-09T13:01:41.490Z","updated_at":"2025-07-22T11:30:28.449Z","avatar_url":"https://github.com/bugtags.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"[![Android Gems](http://www.android-gems.com/badge/bugtags/Bugtags-Android.svg?branch=master)](http://www.android-gems.com/lib/bugtags/Bugtags-Android)\n\nBugtags Android SDK\n===================\n[ ![Download](https://api.bintray.com/packages/bugtags/maven/bugtags-lib/images/download.svg) ](https://bintray.com/bugtags/maven/bugtags-lib/_latestVersion)\n###中文文档请移步 [README_CN](README_CN.md)\n###QQ tribe for help: 210286347\n\n[Bugtags] for Android, reports bugs and their diagnosis information in one step, captures crashes automatically. Improve your apps anywhere, anytime.\n\n[Create a free account](http://bugtags.com/) and invite your team to improve your apps.\n\nDownload demo app here: [DEMO.apk](screenshot/demo.apk)\n\n\u003e If you are using Eclipse for Android development, visit [SDK for Eclipse] to download SDK.\n\n\u003e Bugtags also support [iOS](https://github.com/bugtags/Bugtags-iOS) !\n\n\u003e We are going to support English language in September.\n\n# Features\n1. Take snapshot of bug, add tags to describe the bug.\n2. Automatically collect device and app context data following reporting bugs.\n3. Automatically capture crashes.\n4. Bug lifecycle management.\n\n# Usage\n![How to use](screenshot/usage.gif)\n\n# Install using gradle\n\n## Step 1:\n* Setup `buildscript dependencies`  in Top-level build.gradle file:\n\n```groovy\nbuildscript {\n    repositories {\n        jcenter()\n        mavenCentral()\n    }\n    dependencies {\n        classpath 'com.android.tools.build:gradle:1.2.3'\n\n        classpath 'com.bugtags.library:bugtags-gradle:latest.integration'\n    }\n}\nallprojects {\n    repositories {\n        jcenter()\n        mavenCentral()\n    }\n}\n```\n\n* Add `plugin and dependency` in your module's build.gradle file：\n\n```groovy\n    android {\n        compileSdkVersion ...\n\n        defaultConfig {\n            ndk {\n                // setup so arch\n                abiFilters 'armeabi'// 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64', 'mips', 'mips64'\n            }\n        }\n    }\n\n    //applu Bugtags plugin\n    apply plugin: 'com.bugtags.library.plugin'\n\n    //Bugtags config\n    bugtags {\n        //upload mapping file\n        appKey \"APP_KEY\"  \n        appSecret \"APP_SECRET\"   \n        mappingUploadEnabled true\n\n        trackingNetworkEnabled true\n    }\n\n    dependencies {\n        ...\n        compile 'com.bugtags.library:bugtags-lib:latest.integration'\n    }\n```\n\n## Step 2:\n* Add three callbacks in your base Activity class:\n\n```\n    package your.package.name;\n    import android.app.Activity;\n    import android.os.Bundle;\n    import android.view.MotionEvent;\n    import com.bugtags.library.Bugtags;\n\n    public class BaseActivity extends Activity{\n        @Override\n        protected void onResume() {\n            super.onResume();\n\n            Bugtags.onResume(this);\n        }\n\n        @Override\n        protected void onPause() {\n            super.onPause();\n\n            Bugtags.onPause(this);\n        }\n\n        @Override\n        public boolean dispatchTouchEvent(MotionEvent event) {\n            Bugtags.onDispatchTouchEvent(this, event);\n\n            return super.dispatchTouchEvent(event);\n        }\n    }\n    ```\n\n## Step 3:\n* Create subclass of Application，initialize Bugtags in onCreate() method:\n\n```java\npublic class MyApplication extends Application {\n\n    @Override\n    public void onCreate() {\n        super.onCreate();\n        //initialize here\n        Bugtags.start(\"YOUR APPKEY\", this, Bugtags.BTGInvocationEventBubble);\n    }\n}\n```\n\n* Modify AndroidManifest.xml，use MyApplication:\n\n```xml\n\u003capplication\n    android:name=\".MyApplication\"\n    android:label=\"@string/app_name\"\n    android:theme=\"@style/AppTheme\" \u003e\n    ....\n\u003c/application\u003e\n```\n## Step 4：ProGuard\n\n```\n    # ProGuard configurations for Bugtags\n      -keepattributes LineNumberTable,SourceFile\n\n      -keep class com.bugtags.library.** {*;}\n      -dontwarn com.bugtags.library.**\n      -keep class io.bugtags.** {*;}\n      -dontwarn io.bugtags.**\n      -dontwarn org.apache.http.**\n      -dontwarn android.net.http.AndroidHttpClient\n\n    # End Bugtags\n```\n\n  For more information about Android Studio and gradle, please visit: [Android Developer Site].\n\n## There you go!\n\n# Explore\n1. Invoke event:\n  * BTGInvocationEventBubble: Show floating circle in app.\n  * BTGInvocationEventShake: Show floating circle by shake.\n  * BTGInvocationEventNone: Show no floating circle, capture crash bug only(if allow), this is recommended to be used in release build.\n2. Send caught exception:\n  * Bugtags.sendException(Throwable ex);\n3. Send feedback:\n  * Bugtags.sendFeedback(String msg);\n\n# Canary Channel\nWe are offering a bleeding edge builds on canary chanel, you can enjoy the new features in the first place!\n\n\u003e Canry: https://en.wikipedia.org/wiki/Canary\n\n* Add repository in your project's build.gradle\n\n```groovy\nbuildscript {\n    repositories {\n        mavenCentral()\n        jcenter()\n        maven{\n            url \"https://dl.bintray.com/bugtags/maven\"//added\n        }\n    }\n    dependencies {\n        classpath 'com.android.tools.build:gradle:1.3.0'\n        classpath 'com.bugtags.library-canary:bugtags-gradle:latest.integration'//modify\n    }\n}\nallprojects {\n    repositories {\n        jcenter()\n        mavenCentral()\n        maven{\n            url \"https://dl.bintray.com/bugtags/maven\"//added\n        }\n    }\n}\n  ```\n\n* Change your dependency in your module's build.gradle\n\n```groovy\napply plugin: 'com.bugtags.library.plugin'\n\ndependencies {\n      compile 'com.bugtags.library-canary:bugtags-lib:latest.integration'//modify\n}\n```\n\n# Change log\n\nsee in [releases](https://github.com/bugtags/Bugtags-Android/releases)\n\n# License\nThis demo is [BSD-licensed](LICENSE).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbugtags%2FBugtags-Android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbugtags%2FBugtags-Android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbugtags%2FBugtags-Android/lists"}