updater
Customize the auto updater flow.
This package is also accessible with window.__TAURI__.updater
when build.withGlobalTauri
in tauri.conf.json
is set to true
.
Interfaces​
UpdateManifest
​
Since: 1.0.0
Properties​
body
​
body:
string
Defined in: updater.ts:34
date
​
date:
string
Defined in: updater.ts:33
version
​
version:
string
Defined in: updater.ts:32
UpdateResult
​
Since: 1.0.0
Properties​
manifest
​
Optional
manifest:UpdateManifest
Defined in: updater.ts:41
shouldUpdate
​
shouldUpdate:
boolean
Defined in: updater.ts:42
UpdateStatusResult
​
Since: 1.0.0
Properties​
error
​
Optional
error:string
Defined in: updater.ts:24
status
​
status:
UpdateStatus
Defined in: updater.ts:25
Type Aliases​
UpdateStatus
​
UpdateStatus:
"PENDING"
|"ERROR"
|"DONE"
|"UPTODATE"
Since: 1.0.0
Defined in: updater.ts:18
Functions​
checkUpdate
​
checkUpdate():
Promise
<UpdateResult
>
Checks if an update is available.
Example
import { checkUpdate } from '@tauri-apps/api/updater';
const update = await checkUpdate();
// now run installUpdate() if needed
Since: 1.0.0
Returns: Promise
<UpdateResult
>
Promise resolving to the update status.
installUpdate
​
installUpdate():
Promise
<void
>
Install the update if there's one available.
Example
import { checkUpdate, installUpdate } from '@tauri-apps/api/updater';
const update = await checkUpdate();
if (update.shouldUpdate) {
console.log(`Installing update ${update.manifest?.version}, ${update.manifest?.date}, ${update.manifest.body}`);
await installUpdate();
}
Since: 1.0.0
Returns: Promise
<void
>
A promise indicating the success or failure of the operation.
onUpdaterEvent
​
onUpdaterEvent(
handler
:fn
):Promise
<UnlistenFn
>
Listen to an updater event.
Example
import { onUpdaterEvent } from "@tauri-apps/api/updater";
const unlisten = await onUpdaterEvent(({ error, status }) => {
console.log('Updater event', error, status);
});
// you need to call unlisten if your handler goes out of scope e.g. the component is unmounted
unlisten();
Since: 1.0.2
Parameters
Name | Type |
---|---|
handler | (status : UpdateStatusResult ) => void |
Returns: Promise
<UnlistenFn
>
A promise resolving to a function to unlisten to the event. Note that removing the listener is required if your listener goes out of scope e.g. the component is unmounted.