coolstar1204 / statedfragment

StatedFragment

The library is documented in http://inthecheesefactory.com/blog/best-approach-to-keep-android-fragment-state/en

Version

0.9.3

Installation

To use this library in your android project, just simply add the following dependency into your build.gradle

StatedFragment for Android Support Library v4's Fragment

dependencies {
    compile 'com.inthecheesefactory.thecheeselibrary:stated-fragment-support-v4:0.9.3'
}

StatedFragment for Android's Fragment

dependencies {
    compile 'com.inthecheesefactory.thecheeselibrary:stated-fragment:0.9.3'
}

Usage

State Saving/Restoring

Extends StatedFragment and save state in onSaveState(Bundle outState) and restore state in onRestoreState(Bundle savedInstanceState). You are also able to override onFirstTimeLaunched(), if you want to do something as the first time the fragment is launched (is not called again after that).

public class MainFragment extends StatedFragment {

    ...
    
    /**
     * Save Fragment's State here
     */
    @Override
    protected void onSaveState(Bundle outState) {
        super.onSaveState(outState);
        // For example:
        //outState.putString("text", tvSample.getText().toString());
    }

    /**
     * Restore Fragment's State here
     */
    @Override
    protected void onRestoreState(Bundle savedInstanceState) {
        super.onRestoreState(savedInstanceState);
        // For example:
        //tvSample.setText(savedInstanceState.getString("text"));
    }
    
    ...

}

onActivityResult for Nested Fragment

In v0.9.2 onward, StatedFragment comes up with a feature that can fix onActivityResult problem which couldn't be called on nested fragment. To use it, you have to override onActivityResult on your Activity and add a line of code:

    @Override
    protected void onActivityResult(final int requestCode, final int resultCode, final Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        ActivityResultBus.getInstance().postQueue(new ActivityResultEvent(requestCode, resultCode, data));
    }

And in your fragment, you need to call getActivity().startActivityForResult(...) but not startActivityForResult(...) since we need to let all the result sent to Activity.

Lastly, override onActivityResult in your fragment in the standard way.

    @Override
    public void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        // Add your code here
        Toast.makeText(getActivity(), "Fragment Got it: " + requestCode + ", " + resultCode, Toast.LENGTH_SHORT).show();
    }

Change Logs

v0.9.3

Add support to <fragment> tag.

v0.9.2

Add onActivityResult feature for nested fragment.

v0.9.1

Change Android Support Library v4 dependency's version to 21.+ to avoid future dependency conflict.

v0.9.0

Seperates library into two versions:

• stated-fragment-support-v4: Fragment is inherited from android.support.v4.app.fragment
• stated-fragment: Fragment is inherited from android.app.fragment

License

Apache 2.0