Skip to content

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 원본과 접근 권한을 확인합니다.

실제 WPF UI 흐름만 실행

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 호스트를 섞는 구성은 별도 설계가 필요합니다.

Clone this wiki locally