Jetpack Compose UIテスト自動化の実装ガイド

2026年7月22日

もっとスキルを活かしたいエンジニアへ

スポンサードリンク

働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

エンジニアの世界では、「いつでも動ける状態を作っておけ」とよく言われます。
技術やポートフォリオがあっても、自分に合う案件情報を日常的に見れていないと、いざ動こうと思った時に比較や判断が難しくなってしまいます。
普段から案件情報が集まる環境を作っておくと、良い案件が出た時にすぐ動きやすくなりますよ。
筆者自身も、メガベンチャー勤務時代に年収1,500万円を超えた経験があります。振り返ると、技術だけでなく「どんな案件や働き方があるか」を日頃から見ていたことが、キャリアの選択肢を広げるきっかけになりました。
このブログを読んでくれた方に感謝を込めて、実際に使っている情報収集サービスを紹介します。

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。

Contents

1 Jetpack Composeテスト自動化の実装準備
- 1.1 必要ライブラリと環境設定
  - 1.1.1 依存関係と設定要件
- 1.2 プロジェクト構成の最適化
  - 1.2.1 推奨プロジェクト構成
2 Jetpack ComposeテストAPIの導入と基本構文
- 2.1 AndroidX Testingライブラリの導入手順
- 2.2 Composeテスト用アサーションの使い方
  - 2.2.1 テストケースの実装例
  - 2.2.2 重要なポイント
3 ローカル環境でのユニットテスト構築
- 3.1 テスティングフレームワークの初期設定
  - 3.1.1 例：テストクラスの基本構造
- 3.2 UIコンポーネント単体テストケース作成
  - 3.2.1 例：カウンターコンポーネントのテスト
4 Firebase Test LabによるクラウドUI自動化
- 4.1 Test Labでのインストール手順
  - 4.1.1 例：test_runner.xmlの構造
- 4.2 CI/CD連携時の注意点
  - 4.2.1 例：CI/CD連携ワークフロー（GitHub Actions）
5 実践例: ステップバイステップガイド
6 最新Jetpack Composeバージョンとの互換性確認
- 6.1 API変更履歴のチェックポイント
  - 6.1.1 例：Jetpack Compose 1.5への対応
- 6.2 バージョン別テストケースの調整方法
7 まとめ

スポンサードリンク

Jetpack Composeテスト自動化の実装準備

Jetpack ComposeアプリケーションにおけるUIテスト自動化を構築するには、まず環境設定とプロジェクト構成の最適化が不可欠です。本記事では、Compose専用のテストAPI導入からローカルでのユニットテスト構築まで、実務で即戦力となる具体的な手順を解説します。Jetpack Compose テスト自動化手順を正しく理解することで、安定した品質保証と開発効率の向上が可能になります。

必要ライブラリと環境設定

Jetpack Composeテスト自動化には、公式に提供されているAndroidX Testingライブラリが不可欠です。このライブラリはCompose UIの要素操作や状態検証を簡潔に行えるように設計されており、ローカルでの高速なユニットテスト実行にも対応しています。

依存関係と設定要件

項目	内容
必要ライブラリ	`androidx.compose.ui:ui-test-junit4`
テストフレームワーク	JUnit 4 or JUnit 5（Kotlin DSL）
環境要件	Android Studio 2023.1以降、Composeバージョン1.4以上

blockquote
環境設定の初期段階でライブラリが正しく追加されていないと、後述するテストケース実行時にエラーが発生します。build.gradle.ktsファイルを確認し、依存関係が反映されているか必ず検証してください。

プロジェクト構成の最適化

テストコードの可読性と保守性を高めるため、プロジェクト構造にandroidTestディレクトリ内にcomposeサブフォルダを作成し、UIテスト用のファイルを分離します。また、testディレクトリはローカルでのユニットテスト専用として使い分けましょう。

推奨プロジェクト構成

app/
├── src/
│   ├── main/
│   └── androidTest/
│       └── compose/ (Compose UIテスト用)
└── test/ (ローカルユニットテスト用)

app/

├── src/

│ ├── main/

│ └── androidTest/

│ └── compose/ (Compose UIテスト用)

└── test/ (ローカルユニットテスト用)

このように分離することで、UIテストとロジックテストを明確に区別し、開発効率が向上します。

Jetpack ComposeテストAPIの導入と基本構文

Jetpack Compose用のテストAPIは、従来のView階層ではなくCompose UIの特性に合わせた専用ツールです。このセクションでは、AndroidX Testingライブラリを統合し、実装例付きで基本構文を解説します。

