Upgrade to Pro — share decks privately, control downloads, hide ads and more …

KotlinFest2026 切断・再接続・認証…BLEの修羅場をKotlin TCAで乗り切る

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
  1. 切断・再接続・認証… BLEの修羅場を Kotlin TCA で乗り切る KotlinFest 2026 車田 巡(Jun Kurumada)

    / 八幡 勇樹(Yuki Yawata) マツダ株式会社 クルマ開発本部 コネクティッドソフトウェア開発グループ 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
  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
  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
  5. 前提:センターディスプレイと、コンパニオンデバイス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
  6. 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
  7. アプリの役割について 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
  8. 録画: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
  9. 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
  10. 実機テストの環境: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
  11. なぜ「修羅場」になるのか 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
  12. アプリ側で状態管理が必要な理由 コールバックがいつ、何回、どの順で、どんな理由で届くかを、知る術がない。 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
  13. 素朴な実装が破綻する 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
  14. 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
  15. 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
  16. 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
  17. 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
  18. 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
  19. アプリのパッケージ構成: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
  20. ① 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
  21. 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
  22. 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
  23. 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
  24. ②-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
  25. 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
  26. 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
  27. ペアリング(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
  28. 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
  29. 切断と再接続を 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
  30. 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
  31. ②-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
  32. ユニットテスト:失敗をコードで再現する 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
  33. 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
  34. 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
  35. 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
  36. タイムアウトを仮想時間でテストする: 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
  37. ②-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
  38. デモ録画: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
  39. ③ 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
  40. なぜ 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
  41. まとめ:効果と限界 効果 入口を 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
  42. 結論:いま 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
  43. 参考資料(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

Other Decks in Programming