Google が iOS UIテストフレームワーク EarlGrey をセットアップしたときのメモ。EarlGrey 自体は CocoaPods でインストールできるが、その他各種準備が必要なのでまとめておく。

Test Target の追加

プロジェクトに EarlGrey 用の Test Target を追加する。すでにある場合は使い回すこともできる。 EarlGrey は Xcode の UI Testing とは異なり、アプリと同じプロセス上で動作する方式のため iOS UI Testing Bundle ではなく iOS Unit Testing Bundle のテンプレートを使う。

File > New > Target... メニューを選択する
iOS Unit Testing Bundle テンプレートを選択する
Product Name を設定して保存する（ここでは SampleAppTests）

Scheme の追加

追加した Test Target 用の Scheme を追加する。

スキームボタンをクリックして New Scheme... を選択する
Test Target (SampleAppTests)を選択して同名の Scheme を作成する
スキームボタンをクリックして Manage Schemes...
スキームの Shared オプションを有効にする

EarlGrey のインストール

Podfile の編集

Podfile に EarlGrey を追加する。configure_for_earlgrey には、プロジェクト名(PROJECT_NAME)、テストターゲット名(TEST_TARGET)、Schemeファイル名(SCHEME_FILE)を渡すようにする。

PROJECT_NAME = "SampleApp"
TEST_TARGET = "SampleAppTests"
SCHEME_FILE = "SampleAppTests.xcscheme"

target "SampleAppTests", :exclusive => true do
  pod "EarlGrey"
end

post_install do |installer|
  load("configure_earlgrey_pods.rb")
  configure_for_earlgrey(installer, PROJECT_NAME, TEST_TARGET, SCHEME_FILE)
end

configure_earlgrey_pods.rb の設置

configure_earlgrey_pods.rb をダウンロードして、Podfile と同じディレクトリに置く。

pod install を実行

pod install コマンドを実行して EarlGrey をインストールする。

$ pod install
Updating local specs repositories

CocoaPods 1.0.0.beta.3 is available.
To update use: `gem install cocoapods --pre`
[!] This is a test version we'd love you to try.

For more information see http://blog.cocoapods.org
and the CHANGELOG for this version http://git.io/BaH8pQ.

Analyzing dependencies
Downloading dependencies
Installing EarlGrey (1.0.0)
Generating Pods project
Checking and Updating SampleApp for EarlGrey.
Adding EarlGrey Framework Location as an Environment Variable 
EarlGrey setup complete. You can use the Test Target : SampleAppTests for EarlGrey testing.
Integrating client project

[!] Please close any current Xcode sessions and use `SampleApp.xcworkspace` for this project from now on.
Sending stats
Sending stats
Pod installation complete! There is 1 dependency from the Podfile and 1 total pod installed.

Build Phase の設定

Test Target に Build Phase を設定する

Test Target (SampleAppTests)の Build Phase を選択する
+ ボタンをクリックして New Copy Files Phase を選択し下記のように設定する
- Destination: Absolute Path
- Path: $(TEST_HOST)/..
- Copy files only when installing: （チェック無効）
- Name: EarlGrey.Framework （Code Sign on Copy のチェックを有効にする）

Bridging Header の追加

Briding Header ファイルに #import <EarlGrey/EarlGrey.h> を追加する。存在しない場合は下記の手順で追加する。

File > New > File... メニューを選択する
Header File を選択して SampleAppTests-Bridging-Header.h という名前で追加する
- 追加の際はテストターゲット(SampleAppTests)のチェックボックスを有効にする。

SampleAppTests-Bridging-Header.h を編集して #import <EarlGrey/EarlGrey.h> を追加する。

SampleAppTests-Bridging-Header.h

//
//  SampleAppTests-Bridging-Header.h
//  SampleApp
//
//  Created by Keiichi Inoue on 2/25/16.
//  Copyright © 2016 Keiichi Inoue. All rights reserved.
//

#ifndef SampleAppTests_Bridging_Header_h
#define SampleAppTests_Bridging_Header_h

#import <EarlGrey/EarlGrey.h>

#endif /* SampleAppTests_Bridging_Header_h */

テストターゲットの Build Settings にある Objective-C Bridging Header に追加した Briding Header ファイルを追加する。

SampleAppTests/SampleAppTests-Briding-Header.h

EarlGrey.swift の追加

EarlGrey.swift をダウンロードしてテストターゲット(SampleAppTests)に追加する。

テストの実行

テストの追加

テストコードをテストケースに追加する。

SampleAppTests.swift

import XCTest

class SampleAppTests: XCTestCase {

    let eg = EarlGrey()    

    override func setUp() {
        super.setUp()
    }

    override func tearDown() {
        super.tearDown()
    }

    func testExample() {
        eg.selectElementWithMatcher(grey_accessibilityID("emailField"))
            .performAction(grey_clearText())
            .performAction(grey_typeText("user@example.com"))
        eg.selectElementWithMatcher(grey_accessibilityID("passwordField"))
            .performAction(grey_typeText("password"))
        eg.selectElementWithMatcher(grey_accessibilityID("loginButton"))
            .performAction(grey_tap())
        eg.selectElementWithMatcher(grey_accessibilityID("welcomeText")
             .assertWithMatcher(grey_sufficientlyVisible())
    }
}

準備完了。あとは Product > Test または Command + U でテストを実行できる。

おしまい。

iOS UIテストフレームワーク EarlGrey のセットアップ