배포를 위해 Electron 앱 패키징

이 가이드에서는 Windows API를 사용하여 Electron 앱을 배포하기 위한 MSIX 패키지를 만드는 방법을 보여 줍니다.

필수 조건

  • 개발 환경 설정 완료
  • 를 사용하여 앱이 올바르게 실행되는지 확인했습니다. npm start

패키징 준비

패키징하기 전에 최종 빌드에서 임시 파일을 제외하도록 빌드 도구를 구성합니다.

  • .winapp/ 폴더
  • winapp.yaml
  • 인증서 파일(.pfx)
  • 디버그 기호(.pdb)
  • C# 빌드 아티팩트 (obj/, bin/ 폴더)
  • MSIX 패키지(*.msix)

특성이 올바른 appxmanifest.xml 파일을 가리키는지 확인합니다.Executable.exe

이 방법은 더 많은 제어를 제공하고 모든 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 자동 업데이트를 위한 파일을 만듭니다. 자세한 정보: 앱 설치 관리자 파일 개요.