【iOS】FastlaneでUnitTest/UITestをいい感じに自動化してみた

はじめに

Fastlaneをプロジェクトに導入をする機会があって、いろいろ調べたので記事にしてみました。
Fastlaneをこれから使ってみたい、XCTestを自動化したいという方の参考になれば幸いです。

この記事で学べること

• Fastalenの導入の方法
• XCTest(UnitTest/UITest)を自動化する方法（前提としてプロジェクトにXCTestが導入されている必要がある）
• Test自動化のための細かいオプション

Fastalen導入

Test自動化の前にFastlaneをプロジェクトに導入する必要があります。
プロジェクトのディレクトリに移動して、

bundle init

を実行すると、同ディレクトリにGemfileが生成されます。

Gemfileをテキストエディタなどで開いて、コメントアウトされている# gem "rails"の下に、

gem 'fastlane'

を書き足します。
ここまでは、エラーが起きて失敗したりすることはあまり無いと思います(自分は大丈夫でした)

次はインストールです。

bundle install --path vendor/bundle

このコマンドが結構厄介で、環境によっては権限周りのエラーを吐きます。
PCによって大丈夫だったり、ダメだったり色々です。とりあえず、エラーで検索すれば、解決できました。

ここまできたら次は、Fastalen導入です。

bundle exec fastlane init

1 - 4 の選択肢を提示されて、選ばされますが、どちらにせよ後で編集できるので、4番を選択します。
なんか色々聞かれますが、Enterですべてすっ飛ばします。

このコマンドが成功するとディレクトリにfastlaneというファイルが作られます。
その中に、Fastfile、Appfileがあるはずです。← 今回はこれ使いません。

XCTestの自動化

とりあえず、Fastlaneの導入が終わりましたので、こっから自動化する作業に入ります。

Scanfileを生成する

bundle exec fastlane scan init

とりあえずTest実行してみる

Scanfileが作られたら、とりあえず中身を何も変更しないデフォルトでも自動テストが動きます。

bundle exec fastlane scan  

これだけです。
UnitTestとUITestがプロジェクトに両方ある場合は、両方とも自動で実行されます。

ターミナルでテストが完了したことを確認し、
/fastlane/test_outputのディレクトリにreport.htmlが出力されていればテスト完了です。
テストの結果はこのHTMLファイルから確認できます。

こんな感じです。

プロジェクトにある全てのTestをとりあえず回したいという場合はここまででOKです。

Scanfileを使ってもっと便利にしてみる

デフォルトでもXCTest自動化という目的は達成ですが、せっかくScanfileを生成したので、もう少しカスタムしていきたいと思います。
自分が使ってみて便利だったカスタムは以下に記載しました。

devices(["iPhone 8"])

open_report(true)

clean(true)

only_testing(["Switf5UITestTrainUITests/Switf5UITestTrainUITests/testLogin"])

# skip_testing(["Switf5UITestTrainUITests/Switf5UITestTrainUITests/testLogin"])

パラメーターの仕様をもっと知りたい方はこちらのドキュメントに記載されているので読んでみてください。

参考にさせていただいた記事