{"id":44471483,"url":"https://github.com/tomo-ludens/unity-policy-driven-singleton","last_synced_at":"2026-02-12T21:32:33.205Z","repository":{"id":330727245,"uuid":"1119498895","full_name":"tomo-ludens/unity-policy-driven-singleton","owner":"tomo-ludens","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-11T06:00:33.000Z","size":277,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-13T21:13:27.427Z","etag":null,"topics":["architecture","csharp","design-patterns","domain-reload","monobehaviour","singleton","thread-safety","unity","unity-test-framework"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tomo-ludens.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-19T11:15:30.000Z","updated_at":"2026-01-11T06:00:35.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tomo-ludens/unity-policy-driven-singleton","commit_stats":null,"previous_names":["tomo-ludens/unity-singleton-behaviour","tomo-ludens/unity-policy-singleton"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/tomo-ludens/unity-policy-driven-singleton","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomo-ludens%2Funity-policy-driven-singleton","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomo-ludens%2Funity-policy-driven-singleton/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomo-ludens%2Funity-policy-driven-singleton/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomo-ludens%2Funity-policy-driven-singleton/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tomo-ludens","download_url":"https://codeload.github.com/tomo-ludens/unity-policy-driven-singleton/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomo-ludens%2Funity-policy-driven-singleton/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29381774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T20:34:40.886Z","status":"ssl_error","status_checked_at":"2026-02-12T20:23:00.490Z","response_time":55,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["architecture","csharp","design-patterns","domain-reload","monobehaviour","singleton","thread-safety","unity","unity-test-framework"],"created_at":"2026-02-12T21:32:32.503Z","updated_at":"2026-02-12T21:32:33.195Z","avatar_url":"https://github.com/tomo-ludens.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🧩 PolicyDrivenSingleton\n\n**MonoBehaviour向けのポリシー駆動型シングルトン基底クラス（Domain Reload ON/OFF 両対応）**\n\n[Features](#features) •\n[Requirements](#requirements) •\n[Installation](#installation) •\n[Quick Start](#quick-start) •\n[API](#api-cheat-sheet) •\n[Architecture](#architecture) •\n[Constraints](#constraints--best-practices) •\n[Limitations](#known-limitations) •\n[Debug](#debug-logging) •\n[Troubleshooting](#troubleshooting) •\n[References](#references)\n\n![Unity 2022.3+](https://img.shields.io/badge/Unity-2022.3%2B-black?logo=unity)\n![Reload Domain ON/OFF](https://img.shields.io/badge/Enter%20Play%20Mode-Reload%20Domain%20ON%2FOFF-green)\n![Dependencies None](https://img.shields.io/badge/Dependencies-None-brightgreen)\n![MIT License](https://img.shields.io/badge/License-MIT-blue)\n\n\u003c/div\u003e\n\n---\n\n## Overview\n\n**PolicyDrivenSingleton** は、MonoBehaviour向けの **ポリシー駆動型シングルトン基底クラス**です。\n\n- **`GlobalSingleton\u003cT\u003e`**：シーン間永続 + 見つからなければ自動生成\n- **`SceneSingleton\u003cT\u003e`**：シーンスコープ + 自動生成しない（シーン配置必須）\n\nEnter Play Mode Options の **Reload Domain を無効化**して static が Play 間で残る環境でも、**Playセッション境界**で確実にキャッシュを無効化し、再探索・再初期化できるように設計しています。\n\n### When to Use / Consider Alternatives\n\n| ✅ 本ライブラリが適している場合 | 💡 代替を検討すべき場合 |\n|-------------------------------|------------------------|\n| 常駐マネージャ（Audio, Input, Game など） | テスト容易性を重視 → DI コンテナ（Zenject, VContainer 等） |\n| シーン内コントローラ（Level, UI など） | データ駆動設計を好む → ScriptableObject ベースのサービスロケータ |\n| Domain Reload OFF 環境での安定動作が必要 | 小規模・プロトタイプ → `FindAnyObjectByType` を都度呼ぶ運用 |\n| 明示的なライフサイクル制御が必要 | 状態を持たない処理 → 静的クラスで十分 |\n\n---\n\n## Features\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🎯 Core\n\n- **ポリシー駆動**：永続化 / 自動生成の挙動をポリシーで分離\n- **2種類の提供クラス**：Global / Scene\n- **厳密な型一致**：`T` と実体型が一致しない参照は拒否\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🛡️ Robustness\n\n- **Domain Reload OFF 対応**：PlayセッションIDで static キャッシュを無効化\n- **終了処理ガード（ベストエフォート）**：終了中の復活（resurrection）を抑制\n- **Edit Mode 副作用ゼロ**：検索のみ・生成しない・staticキャッシュ更新しない\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### ⚡ Performance\n\n- **ポリシー解決はゼロアロケ**（readonly struct + default）\n- **検索は FindAnyObjectByType を使用**\n- **頻繁アクセスはキャッシュ推奨**\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 🧰 Dev Experience\n\n- **DEV/EDITOR/ASSERTIONS では fail-fast**（誤用を早期検出）\n- **Playerビルドは strip 前提**：検証/ログは `[Conditional]` で除去され、fail-soft（null/false）になり得る\n- **PlayMode/EditMode テスト同梱**（運用状況に応じて更新）\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## Requirements\n\n| 項目 | 要件 |\n|---|---|\n| Unity | **2022.3+**（Unity 6.3でテスト済み） |\n| Enter Play Mode Options | **Reload Domain ON/OFF 両対応** |\n| 外部依存 | なし |\n\n---\n\n## Installation\n\n### Option A: Manual Copy（推奨）\n\n1. `PolicyDrivenSingleton/` フォルダを任意の場所へコピー\n   例：`Assets/Plugins/PolicyDrivenSingleton/`\n2. 必要なら asmdef 名や namespace をプロジェクト方針に合わせて調整\n\n### Option B: Git で取り込み（任意）\n\n- submodule / subtree 等で `PolicyDrivenSingleton/` を取り込む運用も可能です\n  （このリポジトリは UPM 前提ではありません）\n\n---\n\n## Quick Start\n\n### 1) GlobalSingleton（永続 + 自動生成）\n\n```csharp\nusing PolicyDrivenSingleton;\n\n// 継承禁止 (sealed) を推奨します\npublic sealed class GameManager : GlobalSingleton\u003cGameManager\u003e\n{\n    protected override void Awake()\n    {\n        base.Awake(); // 必須 - シングルトンを初期化します\n        // 初回のみの初期化\n    }\n\n    protected override void OnPlaySessionStart()\n    {\n        // Playセッションごとの再初期化（Domain Reload OFF を含む）\n        // 例：一時データ、イベント購読、キャッシュの再構築\n    }\n}\n\n// 利用例:\n// GameManager.Instance.AddScore(10);\n```\n\n### 2) SceneSingleton（シーンスコープ + 自動生成なし）\n\n```csharp\nusing PolicyDrivenSingleton;\n\npublic sealed class LevelController : SceneSingleton\u003cLevelController\u003e\n{\n    protected override void Awake()\n    {\n        base.Awake(); // 必須\n    }\n}\n\n// ⚠️ シーン配置必須（置き忘れは DEV/EDITOR/ASSERTIONS で fail-fast）\n```\n\n### 3) 毎フレームアクセスは避け、キャッシュする\n\n```csharp\nprivate GameManager _gm;\n\nprivate void Awake()\n{\n    _gm = GameManager.Instance; // 起動時に確立してキャッシュ\n}\n\nprivate void Update()\n{\n    if (_gm == null) return; // fail-soft 構成の保険\n    // ...\n}\n```\n\n---\n\n## API Cheat Sheet\n\n### Public surface\n\n#### アクセサ（確立/取得）\n\n| メンバー | 目的 | 自動生成 | 典型用途 |\n|---|---|---|---|\n| `T Instance { get; }` | 必須経路：確立/取得 | `global_only` | 起動・初期化・ゲーム進行必須 |\n| `bool TryGetInstance(out T instance)` | 任意経路：あれば使う | `never` | 後片付け、解除、終了/中断経路 |\n\n**自動生成**\n- `global_only`: `GlobalSingleton\u003cT\u003e` は未存在なら生成、`SceneSingleton\u003cT\u003e` は生成しない\n- `never`: 生成しない\n\n---\n\n#### フック / ユーティリティ\n\n| メンバー | 目的 | 典型用途 |\n|---|---|---|\n| `protected virtual void OnPlaySessionStart()` | Playセッション単位の再初期化 | Domain Reload OFF 対策、再購読、キャッシュ再構築 |\n| `bool TryPostToMainThread(Action action)` | BG→メインへ委譲 | 非同期結果のUI反映、Unity API 呼び出し |\n\n### Instance / TryGet の挙動（要点）\n\n| 状態        | `Instance`                    | `TryGetInstance` |\n| --------- | ----------------------------- | ---------------- |\n| Play 中    | 確立済みなら返す / 必要なら検索・（Globalは）生成 | 存在すれば返す（生成しない）   |\n| 終了処理中     | `null`                        | `false`          |\n| Edit Mode | 検索のみ（生成しない・キャッシュ更新しない）        | 検索のみ（キャッシュ更新しない） |\n\n\u003e 推奨：解除系（OnDisable/OnDestroy/OnApplicationPause等）は `TryGetInstance` を原則にする。\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003efail-fast / fail-soft の方針（詳細）\u003c/strong\u003e\u003c/summary\u003e\n\n* **DEV/EDITOR/ASSERTIONS**：誤用を早期に発見するため、以下は fail-fast（例外）になり得ます。\n\n  * 非アクティブなシングルトン検出（検索APIがinactiveを既定で見ないため、隠れ重複に繋がる）\n  * SceneSingleton の置き忘れ（自動生成しない契約）\n* **Player**：検証やログは `[Conditional]` 等でストリップされる前提のため、fail-soft（`null` / `false`）になり得ます。\n* したがって利用側は `null` / `false` を前提にハンドリングしてください（特に解除/終了経路）。\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eAPI Quick Reference（状態別の詳細）\u003c/strong\u003e\u003c/summary\u003e\n\n#### `T Instance { get; }` の振る舞い\n\n| 状態 | GlobalSingleton | SceneSingleton |\n|------|-----------------|----------------|\n| **Play中（正常）** | キャッシュ済み → 返す / なければ検索 → 自動生成 | キャッシュ済み → 返す / なければ検索のみ |\n| **終了処理中** | `null` | `null` |\n| **Edit Mode** | 検索のみ（生成・キャッシュ更新なし） | 検索のみ |\n| **非アクティブ/無効コンポーネント検出時** | DEV: 例外 / Player: `null` | DEV: 例外 / Player: `null` |\n| **シーン未配置** | 自動生成 | DEV: 例外 / Player: `null` |\n| **型不一致** | 拒否（DEV: Error ログ → 破棄） | 拒否（DEV: Error ログ → 破棄） |\n| **バックグラウンドスレッド** | `null`（Error ログ出力） | `null`（Error ログ出力） |\n\n#### `bool TryGetInstance(out T)` の振る舞い\n\n| 状態 | 振る舞い |\n|------|----------|\n| **存在する** | `true` + 有効な参照 |\n| **存在しない** | `false` + `null`（**自動生成しない**） |\n| **終了処理中** | `false` + `null` |\n| **Edit Mode** | 検索のみ（キャッシュ更新しない） |\n| **非アクティブ/無効コンポーネント検出時** | DEV: 例外 / Player: `false` + `null` |\n| **バックグラウンドスレッド** | `false` + `null`（Error ログ出力） |\n\n\u003e 補足：`TryGetInstance` は `FindAnyObjectByType` を使うため、非アクティブな GameObject は既定では検索対象外です（検出時のみ例外）。\n\n#### `OnPlaySessionStart()` の呼び出しタイミング\n\n| 条件 | 呼び出し |\n|------|----------|\n| **初回 Play（Domain Reload ON）** | `Awake()` → `OnPlaySessionStart()` |\n| **2回目以降 Play（Domain Reload OFF）** | `OnPlaySessionStart()` のみ（`Awake()` は呼ばれない） |\n| **シングルトン確立時** | 1 Play セッションにつき 1 回のみ |\n\n#### `TryPostToMainThread(Action)` の振る舞い\n\n| 状態 | 振る舞い |\n|------|----------|\n| **メインスレッド上** | 即座に実行、`true` を返す |\n| **バックグラウンドスレッド** | SyncContext 経由で Post、`true` を返す |\n| **SyncContext 未キャプチャ** | `false` を返す（fail-soft）、Error ログ出力 |\n| **null アクション** | `false` を返す |\n\n\u003c/details\u003e\n\n---\n\n## Architecture\n\n```mermaid\nflowchart TB\n  subgraph PublicAPI[\"Public API\"]\n    G[\"GlobalSingleton\u003cT\u003e\u003cbr/\u003ePersistentPolicy\u003cbr/\u003e• DontDestroyOnLoad\u003cbr/\u003e• Auto-create\"]\n    S[\"SceneSingleton\u003cT\u003e\u003cbr/\u003eSceneScopedPolicy\u003cbr/\u003e• Scene bound\u003cbr/\u003e• No auto-create\"]\n  end\n\n  subgraph Core[\"Core\"]\n    B[\"SingletonBehaviour\u003cT, TPolicy\u003e\u003cbr/\u003e• Instance/TryGetInstance\u003cbr/\u003e• TryPostToMainThread\u003cbr/\u003e• Hooks: OnPlaySessionStart\"]\n  end\n\n  subgraph Runtime[\"Runtime (internal)\"]\n    R[\"SingletonRuntime\u003cbr/\u003e• PlaySessionId\u003cbr/\u003e• IsQuitting (best-effort)\u003cbr/\u003e• Thread validation\u003cbr/\u003e• Main thread posting\"]\n    L[\"SingletonLogger\u003cbr/\u003e• Conditional logs\u003cbr/\u003e• Stripped in Player by design\"]\n  end\n\n  subgraph Editor[\"Editor only\"]\n    E[\"SingletonEditorHooks\u003cbr/\u003e• Play Mode events\u003cbr/\u003e• ClearQuittingFlag()\"]\n  end\n\n  G --\u003e B\n  S --\u003e B\n  B --\u003e R\n  B --\u003e L\n  E --\u003e R\n```\n\n**Notes:**\n- **Editor hooks の方向**: `SingletonEditorHooks`（Editor専用）が `SingletonRuntime.ClearQuittingFlag()` を呼び出し、Play Mode 境界で状態をリセット\n- **internal クラス**: `SingletonRuntime` / `SingletonLogger` は `internal` であり、外部から直接呼び出し不可\n\n### Design intent（要約）\n\n* **Domain Reload OFF でも安全**：Playセッション開始ごとに `PlaySessionId` を更新し、型ごとの static キャッシュを無効化 → 再探索して同一インスタンスを掴み直す\n* **Edit Mode 副作用ゼロ**：エディタ拡張から呼んでも生成やキャッシュ更新を行わない\n* **検索仕様に合わせた防御**：Find系APIは既定で inactive を対象外にするため、非アクティブなシングルトンは「存在しても見つからない扱い → 自動生成 → 隠れ重複」になり得る。DEV/EDITOR/ASSERTIONS では強く検出する\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eInstance 取得フロー（図解）\u003c/strong\u003e\u003c/summary\u003e\n\n```mermaid\nflowchart TD\n    A[Instance 呼び出し] --\u003e B{メインスレッド?}\n    B --\u003e|No| Z1[null + Error ログ]\n    B --\u003e|Yes| C{Edit Mode?}\n    C --\u003e|Yes| D[検索のみ → 返す]\n    C --\u003e|No| E{終了中?}\n    E --\u003e|Yes| Z2[null]\n    E --\u003e|No| F{キャッシュあり?}\n    F --\u003e|Yes| G[キャッシュを返す]\n    F --\u003e|No| H[Find で検索]\n    H --\u003e I{見つかった?}\n    I --\u003e|Yes| J{Active \u0026 Enabled?}\n    J --\u003e|No| Z3[DEV: 例外 / Player: null]\n    J --\u003e|Yes| K[初期化 → キャッシュ → 返す]\n    I --\u003e|No| L{AutoCreate 許可?}\n    L --\u003e|Yes| M[生成 → 初期化 → 返す]\n    L --\u003e|No| Z4[DEV: 例外 / Player: null]\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003ePlay Session 境界のライフサイクル（Domain Reload OFF）\u003c/strong\u003e\u003c/summary\u003e\n\n```mermaid\nsequenceDiagram\n    participant U as Unity Runtime\n    participant R as SingletonRuntime\n    participant S as Singleton\u003cT\u003e\n\n    Note over U,S: Play Session 1 開始\n    U-\u003e\u003eR: SubsystemRegistration\n    R-\u003e\u003eR: PlaySessionId++\n    U-\u003e\u003eS: Awake()\n    S-\u003e\u003eS: InitializeForCurrentPlaySession\n    S-\u003e\u003eS: OnPlaySessionStart()\n\n    Note over U,S: Play Session 1 終了\n    U-\u003e\u003eR: Application.quitting\n    R-\u003e\u003eR: IsQuitting = true\n\n    Note over U,S: Play Session 2 開始（Domain Reload OFF）\n    U-\u003e\u003eR: SubsystemRegistration\n    R-\u003e\u003eR: PlaySessionId++, IsQuitting = false\n    Note over S: Awake() は呼ばれない（オブジェクト生存中）\n    U-\u003e\u003eS: Instance アクセス\n    S-\u003e\u003eS: PlaySessionId 変更検出 → キャッシュ無効化\n    S-\u003e\u003eS: 再検索 → 再確立\n    S-\u003e\u003eS: OnPlaySessionStart()\n```\n\n\u003c/details\u003e\n\n---\n\n## Directory Structure\n\n```text\nPolicyDrivenSingleton/\n├── Core/\n│   ├── AssemblyInfo.cs                                  # InternalsVisibleTo（テスト用）\n│   ├── SingletonBehaviour.cs                            # コア実装\n│   ├── SingletonLogger.cs                               # 条件付きロガー（Playerビルドで除去）\n│   └── SingletonRuntime.cs                              # 内部ランタイム（Domain Reload対策）\n├── Editor/\n│   ├── SingletonEditorHooks.cs                          # Editorイベントフック（Play Mode状態）\n│   └── PolicyDrivenSingleton.Editor.asmdef              # Editor用 asmdef\n├── Policy/\n│   ├── ISingletonPolicy.cs                              # ポリシーインターフェース\n│   ├── PersistentPolicy.cs                              # 永続ポリシー\n│   └── SceneScopedPolicy.cs                             # シーンスコープポリシー\n├── Tests/                                               # PlayMode \u0026 EditMode テスト\n│   ├── Editor/\n│   │   ├── Behaviours/                                  # EditMode: behaviour系\n│   │   ├── Core/                                        # EditMode: runtime状態\n│   │   ├── Logging/                                     # EditMode: ログ\n│   │   ├── Policy/                                      # EditMode: ポリシー\n│   │   └── PolicyDrivenSingleton.Editor.Tests.asmdef\n│   ├── Runtime/\n│   │   ├── Domain/\n│   │   ├── Doubles/\n│   │   ├── EdgeCases/\n│   │   ├── GlobalSingleton/\n│   │   ├── Hierarchy/\n│   │   ├── Infrastructure/\n│   │   ├── Lifecycle/\n│   │   ├── Policy/\n│   │   ├── Practical/\n│   │   ├── SceneSingleton/\n│   │   ├── Threading/\n│   │   ├── Validation/\n│   │   ├── PolicySingletonTestSetup.cs                  # SetUpFixture（ログカウンタ）\n│   │   └── PolicyDrivenSingleton.Tests.asmdef\n│   ├── Shared/                                          # EditMode用のテストダブル\n│   │   ├── EditModeSingletonDoubles.cs\n│   │   └── PolicyDrivenSingleton.Tests.Shared.asmdef\n│   └── TestExtensions.cs                                # テスト用ヘルパー\n├── GlobalSingleton.cs                                   # Public API（永続・自動生成あり）\n├── SceneSingleton.cs                                    # Public API（シーン限定・自動生成なし）\n└── PolicyDrivenSingleton.asmdef                         # Runtime asmdef\n```\n\n---\n\n## Constraints \u0026 Best Practices\n\n### 意図的な契約（破ると事故る）\n\n* **Play中はメインスレッド前提**（Unity APIを呼ぶため）\n* **厳密な型一致**：派生型など `T` と一致しない参照は拒否\n* **SceneSingleton はシーン配置必須**（自動生成しない）\n* **DEVでは重複を全探索で検出**（キャッシュ未確立時に fail-fast）\n* **Inactive/Disabled運用は避ける**（隠れ重複の原因）\n* **終了中の復活を避ける**：終了経路は `TryGetInstance` を使う（`Application.quitting` はベストエフォート）\n\n### 実装側の推奨\n\n* 具象クラスは `sealed` 推奨（型不一致/拡張の事故を避ける）\n* `Awake/OnEnable/OnDestroy` を override する場合は **base 呼び出し必須**\n* 頻繁アクセスする参照はキャッシュする（Updateで `Instance` を叩かない）\n* **GlobalSingleton は root GameObject 推奨**：`DontDestroyOnLoad` は root にのみ有効。子オブジェクトの場合、本ライブラリが自動で root へ移動し Warning を出力\n\n---\n\n## Advanced Topics\n\n### Playセッション境界の再初期化（Soft Reset）\n\nDomain Reload OFF 環境では static 状態が残ります。**Awake は生存期間中1回**のため、Playごとの再初期化は `OnPlaySessionStart()` で行ってください。\n\n* `OnPlaySessionStart()` は **冪等**に書く（イベント購読は「解除 → 登録」など）\n\n### Initialization Order（任意）\n\n初期化順序を厳密に制御したい場合は `DefaultExecutionOrder` や Bootstrap で固定してください。\n\n```csharp\nusing UnityEngine;\nusing PolicyDrivenSingleton;\n\n[DefaultExecutionOrder(-10000)]\npublic class Bootstrap : MonoBehaviour\n{\n    void Awake()\n    {\n        _ = GameManager.Instance;\n        _ = AudioManager.Instance;\n        _ = InputManager.Instance;\n    }\n}\n```\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eUnity API前提（要点）\u003c/strong\u003e\u003c/summary\u003e\n\n* Domain Reload 無効：static フィールドと static event の購読が Play 間で残る\n* Find系：既定で inactive は除外される／呼び出しごとに同一オブジェクトが返る保証はない\n* DontDestroyOnLoad：root GameObject（またはroot上のComponent）に対してのみ有効\n* Application.quitting：強制終了やクラッシュ等では発火しない場合がある／キャンセルできない局面で発火する\n\n\u003c/details\u003e\n\n---\n\n## Known Limitations\n\n| 制限事項 | 説明 | 回避策 |\n|----------|------|--------|\n| **静的コンストラクタのタイミング** | シングルトンクラスに静的コンストラクタがあると `PlaySessionId` 初期化前に実行される可能性 | 静的コンストラクタを避ける、または遅延初期化パターンを使用 |\n| **スレッドセーフティ** | すべての操作はメインスレッドから呼び出す必要がある | バックグラウンド処理の結果は `UnityMainThreadDispatcher` 等でメインスレッドに戻す |\n| **シーン読み込み順序** | 複数シーンに同一シングルトン型がある場合、破棄順序は Unity のシーン読み込み順序に依存 | シングルトンは 1 シーンにのみ配置する |\n| **メモリリーク（Domain Reload OFF）** | `OnDestroy` で静的イベント購読を解除しないとリークする | `OnPlaySessionStart` で「解除 → 登録」パターンを使う |\n| **Find API の非決定性** | `FindAnyObjectByType` は呼び出しごとに同一オブジェクトを返す保証がない | 本ライブラリはキャッシュで吸収済み（利用側は意識不要） |\n| **Inactive の検出漏れ** | `FindAnyObjectByType(Exclude)` は非アクティブを見ない | シングルトンは常に Active にする。DEV では fail-fast で検出 |\n\n---\n\n## Testing\n\nPlayMode / EditMode テスト同梱（合計 **79 テスト**：PlayMode 58 / EditMode 21）\n\n**実行方法**：Window → General → Test Runner → Run All\n\n補足:\n- EditMode テスト用のテストダブルは `Tests/Shared/` に配置（Editor フォルダ外で AddComponent 可能にするため）\n- EditMode / PlayMode ともに機能別フォルダ + 1 TestFixture/1 ファイルで整理\n- Runtime の `SetUpFixture`（`PolicySingletonTestSetup`）でログカウンタを初期化（`PolicyDrivenSingleton.Tests.Runtime` 配下に適用）\n- テスト数は増減するため、Test Runner の実行結果に合わせて更新\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eテストカバレッジ詳細\u003c/strong\u003e\u003c/summary\u003e\n\n#### PlayMode テスト（58個）\n\n| カテゴリ | テスト数 | カバレッジ |\n|----------|----------|------------|\n| GlobalSingleton | 7 | 自動生成、キャッシュ、重複検出 |\n| SceneSingleton | 5 | 配置、自動生成なし、重複検出 |\n| InactiveInstance | 3 | 非アクティブGameObject検出、無効コンポーネント |\n| TypeMismatch | 2 | 派生クラス拒否 |\n| ThreadSafety | 7 | バックグラウンドスレッド保護、メインスレッド検証 |\n| TryPostToMainThread | 5 | メインスレッド実行、バックグラウンドPost、null処理 |\n| Lifecycle | 2 | 破棄、再生成 |\n| SoftReset | 1 | PlaySessionId 境界での Playごとの再初期化 |\n| SceneSingletonEdgeCase | 2 | 未配置、自動生成なし |\n| PracticalUsage | 6 | GameManager、LevelController、状態管理 |\n| PolicyBehavior | 3 | ポリシー駆動挙動検証 |\n| ResourceManagement | 3 | インスタンスライフサイクルとクリーンアップ |\n| DomainReload | 6 | PlaySessionId境界、キャッシュ無効化、終了状態 |\n| ParentHierarchy | 2 | DontDestroyOnLoad用のルート再配置 |\n| BaseAwakeEnforcement | 1 | base.Awake() 呼び出し検出 |\n| EdgeCase | 3 | 破棄インスタンスクリーンアップ、高速アクセス、配置タイミング |\n\n#### EditMode テスト（21個）\n\n| カテゴリ | テスト数 | カバレッジ |\n|----------|----------|------------|\n| SingletonRuntimeEditMode | 2 | PlaySessionId、IsQuitting 検証 |\n| Policy | 5 | Policy struct 検証、不変性、インターフェース準拠 |\n| SingletonBehaviourEditMode | 5 | EditMode 挙動、キャッシュ分離 |\n| SingletonLifecycleEditMode | 3 | 親階層、生成、Edit Modeでの共存 |\n| SingletonRuntimeStateEditMode | 2 | NotifyQuitting、PlaySessionId一貫性 |\n| SingletonLoggerEditMode | 4 | Log、LogWarning、LogError、ThrowInvalidOperation API |\n\n\u003c/details\u003e\n\n---\n\n## Debug Logging\n\nライブラリは以下のシンボルのいずれかが定義されている場合にデバッグログを出力します。それ以外では `[Conditional]` によりストリップされます。\n\n- `UNITY_EDITOR`\n- `DEVELOPMENT_BUILD`\n- `UNITY_ASSERTIONS`\n\n### 出力されるログ一覧\n\n| レベル | メッセージ | トリガー |\n|--------|----------|----------|\n| **Log** | `OnPlaySessionStart invoked.` | シングルトンのセッション初期化実行時 |\n| **Log** | `Instance access blocked: application is quitting.` | 終了中に `Instance` アクセス |\n| **Log** | `TryGetInstance blocked: application is quitting.` | 終了中に `TryGetInstance` アクセス |\n| **Warning** | `Auto-created.` | GlobalSingleton の自動生成 |\n| **Warning** | `Duplicate detected. Existing='...', destroying '...'` | 重複シングルトンの検出・破棄 |\n| **Warning** | `Reparented to root for DontDestroyOnLoad.` | 永続化のため子オブジェクトをルートへ移動 |\n| **Error** | `base.Awake() was not called in ...` | サブクラスで `base.Awake()` 呼び出し忘れ |\n| **Error** | `Type mismatch. Expected='...', Actual='...'` | 型不一致検出（派生型など） |\n| **Error** | `... must be called from the main thread.` | バックグラウンドスレッドからのアクセス |\n\n### デバッグ用コードスニペット\n\n```csharp\n// シングルトンの状態確認\nif (MySingleton.TryGetInstance(out var instance))\n{\n    Debug.Log($\"Singleton found: {instance.name}\");\n}\nelse\n{\n    Debug.LogWarning(\"Singleton not available\");\n}\n```\n\n---\n\n## Troubleshooting\n\n### まず見るチェックリスト\n\n* コンポーネントが **Active \u0026 Enabled** か？\n* Play中に **メインスレッド** から呼んでいるか？\n* `Awake` override 時に `base.Awake()` を呼んでいるか？\n* SceneSingleton をシーンに置き忘れていないか？\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eFAQ\u003c/strong\u003e\u003c/summary\u003e\n\n**Q. Play Modeで `Instance` が null を返す**\n\nA. Active/Enabled、メインスレッド、base呼び出し、終了中ガードのいずれかを確認してください。\n\n---\n\n**Q. 重複が検出される / 破棄される**\n\nA. 複数シーン・プレハブに同一型が混在している可能性があります。配置を整理してください。\n\n---\n\n**Q. 例外が出る環境と出ない環境がある**\n\nA. DEV/EDITOR/ASSERTIONS の fail-fast と、Playerの fail-soft の差です。解除・後片付けは `TryGetInstance` を使ってください。\n\n\u003c/details\u003e\n\n---\n\n## References\n\n| トピック | リンク |\n|----------|--------|\n| GitHub Docs: Creating Mermaid diagrams | [docs.github.com](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams) |\n| Unity Manual: Domain Reloading | [docs.unity3d.com](https://docs.unity3d.com/6000.3/Documentation/Manual/domain-reloading.html) |\n| Unity API: Object.FindAnyObjectByType | [docs.unity3d.com](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/Object.FindAnyObjectByType.html) |\n| Unity API: FindObjectsInactive | [docs.unity3d.com](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/FindObjectsInactive.html) |\n| Unity API: Object.DontDestroyOnLoad | [docs.unity3d.com](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/Object.DontDestroyOnLoad.html) |\n| Unity API: Application.quitting | [docs.unity3d.com](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/Application-quitting.html) |\n| Unity API: DefaultExecutionOrder | [docs.unity3d.com](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/DefaultExecutionOrder.html) |\n| Microsoft Docs: ConditionalAttribute | [learn.microsoft.com](https://learn.microsoft.com/dotnet/api/system.diagnostics.conditionalattribute) |\n\n---\n\n## License\n\nMIT License. See [LICENSE](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomo-ludens%2Funity-policy-driven-singleton","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftomo-ludens%2Funity-policy-driven-singleton","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomo-ludens%2Funity-policy-driven-singleton/lists"}