Share
Embed
KotlinFest2026 切断・再接続・認証…BLEの修羅場をKotlin TCAで乗り切る
KotlinFest2026の登壇スライドです
車載機器と連携する「コンパニオンアプリ」開発では、Bluetooth / BLEの状態管理が開発者を悩ませ続けています。
非同期に発生する接続状態の遷移、予期せぬ切断、認証フロー(Trusted Device Flow等)を絡めたハンドシェイクなど、複雑な状態管理を破綻させずに実装するのは容易ではありません。本セッションでは、Swiftエコシステムで人気の「TCA(The Composable Architecture)」に着目し、筆者が携わるAndroid Automotive OS(AAOS)とCompanion Device Connectivity(CDC)を用いた車載コンパニオンアプリPoCで得た知見をもとに、TCAの単方向データフロー(UDF)と副作用(Effect)の管理機構を活用してBLE通信を美しく、テスト可能で、堅牢なアーキテクチャに落とし込む方法を検証・解説します。
想定聴講者: Kotlinを業務・個人開発で使用し、より深く理解したい方(脱初級者を目指す方)
jun kurumada
November 13, 2026
Transcript
50 slides
-
切断・再接続・認証… BLEの修羅場を Kotlin TCA で乗り切る KotlinFest 2026 車田 巡(Jun Kurumada)
/ 八幡 勇樹(Yuki Yawata) マツダ株式会社 クルマ開発本部 コネクティッドソフトウェア開発グループ M A Z DA M OTO R CO R P O RAT I O N -
本日のテーマ 切断・再接続・認証…BLEの修羅場を Kotlin TCA で乗り切る || AndroidアプリにKotlin TCA 採用の経緯として、SwiftUIの画面 状態遷移が扱いやすいTCA
(The Composable Architecture)を BLE の状態遷移で応用してみた話 M A Z DA M OTO R CO R P O RAT I O N 2 -
自己紹介 車田 巡(メインスピーカー) ・マツダ株式会社 クルマ開発本部 コネクティッドソフトウェア開発グループ ソフトウェアエンジニア / システムアーキテクト ~メガベン~日系
or 外資系SIer・フリーランス … etc ➢ ネイティブモバイルアプリ/ Web系開発:通算 約10年 ➢ クラウドインフラ構築:通算 約15年 ➢ MLDL|NLP|LLM|AI Agent / BackOffice FMS|SCM|WMS|CTI|CRM …etc 八幡 勇樹(サポート) ・マツダ株式会社 クルマ開発本部 コネクティッドソフトウェア開発グループ アシスタントマネージャー ~ ソフトウェアハウス・フリーランス・独立系SIerを経て現職 ➢ 組み込みソフトウェア開発:約22年 ➢ Android/AAOS開発:約12年 ➢ C/C++、Java/Kotlinによる開発・不具合解析、Frameworks~下位層の技術調査 M A Z DA M OTO R CO R P O RAT I O N 3 -
今日持ち帰っていただけること 本セッションで扱う BLE は、アプリが Bluetooth/GATT を直接操作するものではなく、 Google の Companion Device
SDK が接続・鍵交換・再接続を担い、アプリがそのコールバックを受け取る構成です ① TCA の実践的な適用パターン BLE の複雑な状態管理を整理するために、State / Action / Reducer / Effect を Kotlin の型機能( fun interface ・ out ・ Nothing など)でどう書くか。 Companion Device SDK のような非決定的な I/O を Effect にして、状態遷移を判断する Reducer から分離する形で示します。 ② BLE イベントを TCA で易しく実装してみる 接続失敗・切断・結果の遅延・車両の無応答を受けたときのアプリの振る舞いを、 仮想時間を使った JVM のユニットテストで再現する方法。通信そのものは実機で確かめます。 ③ TCA は効いたのか、なぜ Kotlin で広まらないのか 導入して効いたこと・効かなかったことを一覧にし、最後に、広まらない理由を考察します。 M A Z DA M OTO R CO R P O RAT I O N 4 -
アジェンダ 内容 前提 コンパニオンデバイスMobileアプリの役割と、スマホと車両(AAOS)の関係 ピュア BLE ではなく Companion Device SDK
を使う理由(実機テストの環境) なぜ「修羅場」になるのか、素朴な実装の問題(同時に動く 4 つの状態) TCA の概要と採用理由、パッケージ構成 ① TCA の実践的な適用パターン TCA のコアを Kotlin で書く fun interface / out A / Nothing / Job ② BLE イベントを TCA で易しく実装してみる ②-1 コールバックとペアリング ②-2 ユニットテストのポイント ②-3 ペアリングのデモ ③ TCA は効いたのか、なぜ Kotlin で広まらないのか 良かった点・悪かった点、広まらない理由の考察 / まとめと結論 M A Z DA M OTO R CO R P O RAT I O N 5 -
前提 コンパニオンデバイスMobileアプリと車両、BLE の「修羅場」、TCA の概要 M A Z DA M OTO
R CO R P O RAT I O N 6 -
前提:センターディスプレイと、コンパニオンデバイスMobileアプリ 本セッションは、スマートフォンで動く「コンパニオンデバイスMobileアプリ」 (以下、アプリ)についての説明です。 車両側(AAOS の CompanionDeviceSupport)は AOSP の実装をそのまま使っているので、説明の範囲外です。 ※ 名前の
Companion は、Kotlin の companion object とは別のものです 左:センターディスプレイ(車両側。AAOS で動き、乗車後は PIN で保護) 右(緑の枠):コンパニオンデバイスMobileアプリ(デモの最後の、車両と接続した状態の画面) M A Z DA M OTO R CO R P O RAT I O N 7 -
Android Automotive OS(AAOS)とは AAOS は、クルマのセンターディスプレイで動く Android スマホの画面を映す Android Auto と違い、車両に組み込まれ
た OS Google 搭載のマツダ車の一部は、AAOS を採用している ※ 但し、本アプリの機能は PoC 段階で、搭載していません AAOS のアプリ開発にも Kotlin を使う スマホと同じ Android の API と Jetpack で書く 今日は、車載アプリの話はしません。 お話しするのは、スマホで動くアプリの話です。 AAOS の画面の例 出典:Android Developers「Android Automotive OS の概要」 (CC BY 4.0) M A Z DA M OTO R CO R P O RAT I O N 8 -
アプリの役割について AAOS(Android Automotive OS)は、車載インフォテインメントで動く Android センターディスプレイは、Android と同じプロファイルロック(PIN / パターン /
パスワード)で保護される ロック中はセンターディスプレイの機能を使えないので、乗車後に PIN を入力して解除する プロファイルロックを「なし」にすれば PIN は不要になるが、保護も無くなる アプリは、手元のスマホを、センターディスプレイのプロファイルロックを解除する「鍵」にするアプリ(=ドアの鍵ではない) 本セッションの「解錠」は、このプロファイルロックの解除のこと AAOS 側の機能名は "Unlock profile with phone"(Trusted Device) アプリが無い場合 アプリがある場合 乗るたびに、センターディスプレイで PIN を入力する。 入力するところを同乗者に見られ、PIN を知られるおそ れもある。 Trusted Device として登録したあとは、ペアリング済 みのスマホの画面ロックを解除すると、AAOS のロック が自動で解除される。車の画面で PIN を入力しなくて よい。 Android 版 SDK の既定では、スマホの画面ロックの 解除が条件。 M A Z DA M OTO R CO R P O RAT I O N 9 -
録画:PIN 入力あり / なしの比較 ① コンパニオンデバイスMobileアプリ無し: 解除のたびに PIN を入力する 0:00
/ 0:10 M A Z DA M OTO R CO R P O RAT I O N ② コンパニオンデバイスMobileアプリ有り: ペアリング済みのスマホの画面ロックを解除すると、AAOS のロ ックが自動で解除される 0:00 / 0:05 10 -
Companion Device SDK を使う理由 前提:今回の構成では、OS に組み込まれた CompanionDeviceSupport が、AAOS のプロファイルの解錠を担う (AOSP
の実装をそのまま使い、車両側は作らない)。 そのため、スマホ側は CompanionDeviceSupport のプロトコルに合わせる必要がある。 選択肢 自前の GATT サービスと QR / PIN ペアリング (PoC の初期に作り、廃止した構成) Android 標準の CompanionDeviceManager を直接使 う 判断 理由 却下 車両側の CompanionDeviceSupport はこの GATT を知らないので、AAOS の車両とは通信できな い。 鍵交換の安全性も自分たちで保証する必要がある 却下 OS の API が扱うのは機器の選択と関連付けまで。 暗号化、Escrow Token の登録、解錠の要求は含まれないので、SDK と同じ処理を自分で書くことに なる CompanionDeviceSupport と同じプロトコルを実装したスマホ側の OSS。 Google Companion Device SDK 採用 UKey2 から解錠の要求まで SDK の中で完結する。 機器の選択には、SDK が内部で CompanionDeviceManager を使う 制約事項: SDK 仕様に合わせてアプリを作る必要がある SDK側が非対応のためBLEの距離の判定は不可となるが、機能上影響は限定的のため許容する。 M A Z DA M OTO R CO R P O RAT I O N 11 -
実機テストの環境:Raspberry Pi(AAOS 15) Android Automotive OS(AAOS)15 + CompanionDeviceSupport イメージを焼いた Raspberry
Pi と Android 端末を使用 車両側:AAOS に常駐するサービス (AOSP の CompanionDeviceSupportとTrustAgentService)を有効化 スマホ側:アプリに組み込む別パッケージ(Companion Device SDK)で通信 Raspberry Pi とスマホで、ペアリング(照合コードと QR コード)、切断と再接続、 Trusted Device の登録と解錠を確認 Raspberry Pi は車両の ECU(Electronic Control Unit)とは今回接続しない AOSP の CompanionDeviceSupport(2025 年時点)の実装では、関連付けられるスマホは 1 台まで(1 対 1)。別のスマホを使うに は、今の登録を外す M A Z DA M OTO R CO R P O RAT I O N 12 -
なぜ「修羅場」になるのか 4 つの状態が、それぞれ別々のコールバックで五月雨に届く 接続(BLEConnectionState) 関連付け(AssociationState) Disconnected connect() Trusted Device(EscrowTokenState) Idle
Connecting disconnect() associate() 解錠の表⽰(CDCLockState) cancelAssociation() onConnected() disconnect() None InProgress connect() Bluetooth OFF onDisconnected() connect() Bluetooth OFF 6 回⽬の onDisconnected() Failed M A Z DA M OTO R CO R P O RAT I O N cancelAssociation() enroll() onEnrollmentRequested() onEnrollmentFailure() Connected onAuthStringAvailable() onConnected() onDisconnected() SDK の⾃動再接続 アプリ起点でない切断 Reconnecting onDisconnected() 回数 +1 cancelAssociation() 再試⾏の前に戻す onUnenroll() unenroll() Renewing onAssociated() QR コードの場合 onAssociated() Completed PairingCodeAvailable onDiscoveryFailed() 機器選択の中断 60 秒で候補なし onAssociationFailed() 引数なし onEnrollmentSuccess() Locked onUnlockingSuccess() onUnlockingFailure() Unlocked Valid AssocFailed 13 -
アプリ側で状態管理が必要な理由 コールバックがいつ、何回、どの順で、どんな理由で届くかを、知る術がない。 onDisconnected() は、アプリが切断していなくても呼ばれる イベント発火時の理由が得られない。 本アプリが使う SDK 3.3 系の onAssociationFailed()
は引数が無く、 onDisconnected() も切断の理由を渡さない SDK の内部では Bluetooth のスレッドも動いている コールバックはメインスレッドで届くが、届くタイミングと順番は不明。 このような入力は、今の状態と、届いた入力の組み合わせで、 次にどうするかを決める必要がある(いわゆるステートマシン)。 これらの判断を TCA の Reducer(State と Action から次の State を返す関数)1 か所にまとめている。 M A Z DA M OTO R CO R P O RAT I O N 14 -
素朴な実装が破綻する 3 つの理由 // よくある素朴な実装(説明用の例。本アプリのコードではない) manager.registerCallback(object : Callback { override
fun onConnected(car: AssociatedCar) { _connected.value = true if (isEnrolling) { // フラグ trustedDevice.enroll(car.deviceId) } } override fun onDisconnected(car: AssociatedCar) { _connected.value = false if (!userInitiated) { // フラグ retryCount++ // 可変の変数 scheduleReconnect() } } override fun onAssociationFailed() { // 引数なし。理由が分からない _error.value = "failed" } }) M A Z DA M OTO R CO R P O RAT I O N ① 状態が複数の変数に散らばる isEnrolling / userInitiated / retryCount / _connected の 組み合わせでしか、今の状態が分からない。 ② 失敗が文字列になる 再試行させるべきか、設定を開かせるべきかを、画面の側で判断でき ない。 ③ テストに実機が必要になる コールバックの中で状態を直接書き換えるので、切断を試すには、実 際に車から離れるしかない。 (Repository と Fake に分ければ、TCA でなくても解決できる) 今の状態が 1 つのデータにまとまっておらず、コールバックごとに別々 の変数を書き換えている。 15 -
MVVM + Flow + コルーチンと比べると TCA ってなに? MVVM + Flow
+ コルーチンを素直に書くと タイミングもバラバラ(来ない・遅れる・⼊れ替わる) ViewModel A の StateFlow 認証イベント ViewModel B の StateFlow カオスな BLE (SDK のコールバック) 接続イベント iOS 版と Android 版の組み合わせ ペアリングイベント 画⾯のフラグ・変数 どこで状態が変わったか追えない TCA の形にすると(すべて Action にして、1 か所で判断する) 画⾯ UI = f(state) 操作 → Action ⼀⽅通⾏ State(1 つだけ) 認証 → Action 次の State Reducer 単⼀の確からしい ステートマシン 接続 → Action ペアリング → Action Effect (SDK の呼び出し) 戻り値で返す 結果も Action M A Z DA M OTO R CO R P O RAT I O N 画面の状態と、状態を変える処理を、決まった部品に分 けて書く単方向データフローの作り方。 状態を変える入口は、Reducer の 1 か所だけ。 カオスな BLE (SDK の コールバック) 層 iOS Android UI = f(state) SwiftUI Jetpack Compose アーキテク チャ MVVM / TCA(採 用) MVVM / TCA(自前 で実装) 下位層 Companion Device SDK Companion Device SDK Android 版は、iOS 版に合わせて TCA を自前で実装 した。 認証が加わると、上の図の矢印はさらに増える。 TCA で増えるのは、Action と Reducer の分岐だけ。 16 -
TCA(The Composable Architecture)とは Point-Free が Swift 向けに公開しているアーキテクチャ。画面の状態と、状態を変える処理を、5 つの部品に分けて書く。 BLE を
1 つのステートマシンで受けるのは前提で、TCA はそれをアプリ全体でどう扱うかの形。 部品 役割 このアプリでの例 画面 State を表示し、利用者の操作を Action として送る PairingScreen (Jetpack Compose) ViewModel Store を持ち、画面に State と send() を渡す (Android のライフサイクルとつなぐ) PairingViewModel Store State を 1 つだけ持ち、Action を Reducer に渡し、返った Effect を実行する core:tca の Store Reducer (State, Action) → (次の State, Effect のリスト) を返す純粋関数。 状態を変えるのは Reducer だけ PairingReducer Effect 通信などの副作用。 ID を付けてキャンセルでき結果は Action として Store に戻る。 Effect.Run(flow, id) Kotlin / Android で採用した理由 BLE の非決定的なコールバックを、すべて Action として 1 つの Reducer で受けられる 競合する処理のキャンセルを、Reducer の戻り値(Effect)としてテストできる iOS 版(Swift の TCA)と同じ State・Action・Reducer の形で、両 OS を少人数で保守できる Kotlin 版の TCA ライブラリは育っていないので、必要な考え方を自前で実装した M A Z DA M OTO R CO R P O RAT I O N 17 -
TCA の処理の流れ StateFlow を UI が収集 State(不変) 新しい State ユーザー操作
/ BLE イ ベント 結果を Action として send() Action Reducer reduce(State, Action) → (State, List<Effect>) Effect のリスト Effect Store CoroutineScope で Flow を collect VehicleClient (SDK の呼び出し) Action → Reducer → (State, Effect のリスト) → Store が Effect を実行 → 結果がまた Action になる、という 1 本のループ(単方向データフロー:UDF) State は reduce() が返した時点で同期的に更新され、副作用は Flow を collect して非同期に実行される 次の State は Reducer が決め、Store が反映する。切断・失敗・タイムアウトも、すべて Action として入ってくる M A Z DA M OTO R CO R P O RAT I O N 18 -
TCA で何を解決できたか BLE(Companion Device SDK)で困ったことを、TCA の仕組みで次のように解決した。 BLE(SDK)で困ったこと TCA でどう解決したか 解説箇所
コールバックがいつ・どの順で届くかを選べない すべて Action にして、1 つの Reducer で受ける ②-1 コールバック Effect に ID を付け、 Effect.cancel(id) を Reducer の戻り値として 返す ① TCA のコア ②-1 コールバック ステートマシンで結果が出るまで State を確定させない ②-1 コールバック ステートマシンで失敗を sealed interface にし、キャンセルと区別する ②-1 コールバック Reducer を純粋関数にし、 TestStore と Fake と仮想時間で再現する ②-2 ユニットテス ト 接続中に切断されるなど、処理どうしが競合する 承認が車両の画面にあり、結果があとで届く 失敗の理由が分からない( onAssociationFailed() に引数が無 い) 切断・遅延・順番を実機でしか試せない iOS 版(Point-Free の TCA)と、同じ画面の進み方と Action で書ける BLEの実装コードがシンプルになり、BLEに詳しくなくても振る舞いが何となくわかるようになった Android ではライブラリを使わず、自分たちで実装した。 M A Z DA M OTO R CO R P O RAT I O N 19 -
TCA を自分たちで実装した理由 ① まず既存の実装を使うことを検討した TCA の原典は Point-Free の swift-composablearchitecture ③
必要な概念だけを Kotlin で実装した 今回は State / Action / Reducer / Effect と、 テスト用の TestStore のみ 本 PoC の iOS 版はこれを使っている ( @Reducer / @Dependency / TestStore ) Swift 版の中心にある @Reducer は Swift のマクロなので、 Kotlin にそのまま移せない iOS と同じ用語で書くために、まず Kotlin 版の TCA を調べた Swift 版の Effect.run { send in … } は async/await を使 うので、Kotlin では suspend 関数と Flow で書ける ② 調べた既存ライブラリ(2026-09-28 時点) 候補 状況 toggl/komposable-architecture 1.0 未満 (1.0.0-preview04) trading-point/kotlin-composablearchitecture wearemakery/kotlin-composablearchitecture RxJava 3 に依存 リリースなし。 最終コミット 2021 年 Orgmir/kotlin-composable-architecture リリースなし。 最終コミット 2022 年 MVIKotlin / Orbit / Ballast MVI 系で、TCA とは用語が 異なる M A Z DA M OTO R CO R P O RAT I O N Scope / ifLet / @Shared は使わなかった。 DI は Hilt、画面の切り替えは AppState.screen ( AppReducer ) で扱っている ④ 中身はコルーチンと Flow のまま、2 つの約束事を載せた Compose + コルーチン + Flow がダメだったのではない ( Tca.kt の依存は kotlinx-coroutines-core だけ) 状態を変えてよい場所は 1 か所(Reducer)だけ 副作用(Effect)は、その場で実行せず、Reducer の戻り値として 返す 20 -
アプリのパッケージ構成:Gradle モジュールと依存 矢印は Gradle の依存( implementation 、点線はテスト用)。 ブルー=TCA の部品、オレンジ=SDK との境界、グレー=テスト用。
:app MainActivity / AppViewModel AppReducer(AppState / AppAction) アプリ全体の画⾯と接続状態 transport/ CompanionConnectionManager (SDK を import する唯⼀のファイル) Companion Device SDK connectionservice 3.3.9 :feature:* 画⾯ごとのモジュール(…Screen → …ViewModel → …Reducer) :feature:pairing PairingReducer (State / Action) :feature:trusted-device TrustedDeviceReducer (State / Action) :feature:status StatusReducer (State / Action) :feature:settings SettingsReducer (State / Action) Jetpack Compose / Hilt 画⾯と ViewModel だけが使う :feature:log / :feature:vehicles は Screen だけ(Reducer なし) :core:tca Store / Reducer / Effect cancellable / runSuspendCatching :core:vehicle-client VehicleClient VehicleAssociationClient :core:model BLEConnectionState / BleFailure AssociationState / EscrowTokenState :core:tca-testing TestStore :core:vehicle-client-testing FakeVehicleClient ほかの :core :core:security-client / :core:telemetry M A Z DA M OTO R CO R P O RAT I O N kotlinx-coroutines-core :core:tca の依存はこれだけ 21 -
① TCA の実践的な適用パターン TCA のコアを Kotlin で書く M A Z
DA M OTO R CO R P O RAT I O N 22 -
① TCA の実践的な適用パターン TCA のコアの型を Kotlin で書く( fun interface /
out A / Nothing / Job ) 今回の説明範囲:コンパニオンデバイスMobileアプリ ⾞両(AAOS の Companion Device SDK CompanionDeviceSupport) アプリ(TCA) ① 探索‧接続 onConnected ② 関連付け onAuthStringAvailable onAssociated ③ Trusted Device 登録 onEnrollmentSuccess ④ 接続ごとの解錠 onUnlockingSuccess ⑤ 切断‧再接続 onDisconnected → Reconnecting M A Z DA M OTO R CO R P O RAT I O N アドバタイズ‧GATT 接続 パッケージ構成(:app / :feature:* / :core:*) :app MainActivity / AppViewModel UKey2‧照合コード (承認は⾞両の画⾯) :feature:* :feature:pairing :feature:trusteddevice transport/ :feature:status Companion Device SDK :feature:settings Jetpack Compose / Hilt kotlinx-coroutines-core Escrow Token UNLOCK_CREDENTIALS (スマホのロック解除が条件) :core:tca :core:vehicle-client :core:model :core:tca-testing :core:vehicle-client-testing ほかの :core SDK が再接続する 23 -
Reducer は fun interface にする fun interface Reducer<S, A> {
fun reduce(state: S, action: A): Pair<S, List<Effect<A>>> } // SAM 変換で、ラムダから Reducer を作れる fun pairingReducer( vehicleClient: VehicleClient, associationClient: VehicleAssociationClient, isDeviceCompromised: suspend () -> Boolean, // 端末の判定も関数として受け取る ): Reducer<PairingState, PairingAction> = Reducer { state, action -> /* when 式が 1 つ */ } typealias Reducer<S, A> = (S, A) -> Pair<S, List<Effect<A>>> でも動くが、 typealias は関数型の別名にすぎない fun interface は独自の型になるので、実装クラスを作ったり、既定の実装を持つメンバーを後から追加したりできる SAM 変換があるので、呼び出し側は Reducer { state, action -> … } とラムダのまま書ける M A Z DA M OTO R CO R P O RAT I O N 24 -
Effect: out A と Nothing と data object sealed interface
Effect<out A> { data object None : Effect<Nothing> data class Run<A>( val flow: Flow<A>, val id: Any? = null, val cancelInFlight: Boolean = false, ) : Effect<A> data class Cancel(val id: Any) : Effect<Nothing> } // ① 共変 // ② Nothing と data object ① out A で宣言しているので、 Effect<Nothing> を Effect<PairingAction> として使える ② Nothing はすべての型の部分型なので、 None と Cancel が Action を出さないことを型で表せる ③ data object は toString() が None になるので、テストの失敗メッセージやログで読める M A Z DA M OTO R CO R P O RAT I O N 25 -
Store: collect した Action を send() に戻す class Store<S, A>(
initialState: S, private val reducer: Reducer<S, A>, private val scope: CoroutineScope, // メインスレッドの Scope ) { private val _state = MutableStateFlow(initialState) private val runningEffects = mutableMapOf<Any, Job>() private val anonymousEffects = mutableSetOf<Job>() private val effectLock = Any() val state: StateFlow<S> = _state.asStateFlow() fun send(action: A) { // メインスレッドから呼ぶ val (newState, effects) = reducer.reduce(_state.value, action) _state.value = newState // State は同期的に確定する effects.forEach { start(it) } } fun cancel(id: Any) { val job = synchronized(effectLock) { runningEffects.remove(id) } job?.cancel() } } private fun launchRun(effect: Effect.Run<A>) { val id = effect.id if (id == null) { // ID の無い Effect は anonymousEffects で管理する return } if (effect.cancelInFlight) cancel(id) val job = scope.launch { effect.flow.collect { send(it) } } synchronized(effectLock) { runningEffects[id] = job } job.invokeOnCompletion { synchronized(effectLock) { if (runningEffects[id] === job) runningEffects.remove(id) } } } Effect の Flow が出した Action を send() に戻すことで、ループがつ ながる cancelInFlight で同じ ID の Effect を入れ替えた直後に、古い Job の 完了通知が遅れて届くことがある。無条件に remove(id) すると、新しい Job の登録を消してしまう そのため、登録されている Job が自分自身( === )のときだけ削除する M A Z DA M OTO R CO R P O RAT I O N 26 -
② BLE イベントを TCA で易しく実装してみる ②-1 コールバックとペアリング / ②-2 ユニットテストのポイント
/ ②-3 ペアリングのデモ M A Z DA M OTO R CO R P O RAT I O N 27 -
②-1 コールバックとペアリング ② BLE イベントを TCA で易しく実装してみる 非決定的な SDK のコールバックを
Flow にして、Effect の外から Action として受け取る。 代表としてペアリングを詳しく見て、切断と失敗は同じ形として短く見る 今回の説明範囲:コンパニオンデバイスMobileアプリ ⾞両(AAOS の Companion Device SDK CompanionDeviceSupport) アプリ(TCA) ① 探索‧接続 onConnected ② 関連付け onAuthStringAvailable onAssociated ③ Trusted Device 登録 onEnrollmentSuccess ④ 接続ごとの解錠 onUnlockingSuccess ⑤ 切断‧再接続 onDisconnected → Reconnecting M A Z DA M OTO R CO R P O RAT I O N アドバタイズ‧GATT 接続 パッケージ構成(:app / :feature:* / :core:*) :app MainActivity / AppViewModel UKey2‧照合コード (承認は⾞両の画⾯) :feature:* :feature:pairing :feature:trusteddevice transport/ :feature:status Companion Device SDK :feature:settings Jetpack Compose / Hilt kotlinx-coroutines-core Escrow Token UNLOCK_CREDENTIALS (スマホのロック解除が条件) :core:tca :core:vehicle-client :core:model :core:tca-testing :core:vehicle-client-testing ほかの :core SDK が再接続する 28 -
SDK を呼ぶ層:コールバックを Flow に変換する Companion Device SDK のコールバック TrustedDeviceFeature.Callback onEnrollmentRequested
/ onEnrollmentSuccess onEnrollmentFailure / onUnenroll onUnlockingSuccess / onUnlockingFailure ConnectedDeviceManager.Callback onConnected / onDisconnected onAssociationStart / onDeviceDiscovered onAuthStringAvailable / CompanionConnectionManager tryEmit() MutableSharedFlow<TrustResult> extraBufferCapacity = 8 DROP_OLDEST value = ... MutableStateFlow<EscrowTokenState> value = ... MutableStateFlow<AssociationState> value = ... MutableStateFlow<BLEConnectionState> アプリ層 VehicleClient / VehicleAssociationClient Effect.observe(flow).cancellable(id) Reducer Store の StateFlow<State> onAssociated onAssociationFailed / onDiscoveryFailed trySend() Channel<IntentSender> Channel.CONFLATED 機器選択の起動 MainActivity (AssociationHost) SDK を import しているのは CompanionConnectionManager.kt の 1 ファイルだけ。 アプリの他の部分は VehicleClient / VehicleAssociationClient のインターフェースだけを参照する M A Z DA M OTO R CO R P O RAT I O N 29 -
SDK のコールバックを 3 種類の Flow に分ける 性質 使う型 最新の値だけが意味を 持つ状態
MutableStateFlow 溜めて順に届ける出来 事 最新の 1 件だけを使う 要求 MutableSharedFlow(extraBufferCapacity = 8, onBufferOverflow = DROP_OLDEST) Channel(Channel.CONFLATED) 実際のフィールド _connectionState / _associationState / _trustedDeviceState _trustResults (登録と解錠の結果) deviceChoosers (機器選択の IntentSender ) private val _connectionState = MutableStateFlow<BLEConnectionState>(BLEConnectionState.Disconnected) private val _trustResults = MutableSharedFlow<TrustResult>( extraBufferCapacity = 8, onBufferOverflow = BufferOverflow.DROP_OLDEST) private val deviceChoosers = Channel<IntentSender>(Channel.CONFLATED) コールバックをすべて同じ種類の Flow にするのではなく、値の性質で使い分ける _trustResults のバッファは、購読中に続けて届いた結果を受けるためのもの。 replay = 0 なので、購読者がいない間に届いた結果は保持しない M A Z DA M OTO R CO R P O RAT I O N 30 -
ペアリング(SDK の関連付け)の流れ:照合コードの場合 今回の説明範囲:コンパニオンデバイスMobileアプリ ユーザー アプリ(TCA) Companion Device SDK ⾞両(AAOS 15
の CompanionDeviceSupport) 1. 探索と機器選択 startDiscovery(DiscoveryRequest) 1 アドバタイズ(関連付け⽤ Service UUID 5e2a68a4-…) 2 onDeviceDiscovered(IntentSender) 3 OS の機器選択ダイアログ 4 ⾞両を選択 5 associate(AssociationRequest) 6 GATT 接続 7 バージョンと能⼒の交換 8 2. UKey2 鍵交換(SDK の中で完結) ClientInit 9 ServerInit 10 ClientFinished 11 両端で共有鍵と照合コードを導出 3. 照合コードの確認 onAuthStringAvailable(authString) 12 照合コードを表⽰ 13 ⾞両の画⾯にも同じコードを表⽰ 14 「番号が⼀致しています」 15 ⾞両の画⾯で承認 16 ⾞両 ID(暗号化) 17 端末 ID と認証キー(暗号化) 18 鍵交換は SDK の中で完結する。アプリに届く「照合コード」 ( onAuthStringAvailable )と「関連付け完了」 ( onAssociated ) の通知に注目 実機テストでは、AAOS 15 と CompanionDeviceSupport を 組み込んだ Raspberry Pi が相手になる。 ピュアな BLE と Companion Device SDK の違い ピュアな BLE:アプリが GATT 接続・サービスの探索・SMP のペ アリングとボンディング・再接続を書く SDK:GATT 接続の上でアプリ層の関連付け(UKey2 の鍵交換・ 照合コード・車両での承認)と暗号化・再接続を担い、アプリにはコ ールバックだけが届く( createBond や SMP の設定は書かない) 照合コードは通信路では送られない。 両端が UKey2 の鍵交換からそれぞれ導出し、画面上に表示す る 6 桁のコードを人が見比べて一致を確かめる。 SDK の ConnectedDeviceManager には、スマホ側から照合コー ドを承認する公開 API が無い。 onAssociated(AssociatedCar) 19 M A Z DA M OTO R CO R P O RAT I O N 31 -
PairingReducer の実装:1 つの when 式で書く Reducer { state, action ->
when (action) { is PairingAction.Initialize -> if (VehicleCapability.OUT_OF_BAND_ASSOCIATION in associationClient.capabilities) PairingState() to emptyList() // 方法(QR コード / 照合コード)を選ぶまで何も始めない else PairingState(method = PairingMethod.VerificationCode) to startAssociationEffects(associationClient, outOfBandUri = null) // 取り消し・監視・開始 is PairingAction.PairingCodePresented -> state.copy(step = PairingStep.Auth, pairingCode = action.code, errorMessage = null, recovery = null) to emptyList() is PairingAction.ConfirmPairingCode -> state.copy(verifying = true, errorMessage = null, recovery = null) to listOf(confirmAssociationEffect(associationClient)) is PairingAction.AssociationCompleted -> state.copy(step = PairingStep.TokenRegister, verifying = false, errorMessage = null, recovery = null, vehicleName = action.vehicleName ?: state.vehicleName) to listOf(enrollTrustedDeviceEffect(vehicleClient, isDeviceCompromised)) // SDK を呼ぶ前に端末を判定する is PairingAction.AssociationFailed -> state.copy(verifying = false, errorMessage = action.message, recovery = action.recovery) to emptyList() /* ~ 中略 ~ ほかに ScanQrCodeTapped / QrCodeScanned / QrScanCancelled / QrScanFailed / StartVerificationCodeTapped / RetryAssociation / TokenRegistered / TokenRegisterFailed / RetryTokenRegister / Cancel(全 15 種類) */ } } State の変更はすべて copy() で行い、可変のフィールドや synchronized は使わない when で全ケースを処理する必要があるので、Action を追加すると、処理していない分岐をコンパイラが指摘する 登録の Effect は、root 化などの兆候があれば SDK を呼ばずに TokenRegisterFailed を返す M A Z DA M OTO R CO R P O RAT I O N 32 -
切断と再接続を 1 か所で扱う: BLEConnectionState sealed interface BLEConnectionState { data object
Disconnected : BLEConnectionState data object Connecting : BLEConnectionState data object Connected : BLEConnectionState data class Reconnecting(val attempt: Int, val failure: BleFailure) : BLEConnectionState } // ほかに Scanning / Failed(failure) // CompanionConnectionManager の抜粋 private fun noteLinkLost() { if (disconnectExpected) { // アプリが切断した disconnectExpected = false _connectionState.value = Disconnected; return } reconnectAttempt += 1 // アプリ起点でない切断 _connectionState.value = // 6 回目で Failed にする Reconnecting(reconnectAttempt, LinkLost) } ペアリングと同じ形:SDK のコールバックを StateFlow の値にし、Reducer は Action として 1 か所( AppReducer の ConnectionStateChanged )で受ける 同じ onDisconnected() を、アプリが切断したのか、そうでないのかで別の状態にする 再接続は SDK が行い、アプリは回数を数えて表示するだけ M A Z DA M OTO R CO R P O RAT I O N 33 -
BLEの接続の失敗を型で表す: sealed interface の抽象プロパティ sealed interface BleFailure { val userMessage:
String val isRetryable: Boolean // 画面に表示する文言 // 再試行で回復し得るか data object BluetoothDisabled : BleFailure { override val userMessage = "Bluetooth がオフです。設定から有効にしてください。" override val isRetryable = false } data object LinkLost : BleFailure { override val userMessage = "車両との接続が切断されました。再接続しています。" override val isRetryable = true } data class Unknown(val detail: String) : BleFailure { override val userMessage = "予期しないエラーが発生しました。" override val isRetryable = true } } enum ではなく sealed interface にしたのは、ケースごとに値を持てるから(例: Unknown(detail) ) userMessage と isRetryable を抽象プロパティにしているので、ケースを追加したときに実装を忘れるとコンパイルエラーになる 失敗は BLEConnectionState.Failed(failure) と Reconnecting(attempt, failure) に入れて運ぶ M A Z DA M OTO R CO R P O RAT I O N 34 -
②-2 ユニットテストのポイント 今回の説明範囲:コンパニオンデバイスMobileアプリ ⾞両(AAOS の Companion Device SDK CompanionDeviceSupport) アプリ(TCA)
テストでは SDK と⾞両の代わりに FakeVehicleClient が応答する ① 探索‧接続 onConnected ② 関連付け onAuthStringAvailable onAssociated ③ Trusted Device 登録 onEnrollmentSuccess ④ 接続ごとの解錠 onUnlockingSuccess ⑤ 切断‧再接続 onDisconnected → Reconnecting アドバタイズ‧GATT 接続 パッケージ構成(:app / :feature:* / :core:*) :app MainActivity / AppViewModel UKey2‧照合コード (承認は⾞両の画⾯) :feature:* :feature:pairing :feature:trusteddevice transport/ :feature:status Companion Device SDK :feature:settings Jetpack Compose / Hilt kotlinx-coroutines-core Escrow Token UNLOCK_CREDENTIALS (スマホのロック解除が条件) :core:tca :core:vehicle-client :core:model :core:tca-testing :core:vehicle-client-testing ほかの :core SDK が再接続する 接続失敗・切断・結果の遅延・車両の無応答を、 FakeVehicleClient と仮想時間の JVM テストで再現する。 M A Z DA M OTO R CO R P O RAT I O N 35 -
ユニットテスト:失敗をコードで再現する TrustedDeviceReducerTest のテスト 端末ロック要求の設定に失敗した ① Reducer の純粋関数テスト(JUnit) reducer.reduce(state, action) らトグルを切り替えない
State と Effect の数を検 証 ② TestStore のシナリオテスト(runTest) store.send(Action) { 期 待する State } store.receive(Action) { 期待する State } store.finish() ③ FakeVehicleClient で SDK の前提を再現 enrollError(失敗) enrollLatencyMs(遅 延) enrollCallbackOrder (順番) advanceTimeBy() で 仮想時間を進める // 失敗を仕込む(実機も電波の操作も要らない) fakeClient.deviceUnlockRequiredError = IllegalStateException("切断中") val store = TestStore( TrustedDeviceUiState(), trustedDeviceReducer(fakeClient) { deviceCompromised }, backgroundScope) // 仮想時間で動き、テスト終了時に破棄される // 送った時点では State を変えない store.send(SetDeviceUnlockRequired(true)) store.receive(DeviceUnlockRequirementFailed(msg)) { it.copy(errorMessage = msg) } // 失敗したので、トグルは元のまま assertFalse(store.state.isDeviceUnlockRequired) store.finish() // 受け取っていない Action が残れば失敗 finish() は、受け取っていない Action が残っていれば失敗さ せる(そのあとに届く分は見ない) ユニットテストで確かめるのは状態遷移と Effect まで。 BLE の実機は使わない(実機テストは別に行う) M A Z DA M OTO R CO R P O RAT I O N 36 -
TestStore の設計 本番の Store との違い 決めたこと 本番の Store は、Effect が出した
Action を自動で send() に Effect.observe のように終わらない Flow は、 finish() で止め 戻す。 る。 そのため、どの Action がどの順で戻ってきたかをテストから確認 できない。 すべての Effect の終了を求めると、監視の Effect を持つ Reducer のテストが書けなくなるので、保証するのは 「受け取っていない Action を残さないこと」だけにした。 TestStore は、Effect が出した Action を Channel(Channel.UNLIMITED) に入れる。 テストは receive() で 1 つずつ取り出し、 そのたびに State の変化を確認する。 fun finish() { val unreceived = generateSequence { pending.tryReceive().getOrNull() }.toList() cancelAll() if (unreceived.isNotEmpty()) throw AssertionError("受け取られていない Action が ${unreceived.size} 件残っています。…") } runTest の backgroundScope を渡すと、テスト終了時に Effect が破棄され、 delay は仮想時間で進む receive() は既定で 5 秒(仮想時間)待ち、届かなければ「Effect が起動されていないか、Action を放出していない可能性があります」と 理由を付けて失敗する M A Z DA M OTO R CO R P O RAT I O N 37 -
TestStore のシナリオテスト @Test // TrustedDeviceReducerTest より(文言は message に省略) fun `履歴の取得に失敗しても見えている履歴を消さない`()
= runTest { val shown = listOf(Instant.parse("2026-01-10T09:00:00Z")) fakeClient.historyError = IllegalStateException("圏外") val store = TestStore( initialState = TrustedDeviceUiState(isUnlockHistorySupported = true, unlockHistory = shown), reducer = trustedDeviceReducer(fakeClient) { deviceCompromised }, scope = backgroundScope, ) store.send(TrustedDeviceAction.RefreshUnlockHistory) store.receive(TrustedDeviceAction.UnlockHistoryFailed(message)) { // message は「解錠履歴を取得できませんでした。…」 it.copy(errorMessage = message) } assertEquals(shown, store.state.unlockHistory) // 失敗しても、表示中の履歴は消さない store.finish() } Fake に例外を入れて、失敗の Action が返ること、State がどう変わるか、表示中のデータが残ることを順に確認する M A Z DA M OTO R CO R P O RAT I O N 38 -
VehicleClient と、SDK の前提を再現する FakeVehicleClient インターフェース( core:vehicle-client ) interface VehicleClient {
val capabilities: Set<VehicleCapability> // 機能の有無 fun observeVehicleState(): Flow<VehicleState> fun observeConnectionState(): Flow<BLEConnectionState> fun observeTrustedDeviceState(): Flow<EscrowTokenState> fun observeTrustResult(): Flow<TrustResult> suspend fun connect() // SDK の Lifecycle を開始する suspend fun disconnect() suspend fun enrollTrustedDevice() suspend fun unenrollTrustedDevice() suspend fun unlockHistory(): List<Instant> suspend fun isDeviceUnlockRequired(): Boolean suspend fun setDeviceUnlockRequired(required: Boolean) suspend fun lockDoors() // 未実装(例外を投げる) } テスト用の実装( core:vehicle-client-testing ) class FakeVehicleClient(…) : VehicleClient { val connectionState = MutableStateFlow<BLEConnectionState>(Disconnected) var enrollError: Throwable? = null var enrollLatencyMs: Long = 0 // 結果はあとで届く var enrollCallbackOrder = CallbackOrder.StateFirst override suspend fun enrollTrustedDevice() { trustedDeviceState.value = EscrowTokenState.Renewing delay(enrollLatencyMs) // 仮想時間で待つ // 状態の通知と、戻り(または例外)を // enrollCallbackOrder の順に行う } /* … */ } connectionState.value = Reconnecting(1, LinkLost) ⇒ BLEの切断を再現できる。 機能の有無は capabilities で判断し、実装クラスの型では分岐しない。 SDK 経路の capabilities は TRUSTED_DEVICE / AUDIT_LOG / OUT_OF_BAND_ASSOCIATION (QR コードでの関連付け)で、 DOOR_LOCK は無い ( lockDoors() は UnsupportedOperationException ) 関連付け(探索と照合)は VehicleAssociationClient ( startAssociation(outOfBandUri) など)に分けている。 M A Z DA M OTO R CO R P O RAT I O N 39 -
タイムアウトを仮想時間でテストする: advanceTimeBy @Test // PairingReducerTest より fun `照合コードを承認しても車両が応答しなければ 15 秒で失敗にする`()
= runTest { // 車両が応答しない:照合コードを出したまま、完了も失敗も届かない fakeAssociationClient.associationFlow = MutableStateFlow(AssociationState.PairingCodeAvailable("482913")) val store = TestStore(PairingState(step = Auth, pairingCode = "482913"), reducer, backgroundScope) store.send(PairingAction.ConfirmPairingCode) { it.copy(verifying = true) } advanceTimeBy(AUTH_TIMEOUT_MS - 1) runCurrent() store.assertNoPendingActions() // 仮想時間で 14.999 秒進める。実時間は待たない // まだ待っている advanceTimeBy(1) // 15 秒ちょうど runCurrent() store.receive(PairingAction.AssociationFailed(NO_RESPONSE_MESSAGE)) { it.copy(verifying = false, errorMessage = NO_RESPONSE_MESSAGE, recovery = Retry) } assertEquals(AUTH_TIMEOUT_MS, currentTime) store.finish() } withTimeoutOrNull(15 秒) も delay と同じスケジューラーで動くので、 advanceTimeBy で時計を進めるだけで打ち切りが起きる assertNoPendingActions() は、このテストのために TestStore に足した。 「まだ何も届いていない」ことを途中で確かめる iOS 版は TestClock の advance(by: .seconds(15)) で同じことを確かめている M A Z DA M OTO R CO R P O RAT I O N 40 -
②-3 ペアリングのデモ:照合コードと QR コード 利用者の操作 照合コード QR コード(SDK の Out-of-Band
関連付け) 車両とスマホに同じ 6 桁の番号が出るので、一致を 確かめて車両の画面で承認する 車両の画面の QR コードを、スマホのカメラで読み取る。照合コードの確認は無い SDK の API (Android) のまま) SDK の API(iOS) 既定の関連付け AssociationState DiscoveryRequest / AssociationRequest (既定 InProgress → PairingCodeAvailable → Completed UriElements.decodeFrom() で QR コードの URL を読み、 DiscoveryRequest.deviceIdentifier で探索先をその車両に絞り、 AssociationRequest.oobData に暗号鍵を渡す OutOfBandAssociationDataSource / scanForCarsToAssociate(outOfBandSource:) InProgress → Completed (照合コードは出ない) Reducer の入口 StartVerificationCodeTapped ScanQrCodeTapped → QrCodeScanned(payload) 再試行 同じ方法で探索をやり直す 同じ中身は使わず、読み取り直す(QR コードは車両側で作り直されることがある) QR コードを選べるのは、 capabilities に OUT_OF_BAND_ASSOCIATION がある経路だけ。 方法を選ぶまで探索は始めない(先に始めると、OS の機器選択ダイアログが読み取り画面に重なる) カメラ(Android は CameraX + ML Kit、iOS は AVFoundation)は画面が扱う。 Reducer は、読み取った文字列を QrCodeScanned で受け取るだけ QR コードの中身は暗号鍵を含むので、ログにもテレメトリにも送らない。 関連付け用ではない QR コードは InvalidQrCode として理由を出す Android では、SDK の送信が止まる不具合を避けるために関連付けを見張り、20 秒で終わらなければ照合コードへ案内する ( OutOfBandStalled 。iOS の SDK では起きない) M A Z DA M OTO R CO R P O RAT I O N 41 -
デモ録画:QR コードでペアリングし、接続するまで 左:AAOS(Raspberry Pi) 右:コンパニオンデバイスMobileアプリ(Android) QR コードの読み取り → 関連付けの完了( Connected
)→ Trusted Device の登録(車両の画面で PIN を 1 回入力)→ ペアリング完了 → 接続済み 0:00 / 0:59 車両とスマホは別々の回に撮った録画で、関連付けの完了と登録の完了の瞬間を揃えて 1 本にしている M A Z DA M OTO R CO R P O RAT I O N 42 -
③ TCA は効いたのか、なぜ Kotlin で広まらないのか 良かった点・悪かった点、広まらない理由の考察 M A Z DA
M OTO R CO R P O RAT I O N 43 -
③ TCA を採用して良かった点・悪かった点の一覧 良かった点 悪かった点(不便・技術的負債) # 良かった点 解説箇所 # 悪かった点
種類 解説箇所 G1 入口を 1 か所に強制できる(コールバックはすべ て Action) ②-1 コールバック B1 同じ接続状態を 2 つの Store で持った 負債 ※今回省略 B2 Store の外に副作用が残った 負債 ※今回省略 G2 キャンセルの順番を、データとしてテストできる ① TCA のコア ②-1 コールバック B3 自前の TCA を自分たちで保守する 負債 ① TCA のコア G3 結果が出るまで表示を変えないことを、遷移で守 れた B4 Action の定義が多い 不便 ②-1 コールバック ②-1 コールバック B5 Reducer から扱えない処理がある 不便 ②-1 コールバック G4 キャンセルと失敗を区別できた ※今回省略 B6 不便 ※今回省略 G5 テストの書き方がそろう(遅延・順番を実機なしで 再現) ②-2 ユニットテスト B7 限界 ②-2 ユニットテスト G6 SDK の型を 1 つのファイルに閉じ込められた ②-1 コールバック G7 iOS 版と同じステップ・Action で書けた ① TCA のコア M A Z DA M OTO R CO R P O RAT I O N StateFlow と組み合わせると落とし穴が ある Fake は SDK の「前提」しか再現できない 44 -
なぜ Kotlin では TCA が広まらないのか(考察) 計測した事実ではなく、既存ライブラリの調査と、この PoC で書いてみた経験からの考察。 # 考察
この PoC で見えたこと 1 Android の公式の推奨が、単方向データフロー 2 構造化された並行性が、取り消しの多くを担う 3 Swift 版の書き心地を支える言語機能が、Kotlin にそのまま無い 4 Kotlin 版のライブラリが育っていない 調べた 4 つは、1.0 未満、RxJava 3 に依存、または数年更新が無い 5 先に MVI 系が広まった MVIKotlin / Orbit / Ballast が同じ場所にある 6 中心となる教材とコミュニティが無い Swift 版は作者の Point-Free が教材も出している 7 KMP で共有したいのは、主にロジック iOS は Swift 版の TCA を使いたくなる。 この PoC も iOS 版は Swift 版の TCA ViewModel + StateFlow で UDF は書ける。 TCA との差は、Effect の ID による取り消しと TestStore viewModelScope と Job で足りる場面が多い。 BLE のように取り消しが多い所で、Effect の ID が効いた @Reducer などのマクロと CasePath。 Kotlin では KSP やコンパイラプラグインが要るので、移さなかった 非決定的なイベントと取り消しが多い BLE では、自前で実装した TCA の考え方が、ある程度は有効だったというのが所感。 M A Z DA M OTO R CO R P O RAT I O N 45 -
まとめ 効果と限界、いま Kotlin で TCA を採用すべきか M A Z DA
M OTO R CO R P O RAT I O N 46 -
まとめ:効果と限界 効果 入口を 1 か所に強制できる:状態を置く場所が State だけになり、 切断と失敗を受け取る場所が 1 か所になった
キャンセルの順番を、データとしてテストできる:競合する処理の取り消し を、Reducer の返り値として書いて確かめられた テストの書き方がそろう:198 件のユニットテストが BLE の実機なしで動 く。 遅延・順番・タイムアウトは仮想時間で再現し、実機テストと組み合わせて いる iOS 版と同じステップと Action で書けた 限界 Store の外に副作用が残った( AppViewModel のテレメトリ) 登録の成否を関数の戻り値で判断していた。 Fake も同じ前提だったので、テストでは見つからなかった。 キャンセルの扱いも flow {} に偶然守られていた (どちらもレビューで発見して修正) Store を画面ごとに分けたので、同じ接続状態を 2 か所で持っている Fake が再現できるのは、SDK について前提としたことだけ。 前提が正しいかは実機でしか分からない (AAOS の登録と、QR コードの送信が止まる SDK の不具合で実際に起 きた) OS の機器選択ダイアログ、カメラ、再接続は、Reducer から扱えない Action の定義などのコード量は増える 使った Kotlin の機能: fun interface / out A / Nothing / sealed の抽象プロパティ / StateFlow と SharedFlow の使い分け / BufferOverflow.DROP_OLDEST / ensureActive() / runTest の仮想時間 M A Z DA M OTO R CO R P O RAT I O N 47 -
結論:いま Kotlin で TCA を採用すべきか Kotlin で TCA が広まらない一因は、Android には単方向データフロー(ViewModel
+ StateFlow )と構造化された並行性がすでにあり、多 くのアプリはそれで足りることだと考えられる。 Swift 版の書き心地を支えるマクロも、育った Kotlin 版のライブラリも無い。 アプリ・機能の性質 いま Kotlin で TCA を採用すべきか 画面の状態が中心の、一般的なアプリ 採用しなくてよい。ViewModel + StateFlow で足りる アプリ全体を Kotlin 版の TCA ライブラリで書く いまは勧めない。調べた 4 つは、1.0 未満、RxJava 3 に依存、または数年更新が無い BLE のように、外から来るイベントと取り消しが多い所 考え方を採用する価値がある。State / Action / Reducer / Effect と TestStore だけを自前で書く iOS 版が Swift の TCA で書かれている 採用を検討する。両 OS のステップと Action をほぼ対応させられた 結論:TCA をライブラリとしてアプリ全体に入れるのではなく、イベントと取り消しが多い所に、考え方だけを小さく入れる。 効いたのは TCA の器の中の、Kotlin の型( sealed interface / out / Nothing )とコルーチン( Job / 仮想時間)だった。 M A Z DA M OTO R CO R P O RAT I O N 48 -
参考資料(URL は 2026 年 10 月 28 日時点で確認) SDK と
AAOS Google Companion Device SDK(OSS): TCA と比較したライブラリ The Composable Architecture(Swift / Point-Free): https://github.com/google/android-auto-companion-android https://github.com/pointfreeco/swift-composable- AOSP CompanionDeviceSupport (AAOS 側の実装): architecture https://android.googlesource.com/platform/packages/apps/Car/ CompanionDeviceSupport/ 本 PoC の iOS 版が使っている( Package.swift ) 調べた Kotlin 版 TCA(自前で実装した理由の根拠) 「AAOS ではプロファイルロックが前提」の根拠は https://github.com/toggl/komposable-architecture companiondevice/res/values/strings.xml https://github.com/trading-point/kotlin-composable- ( create_profile_lock_dialog_message / trusted_device_feature_title など) AOSP TrustAgentService ( @SystemApi 。Companion Device SDK を使う理由の根拠): https://android.googlesource.com/platform/frameworks/base/+/ master/core/java/android/service/trust/TrustAgentService.jav a UKey2: https://github.com/google/ukey2 kotlinx.coroutines(SharedFlow / StateFlow / Channel / BufferOverflow): architecture https://github.com/wearemakery/kotlin-composable-architecture https://github.com/Orgmir/kotlin-composable-architecture 比較した Kotlin の MVI 系 https://github.com/arkivanov/MVIKotlin https://github.com/orbit-mvi/orbit-mvi https://github.com/copper-leaf/ballast The Composable Architecture in Android(Medium, Dhanshri Pathrikar): https://medium.com/@dhanshri_pathrikar/thecomposable-architecture-in-android-d9da41b6c0d3 https://kotlinlang.org/api/kotlinx.coroutines/ kotlinx-coroutines-test( runTest / advanceTimeBy ): https://kotlinlang.org/api/kotlinx.coroutines/kotlinxcoroutines-test/ M A Z DA M OTO R CO R P O RAT I O N 49