Phase 2: MSIX 패키지 + IExplorerCommand 셸 익스텐션

C++ 셸 익스텐션 (src/EverythingToJpeg.Shell/) - WRL RuntimeClass 패턴으로 IExplorerCommand 두 핸들러 구현 - Quick(빠른 변환) / Dialog(설정 창) verb를 다른 CLSID로 분리 - Invoke()에서 EverythingToJpeg.exe로 verb + 파일 경로 전달 - VS 2026 빌드 검증, /utf-8 한글 라벨 지원 MSIX 패키징 (packaging/) - Package.appxmanifest: com:SurrogateServer + desktop4:FileExplorerContextMenus - 26개 확장자 × 2 verb 자동 노출 - BuildMsix.ps1: dotnet publish + msbuild + makeappx 일관 파이프라인 - CreateDevCert.ps1 / Install-EverythingToJpeg.ps1: 자체 서명 인증서 워크플로 - GenerateAssets.ps1: placeholder 로고 자동 생성 CI/CD - .github/workflows/release.yml: 태그 푸시 시 미서명 MSIX 자동 빌드 + 첨부 검증 - 50MB MSIX 산출 확인 (packaging/dist/EverythingToJpeg-x64.msix) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 13:03:16 +09:00 · 2026-05-06 13:03:16 +09:00 · f2c8610ff6
commit f2c8610ff6
parent 8fa4a613d7
19 changed files with 973 additions and 41 deletions
--- a/packaging/README.md
+++ b/packaging/README.md
@ -1,25 +1,87 @@
-# Phase 2 — MSIX 패키징 (placeholder)
+# Phase 2 — MSIX 패키징

-이 폴더는 향후 IExplorerCommand 셸 익스텐션 + MSIX Sparse Package 작업을 위한 자리입니다. 현재 구현되지 않았습니다.
+Win11 메인 우클릭 메뉴에 "JPEG로 빠른 변환" / "JPEG로 변환…"을 띄우는 정공법.

-## 다음 단계 체크리스트
+## 구성

