SafelyAndroid

by Piasy

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

410 Stars 45 Forks Last release: Not found MIT License 12 Commits 1 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

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. :(

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.