README.md

FriendlyCrash

Friendly notify user when app crashed if app moved to background.

Download

implementation 'io.github.tubb:friendlycrash:1.0.3'

Usage

Add below code in your custom Application. That's all done!

FriendlyCrash.build(this).enable()

If app crashed when app moved to background, we just kill app process, so Force Close Dialog will not showing.

killProcess(myPid())

Custom

• We add callback for app lifecycle, like moved to foreground and moved to background.
• Also you can get the notify when app crashed, then do something.
• And enable or disable friendly notify when app on foreground.

class App: Application() {

    companion object {
        private const val TAG = "FriendlyCrash"
    }

    override fun onCreate() {
        super.onCreate()
        val processName = getProcessName(this, android.os.Process.myPid())
        processName?.let { name ->
            if (name == packageName) { // main process
                FriendlyCrash.build(this, ::appMovedTo)
                        .friendlyOnForeground(false)
                        .enable(::appCrashed)
            } else { // background process
                FriendlyCrash.build(this)
                        .friendlyOnForeground(true)
                        .enable()
            }
        }
    }

    private fun appCrashed(onForeground: Boolean, thread: Thread, ex: Throwable) {
        val msg = if (onForeground) {
            "when app on foreground"
        } else {
            "when app on background"
        }
        Log.e(TAG, "App crashed $msg", ex)
    }

    private fun appMovedTo(foreground: Boolean) {
        if (foreground) {
            Toast.makeText(this, "App moved to foreground", Toast.LENGTH_LONG).show()
        } else {
            Toast.makeText(this, "App moved to background", Toast.LENGTH_LONG).show()
        }
    }

    private fun getProcessName(cxt: Context, pid: Int): String? {
        val am = cxt.getSystemService(Context.ACTIVITY_SERVICE) as ActivityManager
        val runningApps = am.runningAppProcesses ?: return null
        for (processInfo in runningApps) {
            if (processInfo.pid == pid) {
                return processInfo.processName
            }
        }
        return null
    }
}

For more details, please see the DEMO project.

Dependencies

implementation("android.arch.lifecycle:extensions:1.1.1") {
    exclude group: 'com.android.support', module: 'support-annotations'
    exclude group: 'com.android.support', module: 'support-compat'
    exclude group: 'com.android.support', module: 'support-fragment'
    exclude group: 'com.android.support', module: 'support-core-ui'
    exclude group: 'com.android.support', module: 'support-core-utils'
}
annotationProcessor "android.arch.lifecycle:compiler:1.1.1"

License

Copyright 2018 TUBB

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.