MSIX 일렉트론 앱에서 AppData 갈라짐과 폴더 생성 실패

먼저 결론
증상: 스토어판(MSIX)으로 싼 일렉트론 앱에서 내부 엔진이 "폴더 없음"으로 안 서고, 새 파일과 원래 파일이 서로 다른 폴더에 저장됐습니다.
원인: 꾸러미 앱의 설치 폴더는 읽기 전용이라 켤 때 폴더 만들기가 실패하고, %APPDATA% 에 새로 만드는 파일은 Packages\<꾸러미>\LocalCache\Roaming\ 으로 옮겨집니다.
해결: 필요한 폴더는 자리 표시 파일을 넣어 꾸러미에 미리 담고, 사용자 작업 폴더 기본값은 문서 폴더로 둡니다.

일반 설치본(NSIS)으로 잘 돌던 일렉트론 데스크톱 앱을 MS 스토어용 MSIX 로 포장해 시험했습니다. 스토어 제출 전에 이 PC 에서 시험용 꾸러미를 굽고 개발자 모드로 등록해 돌려 본 기록입니다. 겪은 순서대로 적습니다.

겪은 순서대로 다섯 가지

1. 켤 때 폴더를 만드는 코드가 조용히 실패했다

앱 안의 파이썬 엔진이 켜질 때 빈 설정 폴더를 os.makedirs 로 만들게 되어 있었습니다. 일반 설치본은 %LOCALAPPDATA%\Programs\ 아래에 깔려 쓰기가 되니 문제가 없었습니다.

스토어판은 설치 폴더가 읽기 전용입니다. 폴더 만들기가 실패했는데 코드가 try/except pass 로 감싸 있어 아무 말 없이 넘어갔고, 엔진은 "폴더 없음"으로 서지 않았습니다. 빈 폴더를 미리 넣어 두려 해도 굽는 도구가 빈 폴더는 버립니다.

그래서 폴더 안에 자리 표시 파일 하나를 넣어 폴더를 살린 채로 구웠습니다. 일반 설치본에서도 이 문제를 미리 잡으려면 설치 폴더에 쓰기 금지를 걸고 켜 봅니다.

icacls "설치 폴더" /deny "사용자:(OI)(CI)(WD,AD,WEA,WA,DC,DE)"
icacls "설치 폴더" /remove:d "사용자"

여기서 (W) 로 막으면 안 됩니다. W 에는 SYNCHRONIZE 까지 들어 있어 읽기도 깨집니다. 위처럼 쓰기에 해당하는 권한만 하나씩 막습니다.

2. AppData 가 두 곳으로 갈라졌다

꾸러미 신분으로 도는 프로그램이 %APPDATA% 에 새로 만드는 파일은 실제로는 이곳에 저장됐습니다.

%LOCALAPPDATA%\Packages\<꾸러미 가족 이름>\LocalCache\Roaming\

그런데 일반 설치본이 이미 만들어 둔 파일(로그, 로그인 정보)은 원래 폴더에 그대로 썼습니다. 환경값 %APPDATA% 는 원래 경로를 그대로 보여 주므로 프로그램은 갈라진 것을 모릅니다.

이것이 뜻하는 것은 둘입니다. 일반 설치본을 쓰던 사람이 스토어판으로 옮기면 자료가 두 곳에 나뉩니다. 그리고 스토어판을 지우면 Packages\<꾸러미> 가 함께 지워지므로, 작업 폴더 기본값이 자료 폴더 안이면 사용자가 만든 것이 사라집니다. 그래서 작업 폴더 기본값을 문서 폴더로 바꿨습니다. 매니페스트의 unvirtualizedResources 라는 다른 길도 있지만 제한 권한이라 심사 사유가 필요하고, 직접 확인하지는 않았습니다.

3. 굽기가 spawn UNKNOWN 으로 죽었다

