Package org.robolectric.shadows.support.v4

Class SupportFragmentController<F extends android.support.v4.app.Fragment>

java.lang.Object

org.robolectric.android.controller.ComponentController<SupportFragmentController<F>,F>

org.robolectric.shadows.support.v4.SupportFragmentController<F>

Type Parameters:

F - a class of the fragment which is under control by this class.

public class SupportFragmentController<F extends android.support.v4.app.Fragment>
extends ComponentController<SupportFragmentController<F>,F>

FragmentController provides low-level APIs to control fragment's lifecycle.

Using FragmentController directly from your tests is strongly discouraged. You have to call all the lifecycle callback methods (create, start, ...) in the same manner as the Android framework by yourself otherwise you'll see fidelity issues. Consider using androidx.fragment.app.testing.FragmentScenario instead, which provides higher-level, streamlined APIs to control the lifecycle and it works with instrumentation tests too.

Field Summary

Fields inherited from class org.robolectric.android.controller.ComponentController

attached, component, intent, myself, shadowMainLooper

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	SupportFragmentController(F fragment, Class<? extends android.support.v4.app.FragmentActivity> activityClass)
protected	SupportFragmentController(F fragment, Class<? extends android.support.v4.app.FragmentActivity> activityClass, Intent intent)

Method Summary

Modifier and Type	Method	Description
SupportFragmentController<F>	create()
SupportFragmentController<F>	create(int contentViewId, Bundle bundle)	Creates the activity with Bundle and adds the fragment to the view with ID contentViewId.
SupportFragmentController<F>	create(Bundle bundle)	Creates the activity with Bundle and adds the fragment to it.
SupportFragmentController<F>	destroy()
static <F extends android.support.v4.app.Fragment> SupportFragmentController<F>	of(F fragment)
static <F extends android.support.v4.app.Fragment> SupportFragmentController<F>	of(F fragment, Class<? extends android.support.v4.app.FragmentActivity> activityClass)
static <F extends android.support.v4.app.Fragment> SupportFragmentController<F>	of(F fragment, Class<? extends android.support.v4.app.FragmentActivity> activityClass, Intent intent)
SupportFragmentController<F>	pause()
SupportFragmentController<F>	postCreate(Bundle bundle)
SupportFragmentController<F>	resume()
SupportFragmentController<F>	saveInstanceState(Bundle outState)
static <F extends android.support.v4.app.Fragment> F	setupFragment(F fragment)	Sets up the given fragment by attaching it to an activity, calling its onCreate() through onResume() lifecycle methods, and then making it visible.
static <F extends android.support.v4.app.Fragment> F	setupFragment(F fragment, Class<? extends android.support.v4.app.FragmentActivity> fragmentActivityClass)	Sets up the given fragment by attaching it to an activity, calling its onCreate() through onResume() lifecycle methods, and then making it visible.
static <F extends android.support.v4.app.Fragment> F	setupFragment(F fragment, Class<? extends android.support.v4.app.FragmentActivity> fragmentActivityClass, int containerViewId, Bundle bundle)	Sets up the given fragment by attaching it to an activity created with the given bundle and container id, calling its onCreate() through onResume() lifecycle methods, and then making it visible.
static <F extends android.support.v4.app.Fragment> F	setupFragment(F fragment, Class<? extends android.support.v4.app.FragmentActivity> fragmentActivityClass, Bundle bundle)	Sets up the given fragment by attaching it to an activity created with the given bundle, calling its onCreate() through onResume() lifecycle methods, and then making it visible.
SupportFragmentController<F>	start()
SupportFragmentController<F>	stop()
SupportFragmentController<F>	visible()

Methods inherited from class org.robolectric.android.controller.ComponentController

get, getIntent, invokeWhilePaused

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SupportFragmentController

protected SupportFragmentController(F fragment,
                                    Class<? extends android.support.v4.app.FragmentActivity> activityClass)

SupportFragmentController

protected SupportFragmentController(F fragment,
                                    Class<? extends android.support.v4.app.FragmentActivity> activityClass,
                                    Intent intent)

Method Detail

of

public static <F extends android.support.v4.app.Fragment> SupportFragmentController<F> of(F fragment)

of

public static <F extends android.support.v4.app.Fragment> SupportFragmentController<F> of(F fragment,
                                                                                          Class<? extends android.support.v4.app.FragmentActivity> activityClass)

of

public static <F extends android.support.v4.app.Fragment> SupportFragmentController<F> of(F fragment,
                                                                                          Class<? extends android.support.v4.app.FragmentActivity> activityClass,
                                                                                          Intent intent)

setupFragment

public static <F extends android.support.v4.app.Fragment> F setupFragment(F fragment)

Sets up the given fragment by attaching it to an activity, calling its onCreate() through onResume() lifecycle methods, and then making it visible. Note that the fragment will be added to the view with ID 1.

setupFragment

public static <F extends android.support.v4.app.Fragment> F setupFragment(F fragment,
                                                                          Class<? extends android.support.v4.app.FragmentActivity> fragmentActivityClass)

Sets up the given fragment by attaching it to an activity, calling its onCreate() through onResume() lifecycle methods, and then making it visible. Note that the fragment will be added to the view with ID 1.

setupFragment

public static <F extends android.support.v4.app.Fragment> F setupFragment(F fragment,
                                                                          Class<? extends android.support.v4.app.FragmentActivity> fragmentActivityClass,
                                                                          Bundle bundle)

Sets up the given fragment by attaching it to an activity created with the given bundle, calling its onCreate() through onResume() lifecycle methods, and then making it visible. Note that the fragment will be added to the view with ID 1.

setupFragment

public static <F extends android.support.v4.app.Fragment> F setupFragment(F fragment,
                                                                          Class<? extends android.support.v4.app.FragmentActivity> fragmentActivityClass,
                                                                          int containerViewId,
                                                                          Bundle bundle)

Sets up the given fragment by attaching it to an activity created with the given bundle and container id, calling its onCreate() through onResume() lifecycle methods, and then making it visible.

create

public SupportFragmentController<F> create(int contentViewId,
                                           Bundle bundle)

Creates the activity with Bundle and adds the fragment to the view with ID contentViewId.

create

public SupportFragmentController<F> create(Bundle bundle)

Creates the activity with Bundle and adds the fragment to it. Note that the fragment will be added to the view with ID 1.

create

public SupportFragmentController<F> create()

Specified by:

create in class ComponentController<SupportFragmentController<F extends android.support.v4.app.Fragment>,F extends android.support.v4.app.Fragment>

postCreate

public SupportFragmentController<F> postCreate(Bundle bundle)

destroy

public SupportFragmentController<F> destroy()

Specified by:

destroy in class ComponentController<SupportFragmentController<F extends android.support.v4.app.Fragment>,F extends android.support.v4.app.Fragment>

start

public SupportFragmentController<F> start()

resume

public SupportFragmentController<F> resume()

pause

public SupportFragmentController<F> pause()

stop

public SupportFragmentController<F> stop()

visible

public SupportFragmentController<F> visible()

saveInstanceState

public SupportFragmentController<F> saveInstanceState(Bundle outState)