AppCode の単体テスト

1. メインメニューのツール | CocoaPods | ポッドファイルを編集をクリックして、既存のポッドファイルを開きます。

2. iOSConferencesTests ターゲットに Quickand Nimble pods を追加します。

   target 'iOSConferences' do use_frameworks! pod 'Yams' target 'iOSConferencesTests' do inherit! :search_paths pod 'Quick' pod 'Nimble' end end

3. エディターの右上隅に表示される pods をインストールするリンクをクリックし、2 つの新しい pods がインストールされるまで待ちます。

   

1. プロジェクトツールウィンドウ Alt+1 で、iOSConferencesTests フォルダーを右クリックし、新規 | Xcode テンプレートからファイルを選択します。

2. 開いたダイアログで iOS | ソース | ユニットテストケースクラスを選択し、次へをクリックします。

3. 次のページで、以下を指定します。

   • ファイル名 : ApiTests

   • 言語 : Swift

   • サブクラス : QuickSpec

   • ターゲット : iOSConferencesTests

   

4. 新しく作成された Swift ファイルで、Yams、Quick、Nimble インポートステートメントを追加し、ApiTests クラスのすべてのデフォルトメソッドを削除します。

   import XCTest import Yams import Quick import Nimble class ApiTests: QuickSpec { }

5. import ステートメントの直後に次の行を追加して、アプリケーションコードをテストで使用できるようにします。

   @testable import iOSConferences

1. QuickSpec クラスの spec() メソッドをオーバーライドします: キャレットを ApiTests クラス内に配置した状態で、Ctrl+O を押し、開いたダイアログで spec() を選択します。

   

2. spec() メソッド内に、describe ブロックを追加し、そこに decoder 変数と loader 変数を作成します。

   override func spec() { describe("Application") { let decoder = YAMLDecoder() let loader = ConferencesLoader() } }

3. describe ブロック内で、it ブロックに次のテストメソッドを追加します。

   it("should load conferences") { waitUntil(timeout: 5) { done in loader.loadConferences { conferences in done() } } } it("should parse conference") { let yaml = try! decoder.decode([Conference].self, from: """ - name: mDevCamp link: https://mdevcamp.eu/ start: 2019-05-30 end: 2019-05-30 location: 🇨🇿 Prague, Czech Republic """ ) let conference: Conference = yaml[0] expect(conference.end).toNot(beNil()) expect(conference.name).to(equal("mDevCamp")) expect(conference.start).toNot(beNil()) expect(conference.location).to(equal("🇨🇿 Prague, Czech Republic")) expect(conference.link).to(equal("https://mdevcamp.eu/")) } it("should ignore unused fields") { let yaml = try! decoder.decode([Conference].self, from: """ - name: mDevCamp link: https://mdevcamp.eu/ start: 2019-05-30 end: 2019-05-30 location: 🇨🇿 Prague, Czech Republic cocoa-only: true cfp: link: https://www.papercall.io/swift-to-2020 deadline: 2020-06-16 """ ) let conference: Conference = yaml[0] expect(conference.end).toNot(beNil()) expect(conference.name).to(equal("mDevCamp")) expect(conference.start).toNot(beNil()) expect(conference.location).to(equal("🇨🇿 Prague, Czech Republic")) expect(conference.link).to(equal("https://mdevcamp.eu/")) }

   これらのメソッドは、以下をテストします。

   • it("should load conferences") : loadConferences() メソッドで実行されたネットワーク要求は、空の応答を返しません。

   • it("should parse conference") : 会議データは正しく解析されます。

   • it("should ignore unused fields") : アプリケーションによって処理されないフィールド（cocoa-only や cfp など）を持つ会議は正しく解析されます。

テストターゲットですべてのテストクラスを実行するには、特別な実行 / デバッグ構成を作成する必要があります。

1. 実行 / デバッグ構成セレクターで、実行構成の編集をクリックします。

   

2. 開いたダイアログで、 をクリックし、XCTest を選択します。

   

3. デフォルトでは、AppCode はテストターゲット内のすべてのクラスの実行 / デバッグ構成を作成します。

   

   OK をクリックして、この構成を保存します。これで、実行 / デバッグ構成セレクターで事前に選択されています。

   

4. Shift+F10 を押して、すべてのテストクラスを実行します。実行ツールウィンドウには、プロジェクトで使用可能なすべてのテストクラスの結果が表示され、2 つのテストが失敗したことがわかります。

   

1. ツリーの DateTests ノードをクリックします。右側のペインに、テストが失敗した理由を理解するのに役立つエラーメッセージを含むスタックトレースが表示されます。この場合、期待値は textDate() メソッドによって返される実際の値と一致しません。

   

2. ツリーで testEndEarlierThanStartReplaced テストをクリックして、エディターでそのコードに移動します。

3. 次の行のブレークポイントを設定する Ctrl+F8 :

   

4. キャレットを testEndEarlierThanStartReplaced() メソッド内に配置した状態で、^ ⇧ D を押して、デバッグモードでテストを実行します。プログラムの実行はブレークポイントで停止し、デバッグツールウィンドウが開きます。

5. F7 を押すか、 をクリックして textDate() メソッドの実装に移動し、F8 を押すか をクリックしてコード行をステップオーバーします。デバッグツールウィンドウの変数タブとエディターに、このメソッドが返す値が表示されます。

   

   ご覧のとおり、ソースファイルで終了日と開始日が混同された場合に交換するためのコードはありません。textDates() メソッドのコードを次のように置き換えます。

   func textDates() -> String { var result = start.dateToString() if let end = self.end { if start < end { result = "\(result) - \(end.dateToString())" } else if start > end { result = "\(end.dateToString()) - \(result)" } } return result }

6. デバッグツールウィンドウで、 を押して失敗したテストを再実行し、コンソールタブに移動します。

   

   現在、ブレークポイントで実行が一時停止されています。F9 を押すか、 をクリックしてプログラムを再開します。すべてのテストに合格しました。

   

最後に、単体テストでカバーされているアプリケーションコードの量を確認しましょう。

1. すべてのテストの実行 / デバッグ構成が選択されていることを確認してください。

2. ツールバーの をクリックします。

カバレッジツールウィンドウが開きます。

フォルダーをダブルクリックしてその内容に移動するか、 ボタンをクリックして上位レベルに移動します。

さらに、プロジェクトツールウィンドウで、テストの対象となるファイルと行の割合を確認できます。

エディターでは、色付きのストライプがガターに表示されます。緑は、線がテストで完全に覆われていることを意味し、黄色（部分的に覆われている、赤）は覆われていないことを意味します。

カバレッジインジケータをクリックすると、ポップアップが表示されます。

ここでは、テスト中に回線が実行された回数を確認し、カバレッジを非表示をクリックしてカバレッジデータを非表示にできます。再度表示するには、Ctrl+Alt+F6 を押して、開いたダイアログから必要なカバレッジスイートを選択します。

AppCode のテストカバレッジの詳細については、カバレッジ付きで実行するを参照してください。