67 lines
3.5 KiB
Markdown
67 lines
3.5 KiB
Markdown
|
+++
|
||
|
|
date = "2017-10-01T00:00:00-05:00"
|
||
|
|
title = "Introducing Automatic Updates"
|
||
|
|
tags = [ "feature-update" ]
|
||
|
|
author = "thekoopakingdom"
|
||
|
|
forum = 0000
|
||
|
|
+++
|
||
|
|
|
||
|
|
Emulators grow quickly. Last month alone, there were [39 pull requests](https://github.com/citra-emu/citra/pulls?utf8=%E2%9C%93&q=is%3Amerged%20merged%3A2017-09-01..2017-09-30%20)
|
||
|
|
merged to Citra. For this reason, it's important to be able to manage the many different
|
||
|
|
versions of an emulator. Until now however, Citra has had no installer or updater
|
||
|
|
for the [nightly builds](https://github.com/citra-emu/citra-nightly/releases). Although
|
||
|
|
the now obsolete [Bleeding Edge builds](https://github.com/citra-emu/citra-bleeding-edge/releases)
|
||
|
|
did have both of these things, it was limited to Windows, and the installer framework
|
||
|
|
had some issues that restricted what we could do with it.
|
||
|
|
|
||
|
|
Thanks to the work by [j-selby](https://github.com/j-selby) and [jroweboy](https://github.com/jroweboy),
|
||
|
|
we now have a new installer and updater for both the [Nightly builds](https://github.com/citra-emu/citra-nightly/releases)
|
||
|
|
and the [Canary builds](https://github.com/citra-emu/citra-canary/releases)!
|
||
|
|
|
||
|
|
More info on the Canary version of Citra will be in the **September 2017 Progress
|
||
|
|
Report**.
|
||
|
|
|
||
|
|
## Installer
|
||
|
|
The [new installer](https://github.com/citra-emu/citra/pull/2966) is an application
|
||
|
|
separate from Citra itself, that utilizes the [Qt Installer Framework](https://doc.qt.io/qtinstallerframework/index.html)
|
||
|
|
(Also known as QtIFW.) to download the latest version of either Citra
|
||
|
|
Nightly or Citra Canary from our website's repository and extract it to your system's
|
||
|
|
program directory.
|
||
|
|
|
||
|
|
{{< figure src="/images/entry/introducing-automatic-updates/installer-options.png"
|
||
|
|
title="CHOOSE YOUR WEAPON" alt="Installer options." >}}
|
||
|
|
|
||
|
|
Additionally, depending on which build(s) you chose, the installer
|
||
|
|
will also create desktop icons for easy access. You can get the installer from the
|
||
|
|
[downloads page](https://citra-emu.org/download/), which will try to automatically
|
||
|
|
select the correct version for your OS.
|
||
|
|
|
||
|
|
## Updater
|
||
|
|
In addition to installing, QtIFW also provides functionality for updating via the
|
||
|
|
`maintenancetool` utility. For convenience, this is [integrated into the Qt frontend](https://github.com/citra-emu/citra/pull/2997)
|
||
|
|
(The main GUI that you probably use.) in the form of scheduled automatic
|
||
|
|
updates. You can optionally check for updates on startup, and/or check for updates
|
||
|
|
on shutdown.
|
||
|
|
|
||
|
|
{{< figure src="/images/entry/introducing-automatic-updates/configuration.png"
|
||
|
|
title="Note the two checkboxes in the updates section." alt="Configuration window." >}}
|
||
|
|
|
||
|
|
If an update is found at startup, you will be asked if you want to run the updater
|
||
|
|
or not.
|
||
|
|
|
||
|
|
{{< figure src="/images/entry/introducing-automatic-updates/update-prompt.png"
|
||
|
|
title="Gotta keep your Citrus fresh!" alt="Message box prompting for installation." >}}
|
||
|
|
|
||
|
|
If an update is found at shutdown, Citra will silently update without prompting,
|
||
|
|
because at this point emulation has already been terminated.
|
||
|
|
|
||
|
|
You can also manually update your Citra installation at any time, by going to the
|
||
|
|
`Help` menu, and then `Check for Updates`.
|
||
|
|
|
||
|
|
## Uninstallation & Install Modification
|
||
|
|
QtIFW's `maintenancetool` can also be used to uninstall Citra, and install a different
|
||
|
|
type of build. Like the updater, this is also integrated into the Qt frontend, and
|
||
|
|
can be accessed by going to the `Help` menu, and then `Modify Citra Install`. Integrating
|
||
|
|
with an already well-established framework like QtIFW allows us to streamline the
|
||
|
|
task of installation maintenence.
|