Electron 문서1.4.1

Docs / API / autoUpdater

autoUpdater

애플리케이션이 자동으로 업데이트를 진행할 수 있도록 기능을 활성화합니다.

autoUpdater 모듈은 Squirrel 프레임워크에 대한 인터페이스를 제공합니다.

다음 프로젝트 중 하나를 선택하여, 애플리케이션을 배포하기 위한 멀티-플랫폼 릴리즈 서버를 손쉽게 구축할 수 있습니다:

플랫폼별 참고 사항

autoUpdater는 기본적으로 모든 플랫폼에 대해 같은 API를 제공하지만, 여전히 플랫폼별로 약간씩 다른 점이 있습니다.

macOS

macOS에선 autoUpdaterSquirrel.Mac를 기반으로 작동합니다. 따라서 이 모듈을 작동시키기 위해 특별히 준비해야 할 작업은 없습니다. 서버 사이드 요구 사항은 서버 지원을 참고하세요.

참고: macOS에서 자동 업데이트를 지원하려면 반드시 사인이 되어있어야 합니다. 이것은 Squirrel.Mac의 요구 사항입니다.

Windows

Windows에선 autoUpdater를 사용하기 전에 애플리케이션을 사용자의 장치에 설치해야 합니다. electron-winstaller, electron-builder 또는 grunt-electron-installer를 사용하여 애플리케이션 인스톨러를 만드는 것을 권장합니다.

Windows에선 autoUpdater 모듈을 사용하기 전에 사용자의 장치에 애플리케이션을 설치해야 합니다. 따라서 electron-winstaller 모듈이나 grunt-electron-installer 패키지를 사용하여 애플리케이션 인스톨러를 만드는 것을 권장합니다.

Squirrel로 생성된 인스톨러는 Application User Model ID와 함께 com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE으로 형식화된 바로가기 아이콘을 생성합니다. com.squirrel.slack.Slackcom.squirrel.code.Code가 그 예시입니다. app.setAppUserModelId API를 통해 애플리케이션 ID를 동일하게 유지해야 합니다. 그렇지 않으면 Windows 작업 표시줄에 애플리케이션을 고정할 때 제대로 적용되지 않을 수 있습니다.

서버 사이드 요구 사항 또한 macOS와 다르게 적용됩니다. 자세한 내용은 Squirrel.Windows를 참고하세요.

Linux

Linux는 따로 autoUpdater를 지원하지 않습니다. 각 배포판의 패키지 관리자를 통해 애플리케이션 업데이트를 제공하는 것을 권장합니다.

Events

autoUpdater 객체는 다음과 같은 이벤트를 발생시킵니다:

Event: ‘error’

Returns:

업데이트에 문제가 생기면 발생하는 이벤트입니다.

Event: ‘checking-for-update’

업데이트를 확인하기 시작할 때 발생하는 이벤트입니다.

Event: ‘update-available’

사용 가능한 업데이트가 있을 때 발생하는 이벤트입니다. 이벤트는 자동으로 다운로드 됩니다.

Event: ‘update-not-available’

사용 가능한 업데이트가 없을 때 발생하는 이벤트입니다.

Event: ‘update-downloaded’

Returns:

업데이트의 다운로드가 완료되었을 때 발생하는 이벤트입니다.

Methods

autoUpdater 객체에서 사용할 수 있는 메서드입니다:

autoUpdater.setFeedURL(url[, requestHeaders])

url을 설정하고 자동 업데이터를 초기화합니다.

autoUpdater.getFeedURL()

Returns String - 현재 업데이트 피드 URL.

autoUpdater.checkForUpdates()

서버에 새로운 업데이트가 있는지 요청을 보내 확인합니다. API를 사용하기 전에 setFeedURL를 호출해야 합니다.

autoUpdater.quitAndInstall()

애플리케이션을 다시 시작하고 다운로드된 업데이트를 설치합니다. 이 메서드는 update-downloaded 이벤트가 발생한 이후에만 사용할 수 있습니다.


고쳐야 할 것이 있습니까? 소스에서 변경을 제안할 수 있습니다.
다른 버전의 문서가 필요한가요? 이전 버전 또는 커뮤니티 번역을 보세요.
모든 문서를 한번에 검색하고 싶으신가요? 한 페이지 문서를 보세요.