releases/.claude/rules/desktop-wpf.md

1.7 KiB

paths
VideoDownloader.App/**
VideoDownloader.Browser/**

WPF · WebView2 영역 규칙

UI 스레드

  • WebView2·엔진 이벤트는 백그라운드 스레드에서 온다. UI 를 만지려면 Dispatcher.BeginInvoke 로 마샬링한다 (MainWindow.xaml.cs 전반의 기존 패턴).
  • 백그라운드에서 갱신되는 컬렉션은 BindingOperations.EnableCollectionSynchronization 으로 락을 등록한다 (Core/DownloadManager.cs:58 참조). 이걸 빼면 랜덤하게 죽는다.

dispose 이후 이벤트

WebView2 가 dispose 된 뒤에도 이벤트 콜백이 도착한다. 콜백 안에서 CoreWebView2 를 만질 때는 로컬 변수로 받아 null 을 확인하고 try 로 감싼다 — UpdateNavState(MainWindow.xaml.cs:453)가 기준 패턴이다. 탭을 닫는 경로를 건드렸다면 이 방어를 반드시 확인한다.

탭

  • Environment 는 전 탭 공유, WebView2 인스턴스는 탭마다. 이 구조를 바꾸지 않는다.
  • 팝업(NewWindowRequested)은 deferral 패턴으로 새 탭에 붙인다. 앱 통제를 벗어나게 두지 않는다.

거대 파일

MainWindow.xaml.cs(86KB) · MainWindow.xaml(55KB)은 통째로 읽지 않는다. Grep 으로 심볼 위치를 찾고 해당 구간만 Read 한다. 분할 리팩터링은 별도 승인 사항이다.

프로세스 실행

외부 프로세스는 문자열 인자 연결로 실행하지 않는다. ProcessStartInfo 에 인자를 배열로 넘긴다 (과거 explorer.exe 인자 인젝션 취약점이 있었다).

테스트 접근

VideoDownloader.App 은 InternalsVisibleTo("VideoDownloader.Tests") 가 걸려 있다. 테스트를 위해 멤버를 public 으로 승격하지 말고 internal 로 두면 된다.