- [ ] `EverythingToJpeg.Shell` C++/WinRT 또는 C#(WinRT projection) 프로젝트 생성 → `IExplorerCommand` 구현
- [ ] `Package.appxmanifest` 작성 — `<uap3:Extension Category="windows.fileExplorerContextMenus">` 사용
- [ ] Windows Application Packaging Project (.wapproj) 생성 — App + Shell DLL 묶기
- [ ] 자체 서명 인증서 생성 스크립트:
-  ```powershell
-  New-SelfSignedCertificate -Type CodeSigningCert `
-      -Subject "CN=EverythingToJpegDev" `
-      -KeyAlgorithm RSA -KeyLength 2048 `
-      -CertStoreLocation "Cert:\CurrentUser\My"
-  ```
- [ ] MakeAppx + SignTool로 MSIX 빌드 + 서명
- [ ] 5대 PC에 인증서를 `Cert:\LocalMachine\TrustedPeople`에 임포트
- [ ] GitHub Actions: 태그 푸시 시 unsigned MSIX 자동 빌드 + Release 첨부
+```
+packaging/
+├── Package.appxmanifest           — IExplorerCommand 등록 (com:Class + desktop4:FileExplorerContextMenus)
+├── Assets/                        — 앱 아이콘 (placeholder, GenerateAssets.ps1로 생성)
+├── GenerateAssets.ps1             — placeholder PNG 일괄 생성
+├── CreateDevCert.ps1              — 자체 서명 코드사이닝 인증서 생성 + PFX export
+├── BuildMsix.ps1                  — .NET publish + C++ DLL 빌드 + makeappx + (선택) signtool
+└── Install-EverythingToJpeg.ps1   — 5대 PC 1회 설치 스크립트
+```

-## 참고
+C++ Shell DLL은 `src/EverythingToJpeg.Shell/` 에 있고 `BuildMsix.ps1` 안에서 자동 빌드됩니다.

- [PowerToys 컨텍스트 메뉴 개발 문서](https://github.com/microsoft/PowerToys/blob/main/doc/devdocs/common/context-menus.md)
- [IExplorerCommand C# 예제](https://github.com/cjee21/IExplorerCommand-Examples)
- [Microsoft: Sparse package 등록](https://learn.microsoft.com/en-us/windows/apps/desktop/modernize/grant-identity-to-nonpackaged-apps)
+## 1회: 자체 서명 인증서 만들기
+
+```powershell
+cd packaging
+.\CreateDevCert.ps1
+# Subject 기본값: CN=EverythingToJpegDev (Package.appxmanifest의 Publisher와 일치)
+# 비밀번호 입력 → EverythingToJpeg-DevCert.pfx 생성
+```
+
+출력된 Thumbprint를 `BuildMsix.ps1 -CertThumbprint <값>` 으로 사용하거나, PFX 파일을 5대 PC에 복사해서 설치 시 사용합니다.
+
+## 빌드
+
+### 미서명 (Phase 1 그대로 사용 가능, 메인 메뉴 노출은 안 됨)
+```powershell
+.\BuildMsix.ps1
+# 산출: packaging/dist/EverythingToJpeg-x64.msix
+```
+
+### 서명
+```powershell
+# 방법 1: PFX 사용
+.\BuildMsix.ps1 -Sign -PfxPath .\EverythingToJpeg-DevCert.pfx
+
+# 방법 2: 인증서 저장소의 Thumbprint
+.\BuildMsix.ps1 -Sign -CertThumbprint AABBCCDD...
+```
+
+## 5대 PC 설치 (관리자 PowerShell)
+
+```powershell
+.\Install-EverythingToJpeg.ps1 `
+    -PfxPath .\EverythingToJpeg-DevCert.pfx `
+    -MsixPath .\EverythingToJpeg-x64.msix
+```
+
+스크립트가 자동으로:
+1. PFX를 `LocalMachine\TrustedPeople` 에 임포트
+2. PFX를 `LocalMachine\Root` 에도 임포트 (체인 신뢰)
+3. `Add-AppxPackage` 로 MSIX 사이드로드
+
+설치 후 PNG/JPG/HEIC/PDF/DOCX 등을 우클릭하면 **메인 메뉴에 직접** "JPEG로 빠른 변환" / "JPEG로 변환…"이 보입니다.
+
+## 미서명 사이드로드 (Phase 2 임시 사용)
+
+자체 서명 만들기조차 귀찮을 때:
+```powershell
+# 개발자 모드 켜기: 설정 → 개인 정보 및 보안 → 개발자용 → 켜기
+Add-AppxPackage -AllowUnsigned -Path .\EverythingToJpeg-x64.msix
+```
+> Win11 24H2부터 `-AllowUnsigned` 지원. 이전 버전은 자체 서명 권장.
+
+## CI/CD
+
+`.github/workflows/release.yml` — 태그 푸시(`v1.0.0` 등) 시 자동:
+1. .NET / MSBuild 셋업
+2. `BuildMsix.ps1` 실행 (미서명)
+3. GitHub Release 생성 + MSIX 첨부
+
+서명까지 자동화하려면 GitHub Secrets에 `PFX_BASE64`, `PFX_PASSWORD`를 등록하고 워크플로에 단계 추가 (별도 보안 검토 후).
+
+## 트러블슈팅
+
+| 증상 | 원인 / 해결 |
+|---|---|
+| `Add-AppxPackage`: "신뢰할 수 없는 인증서" | PFX를 `LocalMachine\TrustedPeople`에 임포트했는지 확인 (Install 스크립트 자동 수행) |
+| 메뉴가 안 뜸 | 탐색기 재시작: 작업관리자 → "Windows 탐색기" 다시 시작 |
+| Publisher 불일치 오류 | `Package.appxmanifest`의 `Publisher=` 와 인증서 `Subject` 가 정확히 일치해야 함 |
+| `App identity required` | MSIX 패키지로 설치된 경우에만 IExplorerCommand 작동. portable EXE는 Phase 1 레지스트리 방식 사용 |