Skip to content
Tools for Android testing with JUnit4.
Branch: master
Clone or download
esmasui Merge pull request #10 from bstau/master
Upgrade Apache Commons Collections to v3.2.2
Latest commit 173b050 Mar 9, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
android-junit3-dbunit-test Upgrade Apache Commons Collections to v3.2.2 Mar 8, 2016
android-junit3-dbunit
android-junit3-extension-support-v4-test [maven-release-plugin] prepare for next development iteration Jul 6, 2014
android-junit3-extension-support-v4
android-junit3-extension [maven-release-plugin] prepare for next development iteration Jul 6, 2014
android-junit4-adapter Remove unused files Sep 30, 2012
android-junit4-extension-support-v4 [maven-release-plugin] prepare for next development iteration Jul 6, 2014
android-junit4-extension [maven-release-plugin] prepare for next development iteration Jul 6, 2014
android-junit4-robolectric-test [maven-release-plugin] prepare for next development iteration Jan 25, 2013
android-junit4-robolectric [maven-release-plugin] prepare for next development iteration Jul 6, 2014
android-junit4-test-mockito
android-junit4-test-robotium Add missing libraries for robotium test Sep 15, 2012
android-junit4-test [maven-release-plugin] prepare for next development iteration Jul 6, 2014
android-junit4 [maven-release-plugin] prepare for next development iteration Jul 6, 2014
.gitignore remove unnecessary file Jul 6, 2014
LICENSE-2.0.txt
README.md Update README.md Dec 22, 2014
pom.xml [maven-release-plugin] prepare for next development iteration Jul 6, 2014

README.md

DEPRECATED

This project is now deprecated. AndroidJUnitRunner is now available.

AndroidJUnit4

AndroidJUnit4 is a framework to running JUnit4 tests on Android devices with Eclipse/ADT or command line tools.

Supported API versions;

API level 3 (Cupcake) or later.

Build instruction;

1. Install Maven (http://maven.apache.org/)
2. Install android-sdks into local m2 repository using https://github.com/mosabua/maven-android-sdk-deployer    
3. Clone the repository

    $ git clone https://github.com/esmasui/AndroidJUnit4.git AndroidJUnit4-readonly

4. Build libraries
    
    $ cd AndroidJUnit4-readonly
    $ mvn eclipse:eclipse install

5. Import AndroidJunit4-readonly/android-junit4 as a Android library project or jar file to your Android test project.

You can also depend on the .jar through Maven:

<dependency>
	<groupId>com.uphyca</groupId>
	<artifactId>android-junit4</artifactId>
	<version>(insert latest version)</version>
</dependency>

If you need to run tests with maven-android-plugin, you need to set testSkip parameter to false in your configuration

<plugin>
	<groupId>com.jayway.maven.plugins.android.generation2</groupId>
	<artifactId>android-maven-plugin</artifactId>
	<configuration>
		...
		<test>
			<skip>false</skip>
		</test>
	</configuration>

</plugin>

or set android.test.skip environment to false

$ mvn clean install -Dandroid.test.skip=false

Continuous integration; http://jenkins.android-tec.org/job/JUnit4InstrumentationTestRunnerMaven/

Usage;

1. Set com.uphyca.testing.JUnit4InstrumentationTestRunner into instrumentation in your AndroidManifest.xml

    <instrumentation
        android:name="com.uphyca.testing.JUnit4InstrumentationTestRunner"
        android:targetPackage="your.test.package" />

2. Write your test classes that extends base test classes for Android dependent tests.

    The base test classses located in com.uphyca.testing package as same name of original android.test package's classes.
    For example; JUnit4 version of android.test.ActivityUnitTestCase is com.uphyca.testing.ActivityUnitTestCase.

Supported test classes are
    AndroidTestCase
    InstrumentationTestCase
    ActivityInstrumentationTestCase<T extends Activity>
    ActivityInstrumentationTestCase2<T extends Activity>
    ActivityTestCase, ActivityUnitTestCase<T extends Activity>
    ApplicationTestCase<T extends Application>
    LoaderTestCase
    ProviderTestCase<T extends ContentProvider>
    ProviderTestCase2<T extends ContentProvider>
    ServiceTestCase<T extends Service>
    SingleLaunchActivityTestCase<T extends Activity>
    SyncBaseInstrumentation

Example;

package com.uphyca.testing.test;

import static org.hamcrest.CoreMatchers.equalTo;
import static org.junit.Assert.assertNotNull;
import static org.junit.Assert.assertThat;

import org.junit.Before;
import org.junit.Test;

import android.app.Activity;
import android.content.Intent;
import android.os.Bundle;
import android.widget.TextView;

import com.uphyca.testing.ActivityUnitTestCase;
import com.uphyca.testing.AndroidJUnit4TestAdapter;
import com.uphyca.testing.test.HelloActivity.MyActivity;

public class HelloActivity extends ActivityUnitTestCase<MyActivity> {

    /**
     * For Eclipse with ADT
     */
    public static junit.framework.Test suite() {
        // Should use AndroidJUnit4TestAdapter for to running AndroidDependent
        // TestCases.
        return new AndroidJUnit4TestAdapter(HelloActivity.class);
    }

    public static class MyActivity extends Activity {
        @Override
        protected void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            TextView view = new TextView(this);
            view.setText("Hello, activity.");
            view.setId(android.R.id.text1);
            setContentView(view);
        }
    }

    private Intent startIntent;

    public HelloActivity() {
        super(MyActivity.class);
    }

    @Override
    @Before
    public void setUp() throws Exception {
        super.setUp();
        startIntent = new Intent(Intent.ACTION_MAIN);
    }

    @Test
    public void assertPreconditions() {
        startActivity(startIntent, null, null);
        assertNotNull(getActivity());
    }

    @Test
    public void sayHello() {
        startActivity(startIntent, null, null);
        assertThat(((TextView) getActivity().findViewById(android.R.id.text1)).getText()
                                                                      .toString(), equalTo("Hello, activity."));
    }

}

License;

Copyright (C) 2012 uPhyca Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
You can’t perform that action at this time.