History

Yun Chan 0e752d76e2 ci: vcxproj를 packages.config 형식으로 복귀, BuildMsix가 nuget.exe 자동 처리 증상: VS 2022 Enterprise(GitHub windows-latest)에서 PackageReference 형식 vcxproj 빌드 시 ResolveNuGetPackageAssets가 "Sequence contains no elements" 오류로 실패. native vcxproj + PackageReference + msbuild restore 조합의 알려진 회귀. 해결: - src/EverythingToJpeg.Shell/EverythingToJpeg.Shell.vcxproj: PackageReference 제거, packages.config + Microsoft.Windows.ImplementationLibrary.targets imports 복귀, EnsureNuGetPackageBuildImports target 복귀. - src/EverythingToJpeg.Shell/packages.config 재추가. - packaging/BuildMsix.ps1: nuget.exe 없으면 dist.nuget.org에서 자동 다운로드, packages.config 기반 restore를 packages/ 폴더에 수행. - .gitignore: packages/, tools/ 제외. 이러면 사용자 PC(VS 2026)와 CI(VS 2022) 모두 동일한 흐름으로 빌드. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>		2026-05-06 23:20:45 +09:00
..
Assets	Phase 2: MSIX 패키지 + IExplorerCommand 셸 익스텐션	2026-05-06 13:03:16 +09:00
BuildAndSign.ps1	feat: P4-P8 한방 마무리 — 자체서명 MSIX, 영구저장, 단축키, capability 알림	2026-05-06 19:36:55 +09:00
BuildMsix.ps1	ci: vcxproj를 packages.config 형식으로 복귀, BuildMsix가 nuget.exe 자동 처리	2026-05-06 23:20:45 +09:00
CreateDevCert.ps1	Phase 2: MSIX 패키지 + IExplorerCommand 셸 익스텐션	2026-05-06 13:03:16 +09:00
GenerateAssets.ps1	Phase 2: MSIX 패키지 + IExplorerCommand 셸 익스텐션	2026-05-06 13:03:16 +09:00
Install-EverythingToJpeg.ps1	feat: P4-P8 한방 마무리 — 자체서명 MSIX, 영구저장, 단축키, capability 알림	2026-05-06 19:36:55 +09:00
Package.appxmanifest	Phase 3: HTML(WebView2) + HWP/HWPX(LibreOffice) 실구현	2026-05-06 13:23:47 +09:00
README.md	Phase 2: MSIX 패키지 + IExplorerCommand 셸 익스텐션	2026-05-06 13:03:16 +09:00

README.md

Phase 2 — MSIX 패키징

Win11 메인 우클릭 메뉴에 "JPEG로 빠른 변환" / "JPEG로 변환…"을 띄우는 정공법.

구성

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 안에서 자동 빌드됩니다.

1회: 자체 서명 인증서 만들기

cd packaging
.\CreateDevCert.ps1
# Subject 기본값: CN=EverythingToJpegDev (Package.appxmanifest의 Publisher와 일치)
# 비밀번호 입력 → EverythingToJpeg-DevCert.pfx 생성

출력된 Thumbprint를 BuildMsix.ps1 -CertThumbprint <값> 으로 사용하거나, PFX 파일을 5대 PC에 복사해서 설치 시 사용합니다.

빌드

미서명 (Phase 1 그대로 사용 가능, 메인 메뉴 노출은 안 됨)

.\BuildMsix.ps1
# 산출: packaging/dist/EverythingToJpeg-x64.msix

서명

# 방법 1: PFX 사용
.\BuildMsix.ps1 -Sign -PfxPath .\EverythingToJpeg-DevCert.pfx

# 방법 2: 인증서 저장소의 Thumbprint
.\BuildMsix.ps1 -Sign -CertThumbprint AABBCCDD...

5대 PC 설치 (관리자 PowerShell)

.\Install-EverythingToJpeg.ps1 `
    -PfxPath .\EverythingToJpeg-DevCert.pfx `
    -MsixPath .\EverythingToJpeg-x64.msix

스크립트가 자동으로:

PFX를 LocalMachine\TrustedPeople 에 임포트
PFX를 LocalMachine\Root 에도 임포트 (체인 신뢰)
Add-AppxPackage 로 MSIX 사이드로드

설치 후 PNG/JPG/HEIC/PDF/DOCX 등을 우클릭하면 메인 메뉴에 직접 "JPEG로 빠른 변환" / "JPEG로 변환…"이 보입니다.

미서명 사이드로드 (Phase 2 임시 사용)

자체 서명 만들기조차 귀찮을 때:

# 개발자 모드 켜기: 설정 → 개인 정보 및 보안 → 개발자용 → 켜기
Add-AppxPackage -AllowUnsigned -Path .\EverythingToJpeg-x64.msix

Win11 24H2부터 -AllowUnsigned 지원. 이전 버전은 자체 서명 권장.

CI/CD

.github/workflows/release.yml — 태그 푸시(v1.0.0 등) 시 자동:

.NET / MSBuild 셋업
BuildMsix.ps1 실행 (미서명)
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 레지스트리 방식 사용