UCE-Handler - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #ai #typescript #llm #golang #nodejs #macos #kubernetes #vue #pytorch #security #mcp #openai

UCE-Handler

(★ 131)

Convenient Uncaught-Exception Handler Library For Testers and Developers. Copy, Share, Email, Save crash logs easily.

파일 탐색기

최종 버전 다운로드 (.zip)

- - build_file_checksums.ser
- encodings.xml
- misc.xml
- modules.xml
- runConfigurations.xml
- vcs.xml
- uce_feature.png
- uce_handler_example.gif
- uce_handler_feature.png
- .gitignore
- build.gradle
- proguard-rules.pro
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- .gitignore
- build.gradle
- proguard-rules.pro
- .gitignore
- build.gradle
- proguard-rules.pro
.gitignore
build.gradle
gradlew
gradlew.bat
LICENSE.md
README.md
settings.gradle
UCE_Handler_Example.apk

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/RohitSurwase/UCE-Handler

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd UCE-Handler

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

./gradlew build

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![](https://jitpack.io/v/RohitSurwase/UCE-Handler.svg)](https://jitpack.io/#RohitSurwase/UCE-Handler) [![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active) [![GitHub stars](https://img.shields.io/github/stars/RohitSurwase/UCE-Handler.svg?style=social&label=Star)](https://GitHub.com/RohitSurwase/UCE-Handler/stargazers) [![](https://jitpack.io/v/RohitSurwase/UCE-Handler/month.svg)](https://jitpack.io/#RohitSurwase/UCE-Handler)

# UCE Handler
### Android library which lets you take control of Android App's uncaught exceptions. View, Copy, Share, Save and Email exceptions details including other useful info easily.
Tracking down all exceptions is the crucial part of the development. We could just expect that we have handled all exceptions. But whatever we do, we come across it with the so-called pop-up saying “Unfortunately, App has stopped”, that is why it is called uncaught-exceptions.

Why should you use this library? Read the answer - [Handling Uncaught-Exceptions in Android](https://android.jlelse.eu/handling-uncaught-exceptions-in-android-d818ffb20181)

![Example Animation](https://github.com/RohitSurwase/UCE-Handler/raw/master/art/uce_feature.png)         ![Example Animation](https://github.com/RohitSurwase/UCE-Handler/raw/master/art/uce_handler_example.gif)

## Features
* Android App lifecycle aware.
* Catches all uncaught exceptions gracefully.
* Displays separate screen with multiple options whenever an App crashes.
* View, Copy, Share, and Save crash logs easily.
* Email crash log along with the .txt file with multiple developers/receipients.
* Completely close the crashed/unstable Application.

## Logged Information
* Device/mobile info.
* Application info.
* Crash log.
* Activity track. //optional
* All log files are placed in a separate folder.

### Each Log file is named upon App's name so you can identify and distinguish files easily if you have added this library in multiple projects/applications.

## Example
Download the example app [here](https://github.com/RohitSurwase/UCE-Handler/raw/master/UCE_Handler_Example.apk)

## Getting Started
Add this library to your Android project and initialize it in your Application class. Additionaly you can add developer's email addresses who will get the email of crash log along with the .txt file attached.

# Setup
In your Project's build.gradle file:

allprojects {
		repositories {
			...
			maven { url 'https://jitpack.io' }
		}
	}

In your Application's or Module's build.gradle file:

dependencies {
	        implementation 'com.github.RohitSurwase.UCE-Handler:uce_handler:1.4'
	}

In your Application class:
* Initialize library using builder pattern.
    
		public class MyApplication extends Application {
		@Override public void onCreate() { 
			...
			// Initialize UCE_Handler Library
			new UCEHandler.Builder(this).build();
		} }

##### Kotlin way of initialization

UCEHandler.Builder(applicationContext).build()
	
##### For those of you who are still using Eclipse + ADT, you need to add UCEDefaultActivity manually in your App's manifest. (As suggested by [Caceresenzo](https://github.com/RohitSurwase/UCE-Handler/issues/2#issuecomment-385262850))

<application>
	    ...
	    <activity
		android:name="com.rohitss.uceh.UCEDefaultActivity"
		android:process=":error_activity"/>
	</application>

### Optional Parameters
##### .setUCEHEnabled(true/false)
//  default 'true'
 =>  Enable/Disable UCE_Handler.
##### .setTrackActivitiesEnabled(true/false)
//  default 'false'
 =>  Choose whether you want to track the flow of activities the user/tester has taken or not.
##### .setBackgroundModeEnabled(true/false)
//  default 'true'
 =>  Choose if you want to catch exceptions while app is in background.
##### .addCommaSeparatedEmailAddresses("abc@gmail.com, pqr@gmail.com,...)
// default - empty
 =>  Add comma separated email addresses who will receive the crash logs.

#### 'Save Error Log' will work only if your app already has storage permission as library does not ask for it.

## Authors & Contributers

* [**Rohit Surwase**](https://github.com/RohitSurwase) - *Initial work* - [API-Calling-Flow](https://github.com/RohitSurwase/API-Calling-Flow) , [AndroidDesignPatterns](https://github.com/RohitSurwase/AndroidDesignPatterns) , [News App Using Kotlin, MVP](https://github.com/RohitSurwase/News-Kotlin-MVP) ,  [Linkaive - Android App on Play Store](https://play.google.com/store/apps/details?id=com.rohitss.saveme)

## License
Copyright © 2018 - 2019 Rohit Sahebrao Surwase.
This project is licensed under the Apache License, Version 2.0 - see the [LICENSE.md](LICENSE.md) file for details