프로젝트 소개

QfStudio.Godette.ReactiveUI는 C# 개발을 위해 ReactiveUI를 Godot Engine과 통합합니다. 이 라이브러리는 ReactiveUI의 반응형 확장 기능을 Godot의 노드 시스템에 연결하는 플랫폼 서비스를 제공하여 Model-View-ViewModel 패턴 구현을 가능하게 합니다. 이 라이브러리는 this.Bind 및 this.OneWayBind 메서드를 통해 ViewModel 속성과 Godot 노드 속성 간의 데이터 바인딩을 지원합니다. 커맨드 바인딩은 ReactiveCommands를 버튼과 같은 Godot 컨트롤에 연결하며, CanExecute 처리를 자동으로 수행합니다. WhenActivated를 통한 활성화 수명 주기 관리는 Godot 씬 트리 존재 여부 및 노드 준비 상태에 반응하며, 비활성화 시 구독을 자동으로 정리합니다. 시그널-옵저버블 변환은 일반적인 Godot 컨트롤을 위한 타입 안전한 ObserveXxx 확장 기능과 커스텀 시그널을 위한 제네릭 ObserveSignal 브리지를 제공합니다. 컬렉션 바인딩은 ItemsBinder와 ItemList, OptionButton, TabBar, PopupMenu 전용 바인더를 통해 ObservableCollection을 Godot 컨테이너와 동기화합니다. 뷰 위치 지정 및 라우팅은 .tscn 씬 간의 내비게이션을 위해 ReactiveUI의 RoutingState와 통합됩니다. 이 라이브러리에는 Godot의 프로세스 또는 물리 프레임 및 메인 스레드 스케줄링에 동기화된 프레임 인식 연산자가 포함되어 있습니다. .NET 10, Godot 4.1+, ReactiveUI v23이 필요합니다. 설치는 NuGet 패키지를 추가하여 진행하며, 개발 경험 향상을 위한 선택적 소스 생성기를 사용할 수 있습니다.