ROUGH DRAFT ··· Follow the Doc Updates project for status
If you are moving from v1.4 to v1.5b, changing your Bundle ID, or upgrading builds that have undergone database changes which require the app to be clean installed, you will need to backup your save games and ROMs or you will lose them all!
At the moment exporting or restoring files such can only be done manually…
DO NOT rely on the beta as your main playing build - to install a secondary app for testing alongside a stable release at the same time, use an alternate Bundle ID.
DO NOT rely solely on Save States, they are not guaranteed to be compatible between app versions due to core updates, etc… Before updating the app, launch the games you want to salvage and create in-game saves to be safe.
Exporting & Restoring Files
In Provenance, either…
Turn on the Web Server and load it via WebDav, or…
Open Apple Files and go to On My Device/Provenance or iCloud Drive/Provenance.
Pull all the files you need from Battery/ and Save States/, if you don't have your ROMs offline somewhere, obtain them from the com.provenance.[system]/ folders.
Make sure your ROM file names don't change by the time you put them back, they must match verbatim, and pay attention to the folder structures. DO NOT rename anything!