はじめに

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週回すとミスにも気づけて、次の点に気をつけて計測するようにしました。

  • kaptやKSPの生成コードを含む build/ とモジュール生成用の雛形を置く template/ は除外する
  • 最新の develop で数える。作業中のブランチが残っているときは、origin/develop を一時ディレクトリに展開して数える(11月からはスキルの手順にも組み込みました)
  • 増減の理由になったコミットをレポートに書く

3月から11月までの計測結果

3月26日以降の、Epoxy使用ファイル数の推移です。 計測のない週は、前後の点を直線でつないでいます。

Epoxy 使用ファイル数(5アプリ合計)の推移。3月26日の308から11月2日の206まで減少し、8月10日から9月7日までは4回連続で270のまま横ばいだった

アプリ3/2611/2増減
アプリA5137-14
アプリB141129-12
アプリC4620-26
アプリD420-42
アプリE2820-8
合計308206-102

数値は定例で共有

計測結果はそのつどAndroid定例で共有しました。 機能開発のついでではなく、意識してCompose化に着手する機会が増えました。 数字が動かない週も、「最近止まっているので頑張っていきたいですね」くらいの声かけにとどめています。

8月10日から9月7日までの4回の計測(8月17日は計測なし)では、合計が270のまま変わりませんでした。 ただ、developのEpoxy使用ファイル数を数えているので、ブランチ上の作業は数字に出ません。 あとで確認すると、この期間もアプリCではビューワー移行のブランチで作業が続いていて、9月14日の計測で反映されました。

9月28日の計測では、アプリDのビューワー移行とアプリEのマイページの移行が入っています。 10月5日の計測で、アプリDのEpoxy依存が完全になくなりました。

ふりかえり

計測して作業を見える化したことで、移行の進み具合をもとに次の動きを決められるようになりました。

おわりに

grepとfindによる集計だけの仕組みですが、ほぼ毎週スキルを回して結果を定例で共有したことにより、移行を意識して進められるようになりました。 日々の開発の中で少しずつJetpack Composeへ移行しているチームがあれば、まずは計測から始めてみてください。

付録

計測コマンド

agents/kpi-measurer.md のコマンドを、作業ツリーを変更せずに手元で実行できるスクリプトとしてまとめ直しました。 origin/develop の内容を一時ディレクトリに展開して数えるので、作業中のブランチや未コミットの変更は数に入りません。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
#!/usr/bin/env bash
# 使い方: ./count.sh <リポジトリのパス>
set -eu
PROJECT_PATH="$1"

# origin/develop の内容を一時ディレクトリに展開する(作業ツリーには触れない)
WORK=$(mktemp -d)
trap 'rm -rf "$WORK"' EXIT
git -C "$PROJECT_PATH" fetch origin develop
git -C "$PROJECT_PATH" archive --format=tar -o "$WORK/src.tar" origin/develop
mkdir "$WORK/src"
tar -xf "$WORK/src.tar" -C "$WORK/src"
SRC="$WORK/src"

# kapt や KSP の生成コードを含む build/ と、雛形を置く template/ は除外する
count_kt() {
  grep -rlE --exclude-dir=build --exclude-dir=template --include="*.kt" "$1" "$SRC" | wc -l | tr -d ' '
}

echo "Epoxy 使用ファイル数: $(count_kt 'com\.airbnb\.epoxy')"
echo "EpoxyController 数: $(count_kt 'EpoxyController')"
echo "EpoxyModel 数: $(count_kt '@EpoxyModelClass|@EpoxyAttribute|EpoxyModel')"
echo "EpoxyHolder 数: $(count_kt 'EpoxyHolder')"
echo "Compose ファイル数: $(count_kt '@Composable')"
echo "XML レイアウト数: $(find "$SRC" \( -name build -o -name template \) -prune -o -path '*/res/layout*' -name '*.xml' -print | wc -l | tr -d ' ')"
echo "Epoxy 依存モジュール数: $(grep -rl --exclude-dir=build --exclude-dir=template --include='*.gradle' --include='*.gradle.kts' 'epoxy' "$SRC" | wc -l | tr -d ' ')"
echo "Epoxy バージョン:"
grep -rh --exclude-dir=build --exclude-dir=template --include='*.toml' --include='*.gradle' --include='*.gradle.kts' 'epoxy' "$SRC" | head -5

返却フォーマット

サブエージェントは、計測結果を次の形式で返します(EpoxyとComposeに関係する項目だけを抜粋)。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
PROJECT: $PROJECT_NAME
STATUS: completed
EPOXY_VERSION: [バージョン文字列]
EPOXY_FILES: [数値]
EPOXY_CONTROLLERS: [数値]
EPOXY_MODELS: [数値]
EPOXY_HOLDERS: [数値]
XML_LAYOUTS: [数値]
COMPOSE_FILES: [数値]
EPOXY_GRADLE_MODULES: [数値]

記載されている会社名、製品名、サービス名は、各社の商標または登録商標です。