Upgrade Guide
v0.x → v1.0.0
Framework 를 v1.0.0(Release Candidate)으로 고정하며 발생한 변경점입니다.
변경점
| 항목 | 이전 | v1.0.0 |
|---|---|---|
| Test Assembly 구조 | 단일 Framework.Tests (EditMode 미인식) |
Framework.Tests.Shared / .EditMode / .PlayMode 3분리 |
| RootScope DI | ConfigCache/IJsonSerializer 미등록, CameraInstaller 미호출 |
전부 등록 완료, PlayMode 정상 초기화 |
| CameraSystem DI | CameraSettings/CameraBrain/CinemachineBridge 미등록으로 Resolve 실패 |
Factory 등록으로 AutoCreateRig 흐름 보존 |
| TickRunner | Scene 전환 시 파괴됨(DontDestroyOnLoad 누락) | Awake 에서 DontDestroyOnLoad 적용 |
| Diagnostics 입력 | 레거시 UnityEngine.Input 사용(Input System 전용 프로젝트에서 예외) |
Keyboard.current 기반(KeyCodeCompat) |
StatInstaller.cs |
미사용 상태로 존재 | 삭제(Dead Code 정리) |
주의사항
- Public API 는 변경되지 않았습니다. 위 변경은 모두
RootScope.cs/CameraInstaller.cs/TickRunner.cs/Diagnostics 내부의 초기화·DI·입력 처리 버그 수정이며, 각 System 의 인터페이스(IAssetSystem,ISaveSystem등)와 시그니처는 동일합니다. - 프로젝트에 구버전
Framework.Tests.asmdef(단일 어셈블리)를 직접 참조하는 코드가 있다면Framework.Tests.EditMode/Framework.Tests.PlayMode/Framework.Tests.Shared중 알맞은 것으로 참조를 갱신해야 합니다. RootScope.prefab의_tickRunnerPrefab참조가Assets/Resources/TickRunner.prefab(신규 독립 프리팹)로 변경되었습니다. 커스텀 RootScope 프리팹을 별도로 관리 중이라면 동일하게 독립 TickRunner 프리팹을 구성해야 합니다.
삭제된 API
없음.
권장 API
- Camera 커스텀 초기화가 필요하면
CameraInstaller.Install(builder, settings)에CameraSettings인스턴스를 직접 전달하세요(기존과 동일하게 지원됨). - 수동 배치(AutoCreateRig=false) 시에는
CameraInstaller.cs주석의 안내(팩토리 인자를resolver.Resolve<CameraBrain>()로 교체)를 따르세요.
향후 버전 계획 (v1.1+)
v1.0.0 은 기능 고정(Feature Freeze) 상태입니다. 이후 변경은 실제 프로젝트 적용 중 발견되는 이슈 수정 위주로 진행하는 것을 권장합니다. 예상 후보는 Documentation/ReleaseChecklist.md 하단 "v1.1 권장 개선사항"을 참고하세요.