이 가이드에서는 Windows API를 사용하여 Electron 앱을 배포하기 위한 MSIX 패키지를 만드는 방법을 보여 줍니다.
필수 조건
- 개발 환경 설정 완료
- 를 사용하여 앱이 올바르게 실행되는지 확인했습니다.
npm start
패키징 준비
패키징하기 전에 최종 빌드에서 임시 파일을 제외하도록 빌드 도구를 구성합니다.
-
.winapp/폴더 winapp.yaml- 인증서 파일(
.pfx) - 디버그 기호(
.pdb) - C# 빌드 아티팩트 (
obj/,bin/폴더) - MSIX 패키지(
*.msix)
특성이 올바른 appxmanifest.xml 파일을 가리키는지 확인합니다.Executable.exe
옵션 1: winapp CLI 직접 사용(권장)
이 방법은 더 많은 제어를 제공하고 모든 Electron 패키지와 함께 작동합니다.
Electron 앱을 빌드하기
npx electron-forge package
./out/ 폴더에 프로덕션 버전이 생성됩니다.
MSIX 패키지 만들기
npx winapp pack .\out\<your-app-folder> --output .\out --cert .\devcert.pfx --manifest .\appxmanifest.xml
Electron Forge에서 만든 실제 폴더 이름으로 <your-app-folder>를 변경하십시오 (예: my-windows-app-win32-x64).
팁 (조언)
편의를 위해 스크립트에 package.json 다음 명령을 추가합니다.
{
"scripts": {
"package-msix": "npx electron-forge package && npx winapp pack ./out/my-windows-app-win32-x64 --output ./out --cert ./devcert.pfx --manifest appxmanifest.xml"
}
}
옵션 2: Electron Forge MSIX Maker 사용
이미 Electron Forge를 사용하는 경우 MSIX 패키징을 직접 통합할 수 있습니다.
MSIX Maker 설치
npm install --save-dev @electron-forge/maker-msix
forge.config.js를 구성합니다
module.exports = {
makers: [
{
name: '@electron-forge/maker-msix',
config: {
appManifest: '.\\appxmanifest.xml',
windowsSignOptions: {
certificateFile: '.\\devcert.pfx',
certificatePassword: 'password'
}
}
}
],
};
앱매니페스트 파일 appxmanifest.xml을 업데이트하십시오
Executable 경로를 app 폴더로 가리키도록 업데이트합니다.
<Applications>
<Application Id="myApp"
Executable="app\my-app.exe"
EntryPoint="Windows.FullTrustApplication">
</Application>
</Applications>
MSIX 패키지 만들기
npm run make
MSIX 패키지는 ./out/make/msix/에서 만들어집니다.
MSIX 설치 및 테스트
개발 인증서 설치(일회성 설정, 관리자 권한으로 실행):
npx winapp cert install .\devcert.pfx
MSIX 패키지를 설치합니다.
Add-AppxPackage .\my-windows-app.msix
앱이 시작 메뉴에 표시됩니다.
분포 옵션
Microsoft Store
가장 광범위한 배포 및 자동 업데이트를 위해 앱을 제출합니다. 자세한 정보: Microsoft Store에 앱을 게시합니다.
직접 다운로드
웹 사이트에서 MSIX 패키지를 호스트합니다. 신뢰할 수 있는 CA(인증 기관) 인증서를 사용하여 서명합니다.
기업 배포
Company Portal (Intune), 직접 다운로드 또는 사이드로딩을 통해 배포하세요. 자세한 정보: 스토어 외부에 앱을 배포합니다.
앱 설치 관리자
.appinstaller 자동 업데이트를 위한 파일을 만듭니다. 자세한 정보: 앱 설치 관리자 파일 개요.
관련 토픽
Windows developer