명령은 electron-builder --win appx --publish never 였습니다. electron-builder 가 내려받아 둔 makeappx.exe 가 그 자리(%LOCALAPPDATA%\electron-builder\Cache\winCodeSign-2.6.0\...\windows-10\x64\)에서 "side-by-side 구성이 잘못됨"으로 실행되지 않았고, 굽기는 spawn UNKNOWN 으로 끝났습니다.

그 폴더를 통째로 다른 곳(아래 예에서는 C:\tools\makeappx\)에 복사하니 돌았습니다. 그다음 electron-builder 가 남긴 배치표로 직접 쌌습니다.

& "C:\tools\makeappx\makeappx.exe" pack /o /f dist\__appx-x64\mapping.txt /p 결과.appx

4. 깃 배시에서는 사용법만 찍혔다

위 명령을 깃 배시에서 부르면 /f, /p 같은 인자가 드라이브 경로로 바뀌어 makeappx 가 사용법만 찍고 끝납니다. 이런 윈도우식 인자를 쓰는 도구는 파워셸에서 부릅니다. 경로에 띄어쓰기가 있을 때 다른 쪽에서 생기는 문제는 파이썬 execv 가 띄어쓰기 경로에서 죽을 때에 적었습니다.

5. 스토어판인데 앱 안 업데이트가 돌았다

electron-updater 는 스토어판에서도 그대로 돌았습니다. 시험 앱이 실제로 latest.yml 을 확인했습니다. 새 판이 있었다면 일반 설치본을 받아 스토어 설치 위에 덮었을 것입니다. 그래서 process.windowsStore 가 참이면 업데이트 받기와 새 판 알림을 건너뛰게 했습니다.

원인과 처방 한눈에 보기

증상 원인 처방
엔진이 "폴더 없음" 읽기 전용 설치 폴더, 빈 폴더는 굽기에서 빠짐 자리 표시 파일로 폴더를 담아 굽는다
파일이 두 폴더에 나뉨 새 파일만 LocalCache\Roaming 으로 옮겨짐 작업 폴더 기본값을 문서 폴더로
spawn UNKNOWN 캐시 자리의 makeappx 가 side-by-side 오류 폴더를 복사해 직접 pack
사용법만 찍힘 깃 배시가 /f, /p 를 경로로 바꿈 파워셸에서 부른다
일반 설치본으로 덮일 뻔 electron-updater 가 스토어판에서도 동작 process.windowsStore 면 건너뜀

꾸러미 안에서 도는지 헷갈릴 때는 파이썬 ctypes.windll.kernel32.GetCurrentPackageFullName 을 불러 봅니다. 돌려주는 값이 0 이면 꾸러미 신분이 있고, 15700 이면 없습니다. 엔진 같은 부품만 꾸러미 안에서 따로 돌릴 때는 Invoke-CommandInDesktopPackage 를 썼습니다. 표준 입출력이 이어지지 않아 배치 파일 안에서 결과를 파일로 받았습니다. 위 1번처럼 오류를 삼키는 코드가 왜 위험한지는 파이썬이 조용히 실패하는 경우에 모았습니다.

시험한 방법과 환경

스토어 서명 없이 개발자 모드에서 등록해 시험했습니다. 개발자 모드는 HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock 의 AllowDevelopmentWithoutDevLicense 가 1 인지로 확인합니다.

Add-AppxPackage -Register "풀어 둔 폴더\AppxManifest.xml"
Get-AppxPackage -Name <identityName>     # PackageFamilyName 확인
Remove-AppxPackage <PackageFullName>     # 끝낼 때 (Packages 자료 폴더도 지워짐)
항목 값
운영체제 윈도우 10, 개발자 모드
포장 도구 electron-builder (appx 대상), winCodeSign-2.6.0 의 makeappx
설치 방식 Add-AppxPackage -Register (서명 없음)
확인한 날짜 2026년 9월 29일

스토어에서 서명해 설치하는 경우(C:\Program Files\WindowsApps\)에도 같은 규칙인지는 확인하지 못했습니다. 이 글의 내용은 개발자 모드 등록 기준입니다.

이 글의 내용은 2026년 10월 11일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.