Skip to content

Screens

dragonfavors edited this page Nov 10, 2026 · 6 revisions

화면 생명주기

문서 홈

상태 변경 → 비동기 훅 대기 → 완료 이벤트 → 호출한 Task 완료 순서입니다. OnActivatedAsync() 안에서는 이미 IsActive == true이지만, 작업 완료는 await ActivateAsync()로 확인합니다.

실행 순서

동작 순서
생성 Deactivated 상태
최초 활성화 Active·활성 메시지 구독 → LongMessenger 등록 → OnInitialActivatedAsync(token) → OnActivatedAsync(token) → Activated
비활성화 활성화 취소·대기 → Deactivated·활성 구독 해제 → OnDeactivatedAsync() → Deactivated 이벤트
재활성화 Active·활성 구독 → OnActivatedAsync(token) → Activated
종료 필요 시 비활성화 → View·LongMessenger 해제 → Closed → OnClosedAsync() → Closed 이벤트

OnStateChangedAsync(previous, current)는 상태 변경 직후 실행합니다. StateChanged 이벤트는 각 완료 이벤트 뒤에 발생합니다. 같은 완료 상태로 다시 전환하면 훅을 반복하지 않습니다.

초기화는 성공할 때까지 다시 시도합니다. 성공한 초기화는 닫았다 다시 열 때까지 유지됩니다. 이미 Dispose한 객체는 다시 열지 않습니다.

VM에서 재정의하기

using Gyedo;
using System;
using System.Threading;
using System.Threading.Tasks;

public class ContentViewModel : Screen
{
    private readonly Func<CancellationToken, Task<string>> load;
    private string content = "";
    public string Content
    {
        get => this.content;
        private set => this.SetProperty(ref this.content, value);
    }

    public ContentViewModel(Func<CancellationToken, Task<string>> load) => this.load = load;

    protected override async Task OnActivatedAsync(CancellationToken token)
    {
        string result = await this.load(token);
        token.ThrowIfCancellationRequested();
        this.Content = result;
    }
}

필요한 훅만 재정의합니다. 비동기 작업이 없으면 Task.CompletedTask를 반환합니다. Conductor를 상속했다면 await base.OnActivatedAsync(token) 등도 호출해 자식 처리를 유지합니다. 생성자에서 하던 화면 전환은 OnInitialActivatedAsync로 옮깁니다.

닫기 요청과 폐기

  • 일반 닫기: await RequestCloseAsync() 또는 부모의 CloseItemAsync(item). CanCloseAsync()가 거절하면 false, 종료·부모 정리까지 끝나면 true입니다.
  • 종료 조건을 추가할 때는 CanCloseAsync()를 재정의합니다. Conductor에서는 자식 검사도 필요하므로 base.CanCloseAsync() 결과를 확인합니다.
  • 직접 호출하는 CloseAsync()·TryCloseAsync()는 종료 확인을 우회합니다.
  • Conductor는 종료 후 부모 연결을 해제하고, DisposeChildren == true이면 IAsyncDisposable을 우선 사용해 폐기합니다. DI 소유 객체는 소유권 규칙을 따릅니다.

취소와 실패

상황 처리
활성화 중 비활성화·종료 요청 먼저 취소를 전달하고 작업 정리를 기다림
활성화 실패·취소 Deactivated로 되돌리고 활성 메시지 구독 해제·OnDeactivatedAsync 정리. Activated 이벤트 없이 오류 전달
비활성화·종료 정리 실패 이미 바뀐 상태 유지, 완료 이벤트 생략. 같은 메서드로 정리 재시도
종료 정리 실패 후 재활성화 먼저 CloseAsync 재시도를 성공시켜야 함

취소는 강제 중단이 아닙니다. 서비스에 토큰을 전달하고 결과 반영 전에도 확인하세요. 여러 자식 중 이미 끝난 정리까지 되돌리지는 않습니다.

같은 화면의 전환과 같은 Conductor의 탐색은 순서대로 처리합니다. 훅 안에서 자기 전환이나 현재 부모의 탐색을 다시 await하면 재진입 예외가 발생합니다.

View와 메시지는 별개

OnViewLoadedAsync()는 실제 View의 Loaded 알림이며 같은 화면의 작업과 순차 실행합니다. 창은 활성화 완료 후 표시하므로 활성화 훅에서 Loaded를 기다리지 않습니다.

Screen은 ObservableRecipient 기반입니다. 세 메신저의 수신 기간은 메시징을 참고하세요. 임의의 명령·타이머·백그라운드 작업은 수명주기 Task에 자동 포함되지 않으며 필요한 정리는 훅에서 기다립니다.

상태 전환은 UI 스레드에서 호출합니다. await가 작업을 자동으로 백그라운드에 옮기지는 않습니다. 스레드 처리

Clone this wiki locally