Android Activity のテスト

| Android

http://developer.android.com/guide/topics/testing/activity_testing.html

概要

Activity のテストはかなり Android instrumentation framework に依存する
Activity は他のコンポーネントとは異なり、コールバックメソッドに基づいた、複雑なライフサイクルを持っているため
これらは、instrumentation 以外から直接呼び出すことができない
プログラムからイベントをユーザーインターフェースへ送る唯一の方法は、instrumentation を通して

Activity テスト API

Activity テスト API の基底クラスは、InstrumentationTestCase
テストケース派生クラスへActivityのための操作方法を提供する

InstrumentationTestCaseが提供する機能

ライフサイクル制御

テストケースクラスが提供するメソッドから、Activity を開始でき、一時停止でき、破棄できる

依存性の注入

Instrumentaion は、Contexts や Application のようなシステムオブジェクトのモックを作成することができ、テストで利用できる
れこは、テスト環境の制御を助け、製品のシステムから隔離する。
カスタムインテントを用意し、それによりActivityを開始することもできる

ユーザーインターフェースインタラクション

Instrumentaion をキーストロークおよびタッチイベントを直接 Activity のユーザーインターフェースに送るために利用できる

JUnit

Activity テストクラスは、TextCase と Assert クラスを継承した、JUnit フレームワークも提供している

2つの主のテスト用サブクラス

ActivityInstrumentationTestCase2 |http://developer.android.com/reference/android/test/ActivityInstrumentationTestCase2.html および、[ActivityUnitTestCase]
Activity を通常ではないモードで起動した場合には、SingleLaunchActivityTestCase を利用する

ActivityInstrumentationTestCase2

ActivityInstrumentationTestCase2 は、アプリケーションの一つ以上のActivity の機能を通常のシステム基盤を用いて、テストするためにデザインされている
通常のシステムコンテキストを利用してアプリケーションの通常のインスタンスでActivityを起動する。
モックのインテントをActivityに送信することができるので、
複数のタイプのインテントに対する応答をテストできる
インテントに含まれるデータタイプの確かさを期待するActivity をテストできる

<blockquote>製品のシステムの残りの部分からテストが隔離されていないため、モックのContext および　Application は利用できない</blockquote>

ActivityUnitTestCase

ActivityUnitTestCase は、隔離された、ただ一つのAcitivity をテストする。
Activity を開始する前に、モックのContext または Application (もしくは両方) を注入することができる
そして、Androidと影響し合うことなしに、メソッドのユニットテストを行うことができる
テスト時にモックのインテントを Activity に送ることはできない
しかしながら、Activity.startActivity(Intent) を呼び出すことはできるし、受け取った引数を確認することが可能

SingleLaunchActivityTestCase

SingleLaunchActivityTestCase は、複数のテストの間、変化しない環境の中のただ一つのAcitvityをテストするのに便利なクラス
setUp()|http://developer.android.com/reference/junit/framework/TestCase.html#setUp() と [tearDown()] をメソッドの呼び出ごとに呼び出す代わりに、たった一度だけ呼び出す。
いかなるモックオブジェクトの注入も許可しない

モックオブジェクトとActivityのテスト

android.test.mock で定義されるモックオブジェクトをAcitivity のテストに利用する

MockApplication

MockApplication|http://developer.android.com/reference/android/test/mock/MockApplication.htmlは、 [ActivityUnitTestCase] を使う場合、Activity のテストに唯一有効。
デフォルトでは、ActivityUnitTestCase は隠された MockApplication オブジェクトを生成しテストで使用する
独自のオブジェクトを、setApplicationで利用できる

Activityテストでのアサーション

ViewAsserts はViewのためのアサーションを定義する
Viewnoアライメントや位置、ViewGroup のステートを確認するのに利用できる

Eclipse ADT でのテスト

http://developer.android.com/guide/developing/testing/testing_eclipse.html

テストプロジェクトの作成

テスト環境を Ancroid アプリケーションにセットアップするには、最初にテストコードを含む分離されたプロジェクトを作成する必要がある
新しいプロジェクトは、Android アプリケーションのディレクトリ構造に従う
同じタイプのコンテンツとファイル、ソースコード、リソース、マニフェストファイルなどなどを含む
作成したテストパッケージはテスト時にマニフェストファイルの <instrumentation> 要素に従ってアプリケーションに接続する

