2025/6/6

【Xcode/iOS】XCTestでテストカバレッジを計測する方法！

この記事からわかること

SwiftのXCTestでテストカバレッジを計測する方法

index

[open]

テストカバレッジとは？
Xcodeでテストカバレッジを計測する方法
1.テストコードを導入
2.「Code Co Gather coverage for...」にチェックをいれる
3.テストを実行
テストコードがないのにテストカバレッジ率に値が理由

＼アプリをリリースしました／

友達や家族の誕生日をメモ！通知も届く-みんなの誕生日-

posted withアプリーチ

環境

Xcode：16.3
iOS：18.0
Swift：5.9
macOS：Sequoia 15.4

テストカバレッジとは？

「テストカバレッジ」とはテストがソースコードのどの程度を実行したかを示す指標です。実装されているコードに対してテストコードを通過している割合を数値として把握することができるので、テストがどこまで網羅しているかを把握することができます。

テストカバレッジは実際にそのコードがテストで実行されているかどうかが重要になります。例えば以下のような実装コードがあるとします。

ソースコード
func greet(_ name: String) -> String {
    if name.isEmpty {
        return "Hello, Guest!"
    } else {
        return "Hello, \(name)!"
    }
}

そして以下のようなテストコードのみが実装されているとすると、テストカバレッジは100%になりません。これはreturn "Hello, Guest!"側のコードが通っていないためです。

テストコード
func testGreet() {
    let result = greet("Ame")
    #expect(result == "Hello, Ame!")
}

そのためelse側のテストも追加するなど、テストで条件分岐のパターンなども網羅していくとテストカバレッジの値も上がっていきます。

Xcodeでテストカバレッジを計測する方法

Xcodeではテストカバレッジを計測することが可能です。カバレッジを計測するためのステップは以下の通りです。

テストコードを導入
「Code Co Gather coverage for...」にチェックをいれる
テストを実行

1.テストコードを導入

まずはテストコードを導入します。Xcodeでは「XCTest」と「Swift Testing」の2つの方法がありますが「Swift Testing」の方が新しく使い勝手も良いためおすすめです。テストコードの実装方法は以下の記事を参考にしてください。

2.「Code Co Gather coverage for...」にチェックをいれる

テストコードの実装が完了したらテストカバレッジを計測できるようにしていきます。カバレッジの計測設定はスキームごとに行います。「Edit Scheme...」から「Test」＞「Code Co Gather coverage for...」にチェックをいれるだけです。

この際にカバレッジ計測対象のターゲットを選択することができるので「all targets」もしくは「some targets」を選択できます。「all targets」だとプロジェクト内の全てーのターゲット(ライブラリやフレームワークなど)も対象になってしまうため「some targets」で対象のターゲットを明示的に指定した方がカバレッジ率が把握しやすいです。

3.テストを実行

実際にカバレッジを確認するためにはまずテストを実行します。実行すると左側のナビゲータエリアの「Report Navigator（⌘9）」から「Coverage」が追加されていることを確認できます。ここをクリックするとターゲット内のファイルごとにテストカバレッジ率が表示されるようになります。