This is for updating your existing spruce install of versions 2.3.0 and below. This will allow you to update to the latest version of Spruce painlessly and keep all your relevant configurations and settings.
If you are looking for first time installation instructions go to our wiki on the spruceUI repo
If you are on spruce 3.0.0 or above you do not need this, it is included in these versions.
You don't need to do much except make sure you have enough free space on your SDCard for the latest version of spruce, and some room to spare. Make sure you have at least 30% battery left or charging when you run the updater.
To use this get the latest release and plug your A30's SDCard into your computer. AutoUpdater should be a contained zip file with all the parts you'll need to update your spruce install. You'll need the latest AutoUpdater compatiblie spruce file.
This should just be the 7zip file in the latest spruce release.
Unzip the EZUpdaterVx.x.x.zip file and place the contents directly onto your SDCard's root. They should align somewhat with the already existing spruce folders, like Apps. If it prompts you to overwrite be sure to accept.
Place your spruceVxx.xx.xx.7z on the root of your SDCard. Do not extract this file! You should place the 7z directly on your SDCard. This will be used by AutoUpdater for you.
Once you've place the Auto Updater files and the latest release 7z file on your SDCard put it back into your A30 and startup.
Once back on your A30, go to your Apps and you should see a new spruce Updater app in your list of apps. Just launch this and sit back. This will backup your current install, install the update, restore your install, upgrade any files that need it, and then shut down. You'll need to power back on manually afterwards.
Afterward you should go through our fresh update process to finish setting up the install. During the Auto Updater process your back up was automatically restored so you should be good to go. Happy gaming!
No, this contains a self contained version of our spruce Backup app to backup your valuable data. This includes but is not limited to: PPSSPP saves/configs, NDS saves/configs, Syncthing setup, PICO8 saves/bios, and your RetroArch config. Your Saves, Roms, and BIOS folders will be left untouched.
The currently targeted version of spruce this was written for was 1.4.3 to 2.3.0. But it should work well if not entirely with lower versions. We'll work to getting lower versions the official stamp of approval but overall they should work perfectly fine with AutoUpdater. If we hear/find otherwise we'll update this. We've ran this on version 1.0 of Spruce, but no promises.
All of them except those in the BIOS, Roms, Saves, and Themes folders. Those folders are left entirely untouched just to make sure you keep your personal information. Anything important outside of those folders mentioned are backed up when updating. (And placed in the Saves/spruce/backups). All your other folders will be affected by the update and will be cleaned up and updated.
If you see this you do not have an update file, the update file is not in the right place (the root of your SDCard), or the update file isn't named with our naming convention. Be sure you have a file on the root of your SDCard named spruceVxx.xx.xx.7z with the xx.xx.xx being the version number you have.
Should be obvious, charge your device! If you have less than 30% battery auto updater will not run. You can also plug your device in and run it again if you don't want to wait.
This is a rather rudimentary check if your current spruce install is in a good state or not. If this appears your current installation isn't in a good state. But we'll allow you to run the updater and skip the version check. This mostly just an informative warning. More details can be found in SDCARD/Updater/update.log
If you see this the spruce 7z you provided could not be validated as a proper spruce update file. Be sure you're using the proper update file from our latest spruce release. If you continue to get this message reach out to us and be sure to include your update log file. Log can be found in SDCARD/Updater/update.log
If you see this the update process successfully ran but a file wasn't able to be extracted from the update file. Hopefully this shouldn't appear, but if it does it can be mostly harmless. But check the update log in your SDCARD/Updater/update.log file for more details.
This is a post install verfication. If you see this something went wrong with your install, the updater stopped running immediatly. If this happens to you it's most likely an SDCard failure of some kind, be sure to verify your SDCard. During the process a compatible backup file was made. You should hold onto that and after checking your SDCard manually update and run spruce Restore afterwards.