Repository navigation
Screens
상태 변경 → 비동기 훅 대기 → 완료 이벤트 → 호출한 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한 객체는 다시 열지 않습니다.
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하면 재진입 예외가 발생합니다.
OnViewLoadedAsync()는 실제 View의 Loaded 알림이며 같은 화면의 작업과 순차 실행합니다. 창은 활성화 완료 후 표시하므로 활성화 훅에서 Loaded를 기다리지 않습니다.
Screen은 ObservableRecipient 기반입니다. 세 메신저의 수신 기간은 메시징을 참고하세요. 임의의 명령·타이머·백그라운드 작업은 수명주기 Task에 자동 포함되지 않으며 필요한 정리는 훅에서 기다립니다.
상태 전환은 UI 스레드에서 호출합니다. await가 작업을 자동으로 백그라운드에 옮기지는 않습니다. 스레드 처리