FAQ & トラブルシューティング¶

初期ステートの `onEnter` が発火しない¶

onEnter はストアが最初に構築されたときの初期ステートに対しては呼ばれません。コレクターが state・actions・effects のいずれかを購読した最初のタイミングで発火します。

コレクターがアタッチする前に発火させる必要がある場合は、store.start() を明示的に呼んでください:

val store = store<MyState, MyAction, MyEffect>(scope) { … }
store.start()

エフェクトは replay = 0 の SharedFlow で発行されます。Compose では monaka-compose の handleEffects { } を使用してください。

デフォルトでは generateMonakaStubs は既存ファイルを上書きしません。上書きするには:

./gradlew generateMonakaStubs --replace=true

以下の順序で確認してください:

LoggingPlugin を有効にしてランタイムの動作をトレースしてください。

dispatch() はアクションをチャンネルの末尾にエンキューします。現在のハンドラーが終了した後に処理されます。これは設計上の動作です。

transition() は最初の書き込みが優先です。2度目の呼び出しは無視されます。排他的な分岐が必要な場合は if/else を使用してください。

onUpdate はステート型が同じで値が変化したときに発火します — 気にしないフィールドの更新も含みます。fromState/toState アクセサーを使ってガードしてください。

同じストアインスタンス（同じ id）を2度登録すると IllegalArgumentException がスローされます。register を使ってください — 所有スコープがキャンセルされたときにストアを自動的に登録解除します。

testStore は initialState(…) が設定された stateMachine { } を必要とします。各テストケースで特定の開始ポイントが必要な場合は given(state) を使用してください。