AndroidX Testingライブラリの導入手順

Jetpack ComposeテストAPIはandroidx.compose.ui:ui-test-junit4モジュールに含まれており、以下のように導入できます：

build.gradle.ktsファイルに以下を追加
kotlin dependencies { androidTestImplementation("androidx.compose.ui:ui-test-junit4") testImplementation("androidx.test.ext:junit-ktx") }
テストクラスに必要なアノテーションとライブラリをインポート
kotlin import androidx.compose.ui.test.* import androidx.compose.ui.test.junit4.createComposeRule import org.junit.Rule import org.junit.Test

blockquote
Jetpack Compose 1.4以降では、androidx.compose.ui:ui-test-junit4が安定して動作するようになり、過去バージョンとの互換性は公式ドキュメントで明記されている限り保証されます。

Composeテスト用アサーションの使い方

Compose UIテストでは、onNodeやonChildメソッドを使ってUI要素を検出・操作します。以下に基本的なアサーション例を示します。

テストケースの実装例

class CounterTest {
    @get:Rule
    val composeRule = createComposeRule()

    @Test
    fun testCounterIncrement() {
        // 1. UIコンポーネントを構築
        composeRule.setContent {
            CounterScreen()
        }

        // 2. テキストノードの検索と確認
        onNodeWithText(&quot;Count: 0&quot;)
            .assertIsDisplayed()

        // 3. ボタンクリックシミュレーション
        onNodeWithContentDescription(&quot;Increment Button&quot;)
            .performClick()

        // 4. 更新後の状態確認
        onNodeWithText(&quot;Count: 1&quot;)
            .assertIsDisplayed()
    }
}

class CounterTest {

@get:Rule

val composeRule = createComposeRule()

@Test

fun testCounterIncrement() {

// 1. UIコンポーネントを構築

composeRule.setContent {

CounterScreen()

}

// 2. テキストノードの検索と確認

onNodeWithText("Count: 0")

.assertIsDisplayed()

// 3. ボタンクリックシミュレーション

onNodeWithContentDescription("Increment Button")

.performClick()

// 4. 更新後の状態確認

onNodeWithText("Count: 1")

.assertIsDisplayed()

}

重要なポイント

onNodeWithText()：UIに表示されているテキストを検索
performClick()：ユーザー操作をシミュレート
assertIsDisplayed()：要素が画面に表示されているか確認

このようにして、ComposeのUIコンポーネントに対して直接的なテストを行うことが可能です。

ローカル環境でのユニットテスト構築

ローカル環境でUIテストを実行するには、テストフレームワークの初期設定とUIコンポーネント単体のテストケース作成が必要です。

テスティングフレームワークの初期設定

Android Studioで「File」→「New」→「New Module」を選択し、Test Libraryを追加
build.gradle.ktsにテスト関連ライブラリの依存関係を記述（前項と同様）
テストクラスを作成し、createComposeRuleでUI画面を起動させる

例：テストクラスの基本構造

import androidx.compose.ui.test.*
import androidx.compose.ui.test.junit4.createComposeRule
import org.junit.Rule
import org.junit.Test

class ExampleTest {
    @get:Rule
    val composeRule = createComposeRule()

