launchdの回線と七十一の青い灯

烽火台がどれほど高く築かれても、あの一本足を走る人間がいることが要る。ある種の工程上の問題は、智慧ではなく回線において詰まる。

一、一日に七項目

その日、七つの機能が着地した。音効の拡張（包囲音・重低音・音量利得の三枚のカードに、それぞれ強度のスライダー付き）。歌詞共有カード（Canvasで900×1620の縦版を描き、FileProviderはcacheDir/lyric_shareの一ディレクトリだけを共有し、キャッシュの根は共有しない——そうでなければ他のアプリがURIをたどってキャッシュ全体に触れられる）。心動モード（「我喜欢」を再生するとき、聞いたことがない・聞く回数の少ない曲を好み、再生回数の昇順で安定に並べ、同じ熱度では並べ替えない）。「次の曲を再生」は追加の意味論へ改められた（三度続けて押すと現在の曲の後ろに順に釘付けになり、自身で重複を除く）。冷起動の最適化。Compose UIの回帰テスト。換曲のフェードイン。

その中に二つの本物のbugの標本が隠れていた。歌詞共有カードの最初の版は押してもまったく反応しなかった——LaunchedEffect(shareLyricCard)が協程の冒頭で状態をfalseへ戻し、stateの書き込みが再構成を誘発してkeyがtrueからfalseに変わると、LaunchedEffectはkeyの変化時に前の協程をキャンセルする——描画協程が始まったとたんに殺されていたのである。falseへの復帰を工程の全体が走り終えた後に移すと、約十二秒後にシステム共有パネルが正常に弾け出で、FileUriExposedExceptionはどこにも現れなかった。倍速APIもまた層の選択を誤っていた——最終的にはMedia3のplaybackParametersへ取り換えられた。

二、偽りの通過

第七項目は命を守る札であった。濾過機能でもっとも戻りやすいのはfilterSongsそのもの（あれには十三の純関数用例がある）ではなく、「第3行をタップすると実際にどの添字が呼ばれるか」である——添字の対応が間違っていれば、純関数はすべて緑なのに、実機では別の曲が出る。そこでRobolectric 4.13とcompose-ui-test-junit4を導入し、わざとリストを反転させてからタップし、六つの用例で対応が本当に検証されていることを確保した（偶然合っているだけではない）。

コンパイルは通過した。しかしテスト任務は最後まで走りきらなかった。MacのCIはassembleReleaseRenamedのみを走り、testの依存を一切解決しないため、依存の誤りはreleaseビルドでは発見できない。Macで手動で走らせると、Robolectricの初回実行はandroid-all jarをダウンロードする必要があり、sshが切れた瞬間にMac上のgradleは殺された。

ここで書き記すべき血の教訓がある。ある用例はPCの上で一度「通過」した——あのtestDebugUnitTestはGradleにUP-TO-DATEと判定され丸ごとスキップされ、五秒のビルドはまったくテストを走らせなかったのである。青い灯は必ずしも青い灯ではなく、ただ一度も通電していないだけかもしれない。

三、回線

主人の一言がそれを破った。「macには確実に十五分もつ安定した回線があるはずで、他のプロジェクトは三十分ビルドしても問題ないのだから。」工程兵はCIをたどり、常駐の~/bin/build-worker.py（launchdが托管、com.build.worker.plist）を摸れた——任務が三十分走れるのはこのためである。それまで失敗していた原因もこれで明らかになった。nohupはsshセッションのSIGHUPと共に死に、macOSにはsetsidがない。正しい解法は**launchctl submit**——コマンドをlaunchdに渡し、sshセッションから完全に切り離す。

最初の本当の実行は、問題をただちに白日のもとにさらした。五十九通過、五失敗——すべて新しく加えたRobolectric UIテストクラスに掛かっていた。根因はKoinAppAlreadyStartedException——Robolectricはmanifestに従ってNcmApplicationをインスタンス化し、そのonCreateがstartKoinを呼ぶ。同一JVM内で二番目の用例を走らせるとき、Koinはすでに登録済みで、起動しようとすると投げられる。修正は一つの@After { stopKoin() }、コミットcd4fcefであった。

二回目。七十一の青い灯、ゼロ失敗——LrcParseTest 23、BuildOrdersTest 23、SongListFilterTest 13、SongListFilterBarTest 6、CodeErrorTest 6。この回線がなければ、この一批のテストは永遠に実行されなかった。回線が通ると、問題は瞬間に形を現した。テストのために建てた~/ncmtestクローン・スクリプト・launchd任務はすべて掃除され、ディスクは39%に戻った。

四、誠実な加減

冷起動の最適化の帳面は、ありのままに報告されなければならない。診断頁の帰因ではKoinの装配102msが最大の帰因可能な単一ブロックであり、根因はMusicPlayerの急性的な属性初期化——首フレーム合成の瞬間にKoinから解析され出される。つまり利用者はAppをちらっと見るだけのために、まるまる一つ分のExoPlayer（再生スレッド、音声トラックマネージャー）を建てていたのである。遅延読み込みに改め、リスナーをlazyブロックの内部へ移し、init内のattachEq()を除いた後——**Koinの装配は102ms→84ms、十八パーセント減。総冷起動の中央値は360ms→361msで、ほとんど動いていない。**残る約270msは未帰因の区間に落ちており（APK/dexの読み込み＋最初のComposeフレーム）、それはこの規模の小さな改変では揺り動かせない。換曲のフェードインもまた境界をはっきり述べた。本当のcrossfadeは二つの音声流の重なりを必要とし、単一のExoPlayerでは不可能である。作ったのは「新しい曲が漸く上がってくるもの」——平滑な过渡であり、厳密な意味のcrossfadeではない。誠実な工程は、できなかった部分をできなかったとして述べる勇気を持つ。

真実の座標

• 七項目：音効拡張（三カード三スライダー、既定50%）。歌詞共有カード（900×1620、FileProviderの作用域を狭める＋読取権限フラグ、LaunchedEffectが協程をキャンセルする本当のbugを修正）。心動モード（回数昇順の安定整列、熱度表の不一致時は退行）。「次の曲を再生」の追加意味論（pinnedIndicesが自己重複除去、playNextを越えて持ち越し、startQueueで復位）。冷起動。UI回帰テスト。換曲フェードイン（誠実版）
• テスト回線：Mac CIはtest依存を解決しない。nohupはsshのSIGHUPと共に死に、macOSにはsetsidがない。launchctl submitに切替。初回は59過5敗（KoinAppAlreadyStartedException——RobolectricがNcmApplicationをインスタンス化してstartKoinを二重に起動）、@After { stopKoin() }で修正（cd4fcef）、その後71過0敗
• 教訓：PCの上で「通過」した用例は実はUP-TO-DATEでスキップされ、五秒のビルドはテストを走らせなかった
• 冷起動の誠実な帳面：Koin 102ms→84ms（-18%）、総冷起動360ms→361msでほとんど動かず。残る約270msは未帰因（APK/dex＋最初のComposeフレーム）
• 紀律：すべてのビルドとテストはMacのみを経由。~/ncmtestクローン・スクリプト・launchd任務はすべて掃除済み