50 lines
2.6 KiB
Markdown
50 lines
2.6 KiB
Markdown
---
|
|
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` 로 두면 된다.
|
|
|
|
## 아이콘 글리프 (PUA · Segoe Fluent Icons)
|
|
|
|
- **암시적(키 없는) TextBlock 스타일에 FontFamily 를 넣지 않는다.** 버튼 ContentPresenter 가 만드는
|
|
자동 TextBlock 이 IconFont 상속을 잃어 모든 아이콘이 tofu(□)가 된다(2026-08-18 실결함 — 원인 규명에
|
|
실캡처·픽셀 비교까지 필요했다). UI 폰트 통일은 각 창 루트의 `FontFamily="{DynamicResource UiFont}"`
|
|
상속으로 한다. 코드 생성 창은 `SetResourceReference(FontFamilyProperty, "UiFont")`.
|
|
- PUA 글리프는 IconFont 보장 스타일(IconButton·FluentIcon·CaptionButton 계열)이나 명시
|
|
`FontFamily="{DynamicResource IconFont}"` 에서만 쓴다. **한 문자열에 PUA 와 일반 텍스트를 섞지 않는다.**
|
|
`Infrastructure/IconGlyphXamlTests` 가 정적으로, `E2E/IconContentFontTests` 가 실창에서 이를 강제한다.
|