networkSetup/docs/changes/2026-11-11-exe-file-tree-remove.md

설치파일 트리의 파일·폴더 삭제

2026-11-11. 설치 구성 › 설치파일 트리의 파일과 폴더 행에 삭제 버튼을 추가했다. 삭제는 이 버전의 설치 목록에서 빼는 것이며 소스 폴더의 실제 파일은 지우지 않는다. 화면과 규칙 편집까지이며 EXE 빌드·설치 시험은 범위 밖이다.

사용

1. 트리의 파일이나 폴더 행에 마우스를 올리면(키보드 포커스 포함) 오른쪽에 휴지통 버튼이 나온다. 설치 폴더(INSTALLDIR) 자체에는 없다.
2. 파일은 바로 빠진다. 폴더는 "폴더를 삭제할까요?" 팝업에서 경로와 안의 파일 수를 확인한 뒤 삭제를 누른다.
3. 저장해야 버전 파일에 반영된다. 저장 전에는 저장하지 않고 닫으면 되돌릴 수 있다. 잠긴 버전은 버튼이 비활성화된다.

모델과 실행

• 파일: 파일 추가로 넣은 파일(규칙의 포함 패턴이 그 파일 이름)은 그 이름을 포함 패턴에서 지우고, 포함 패턴이 비면 규칙도 지운다. **/* 같은 패턴으로 들어온 파일은 그 규칙의 제외 패턴에 경로를 문자 그대로([ ] * ? { } 이스케이프) 더한다.
• 폴더: 그 폴더나 하위를 대상으로 하는 규칙을 지운다. 위쪽 폴더의 규칙이 그 폴더에 파일을 넣고 있으면 그 규칙의 제외 패턴에 폴더/**를 더한다. 추가만 하고 비어 있던 폴더도 함께 지운다. Windows 기본 폴더 루트(예: ProgramData)도 지울 수 있으며, 설치 폴더 쪽 규칙은 다른 루트에 영향을 주지 않는다.
• 어느 규칙이 파일을 넣었는지는 파일 목록 미리보기(preview_files)의 규칙 ID로 판단한다. 목록을 읽는 중에는 NotScanned로 막고, 규칙을 찾지 못하면 UnknownRule, 설치 폴더 자체는 InstallFolderRemoval로 거부한다.
• 패치 버전에서 이전 버전이 설치한 파일을 빼면 기존처럼 입력 검사가 PatchRemovesFiles로 거부한다.
• 범위 밖: 여러 항목 한꺼번에 삭제, 실행 취소, 드래그로 옮기기.

확인 결과

• 프런트엔드 테스트 82개 통과; TypeScript/Vite 빌드 통과. 이름 규칙에서 빼기와 빈 규칙 삭제, 패턴 규칙 제외(한 번만, 문자 그대로), 다른 루트의 파일 제외, 폴더 삭제 시 하위 규칙 삭제·위쪽 규칙 제외·대기 폴더 정리, 루트 폴더 삭제, 설치 폴더·읽는 중·모르는 규칙 거부, 버튼 표시·잠금, 확인 팝업 이스케이프를 검사한다.
• Rust 코드는 바뀌지 않았다(Rust 테스트 72개 기존 통과 상태).
• 실제 앱에서 버튼을 눌러 보는 GUI 시험은 수행하지 않았다.

후속 변경 (같은 날): 설치파일 화면 단순화

• 설치파일 탭에는 폴더 추가·파일 추가 버튼과 트리만 남겼다. 트리 아래 파일 규칙(고급)(패턴 규칙 카드·패턴 규칙 추가), 제목 줄(설치 폴더 경로), "추가할 위치" 줄, "파일 목록을 읽는 중" 문구를 없앴다. 경고(소스 alias 없음, 읽지 못한 규칙, VFS)는 있을 때만 표시한다.
• 소스 폴더 연결 버튼이 고급 영역에만 있었으므로, 파일 추가를 눌렀을 때 이 PC에 연결된 소스 폴더가 없으면 먼저 소스 폴더 선택 창을 띄운다. 기존 폴더 선택과 같이 연결 전후로 프로젝트를 저장한다. MissingSource 안내 문구도 설치파일 탭 기준으로 바꿨다.
• 패턴(**/*, 제외 패턴)·소스 기준 폴더를 화면에서 고치는 기능과 연결된 소스 폴더를 바꾸는 기능은 화면에서 빠졌다. 규칙을 직접 고치려면 앱을 닫은 상태에서 .isver를 수정한다.
• 확인: 프런트엔드 테스트 78개 통과, TypeScript/Vite 빌드와 Rust 검사·데스크톱 빌드 통과. GUI 클릭 시험은 수행하지 않았다.

후속 변경 (같은 날): 버튼 위치·선택 기준·소스 연결

• 트리를 감싼 테두리 박스를 없애고 폴더 추가·파일 추가를 탭 설명 줄 오른쪽 끝으로 옮겼다.
• 폴더뿐 아니라 파일도 선택할 수 있다. 추가 위치는 선택한 폴더, 선택한 파일의 폴더, 선택이 없으면 최상위(설치 폴더)다. 처음에는 아무것도 선택되어 있지 않다. 선택한 파일을 다시 누르거나 트리의 빈 곳을 누르면 선택이 풀린다.
• 파일 추가는 소스 폴더 선택 창 없이 바로 파일 선택 창을 연다. 이 PC에 연결된 소스 폴더가 없으면 고른 파일이 있는 폴더(여러 파일이면 공통 상위 폴더)를 첫 소스의 폴더로 연결한다. 드라이브 루트는 미리보기·빌드가 드라이브 전체를 읽게 되므로 RootSource로 거부한다. 연결은 세션에만 바뀌고 저장해야 로컬 설정 파일에 쓴다. 이미 연결된 소스 밖의 파일은 연결된 폴더 경로를 알려 주는 OutsideSource로 거부한다.
• 확인: Rust 테스트 통과(common_folder의 공통 폴더·드라이브 루트 거부, OutsideSource 문구 포함), 프런트엔드 테스트 80개 통과, 데스크톱 빌드 통과. GUI 클릭 시험은 수행하지 않았다.

