iPhone/テスト駆動型開発の準備のバックアップ(No.4)

「実行可能ファイル」を選択し、右クリックで「追加」→「新規カスタム実行可能ファイル」を選択
「実行可能ファイル名」をotest、実行可能ファイルのパスとして、以下の値をセット
```
/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS4.0.sdk/Developer/usr/bin/otest
```

otestの設定

otestを選択し、右クリックで「情報を見る」を選択し、引数タブを選択します

のように引数と環境変数を設定します。

引数は、2個目の引数は、単体テストのターゲット名+.octestとします。

-SenTest All

UnitTests.octest

環境変数は、

Name	Value
DYLD_ROOT_PATH	$(SDKROOT)
DYLD_FRAMEWORK_PATH	${BUILD_PRODUCTS_DIR}:${SDK_ROOT}:${DYLD_FRAMEWORK_PATH}
IPHONE_SIMULATOR_ROOT	$(SDKROOT)
CFFIXED_USER_HOME	$(HOME)/Library/Application Support/iPhone Simulator/User/
OBJC_DISABLE_GC	YES
DYLD_LIBRARY_PATH	${BUILD_PRODUCTS_DIR}:${SDK_ROOT}:${DYLD_LIBRARY_PATH}
DYLD_NEW_LOCAL_SHARED_REGIONS	YES
DYLD_NO_FIX_PREBINDING	YES

↑

デバッガの起動 †

デバッガを起動する前に、もう一度、ターゲットUnitTestsを実行しておきます。

次に、

testMathの最初の行にブレークポイントを設定
otestを選択し、右クリックで「ブレークポイントを使ってotestを開始」を選択します。
実行からデバッガを表示をクリックすると以下のデバッガの画面になります。

これで、無事デバッガが使えるようになりました。

↑

hamcrestの準備 †

hamcrestは、単体テストで判定をする時の便利な機能を集めたパッケージです。

hamcrestの大きな特徴は、メソッド名称が英語に近い表現になっていることです。

assertThat(aaaa, is(not(equalTo(bbbb))));

は、カッコとカンマを全部取り除くと assert that aaaa is not equal to bbbb.となり、英語として意味のわかるように作られています。*1

↑

インストール手順 †

残念ながら、hamcrestにはiPhone SDK用のパッケージはありません。

ここでは、SVNを使ったソースからの作成方法を紹介します。

ホームディレクトリにlocal/OCHamcrestを作成

SVNを使ってソースをダウンロードします

svn checkout http://hamcrest.googlecode.com/svn/trunk/ hamcrest-read-only

/local/OCHamcrest/hamcrest-read-only/hamcrest-objectivec/SourceのOCHamcrest.xcodeprojをダブルクリック
ターゲットのOCHamcres-iOSをテスト環境と同じDebugとSimulatorにセットし、ビルドします

↑

使い方 †

hamcrestの使い方*2は、簡単です。

ソースの最初に以下の2行を追加するだけです。

#define HC_SHORTHAND
#import <OCHamcrest/OCHamcrest.h>

最初のHC_SHORTHANDは、メソッドの先頭にHC_を付けないで使用するためのおまじないです。

ライブラリで提供する機能は以下の通りです。

基本
- aynthing : 常にマッチする
- describedAs : カスタムfailureを記述するためのデコレータ（可読性のためのメソッド）
- is : 読みやすくするためのデコレータ

論理
- allOf : すべてがマッチしたときに、マッチ（真となる）
- anyOf : いづれかたがマッチしたときに、マッチ
- isNot : マッチしなかったときにマッチ

オブジェクト
- equalTo : オブジェクトの一致をisEqualメソッドを使ってチェック
- hasDescription : テストに関する記述を追加
- instanceOf, isCompatibleType : 型の一致をチェック
- notNilValue, nilValue : nilのチェック
- sameInstance : 同一インスタンスのチェック

集合
- hasEntry, haskey, hasValue : NSDictionaryのcontains entry, key, value のチェック
- hasItem, hasItems : 集合がアイテムを含むか否かのチェック

数値
- closeTo : 浮動小数点の値が近いかどうかのチェック
- greaterThan, greaterThanOrEqualTo, lessThan, LessThanOrEqualTo : 大小のチェック

テキスト
- equalToIgnoringCase : 大文字小文字の区別無く文字の一致をチェック
- equalToIgnoringWhiteSpace : 空白の違いを無視して文字の一致をチェック
- containsString, endsWith, startsWith : 文字の一致をチェック

↑

hamcrestの使用例 †

hamcrestを使うには、

外部フレームワークをセットし、インクルードファイルパスをセットする
使用するライブラリがiPhone OS用のスタティックライブラリを使用するためにhamcrestプロジェクトをドラッグする
外部リンクフラッグに-ObjC -all_loadを追加する

必要があります。

外部フレームワークの追加は、プロジェクトを選択し、右クリックで「追加」→「既存のフレームワーク」を選択し、「その他の追加」からOCHamcrestのSource/build以下のDebug/OCHamcrest.frameworkを選択します。

次に、OCHamcrestのXCodeプロジェクトをテストしたいプロジェクトにドラッグしますと、

のダイアログが表示されるので、ターゲットを単体テスト（UnitTests）であることを確認します。

次に、libochamcrest.aの左端のチェックボックスをセットします。

最後にターゲットのUnitTestsを選択し、「情報を見る」を選択し、ビルドタグから外部リンクを選択し、「他のリンカフラグ」をダブルクリックし、最後に-ObjC, -all_load テストプログラムは、以下を参考に入力してください。

#import "GTMSenTestCase.h"
#define HC_SHORTHAND
#import <hamcrest/hamcrest.h>
 
@interface ExampleWithAssertThat : SenTestCase
@end
 
@implementation ExampleWithAssertThat
 
- (void) testUsingAssertThat
{
    assertThat(@"xx", is(@"xx"));
    assertThat(@"yy", isNot(@"xx"));
    assertThat(@"i like cheese", containsString(@"cheese"));
}
 
@end

↑

コメント †

この記事は、

皆様のご意見、ご希望をお待ちしております。

選択肢	投票
おもしろかった	0
そうでもない	0
わかりずらい	0

iPhone/テスト駆動型開発の準備 のバックアップ(No.4)

iPhone SDKのUnitTestは中途半端 †

UnitTest バンドルの新規作成 †

単体テストクラスを作成 †

単体テストの実行 †

かっこ悪いデバッガの使い方 †