notParsec / 문서전체 문서

설명·설계 문서

Windows 앱 실행과 별도 콘솔 창

design/WINDOWS_APP_LAUNCH.ko.md

출처: 현재 작업 폴더 · 원문 다운로드

이 문서의 목차

2026-09-24 · F30/F61/F64 · 통합 EXE 실행 형식 교정.

사용자는 AccessKit 초기화 순서를 수정한 빌드 1790276509를 웹에서 다시 내려받은 뒤 앱 실행에 성공했다고 보고했다. 이어 앱과 별도로 콘솔 창이 표시되는 문제를 확인했다. 자동 업데이트를 통한 교체 성공까지 보고한 것은 아니다.

원인과 수정

기존 notParsec EXE는 PE Subsystem = 3(Windows console)이어서 탐색기에서 실행할 때 Windows가 콘솔을 만들었다. apps/desktop/src/main.rs에 Windows GUI subsystem을 지정해 Subsystem = 2로 빌드한다. 실행 후 창을 숨기는 방식이 아니라 시작 시 콘솔을 만들지 않는 실행 형식이다.

같은 EXE의 기존 CLI 진단·인증 명령은 유지한다. apps/desktop/src/console.rs에서 부모 터미널이 있으면 AttachConsole(ATTACH_PARENT_PROCESS)로 연결하고, 기존 표준 입출력의 파일·파이프 리다이렉션을 보존한다. 새 콘솔을 할당하지 않는다. 일반 탐색기 실행에서는 부모 콘솔이 없으므로 연결 실패를 정상 처리한다. GUI 시작 오류·panic의 notparsec.startup.json 기록은 유지한다.

scripts/ci/inspect_release.py는 실제 배포 EXE가 GUI subsystem인지 검사하고 console subsystem 빌드를 거부하도록 강화했다. Windows CLI의 출력·입력 리다이렉션과 새 빌드의 실제 탐색기 실행은 실기기 추가 확인 대상이다. GUI subsystem의 CLI 실행을 명령 프롬프트에서 기다려야 한다면 start /wait를, PowerShell에서 출력 완료를 기다려야 한다면 | Out-Host를 사용할 수 있다.

원본 대조와 검증 범위

API 근거: Rust windows_subsystem, Microsoft AttachConsole, Microsoft 표준 핸들과 리다이렉션.