Catcho

All android developer must have faced force close issue while developing an application. Here is a library to catch that errors and treat it elegantly.

Catcho will create an error page kind of mechanism in your android application. So whenever your application is crashed user will not able to see that irritating pop up dialog. Instead of that app will display a predefined view to the user.

You can report any issue on issues page. Note: If you speak Arabic, you can submit issues with Arabic language and I will check them. :)

Installation

Maven

<dependency>
<groupId>net.alhazmy13.catcho</groupId>
<artifactId>library</artifactId>
<version>1.1.0</version>
</dependency>

Gradle

dependencies {
    compile 'net.alhazmy13.catcho:library:1.1.0'
}

ScreenShots

Usage

-- Though it is very simple. Copy following line of code in your each (Activity or BaseActivity) class, just after the call of super method in your overriden onCreate method.

       Catcho.Builder(this)
       .recipients("your-email@domain.com")
       .build());

Your Activity may look something like this…

public class AnyActivity extends Activity {
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

       Catcho.Builder(this)
       .recipients("your-email@domain.com")
       .build());

        setContentView(R.layout.main);

        // Your mechanism is ready now.. In this activity from anywhere 
        // if you get force close error it will be redirected to the Catcho.
    }
}

Custom Activity

If you want to change the default activity, then just pass the refrance of your activity to catcho and from your activity you can get CatchoError serializable object.

 Catcho.Builder(this)
       .activity(ACTIVITY.class)
       .build());

public class CustomActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_custom);
        CatchoError error = (CatchoError) getIntent().getSerializableExtra(Catcho.ERROR);

    }
}

Comming Soon

--

SMTP Service & Gmail SMTP Service

Theme and Resource

-- You can theme the activity by overwriting the color resources as well as you can translate it to any language

    <color name="catcho_primary">#FF9800</color>
    <color name="catcho_primary_dark">#F57C00</color>
    <color name="catcho_text_light">#FFFFFF</color>
    <color name="catcho_accent">#607D8B</color>
    <color name="catcho_text">#212121</color>

License

Copyright 2016 alhazmy

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.