autoUpdater
アプリを自動的に更新することができます。
プロセス: Main
こちらも参照: アプリケーションを更新する
autoUpdater
は EventEmitter を継承しています。
プラットフォームに関する注意事項
現在、macOS と Windows にのみ対応しています。 Linux では、自動更新の組み込みサポートがないので、アプリ更新にはディストリビューションのパッケージマネージャーの使用を推奨しています。
さらに、各プラットフォームではいくつかの微妙な違いがあります。
macOS
macOSでは、autoUpdater
モジュールは Squirrel.Mac で構築されているので、動作させるのに特別なセットアップ作業をする必要はありません。 サーバー側の要件については、サーバーサポート をお読みください。 Note that App Transport Security (ATS) applies to all requests made as part of the update process. アプリのplistに NSAllowsArbitraryLoads
キーを追加することで、ATSを無効にすることができます。
注: macOS で自動更新を有効にするには、アプリ署名が必要です。 これは Squirrel.Mac
の動作要件です。
Windows
Windows で autoUpdater
を使用するには、アプリをユーザのマシンにインストールする必要があります。electron-winstaller、Electron Forge、grunt-electron-installer のいずれかのパッケージで Windows インストーラを生成することを推奨します。
electron-winstaller または Electron Forge を使用する場合、初回実行時に アプリを更新しようとしないようにしてください (この issue の詳細情報 も参照)。 アプリのデスクトップショートカットを作成する electron-squirrel-startup も使用することを推奨します。
Squirrel で作成されたインストーラは、例えば、com.squirrel.slack.Slack
や com.squirrel.code.Code
といったcom.squirrel.PACKAGE_ID.YOUR_EXE_WITHOUT_DOT_EXE
という形式の アプリケーションユーザ ID を持つショートカットアイコンを作成します。 app.setAppUserModelId
APIでアプリに対して同じIDを使うようにしてください。そうでないと、Windowsはタスクバーにアプリを正しくピン留めすることができません。
Squirrel.Mac と同様に、Windows でも S3 やその他の静的ファイルホストで更新プログラムをホストできます。 Squirrel.Windows の仕組みの詳細については、Squirrel.Windows のドキュメントをお読みください。
イベント
autoUpdater
オブジェクトは以下のイベントを発生させます。
イベント: 'error'
戻り値:
error
Error
更新中にエラーがあるときに出力されます。