Pull Request 작성기 - wpfui (1)

🛠️ WPF 개발, ‘wpfui’와의 설레는 첫 만남과 의외의 난관

최근 토이 프로젝트를 진행하면서 WPF로 세련된 UI를 구현하고 싶은 열망이 생겼습니다. 그러던 중 Fluent Design System 스타일의 컨트롤을 제공하는 ‘wpfui’라는 UI 라이브러리를 발견했습니다. 깔끔한 디자인과 뛰어난 사용성에 매료되어 주저 없이 프로젝트에 도입하게 되었습니다.

초기에는 만족스럽게 사용하던 중, 특정 컨트롤에서 예상치 못한 동작을 발견하고 의아해졌습니다. 바로 SplitButton에서 발생한 이상 현상이었습니다.

🤨 SplitButton, 기대와 달랐던 작동 방식에 혼란

제가 마주친 문제는 SplitButton의 Flyout(팝업 메뉴) 작동 방식에 있었습니다. 일반적으로 SplitButton은 두 개의 distinct한 영역으로 구성됩니다. 메인 버튼 영역을 클릭하면 특정 기능이 실행되고, 오른쪽의 작은 토글 버튼 영역을 클릭하면 Flyout이 열리는 것이 standard한 사용자 경험입니다.

하지만 ‘wpfui’의 SplitButton은 완전히 달랐습니다. 토글 버튼 영역을 클릭했을 때 간혹 메인 버튼의 커맨드가 실행되거나 Flyout이 열리지 않는 현상이 지속적으로 발생했습니다. 처음에는 제 코드에서 SplitButton의 이벤트를 잘못 처리했나 의심하며 여러 차례 디버깅을 시도했습니다. 하지만 코드를 아무리 꼼꼼히 살펴보아도 제 실수로 보이지 않았습니다.

결국 ‘wpfui’ 라이브러리의 내부 코드를 직접 파헤치게 되었습니다. ControlTemplate과 이벤트 처리 로직을 면밀히 추적하여 문제의 근본 원인을 찾아낼 수 있었습니다.

🚨 문제의 핵심: 클릭 영역 제한과 Flyout의 부자연스러운 동작

기존 구현에서는 버튼의 매우 제한된 부분, 특히 텍스트가 표시되는 영역을 정확히 클릭해야만 Flyout이 정상적으로 열리도록 되어 있었습니다.

📌 문제 화면:

이는 사용자에게 극도로 혼란스러운 사용자 경험을 제공했습니다. 토글 버튼을 클릭했을 때 예상치 못한 동작(메인 커맨드 실행 또는 아무 반응 없음)으로 인해 UI가 제대로 작동하지 않는 것처럼 느껴졌습니다.

✍️ ControlTemplate 수정으로 해결, 비로소 찾아온 시원함

상황이 도저히 개선될 수 없다고 판단하고, ‘wpfui’의 소스 코드를 참고하여 SplitButton의 ControlTemplate을 직접 재정의하고 마우스 이벤트 처리 방식을 수정했습니다.

핵심은 토글 버튼의 어느 영역을 클릭하더라도 일관적으로 Flyout이 열리도록 이벤트 트리거 조건을 변경하는 것이었습니다. 여러 번의 시도 끝에 원하는 대로 동작하도록 수정했을 때, 마음속 깊은 곳에서 시원함을 느꼈습니다.

📌 수정 후 화면:

마침내 제가 기대했던 자연스러운 SplitButton의 동작을 구현할 수 있었습니다.

🚀 나만의 해결책을 넘어, 오픈소스 기여로 발걸음을 내딛다

문제를 해결한 후, 다른 사용자들도 이와 유사한 어려움을 겪었을 것이라는 생각이 들었습니다.

호기심에 ‘wpfui’의 GitHub 저장소를 방문해 Issues 목록을 살펴보았고, 과연 제가 겪은 것과 동일한 문제를 보고한 이슈가 이미 존재하고 아직 해결되지 않은 상태였습니다!

이는 제 해결 방법이 다른 사용자들에게도 실질적인 도움이 될 수 있음을 의미했습니다. 즉시 오픈소스 프로젝트에 Pull Request(PR)를 통해 기여할 기회라고 판단했습니다.

수정한 코드를 바탕으로 ‘wpfui’ 저장소를 포크하고, 새로운 브랜치를 생성하여 변경 사항을 커밋하고 푸시했습니다. 그리고 문제 이슈를 참조하는 형태로 PR을 작성했습니다.

📌 PR 화면:

PR 템플릿이 잘 구성되어 있어 문제 설명과 해결 방법을 상세히 작성하는 데 큰 어려움이 없었습니다. 제가 발견하고 해결한 작은 문제가 커뮤니티에 기여할 수 있다는 사실에 뿌듯함을 느꼈습니다.

⏳ Merge를 기다리며, 오픈소스 컨트리뷰터가 되는 꿈

이제 제가 제출한 PR이 프로젝트 관리자들의 리뷰를 거쳐 병합(Merge)되기를 기다리고 있습니다. GitHub에 쌓여 있는 수많은 PR들을 보며 ‘언제쯤 내 PR이 검토될까?’ 하는 생각도 들지만, 제가 수정한 코드가 반영되어 ‘wpfui’를 사용하는 다른 개발자들에게 도움이 되고, 나아가 이 훌륭한 오픈소스 프로젝트의 공식 Contributor 목록에 제 이름(아이디)이 새겨지는 날을 간절히 기대하고 있습니다!

비록 작은 기여일지라도, 제가 겪은 불편함을 해결하는 과정이 다른 사람들에게도 긍정적인 영향을 줄 수 있다는 사실에 큰 보람을 느낍니다. 앞으로도 오픈소스 활동에 꾸준히 참여하고 싶다는 동기 부여가 된 경험이었습니다. Merge되는 그날까지 설레는 마음으로 기다리겠습니다!