9b7e5f0d0c
EverythingToJpeg(N→JPEG 단방향)에서 Everything2Everything(N×M 매트릭스)으로 앱을 피보팅. 7개 Provider, 200+ 변환 쌍 지원. 리네이밍 - 디렉토리/솔루션/csproj/namespace/AssemblyName/MSIX Identity 일괄 치환 - 임시파일 prefix e2j_ → e2e_, 로고 라벨 E2J → E2E 아키텍처 - ConversionPair(input, output) 신규 + ProviderCapability.SupportedConversions - IConverterProvider.ConvertAsync에 outputExtension 파라미터 추가 - ProviderRegistry를 Dictionary<(input, output), Provider> 매트릭스로 재작성 + OutputsForInput / OutputsForFile 쿼리 API - ConversionEngine: 출력 ext 라우팅, 동일 입출력 자동 skip, 서브폴더 suffix를 출력 ext에서 자동 도출 - ConvertOptions를 형식별 sub-record로 분리 (Jpeg/Png/Webp/Avif/Tiff/Pdf*/Html*/Ocr) Provider 매트릭스 - MagickProvider: PNG/JPEG/WebP/AVIF/BMP/TIFF/GIF/PDF 양방향 + RAW/PSD 디코딩 (단일이미지→1페이지 PDF, GIF/TIFF→다페이지 PDF) - HeicProvider: HEIC/HEIF → 이미지 7종 - PdfProvider: PDF → 이미지 6종 (PNG임베드 후 ImageMagick 인코딩) - HtmlProvider: HTML/HTM → 이미지 + PDF (CDP printToPDF) - DocxProvider/HwpxProvider: PDF + 이미지 7종 (LibreOffice 활용) - OcrProvider 신규: 이미지/PDF → TXT/DOCX (Windows.Media.Ocr + DocumentFormat.OpenXml, PDF는 페이지별 OCR 후 결합) UI - 사이드바 TARGET FORMAT을 동적 ComboBox로 (큐 파일 매트릭스의 교집합만 표시) - 출력 형식별 색상 배지 + Quality 패널 라벨 동적 - OUTPUT DESTINATION hint도 출력 ext 기반 동적 CLI - 신규 'to <ext> <files...>' verb (예: to png photo.heic doc.docx) - help 텍스트 양방향 컨셉으로 갱신 셸 통합 - ContextMenuRegistrar 카스케이드로 재설계 (ExtendedSubCommandsKey + Everything2Everything.SubMenu.<ext>) - 입력별 매트릭스에 따라 인기 출력 10종(JPEG/PNG/WebP/PDF/TXT/DOCX/AVIF/GIF/TIFF/BMP) 동적 노출, 마지막에 '변환…' 옵션 - 메뉴 라벨 'JPEG로 변환' → 'Everything2Everything으로 변환' 기타 - Core.csproj TFM net9.0-windows → net9.0-windows10.0.19041.0 (WinRT API용) - DocumentFormat.OpenXml 3.1.0 NuGet 추가 - README 양방향 매트릭스 기준 전면 개편 - MSIX appxmanifest Description / IExplorerCommand DLL 라벨 갱신 빌드: 0 errors, 0 warnings
3.6 KiB
3.6 KiB
MSIX 패키징
Win11 메인 우클릭 메뉴에 "Everything2Everything: 빠른 변환 (JPEG)" / "Everything2Everything: 변환…"을 띄우는 정공법. 레지스트리 기반 카스케이드 메뉴는 Portable EXE 방식을 참고하세요.
구성
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-Everything2Everything.ps1 — 5대 PC 1회 설치 스크립트
C++ Shell DLL은 src/Everything2Everything.Shell/ 에 있고 BuildMsix.ps1 안에서 자동 빌드됩니다.
1회: 자체 서명 인증서 만들기
cd packaging
.\CreateDevCert.ps1
# Subject 기본값: CN=Everything2EverythingDev (Package.appxmanifest의 Publisher와 일치)
# 비밀번호 입력 → Everything2Everything-DevCert.pfx 생성
출력된 Thumbprint를 BuildMsix.ps1 -CertThumbprint <값> 으로 사용하거나, PFX 파일을 5대 PC에 복사해서 설치 시 사용합니다.
빌드
미서명 (Phase 1 그대로 사용 가능, 메인 메뉴 노출은 안 됨)
.\BuildMsix.ps1
# 산출: packaging/dist/Everything2Everything-x64.msix
서명
# 방법 1: PFX 사용
.\BuildMsix.ps1 -Sign -PfxPath .\Everything2Everything-DevCert.pfx
# 방법 2: 인증서 저장소의 Thumbprint
.\BuildMsix.ps1 -Sign -CertThumbprint AABBCCDD...
5대 PC 설치 (관리자 PowerShell)
.\Install-Everything2Everything.ps1 `
-PfxPath .\Everything2Everything-DevCert.pfx `
-MsixPath .\Everything2Everything-x64.msix
스크립트가 자동으로:
- PFX를
LocalMachine\TrustedPeople에 임포트 - PFX를
LocalMachine\Root에도 임포트 (체인 신뢰) Add-AppxPackage로 MSIX 사이드로드
설치 후 PNG/JPG/HEIC/PDF/DOCX 등을 우클릭하면 메인 메뉴에 직접 "JPEG로 빠른 변환" / "JPEG로 변환…"이 보입니다.
미서명 사이드로드 (Phase 2 임시 사용)
자체 서명 만들기조차 귀찮을 때:
# 개발자 모드 켜기: 설정 → 개인 정보 및 보안 → 개발자용 → 켜기
Add-AppxPackage -AllowUnsigned -Path .\Everything2Everything-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 레지스트리 방식 사용 |