Skip to content
Build safely Android app, no more Activity not found, Activity state loss and NPE during fragment transaction!
Java
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
art Custom lint rule Apr 17, 2016
example
gradle/wrapper
safelyandroid-detector
safelyandroid-lint v1.2.4 Oct 27, 2016
safelyandroid
.gitignore
CHANGELOG.md
LICENSE
README.md update readme Jul 17, 2016
build.gradle v1.2.4 Oct 27, 2016
gradlew v1.0.0 Apr 3, 2016
gradlew.bat
settings.gradle

README.md

SafelyAndroid

Download

Build safely Android app, no more Activity not found, Activity state loss and NPE during fragment transaction!

Pause-safe fragment transaction

safely-android-demo.gif

Dependency

Add to gradle dependency of your module build.gradle:

repositories {
    jcenter()
}

dependencies {
    compile 'com.github.piasy:safelyandroid:1.2.0'
}

Usage

Start activity safely

Start activity from context, fragment and support v4 fragment, and start activity for result from activity, fragment and support v4 fragment, with or without the optional bundle options. StartActivityDelegate will launch the intent only when its component exist, otherwise, it will return false. Never get activity not found error again!

StartActivityDelegate.startActivitySafely(fragment, intent)

StartActivityDelegate.startActivitySafely(fragment, intent, options)

StartActivityDelegate.startActivityForResultSafely(fragment, intent, requestCode)

StartActivityDelegate.startActivityForResultSafely(fragment, intent, requestCode, options)

StartActivityDelegate.startActivitySafely(context, intent)

StartActivityDelegate.startActivitySafely(context, intent, options)

StartActivityDelegate.startActivityForResultSafely(activity, intent, requestCode)

StartActivityDelegate.startActivityForResultSafely(activity, intent, requestCode, options)

Dismiss dialog fragment safely

Dismiss a dialog fragment or support v4 dialog fragment safely. dialogFragmentDismissDelegate will dismiss this dialog fragment only when it's resumed, otherwise, it will return true and dismiss it when dialogFragmentDismissDelegate.onResumed is called. Never get activity state loss error again!

dialogFragmentDismissDelegate.safeDismiss(dialogFragment)

dialogFragmentDismissDelegate.onResumed(dialogFragment)

supportDialogFragmentDismissDelegate.safeDismiss(dialogFragment)

supportDialogFragmentDismissDelegate.onResumed(dialogFragment)

Do fragment transaction safely

Do fragment or support v4 fragment transaction safely. Components (activity, fragment or support v4 fragment) should implement the TransactionCommitter interface, and the fragment transaction will only be committed when the components is resumed, otherwise it will return true and the transaction will be committed when onResumed is called. Never get activity state loss error again!

fragmentTransactionDelegate.safeCommit(transactionCommitter, transaction)

fragmentTransactionDelegate.onResumed()

supportFragmentTransactionDelegate.safeCommit(transactionCommitter, transaction)

supportFragmentTransactionDelegate.onResumed()

Build fragment transaction safely

See FragmentTransactionBuilder and SupportFragmentTransactionBuilder.

Just extends the safely base components

We provide the default safely components, including SafelyActivity, SafelyDialogFragment, SafelyFragment, SafelyAppCompatActivity, SafelySupportDialogFragment, and SafelySupportFragment, which encapsulate safely behaviours above, you can just extends them, and dismiss dialog fragment with safeDismiss(), do fragment transaction with safeCommit(transaction), then you can build safely Android app now!

Create your own base components

If your base components must extends other base components, you can make your base component implement the TransactionCommitter interface, and mimic the behaviours of safely base components provided by us, then you can also build safely Android app now!

Lint check

When using safeCommit, lint will warn "Missing commit() calls", you could disable it.

We provide a custom lint rule, to check the "unsafe dismiss() call" of dialog fragment.

safely-android-demo.gif

Just adding this dependency in your module's build.gradle:

repositories {
    jcenter()
}

dependencies {
    compile 'com.github.piasy:safelyandroid-lint:1.2.0'
}

The suppress of "Missing commit() calls" and "unsafe commit() call" lint rules may not be added in the long future. :(

You can’t perform that action at this time.