Android - Unabhängigen Fragment UI-Test-tool

Ich bin mit einem benutzerdefinierten FragmentTestRule und Espresso zu testen, meiner Fragments isoliert.

Ich habe einen dedizierten TestActivity zeigt, dass die getesteten Fragments in meiner app. In meinem Fall die Activity existiert nur in der debug Variante, weil meine instrumentation tests gegen debug.

TL;DR Verwenden Sie die awesome FragmentTestRule Bibliothek von @brais-gabin.

1. Erstellen Sie eine TestActivity in src/debug/java/your/package/TestActivity.java mit einem zufriedenen Blick, wo das getestet Fragment Hinzugefügt werden:

@VisibleForTesting
public class TestActivity extends AppCompatActivity {
    @Override
    protected void onCreate(@Nullable final Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        FrameLayout frameLayout = new FrameLayout(this);
        frameLayout.setId(R.id.container);
        setContentView(frameLayout);
    }
}

2. Erstellen Sie eine AndroidManifest.xml für die debug Variante und erklären die TestActivity. Dies ist erforderlich, um starten Sie den TestActivity bei der Prüfung. Fügen Sie dieses Manifest an die debug Variante in src/debug/AndroidManifest.xml:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application>           
        <activity android:name="your.package.TestActivity"/>
    </application>
</manifest>

3. Erstellen Sie die FragmentTestRule in der androidTest Variante bei src/androidTest/java/your/test/package/FragmentTestRule.java:

public class FragmentTestRule<F extends Fragment> extends ActivityTestRule<TestActivity> {

    private final Class<F> mFragmentClass;
    private F mFragment;

    public FragmentTestRule(final Class<F> fragmentClass) {
        super(TestActivity.class, true, false);
        mFragmentClass = fragmentClass;
    }

    @Override
    protected void afterActivityLaunched() {
        super.afterActivityLaunched();

        getActivity().runOnUiThread(() -> {
            try {
                //Instantiate and insert the fragment into the container layout
                FragmentManager manager = getActivity().getSupportFragmentManager();
                FragmentTransaction transaction = manager.beginTransaction();
                mFragment = mFragmentClass.newInstance();
                transaction.replace(R.id.container, mFragment);
                transaction.commit();
            } catch (InstantiationException | IllegalAccessException e) {
                Assert.fail(String.format("%s: Could not insert %s into TestActivity: %s",
                        getClass().getSimpleName(),
                        mFragmentClass.getSimpleName(),
                        e.getMessage()));
            }
        });
    }
    public F getFragment(){
        return mFragment;
    }
}

4. Dann können Sie testen Fragments isoliert:

public class MyFragmentTest {

    @Rule
    public FragmentTestRule<MyFragment> mFragmentTestRule = new FragmentTestRule<>(MyFragment.class);

    @Test
    public void fragment_can_be_instantiated() {

        //Launch the activity to make the fragment visible 
        mFragmentTestRule.launchActivity(null);

        //Then use Espresso to test the Fragment
        onView(withId(R.id.an_id_in_the_fragment)).check(matches(isDisplayed()));
    }
}

Wenn Sie mit der Navigation-Architektur-Komponente und verwenden Sie eine single-activity-Architektur in Ihrer app, können Sie schnell testen, jedes fragment durch Deep-linking auf das target-fragment (mit den passenden Argumenten) am Anfang der Prüfung.

Beispiel:

@Rule
@JvmField
var activityRule = ActivityTestRule(MainActivity::class.java)

protected fun launchFragment(destinationId: Int,
                             argBundle: Bundle? = null) {
    val launchFragmentIntent = buildLaunchFragmentIntent(destinationId, argBundle)
    activityRule.launchActivity(launchFragmentIntent)
}

private fun buildLaunchFragmentIntent(destinationId: Int, argBundle: Bundle?): Intent =
        NavDeepLinkBuilder(InstrumentationRegistry.getInstrumentation().targetContext)
                .setGraph(R.navigation.navigation)
                .setComponentName(MainActivity::class.java)
                .setDestination(destinationId)
                .setArguments(argBundle)
                .createTaskStackBuilder().intents[0]

destinationId werden die fragment-Ziel-id in der navigation Diagramm. Hier ist ein Beispiel für einen Aufruf, der würde getan werden, sobald Sie bereit sind, starten Sie das fragment:

launchFragment(R.id.target_fragment, targetBundle())

private fun targetBundle(): Bundle? {
    val bundle = Bundle()
    bundle.putString(ARGUMENT_ID, "Argument needed by fragment")
    return bundle
}

Dadurch starten Sie das fragment direkt. Wenn dein test funktioniert, dann beweist dies, dass Ihre app wird nicht Abstürzen, wenn das fragment ist tief verbunden. Es sorgt auch dafür, dass die app stabil sein, wenn der Prozess getötet werden, durch das system und versucht, den Wiederaufbau der stack und der relaunch der fragment.