    @Test
    fun testUIComponent() {
        // テストロジックを記述
    }
}

import androidx.compose.ui.test.*

import androidx.compose.ui.test.junit4.createComposeRule

import org.junit.Rule

import org.junit.Test

class ExampleTest {

@get:Rule

val composeRule = createComposeRule()

@Test

fun testUIComponent() {

// テストロジックを記述

}

このようにして、ローカル環境で高速なテストが実行可能になります。

UIコンポーネント単体テストケース作成

UIコンポーネントを単体でテストするには、以下の手順を行います：

テスト対象のComposable関数を@Composableとして抽出
Ruleを用いて画面を起動し、コンポーザブルを検証
アサーションでUI状態を確認

例：カウンターコンポーネントのテスト

@Test
fun testCounterDisplay() {
    composeRule.setContent {
        CounterScreen()
    }

    onNodeWithText(&quot;Count: 0&quot;)
        .assertIsDisplayed()
}

@Test

fun testCounterDisplay() {

composeRule.setContent {

CounterScreen()

}

onNodeWithText("Count: 0")

.assertIsDisplayed()

}

このように、ローカル環境でのテストはCI/CD連携に最適な形で実行可能です。

Firebase Test LabによるクラウドUI自動化

Firebase Test Labは、リモートデバイスでのUIテスト自動化を実現するためのクラウドベースのツールです。

Test Labでのインストール手順

Firebaseプロジェクトを作成し、Test Labの設定画面へアクセス
AndroidアプリケーションのAPKやAABファイルをアップロード
テスト実行デバイス（物理端末またはエミュレータ）を選択
テストケース用のスクリプトをtest_runner.xmlに記述

例：test_runner.xmlの構造

&lt;configuration&gt;
    &lt;device&gt;
        &lt;manufacturer&gt;Google&lt;/manufacturer&gt;
        &lt;model&gt;Nexus5X&lt;/model&gt;
        &lt;os_version&gt;10.0&lt;/os_version&gt;
    &lt;/device&gt;
    &lt;tests&gt;
        &lt;test&gt;
            &lt;instrumentation_test&gt;
                &lt;package_name&gt;com.example.app&lt;/package_name&gt;
                &lt;runner_class&gt;androidx.test.runner.AndroidJUnitRunner&lt;/runner_class&gt;
            &lt;/instrumentation_test&gt;
        &lt;/test&gt;
    &lt;/tests&gt;
&lt;/configuration&gt;

<manufacturer>Google</manufacturer>

<model>Nexus5X</model>

<os_version>10.0</os_version>

</device>

<tests>

<test>

<instrumentation_test>

<package_name>com.example.app</package_name>

<runner_class>androidx.test.runner.AndroidJUnitRunner</runner_class>

</instrumentation_test>

</test>

</tests>

</configuration>

blockquote
Test LabはAndroid 13以降の端末もサポートしており、Jetpack Compose 1.4以上での互換性が確認されています。公式ドキュメント（Firebase Test Lab ドキュメント）を参照し、最新情報を常に把握してください。

CI/CD連携時の注意点

Test LabとCI/CDパイプラインを連携する際には、以下の点に注意してください：

テスト結果の自動収集：gcloud test android results downloadコマンドでリザルトを取得
セキュリティ設定：Firebaseプロジェクトへのアクセス権限を適切に管理
テストスクリプトのバージョン管理：test_runner.xmlはソースコードと同様にバージョン制御する

例：CI/CD連携ワークフロー（GitHub Actions）

name: Firebase Test Lab CI

on: [push]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Install gcloud CLI
        run: |
          curl https://sdk.cloud.google.com | bash
          export PATH=$PATH:$HOME/gcloud/bin
      - name: Run Firebase Test Lab
        run: |
          gcloud test android create --project=your-project-id \
            --type=instrumented_test \
            --test-targets=app-release.aab \
            --test-runner=androidx.test.runner.AndroidJUnitRunner \
            --device-definitions=manufacturer=Google,model=Nexus5X,os_version=10.0

name: Firebase Test Lab CI

on: [push]

jobs:

test:

runs-on: ubuntu-latest

steps:

- uses: actions/checkout@v3

- name: Install gcloud CLI

run: |

curl https://sdk.cloud.google.com | bash

export PATH=$PATH:$HOME/gcloud/bin

- name: Run Firebase Test Lab

run: |

gcloud test android create --project=your-project-id \

--type=instrumented_test \

--test-targets=app-release.aab \

--test-runner=androidx.test.runner.AndroidJUnitRunner \

--device-definitions=manufacturer=Google,model=Nexus5X,os_version=10.0

このように設定することで、リモートデバイスでのUIテストを自動化可能です。

実践例: ステップバイステップガイド

具体的なプロジェクトを通して、Jetpack Composeのテスト自動化手順を解説します。

サンプルアプリケーションの作成

プロジェクトを作成：Android Studioで新規プロジェクトを作成し、Jetpack Composeを選択
UIコンポーネントを実装：簡単なカウンターアプリを作成（上記例と同様）
テストスクリプトを準備：ローカルでのユニットテストとTest Labでのクラウドテスト用にスクリプトを分離

テストケースの記述と実行

ローカルテスト（JUnit + Compose UIテストAPI）

@Test
fun testCounterIncrement() {
    composeRule.setContent {
        CounterScreen()
    }

    onNodeWithText(&quot;Count: 0&quot;).assertIsDisplayed()
    onNodeWithContentDescription(&quot;Increment&quot;).performClick()
    onNodeWithText(&quot;Count: 1&quot;).assertIsDisplayed()
}

@Test

fun testCounterIncrement() {

composeRule.setContent {

CounterScreen()

}

onNodeWithText("Count: 0").assertIsDisplayed()

onNodeWithContentDescription("Increment").performClick()

onNodeWithText("Count: 1").assertIsDisplayed()

}

Test Labでのテスト（CI/CD連携）

test_runner.xmlで対象デバイスを指定し、gcloud test android createコマンドで実行

結果確認と改善点

テスト結果画面でUIの表示やクリック動作が正常に実行されているか確認
エラーログがないことを前提に、コード品質とテストカバレッジを評価
不足しているテストケースがあれば、追加のスクリプトを作成

このようにして、UIテスト自動化の流れをステップバイステップで実践できます。

ジェネレーション	対応するJetpack Composeバージョン	調整点
初期版	1.0〜1.2	`setContent`の使用制限
中盤	1.3〜1.4	アサーションメソッドの変更（例：`onNodeWithText()`）
最新版	1.5以降	新APIの利用、`@ExperimentalComposeApi`の追加

まとめ

本記事では、Jetpack ComposeによるUIテスト自動化の実装手順と実践方法を解説しました。

Compose専用テストAPIはローカルでのユニットテストに最適
Firebase Test LabでクラウドベースのUIテストを行うことで、複数デバイスでの品質保証が可能
最新版Jetpack Composeとの互換性確認は開発プロセスにおいて不可欠

上記の手順を活用し、効率的なUIテスト自動化フローを構築してください。コメント欄で実装結果や質問を共有すれば、さらに技術レベルが高まります。

スポンサードリンク

もっとスキルを活かしたいエンジニアへ

スポンサードリンク

働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。

-JetpackCompose

comment コメントをキャンセル

: JetpackCompose

Jetpack Composeテーマカスタマイズ手順：アプリのUI刷新ガイド

Jetpack Composeのテーマカスタマイズ手順を解説。Material Design 3対応のColorSchemeやTypographyの実装例、動的切り替え方法を紹介します。

: JetpackCompose

Jetpack Composeでアニメーションを実装する方法 | 状態管理と宣言型UIの関係

Jetpack Composeでアニメーションを構築する際の状態管理（State Management）と宣言型UIの関係性、AnimatedVisibility・Transition API・Fade/Slideアニメーション・Animatableによるタイムライン制御など、実装例をステップバイステップで解説。

: JetpackCompose

Jetpack Composeアニメーション入門｜Transition APIとFade・Slideの実装

Jetpack Composeの宣言型UIと状態変化の関係性、Transition APIの基礎、Fade・Slideアニメーションの実装例をステップバイステップで解説します。

: JetpackCompose

Jetpack Compose Material3テーマカスタムガイド | 初心者向け

Jetpack ComposeのMaterial3テーマカスタム方法をステップバイステップで解説。ColorScheme・Typography・Shapeの設定とダークモード対応、Firebase Remote Configによる動的変更まで。

: JetpackCompose

Jetpack Compose Material3 テーマカスタマイズ完全ガイド

Jetpack Compose Material3テーマカスタマイズの基本構造、ColorScheme・Typography・Shapeの設定方法、ダークモード実装までステップバイステップで解説。Codelab活用も含む実践ガイドです。

miiveで中小企業の福利厚生改革を成功させるガイド

弥生会計Next導入ガイド：中小企業の5ステップ移行手順

Jetpack Compose UIテスト自動化の実装ガイド

Jetpack Composeテスト自動化の実装準備

必要ライブラリと環境設定

依存関係と設定要件

プロジェクト構成の最適化

推奨プロジェクト構成

Jetpack ComposeテストAPIの導入と基本構文

AndroidX Testingライブラリの導入手順

Composeテスト用アサーションの使い方

テストケースの実装例

重要なポイント

ローカル環境でのユニットテスト構築

テスティングフレームワークの初期設定

例：テストクラスの基本構造

UIコンポーネント単体テストケース作成

例：カウンターコンポーネントのテスト

Firebase Test LabによるクラウドUI自動化

Test Labでのインストール手順

例：test_runner.xmlの構造

CI/CD連携時の注意点

例：CI/CD連携ワークフロー（GitHub Actions）

実践例: ステップバイステップガイド

サンプルアプリケーションの作成

テストケースの記述と実行

ローカルテスト（JUnit + Compose UIテストAPI）

Test Labでのテスト（CI/CD連携）

結果確認と改善点

最新Jetpack Composeバージョンとの互換性確認

API変更履歴のチェックポイント

例：Jetpack Compose 1.5への対応

バージョン別テストケースの調整方法

まとめ