후속 변경 (같은 날): 행별 추가 버튼과 설치 위치 추가

• 폴더 추가·파일 추가를 각 폴더 행 오른쪽의 아이콘 버튼으로 옮겼다. 추가는 버튼을 누른 그 폴더에 들어간다. 파일 행에는 삭제 버튼만 있다. 행 선택(강조)과 선택 기준 추가는 없앴고, 폴더 행을 누르면 접히거나 펼쳐진다.
• 탭 설명 줄 오른쪽 끝에는 설치 위치 추가(EXE만)만 둔다. 아직 트리에 없는 Windows 기본 폴더(TARGET_ROOTS, x86은 64비트 폴더 제외)를 골라 트리에 루트로 더하며, 모두 추가했으면 비활성화된다. 추가한 루트는 행의 삭제로 다시 뺄 수 있다.
• 폴더 추가 팝업은 기본 위치 선택·직접 입력 대신 그 폴더 아래에 만들 이름만 받는다. Data\Config처럼 여러 단계를 한 번에 만들 수 있다.
• 새 버전은 설치 폴더 행(폴더·파일 추가 버튼 포함)과 "*설치할 파일들을 추가하세요." 문구로 시작한다.
• 확인: 프런트엔드 테스트 78개 통과, TypeScript/Vite 빌드 통과. Rust 코드는 바뀌지 않았다. GUI 클릭 시험은 수행하지 않았다.
• 루트 행에 전체 설치 경로를 표시하고, 하위 폴더·파일 행은 마우스를 올리면 전체 경로를 보여 준다(프런트엔드 테스트 79개 통과).
• 기본 설치 폴더(EXE)도 삭제할 수 있다. 그 안을 대상으로 하는 규칙과 대기 폴더를 지우고 트리에서 숨긴다(다른 루트는 영향 없음). 설치 위치 추가로 다시 넣거나 그 안을 대상으로 하는 항목이 생기면 다시 보인다. 숨김은 화면 상태라 버전을 다시 열면 원래대로 보인다.
• 설치 위치 추가 팝업은 기본 설치 폴더와 허용된 Windows 폴더를 모두 나열하고, 이미 트리에 있는 위치는 "추가됨"으로 비활성화한다. **직접 입력…**으로 [속성]하위\경로(속성 없으면 기본 설치 폴더 기준)를 받는다. 허용되지 않은 속성은 UnsupportedTargetRoot, 이미 있는 위치·폴더는 DuplicateFolder로 팝업 안에 표시한다. 프런트엔드 테스트 81개 통과.

후속 변경 (같은 날): 로컬 폴더 불러오기와 끌어다 놓기

• 폴더 추가 팝업에 **로컬 폴더 불러오기…**를 추가했다. 새 명령 choose_folders가 폴더 선택 창을 열고, 고른 폴더마다 같은 이름의 하위 폴더와 sourceFolder = 그 폴더, include = **/*인 규칙을 만든다. 같은 위치의 같은 폴더는 다시 추가하지 않고, 대상에 둘 수 없는 이름(MSIX 루트의 VFS 등)은 InvalidFolderName으로 전체를 거부한다.
• 탐색기에서 설치파일 트리로 파일·폴더를 끌어다 놓으면 놓은 행의 폴더(파일 행이면 그 파일의 폴더, 행 밖이면 기본 설치 폴더)에 추가한다. 창의 OS 드롭 이벤트에서 Rust가 경로를 세션에 기록하고 새 명령 take_dropped(인자 없음)가 한 번 소비한다. 화면은 포인터 위치만 쓴다. 설치파일 트리가 열려 있지 않거나 팝업이 떠 있으면 무시한다.
• 소스 규칙은 파일 추가와 같다: 연결된 소스 폴더 밖이면 OutsideSource, 연결된 소스가 없으면 항목들의 공통 상위 폴더(드라이브 루트 바로 아래의 폴더 하나면 그 폴더 자체)를 첫 소스로 연결한다.
• 확인: Rust 테스트 통과(locate_items의 파일·폴더 분리, 파일 대화상자의 폴더 거부, link_folder), 프런트엔드 테스트 84개 통과, 데스크톱 빌드 통과. 실제 끌어다 놓기와 폴더 선택 창 GUI 시험은 수행하지 않았다.
• 끌어다 놓기와 로컬 폴더 불러오기는 바로 적용하지 않는다. 후보 규칙을 preview_files로 읽어 추가할 파일 검토 팝업에 트리로 보여 주고, 확장자별·검색어별(파일 이름 기준, 대소문자 무시) 일괄 제외와 파일별 제외를 거쳐 적용해야 버전에 넣는다. 제외는 폴더 규칙의 제외 패턴(**/*.ext, **/*검색어*, 개별 경로를 문자 그대로)과 이름 규칙에서의 이름 삭제로 옮기며, 남는 파일이 없는 규칙은 넣지 않는다. 같은 폴더·같은 이름은 다시 넣지 않는다. 취소하면 아무것도 바뀌지 않는다(처음 연결한 소스 폴더만 남는다). 프런트엔드 테스트 88개 통과; GUI 시험은 수행하지 않았다.