Repository navigation
Troubleshooting
dragonfavors edited this page Nov 10, 2026
·
9 revisions
증상에 해당하는 항목부터 확인합니다.
| 증상 | 확인할 내용 |
|---|---|
| View를 찾지 못함 | VM/View 이름·네임스페이스·검색 어셈블리. 이름 규칙 |
| ViewManager 리소스 오류 | ApplicationLoader 또는 StartGyedoAsync로 초기화했는지 |
| 콘텐츠에 창을 넣을 수 없음 | 자식 View는 UserControl, 별도 창은 Window 사용 |
| 같은 화면을 두 곳에 넣을 때 오류 | 같은 VM/View를 두 부모가 공유하지 않는지 |
| 생성 속성·명령을 찾지 못함 | Toolkit 직접 참조, partial 선언, 생성기 진단 |
| 버튼 상태가 갱신되지 않음 | NotifyCanExecuteChangedFor 또는 NotifyCanExecuteChanged 호출 |
| 활성화 훅이 끝나기 전에 IsActive가 true | 정상 동작. 완료는 전환 메서드를 await해 확인 |
| 디스패처의 async 작업이 너무 일찍 끝남 | Action용 Post·Send 대신 InvokeAsync 또는 Execute의 Async 오버로드 사용 |
| 우선순위가 적용되지 않음 | 현재 UI에서 즉시 실행하는 RunAsync 대신 게시 API 사용 |
| 화면 전환이 끝나지 않음 | 훅이 취소를 처리하는지, UI Wait/Result나 자기 전환 await가 있는지 |
| 재활성화가 거절됨 | 실패한 CloseAsync 정리를 먼저 재시도했는지 |
| 메시지가 오지 않거나 닫힌 VM에도 옴 | 발신 메신저와 수신 기간을 맞췄는지 |
| VM을 생성하지 못함 | 생성자 의존성을 DI에 등록했는지 |
| Scoped 서비스 오류·중복 Dispose | Scope와 소유권을 맞췄는지 |
| RequestCloseAsync 부모 오류 | Conductor 또는 WindowManager에 연결된 화면인지 |
| 창이 닫히지 않음 | CanCloseAsync 거절 여부, 종료 훅의 예외·대기 확인 |
| Main이 중복됨 | StartupObject와 App.xaml의 ApplicationDefinition/Page 설정 |
| 앱 종료 정리가 누락됨 | Application.Shutdown 직접 호출 대신 정상 종료 API 사용 |
저장소 루트에서 실행합니다.
dotnet test Gyedo.Core.Tests/Gyedo.Core.Tests.csproj
dotnet test Gyedo.Wpf.Tests/Gyedo.Wpf.Tests.csproj
dotnet build Gyedo.sln
dotnet build Samples/Gyedo.Samples.sln코어 테스트는 .NET 10 SDK로 실행합니다. WPF·샘플·템플릿은 Windows가 필요합니다. 패키지 복원이 실패하면 NuGet 원본과 접근 권한을 확인합니다.
dotnet test Gyedo.Wpf.Tests/Gyedo.Wpf.Tests.csproj --filter "TestCategory=WpfIntegration"WpfUiFlowTests는 실제 창·ViewManager·WindowManager·기본 탭 스타일을 구동합니다. 화면 밖에 창을 표시하고 UI Automation 버튼 호출과 컨트롤 선택으로 검증합니다.
창·바인딩, 모달 결과, 메시지 박스, 탭 전환 실패 복구, 로딩 중 종료, 종료 거절·재시도, 세 메신저, 우선순위에 따른 UI 갱신을 확인합니다. 고정 시간만 기다리지 않고 UI 이벤트와 Task 완료를 기다리며 테스트 종료 시 창을 정리합니다.
| 샘플 | 확인할 내용 |
|---|---|
| Hello | 생성 속성·명령, 메시지 박스 |
| CustomStartup | 직접 작성한 Main과 호스트 |
| HelloDialog | 대화상자 결과 |
| TabNavigation | OneActive 탭 |
| NavigationController | 탐색 서비스·팩터리 |
| MasterDetail | 목록·상세 화면 |
| ModelValidation | FluentValidation·버튼 조건 |
| OverridingViewManager | View 탐색 규칙 |
| DesignMode | 디자인 모드 |
| RedditBrowser | 복합 탐색·AlwaysMessenger·비동기 요청 응답 |
RedditBrowser에는 오래된 Newtonsoft.Json 간접 의존성의 NuGet 경고가 남아 있습니다. 실제 외부 API 연결은 별도 확인이 필요하며, 단위 테스트는 해당 네트워크 호출 없이 검증합니다.
현재 창 관리는 WPF 전용이고 Execute는 전역 Dispatcher를 사용합니다. 여러 UI 스레드·여러 UI 호스트를 섞는 구성은 별도 설계가 필요합니다.