autoUpdater

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

プラットフォーム留意点

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

OS X

OS Xでは、 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.Slackcom.squirrel.code.Code)でApplication User Model IDとショートカットアイコンを作成します。app.setAppUserModelIdAPIで同じIDを使う必要があります。同じIDでないと、Windowsはタスクバーに適切にピン止めすることができません。

サーバーサイドのセットアップは、OS Xと異なります。詳細は、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が出力された後のみ、コールすべきです。