新規 Android テストプロジェクトダイアログは、それらを簡単に作成するし、いつでもできる
ダイアログは、新しい Android アプリケーション作成直後に表示されるが、事前に作成しておくこともできる

テストプロジェクトを作成するには

File － New － Other

Android TestProject を選択し、Next

Android Test Project ウィザード

Test Project Name:任意の名前がつけられるが、対象のプロジェクトに"Test"を付加するのが関連を表す一つの方法
既存の Android プロジェクトを選択すると、必要な項目が自動で設定される

テストパッケージの作成

テストプロジェクトを作成したら、テストパッケージを作成する
パッケージは、Activity を必須とはしないが、望めば、定義することもできる
テストパッケージは、Activity、テストケースクラスと通常のクラスと一体化可能ではあるが、メインとなるテストケースはAndroid テストケースクラスの一つ、もしくはJUnitクラスから継承すべきである。なぜなら、ベストなテスト機能を提供するから
テストパッケージは、Android　GUI は必要としない
Eclipse ADT から起動する場合、JUnit ビューに結果が表示される
テストを実行し、結果を確認する詳細については、 Running Tests を参照

android.test にAndroid のテストケースクラスが定義されている
それらは、JUnit の TestCase クラスを継承している

作成されたテストパッケージのコンテキストメニューから、New － Class

クラス名は、テストしたい対象のクラス名 + "Test" としておくのが一つの方法
継承元は、上記で上げた基底クラスを指定する。(今回は、ActivityInstrumentationTestCase2) とした

クラスが作成されたら、ActivityInstrumentationTestCase2 のジェネリック型に対象のActivity を指定する。
テスト環境を制御するためには、setUp() と tearDown() メソッドをオーバーライドする

setUp()

どのテストメソッドが呼ばれる前に呼ばれる
テスト用の環境をセットするのに使用する
ACTION_MAIN を伴った新しいインテントを生成するのに利用できる

tearDown()

すべてのテストメソッドの後に呼び出される
ガベージコレクトおよびテスト用の設定のリセットに利用する

例

package info.typea.shujiroid.free.test;

import info.typea.shujiroid.core.ShujiView;
import info.typea.shujiroid.free.R;
import info.typea.shujiroid.free.ShujiActivity;
import android.test.ActivityInstrumentationTestCase2;
import android.test.TouchUtils;
import android.view.Gravity;

public class ShujiroidTest extends 
              ActivityInstrumentationTestCase2<ShujiActivity> {
    private ShujiView shujiView;
    
    public ShujiroidTest() {
        super("info.typea.shujiroid.free", ShujiActivity.class);
    }

    @Override
    protected void setUp() throws Exception {
        super.setUp();
        shujiView = (ShujiView) getActivity().findViewById(R.id.shujiview);
    }
    
    public void testDraw() {
        getActivity().runOnUiThread(new Runnable() {
            @Override
            public void run() {
                shujiView.requestFocus();
            }
        });
        TouchUtils.dragViewBy(this, shujiView, Gravity.CENTER, 500, 200);
    }
}

ユーティリティ

Assert : JUnit のアサートクラス
MoreAsserts : Android の追加アサートクラス
ViewAsserts : View テスト用に便利なアサートクラス
TouchUtils: タッチイベントシミュレーション用

テストの実行

テストを Eclipse から実行するには、2つの方法がある
- Run As ... － Android JUnit Test をプロジェクトのコンテキストメニューから選択
- Eclipse の run configuration を作成する

自動で、画面に描画された

MyMemoWiki

Android Activity の テスト

目次

Android Activity の テスト

概要

Activity テスト API

InstrumentationTestCaseが提供する機能

ライフサイクル制御

依存性の注入

ユーザーインターフェースインタラクション

JUnit

2つの主のテスト用サブクラス

ActivityInstrumentationTestCase2

ActivityUnitTestCase

SingleLaunchActivityTestCase

モックオブジェクトとActivityのテスト

MockApplication

Activityテストでのアサーション

Eclipse ADT でのテスト

テストプロジェクトの作成

テストプロジェクトを作成するには

File － New － Other

Android Test Project ウィザード

テストパッケージの作成

作成されたテストパッケージのコンテキストメニューから、New － Class

setUp()

tearDown()

例

ユーティリティ

テストの実行

案内メニュー

検索

Android Activity のテスト

Android Activity のテスト