AndroidでJUnit4を使う方法

9754 ワード
Android JUnit AndroidStudio Android テキストリンク

注意：（2014/12/23）Android SDKでJUnit4がサポートされるようになりました。このエントリーの一部は古くなっています。

Android SDKでのサポートについてはこちらをどうぞ。
続・AndroidでJUnit4を使う方法（Android SDKで正式サポートされました！）

執筆時点（2014/04/07）の環境、バージョン等

  • AndroidStudio 0.5.4
  • JUnit 4.11
  • Android-JUnit4 0.3

eclipseの場合

build.gradleの編集（JUnit4, Android-JUnit4のjar追加、TestRunnerの指定）

build.gradle に以下を追加する。

build.gradle
android {
    defaultConfig {
        testInstrumentationRunner "com.uphyca.testing.JUnit4InstrumentationTestRunner"
    }

    dependencies {
        // 行末のバージョン指定（4.+ 等）は適宜変更
        androidTestCompile ("junit:junit:4.+")
        androidTestCompile ("com.uphyca:android-junit4:+")
    }

    // LICENS.txtがどうのこうのというエラーが出たら、他のjarと競合しているので下記の記述を追加。
    // パスはAndroidStudioの「Project」ペインでjarの中身を見て適宜変更。
    // （AndroidStudioのバグらしい）
    packagingOptions {
        // for AndroidStudio's bug. duplication error of file below.
        pickFirst 'META-INF/LICENSE.txt'
        pickFirst 'LICENSE.txt'
    }

}

追加後は、Tools > Android > Sync Project with Gradle Files （またはツールバーのSync Project with Gradle Filesアイコン）を実行する。これによりMaven Centralからjarがダウンロードされる。

AndroidManifest.xmlの編集

アプリのAndroidManifest.xmlでなくテストコードのAndroidManifest.xmlなので注意。

AndroidManifest.xml
<manifest>
    <!-- 下記以外は省略しています -->
    <instrumentation
        android:name="com.uphyca.testing.JUnit4InstrumentationTestRunner"
        android:targetPackage="your.app.package" />
</manifest>

build.gradleのdefaultConfigで上書きされるのでandroid:name="com.uphyca.testing.JUnit4InstrumentationTestRunner"は書かなくても動く模様。

Testクラスを作成する

例.AndroidUtilクラスのTestクラス

AndroidUtilTest.java
import com.uphyca.testing.AndroidTestCase;  
import org.junit.Test;

import static org.junit.Assert.*;
import static org.hamcrest.CoreMatchers.*;

// テスト内容に応じて com.uphyca.testing 内の
// AndroiTestCase, ActivityTestCase 等を extends する
public class AndroidUtilTest extends AndroidTestCase {

    @Test   // @Testアノテーションでテストメソッドを指定。
    public void ほげメソッドがXXXを返すテスト() {
        // メソッド名をtestで始める必要なし。

    }
}

com.uphyca.testing内のTestCaseクラスを使用する以外は、通常のJUnit4の使用方法と同じ。

JUnit3系のTestクラスをJUnit4用に書き換える例

JUnit3.8用（抜粋）

AndroidUtilTest.java
import android.test.AndroidTestCase;


// android.test.AndroidTestCase を extends
public class AndroidUtilTest extends AndroidTestCase {

    // メソッド名をtestで始める。
    public void test_checkメソッドがIllegalArgumentExceptionを送出する() {
        try {
            AndroidUtil.check(null);
        } catch (IllegalArgumentException e) {
            assertTrue(true);
        }
    }
}

JUnit4用（抜粋）

AndroidUtilTest.java
import com.uphyca.testing.AndroidTestCase;  
import org.junit.Test;

import static org.junit.Assert.*;
import static org.hamcrest.CoreMatchers.*;

// com.uphyca.testing.AndroidTestCase を extends
public class AndroidUtilTest extends AndroidTestCase {

    @Test(expected = IllegalArgumentException.class)
    public void checkの引数がnullの時IllegalArgumentExceptionが送出される() {
        AndroidUtil.check(null);
    }
}

AndroidStudioで実行する設定

Run > Edit Configurations... （またはツールバー）の specific instrumentation runner(optional): に com.uphyca.testing.JUnit4InstrumentationTestRunner を指定する。

AndroidStudioでテスト実行

ツールバーの Run アイコン等から実行。