com.android21buttons.fragmenttestrule

Class FragmentTestRule<A extends FragmentActivity,F extends Fragment>

java.lang.Object

<any>

com.android21buttons.fragmenttestrule.FragmentTestRule<A,F>

Type Parameters:

A - The container activity for the fragment under test

F - The fragment under test

public class FragmentTestRule<A extends FragmentActivity,F extends Fragment>
extends <any>

This rule provides functional testing of a single fragment.

Idea extracted from: http://stackoverflow.com/a/38393087/842697

Constructor Summary

Constructors

Constructor and Description
FragmentTestRule(java.lang.Class<A> activityClass, java.lang.Class<F> fragmentClass) Similar to FragmentTestRule(Class, Class, boolean) but with "touch mode" disabled.
FragmentTestRule(java.lang.Class<A> activityClass, java.lang.Class<F> fragmentClass, boolean initialTouchMode) Similar to FragmentTestRule(Class, Class, boolean, boolean) but defaults to launch the activity under test once per Test method.
FragmentTestRule(java.lang.Class<A> activityClass, java.lang.Class<F> fragmentClass, boolean initialTouchMode, boolean launchActivity) Similar to FragmentTestRule(Class, Class, boolean, boolean, boolean) but defaults to launch the fragment under test once per Test method.
FragmentTestRule(java.lang.Class<A> activityClass, java.lang.Class<F> fragmentClass, boolean initialTouchMode, boolean launchActivity, boolean launchFragment) Creates an FragmentTestRule for the Fragment under test.

Method Summary

Modifier and Type	Method and Description
protected void	afterActivityLaunched()
static <F extends Fragment> FragmentTestRule<?,F>	create(java.lang.Class<F> fragmentClass) Creates an FragmentTestRule for the Fragment under test.
static <F extends Fragment> FragmentTestRule<?,F>	create(java.lang.Class<F> fragmentClass, boolean initialTouchMode) Creates an FragmentTestRule for the Fragment under test.
static <F extends Fragment> FragmentTestRule<?,F>	create(java.lang.Class<F> fragmentClass, boolean initialTouchMode, boolean launchFragment) Creates an FragmentTestRule for the Fragment under test.
protected F	createFragment() Override this method to set up the desired Fragment.
F	getFragment()
void	launchFragment(F fragment) Launches the Fragment under test.

Methods inherited from class java.lang.Object

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

Constructor Detail

FragmentTestRule

public FragmentTestRule(java.lang.Class<A> activityClass,
                        java.lang.Class<F> fragmentClass)

Similar to FragmentTestRule(Class, Class, boolean) but with "touch mode" disabled.

Parameters:

activityClass - The container activity for the fragment under test. This must be a class in the instrumentation targetPackage specified in the AndroidManifest.xml

fragmentClass - The fragment under test

See Also:

FragmentTestRule(Class, Class, boolean)

FragmentTestRule

public FragmentTestRule(java.lang.Class<A> activityClass,
                        java.lang.Class<F> fragmentClass,
                        boolean initialTouchMode)

Similar to FragmentTestRule(Class, Class, boolean, boolean) but defaults to launch the activity under test once per Test method. It is launched before the first Before method, and terminated after the last After method.

Parameters:

activityClass - The container activity for the fragment under test. This must be a class in the instrumentation targetPackage specified in the AndroidManifest.xml

fragmentClass - The fragment under test

initialTouchMode - true if the Activity should be placed into "touch mode" when started

See Also:

FragmentTestRule(Class, Class, boolean, boolean)

FragmentTestRule

public FragmentTestRule(java.lang.Class<A> activityClass,
                        java.lang.Class<F> fragmentClass,
                        boolean initialTouchMode,
                        boolean launchActivity)

Similar to FragmentTestRule(Class, Class, boolean, boolean, boolean) but defaults to launch the fragment under test once per Test method. It is launched before the first Before method, and terminated after the last After method.

Parameters:

activityClass - The container activity for the fragment under test. This must be a class in the instrumentation targetPackage specified in the AndroidManifest.xml

fragmentClass - The fragment under test

initialTouchMode - true if the Activity should be placed into "touch mode" when started

launchActivity - true if the Activity should be launched once per Test method. It will be launched before the first Before method, and terminated after the last After method.

See Also:

FragmentTestRule(Class, Class, boolean, boolean, boolean)

FragmentTestRule

public FragmentTestRule(java.lang.Class<A> activityClass,
                        java.lang.Class<F> fragmentClass,
                        boolean initialTouchMode,
                        boolean launchActivity,
                        boolean launchFragment)

Creates an FragmentTestRule for the Fragment under test.

Parameters:

activityClass - The container activity for the fragment under test. This must be a class in the instrumentation targetPackage specified in the AndroidManifest.xml

fragmentClass - The fragment under test

initialTouchMode - true if the Activity should be placed into "touch mode" when started

launchActivity - true if the Activity should be launched once per Test method. It will be launched before the first Before method, and terminated after the last After method.

launchFragment - true if the Fragment should be launched once per Test method. It will be launched before the first Before method, and terminated after the last After method.

Method Detail

create

public static <F extends Fragment> FragmentTestRule<?,F> create(java.lang.Class<F> fragmentClass)

Creates an FragmentTestRule for the Fragment under test.

This factory uses a standard Activity to launch the fragment. If you need a special Activity use the constructors.

Parameters:

fragmentClass - The fragment under test

Returns:

the fragmentTestRule

See Also:

FragmentTestRule(Class, Class)

create

public static <F extends Fragment> FragmentTestRule<?,F> create(java.lang.Class<F> fragmentClass,
                                                                boolean initialTouchMode)

Creates an FragmentTestRule for the Fragment under test.

This factory uses a standard Activity to launch the fragment. If you need a special Activity use the constructors.

Parameters:

fragmentClass - The fragment under test

initialTouchMode - true if the Activity should be placed into "touch mode" when started

Returns:

the fragmentTestRule

See Also:

FragmentTestRule(Class, Class, boolean)

create

public static <F extends Fragment> FragmentTestRule<?,F> create(java.lang.Class<F> fragmentClass,
                                                                boolean initialTouchMode,
                                                                boolean launchFragment)

Creates an FragmentTestRule for the Fragment under test.

This factory uses a standard Activity to launch the fragment. If you need a special Activity use the constructors.

Parameters:

fragmentClass - The fragment under test

initialTouchMode - true if the Activity should be placed into "touch mode" when started

launchFragment - true if the Fragment should be launched once per Test method. It will be launched before the first Before method, and terminated after the last After method.

Returns:

the fragmentTestRule

See Also:

FragmentTestRule(Class, Class, boolean, boolean, boolean)

afterActivityLaunched

protected void afterActivityLaunched()

launchFragment

public void launchFragment(F fragment)

Launches the Fragment under test.

Don't call this method directly, unless you explicitly requested not to lazily launch the Fragment manually using the launchFragment flag in FragmentTestRule(Class, Class, boolean, boolean, boolean).

Usage:

    @Test
    public void customIntentToStartActivity() {
        Fragment fragment = MyFragment.newInstance();
        fragmentRule.launchFragment(fragment);
    }
 

Parameters:

fragment - The Fragment under test. If fragment is null, the fragment returned by createFragment() is used.

See Also:

createFragment()

createFragment

protected F createFragment()

Override this method to set up the desired Fragment.

The default Fragment (if this method returns null or is not overwritten) is: fragmentClass.newInstance()

Returns:

the fragment to test.

getFragment

public F getFragment()

Returns:

The fragment under test.