Epoxy で作られた画面を Jetpack Compose に置き換え、Epoxy 使用ファイル数の推移を週次で追うイメージ

Jetpack Compose 移行 KPI を週次で定点観測する仕組みの導入とふりかえり

はじめに and factory ではマンガアプリを複数開発しています。 Androidの既存アプリでは、Android ViewからJetpack Composeへの移行を進めています。 この記事ではその進捗計測の仕組みと、計測してからの推移を書きます。 移行の当面のゴールは、RecyclerViewベースのUIライブラリ Epoxy への依存をなくすことです。 Epoxyを使っているファイルは、5アプリ合計で3月末の308から11月初めの206まで減り、1アプリでは0になりました。 数年前から少しずつ置き換えてきたので、3月の時点でEpoxyのファイルはそれほど多くありませんでした。 EpoxyからJetpack Composeへの移行 Jetpack Composeが出てから比較的早い段階で積極的にComposeを使っていく方針にしました。 新しい画面はComposeで作成し、既存の画面は機能開発で触る際に置き換えています。 移行タスクはNotionで管理していましたが、いつまでに終えるかは決めていませんでした。 一覧画面やマンガビューワーなど既存画面の多くはEpoxyで作られているので、Compose移行の作業の中心はEpoxyで書かれた画面の書き直しです。 Compose移行のモチベーション Epoxyのバージョンはアプリによって3.xから5.xまでばらばらでした。 EpoxyがKSPに対応したのは5.0.0から、KSP2に対応したのは5.2.0からです(Epoxy の CHANGELOG)。 3.xや4.xのアプリでKSPに移るには、Epoxyのメジャーアップデートが必要です。 上げたあとも、KotlinやAGPを上げる際にEpoxyまわりの対応が必要になることがあります。 Epoxyを使い続ける限り、XMLレイアウトのメンテナンスも続きます。 こういった都合もあり2025年あたりから機能開発で触らない箇所も積極的にComposeへ置き換える方針を明確にしました。 実際、2026年8月にはアプリAでAGP 9.xとKSP2に対応するため、Epoxyを5.0.0から5.2.1に上げています。 KSP2との相性やコード生成の不具合を避けるための作業で、Epoxyのファイルは1つも減っていません。 進み具合を把握するため、2026年3月からは移行状況をほぼ毎週計測してAndroid定例で共有するようにしました。 計測の仕組み Claude Codeスキルによる計測 計測はClaude Codeのスキル /android-compose-kpi として作成し、各アプリのリポジトリに対して grep と find でファイル数を数えるようにしました。 数えるだけならシェルスクリプトでも足ります。 Claude Codeを使っているのは、数字が増減したときに、理由になったコミットをgitの履歴から調べてレポートに書くところまで任せられるからです。 SKILL.md に全体の流れを書いて、1アプリ分の計測手順は agents/kpi-measurer.md に分けています。 サブエージェントからの応答形式は KEY: 値 で固定して、5アプリ分の結果をMarkdownのレポートにまとめる処理を、ほぼ毎週実行しています(祝日や繁忙期は計測しない週もありました)。 指標は次の8つです。 実際のコマンドは、記事の最後の付録に載せています。 指標 数え方 Epoxy バージョン libs.versions.toml や build.gradle から検出 Epoxy 使用ファイル数 com.airbnb.epoxy を含む .kt EpoxyController 数 EpoxyController を含む .kt EpoxyModel 数 @EpoxyModelClass などを含む .kt EpoxyHolder 数 EpoxyHolder を含む .kt Compose ファイル数 @Composable を含む .kt(画面以外の部品やテストも含む) XML レイアウト数 res/layout*/ 配下の .xml Epoxy 依存モジュール数 epoxy を参照する Gradle ファイル ハマったところ build/ を除外し忘れていたり自動生成コードが入ってしまったりで、集計ごとに数が増減して最初は安定しませんでした。 1〜2週回すとミスにも気づけて、次の点に気をつけて計測するようにしました。 ...

2026年11月17日 · 読了時間: 2分 · 竹中 貴哉
変更した行だけを見る品質ゲート

テストが2441個あってカバレッジ9.5% ── 全体の数字を諦め、変更した行だけを見る品質ゲートに切り替えた

はじめに テストカバレッジのゲートを3つのサイトに入れた記録です。 同じドメインで連携する3つのNext.jsサイト(利用者向け / 提供者向け / 社内管理画面)を運用しています。カバレッジを測る設定は、利用者向けでは5月、社内管理画面では6月から入っていました。ただし閾値もCI連携もなく「測れるが誰も追っていない」状態でした。提供者向けでは、計測とゲートを同じ日に入れています。 半期の計画でカバレッジ向上に取り組むことが決まり、まず現状を測るところから始めました。 実測したところ、社内管理画面は テストが2441個あって、カバレッジ9.5% でした。この数字を前にして「まず全体80%を目指そう」と言っても、誰も動きません。 そこで全体の数字を目標にするのをやめ、「変更した行」だけを見るゲートに切り替えました。 この記事で得られること テスト数とカバレッジが比例しない理由と、計測対象の決め方 全体のカバレッジをゲートにすると何がうまくいかないか(未使用コードを消すと率が下がる問題) 変更した行のカバレッジをゲートにする設計と、全体の数字をこれ以上下がったら止める「下限」として使う考え方 外部のカバレッジサービスを使わず、CI内で完結させる実装 計測から外すファイルを決めないと数字が実態とずれる話 既存コードの多いリポジトリで、止めずにゲートを入れる段階の踏み方 1. 3サイトのカバレッジ実測値 まず現状を測りました。CIと同じ環境変数で、全テストが通る状態での実測値です。 Lines Statements Functions Branches テスト規模 社内管理画面 9.5% 9.5% 7.1% 8.4% 176ファイル / 2441テスト 利用者向け 26.8% 26.3% 20.0% 24.2% 70ファイル / 908テスト 提供者向け 34.3% 34.5% 28.9% 32.1% 45ファイル / 625テスト 目を引くのは社内管理画面です。テストが一番多いのに、カバレッジが一番低くなっています。 テストの数とカバレッジが比例しない理由 原因はテストの置き場所が偏っていたことでした。導入時のコミットで測り直し、テストと計測対象の行を突き合わせると、こうなっていました。 1 2 3 4 5 6 7 8 2441テストの内訳 入力チェックの定義(zodのスキーマ)のテスト 1358 自動生成されたAPIクライアントのテスト 195(自動生成コードは計測対象外) その他 888 計測対象 18981行の内訳 入力チェックの定義 143行 74.1%がテストで実行された 画面のコンポーネント 13910行 4.4%がテストで実行された テストの半分以上が入力チェックの定義に集まっていました。定義は1つが数行にまとまるので、計測対象の行数では143行、全体の1%もありません。一方、計測対象の7割以上を占める画面のコンポーネントは、ほとんどテストで実行されていませんでした。 ...

2026年11月16日 · 読了時間: 5分 · 福士宗介