autoUpdater

このモジュールは、Squirrelオートアップデートフレームワークのインターフェイスを提供します。

プラットフォーム留意点

autoUpdaterは、異なるプラットフォーム用に統一したAPIを提供していますが、それぞれのプラットフォーム上で、まだ多少の差があります。

macOS

macOSでは、 autoUpdater モジュールは、Squirrel.Mac上に構築されていて、動作させるのに特別な設定が不要であることを意味します。サーバーサイドの要件は、Server Supportを読んでください。

Windows

Windowsでは、auto-updaterを使う前に、ユーザーのPCにアプリをインストールする必要があるので、Windows インストーラーを生成するためにgrunt-electron-installerモジュールを使用することをお勧めします。

Squirrelで生成されたインストーラーは、com.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXEのフォーマット（例えば、com.squirrel.slack.Slack と com.squirrel.code.Code）でApplication User Model IDとショートカットアイコンを作成します。app.setAppUserModelIdAPIで同じIDを使う必要があります。同じIDでないと、Windowsはタスクバーに適切にピン止めすることができません。

サーバーサイドのセットアップは、macOSと異なります。詳細は、Squirrel.Windows を参照してください。

Linux

Linuxでは、auot-updater用のサポートがビルトインされていないので、アプリをアップデートするためにディストリビューションのパッケージマネジャーを使用することをお勧めします。

イベント

autoUpdater オブジェクトは次のイベントを出力します。

イベント: 'error'

戻り値:

• error Error

アップデート中にエラーがあった場合に出力されます。

イベント: 'checking-for-update'

アップデートを開始したかチェックしたときに出力されます。

イベント: 'update-available'

アップデートが提供されているときに出力されます。アップデートは自動的にダウンロードされます。

イベント: 'update-not-available'

アップデートが提供されていないときに出力されます。

イベント: 'update-downloaded'

戻り値:

• event Event
• releaseNotes String
• releaseName String
• releaseDate Date
• updateURL String

アップデートをダウンロードしたときに出力されます。

Windowsでは、releaseName のみ提供されます。

メソッド

autoUpdater オブジェクトは次のメソッドを持っています。

autoUpdater.setFeedURL(url)

• url String

  urlを設定し、自動アップデートを初期化します。 urlは一度設定すると変更できません。

autoUpdater.checkForUpdates()

アップデートがあるかどうかサーバーに問い合わせます。APIを使う前に、setFeedURLをコールしなければなりません。

autoUpdater.quitAndInstall()

ダウンロード後、アプリを再起動して、アップデートをインストールします。update-downloadedが出力された後のみ、コールすべきです。