Skip to content
dragonfavors edited this page Nov 10, 2026 · 7 revisions

계도 · Gyedo 사용 가이드

Gyedo는 Stylet에서 파생된 독립 MVVM 라이브러리입니다. Stylet의 화면 관리 설계를 바탕으로 CommunityToolkit.Mvvm을 통합하고, 기능을 줄여 비동기 화면 수명주기에 집중합니다.

현재 .NET 10과 WPF를 지원하며, ViewModel에 맞는 View를 찾아 연결하고 화면 전환과 종료를 관리합니다. 속성·명령·메시징은 CommunityToolkit.Mvvm, 앱 시작과 DI는 Generic Host를 사용합니다.

먼저 알아둘 세 가지

  • 화면 전환은 await합니다. 상태를 먼저 바꾸고 비동기 훅을 기다린 뒤 완료 이벤트를 보냅니다.
  • 수신 기간을 선택합니다. Messenger는 활성 중, LongMessenger는 최초 활성화부터 닫기까지, AlwaysMessenger는 인스턴스가 살아 있는 동안 수신합니다.
  • 닫기와 폐기는 다릅니다. 화면 종료 후 누가 객체를 Dispose할지는 Conductor·DI의 소유권에 따라 정합니다.

시작하기

  1. 빠른 시작으로 첫 WPF 앱을 만듭니다.
  2. 화면 생명주기와 화면 전환을 확인합니다.
  3. 앱이 Main과 호스트를 직접 구성해야 하면 커스텀 Main을 사용합니다.

기능 찾기

문서 다루는 내용
호스트와 DI 서비스 등록, Scope, 앱 종료와 객체 폐기
Toolkit 속성과 명령 생성 속성, 버튼 실행 조건, 비동기 명령
화면 생명주기 상태·훅·이벤트 순서, 종료 확인, 실패·취소
화면 전환과 탭 단일 화면, 탭, 여러 화면, 뒤로 가기
View 연결 이름 규칙, 자식 화면 표시, View 재사용
창과 대화상자 창 표시, 결과 반환, 메시지 박스
메시징 세 수신 기간, 발신 예제, 비동기 응답
입력 검증 IModelValidator, 오류 표시, 저장 전 검증
스레드와 컬렉션 UI 전달, 속성 알림, BindableCollection
기타 도구 속성 구독, 컨버터, 디자인 모드, 로깅
이전 안내 제거·변경한 API와 대체 방법
문제 해결 증상별 확인 사항, 빌드·테스트, 샘플

구성과 지원 범위

참조할 프로젝트 대상 역할
Gyedo.Core net10.0 화면 모델·탐색·검증·메시징·컬렉션
Gyedo.Wpf net10.0-windows WPF View·창 관리·호스트 연결. 코어도 함께 참조

공통 네임스페이스는 Gyedo입니다. 현재 UI 어댑터는 WPF이며, Avalonia와 창·탭별 DI Scope 자동 관리는 제공하지 않습니다. 검증은 IModelValidator, 메시징은 Toolkit의 IMessenger를 사용합니다.

NuGet.org의 원본 Stylet 패키지에는 이 포크의 새 API가 없습니다. 이 저장소의 프로젝트를 참조하거나 직접 빌드한 패키지를 사용하세요.

Clone this wiki locally