2015-08-27 00:19:24 +00:00
|
|
|
# autoUpdater
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-10-23 20:57:37 +00:00
|
|
|
이 모듈은 `Squirrel` 자동 업데이트 프레임워크의 인터페이스를 제공합니다.
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2016-03-31 05:03:35 +00:00
|
|
|
[electron-release-server](https://github.com/ArekSredzki/electron-release-server)를
|
|
|
|
|
포크하면 어플리케이션을 배포하기 위한 멀티 플랫폼 릴리즈 서버를 손쉽게 구축할 수 있습니다.
|
|
|
|
|
|
2015-10-23 20:57:37 +00:00
|
|
|
## 플랫폼별 참고 사항
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-11-19 19:46:05 +00:00
|
|
|
`autoUpdater`는 기본적으로 모든 플랫폼에 대해 같은 API를 제공하지만, 여전히 플랫폼별로
|
|
|
|
|
약간씩 다른 점이 있습니다.
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-10-23 20:57:37 +00:00
|
|
|
### OS X
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-10-23 20:57:37 +00:00
|
|
|
OS X에선 `auto-updater` 모듈이 [Squirrel.Mac][squirrel-mac]를 기반으로 작동합니다.
|
|
|
|
|
따라서 이 모듈을 작동시키기 위해 특별히 준비해야 할 작업은 없습니다.
|
|
|
|
|
서버 사이드 요구 사항은 [서버 지원][server-support]을 참고하세요.
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-10-23 20:57:37 +00:00
|
|
|
### Windows
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-11-19 19:46:05 +00:00
|
|
|
Windows에선 `auto-updater` 모듈을 사용하기 전에 어플리케이션을 사용자의 장치에
|
|
|
|
|
설치해야 합니다. [grunt-electron-installer][installer]를 사용하여 어플리케이션
|
|
|
|
|
인스톨러를 만드는 것을 권장합니다.
|
2015-11-04 08:47:14 +00:00
|
|
|
|
|
|
|
|
Squirrel로 생성된 인스톨러는 [Application User Model ID][app-user-model-id]와 함께
|
2015-11-19 19:46:05 +00:00
|
|
|
`com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE`으로 형식화된 바로가기 아이콘을
|
|
|
|
|
생성합니다. `com.squirrel.slack.Slack` 과 `com.squirrel.code.Code`가 그 예시입니다.
|
|
|
|
|
`app.setAppUserModelId` API를 통해 어플리케이션 ID를 동일하게 유지해야 합니다. 그렇지
|
|
|
|
|
않으면 Windows 작업 표시줄에 어플리케이션을 고정할 때 제대로 적용되지 않을 수 있습니다.
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-11-19 19:46:05 +00:00
|
|
|
서버 사이드 요구 사항 또한 OS X와 다르게 적용됩니다. 자세한 내용은
|
|
|
|
|
[Squirrel.Windows][squirrel-windows]를 참고하세요.
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-10-23 20:57:37 +00:00
|
|
|
### Linux
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-10-23 20:57:37 +00:00
|
|
|
Linux는 따로 `auto-updater`를 지원하지 않습니다.
|
|
|
|
|
각 배포판의 패키지 관리자를 통해 어플리케이션 업데이트를 제공하는 것을 권장합니다.
|
2015-08-31 06:11:06 +00:00
|
|
|
|
2015-08-27 00:19:24 +00:00
|
|
|
## Events
|
|
|
|
|
|
|
|
|
|
`autoUpdater` 객체는 다음과 같은 이벤트를 발생시킵니다:
|
|
|
|
|
|
|
|
|
|
### Event: 'error'
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-10-23 20:57:37 +00:00
|
|
|
Returns:
|
|
|
|
|
|
|
|
|
|
* `error` Error
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-10-23 20:57:37 +00:00
|
|
|
업데이트에 문제가 생기면 발생하는 이벤트입니다.
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-08-27 00:19:24 +00:00
|
|
|
### Event: 'checking-for-update'
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-08-09 18:33:32 +00:00
|
|
|
업데이트를 확인하기 시작할 때 발생하는 이벤트입니다.
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-08-27 00:19:24 +00:00
|
|
|
### Event: 'update-available'
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-08-09 18:33:32 +00:00
|
|
|
사용 가능한 업데이트가 있을 때 발생하는 이벤트입니다. 이벤트는 자동으로 다운로드 됩니다.
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-08-27 00:19:24 +00:00
|
|
|
### Event: 'update-not-available'
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-08-09 18:33:32 +00:00
|
|
|
사용 가능한 업데이트가 없을 때 발생하는 이벤트입니다.
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-08-27 00:19:24 +00:00
|
|
|
### Event: 'update-downloaded'
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-10-23 20:57:37 +00:00
|
|
|
Returns:
|
|
|
|
|
|
2015-06-25 17:32:51 +00:00
|
|
|
* `event` Event
|
|
|
|
|
* `releaseNotes` String
|
|
|
|
|
* `releaseName` String
|
|
|
|
|
* `releaseDate` Date
|
2015-11-16 03:15:21 +00:00
|
|
|
* `updateURL` String
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-10-23 20:57:37 +00:00
|
|
|
업데이트의 다운로드가 완료되었을 때 발생하는 이벤트입니다.
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-08-27 00:19:24 +00:00
|
|
|
## Methods
|
|
|
|
|
|
|
|
|
|
`autoUpdater` 객체에서 사용할 수 있는 메서드입니다:
|
|
|
|
|
|
2015-11-16 03:15:21 +00:00
|
|
|
### `autoUpdater.setFeedURL(url)`
|
2015-06-25 17:32:51 +00:00
|
|
|
|
|
|
|
|
* `url` String
|
|
|
|
|
|
2015-08-09 18:33:32 +00:00
|
|
|
`url`을 설정하고 자동 업데이터를 초기화합니다. `url`은 한번 설정되면 변경할 수 없습니다.
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-08-27 00:19:24 +00:00
|
|
|
### `autoUpdater.checkForUpdates()`
|
2015-06-25 17:32:51 +00:00
|
|
|
|
2015-11-19 19:46:05 +00:00
|
|
|
서버에 새로운 업데이트가 있는지 요청을 보내 확인합니다. API를 사용하기 전에
|
|
|
|
|
`setFeedURL`를 호출해야 합니다.
|
2015-10-23 20:57:37 +00:00
|
|
|
|
2015-11-04 08:47:14 +00:00
|
|
|
### `autoUpdater.quitAndInstall()`
|
2015-10-23 20:57:37 +00:00
|
|
|
|
|
|
|
|
어플리케이션을 다시 시작하고 다운로드된 업데이트를 설치합니다.
|
|
|
|
|
이 메서드는 `update-downloaded` 이벤트가 발생한 이후에만 사용할 수 있습니다.
|
|
|
|
|
|
|
|
|
|
[squirrel-mac]: https://github.com/Squirrel/Squirrel.Mac
|
|
|
|
|
[server-support]: https://github.com/Squirrel/Squirrel.Mac#server-support
|
|
|
|
|
[squirrel-windows]: https://github.com/Squirrel/Squirrel.Windows
|
|
|
|
|
[installer]: https://github.com/atom/grunt-electron-installer
|
2015-11-04 08:47:14 +00:00
|
|
|
[app-user-model-id]: https://msdn.microsoft.com/en-us/library/windows/desktop/dd378459(v=vs.85).aspx
|
