From ca63ff3f5f4f222692ffa7b7f13af8e6b6175c64 Mon Sep 17 00:00:00 2001 From: laz Date: Sat, 30 Mar 2024 17:43:18 +0100 Subject: [PATCH] wiki --- .../testing/release-candidate-testing.md | 66 +++++++++++++------ 1 file changed, 46 insertions(+), 20 deletions(-) diff --git a/wiki-rtd/docs/wiki_development/testing/release-candidate-testing.md b/wiki-rtd/docs/wiki_development/testing/release-candidate-testing.md index 8fa956a..c5894d9 100644 --- a/wiki-rtd/docs/wiki_development/testing/release-candidate-testing.md +++ b/wiki-rtd/docs/wiki_development/testing/release-candidate-testing.md @@ -16,9 +16,9 @@ First take some backups: Generally, very few things would target the roms folder, but the other folders could be targeted for various scripts. Our recommendation would be to back up the full `/retrodeck` folder, but as a tester you can decide how much you want to risk. -Disclamer: The RetroDECK Team also had never had any major data loss so far and we do cooker updates almost daily. - +**Disclamer:** +The RetroDECK Team also had never had any major data loss so far and we do cooker updates almost daily. ## Step 2: Download the Cooker @@ -34,28 +34,54 @@ Open the terminal window. - `flatpak remove net.retrodeck.retrodeck` and press (y) yes to remove RetroDECK. If you have more then one version installed for some reason choose to remove all versions. - `flatpak install --user --bundle --noninteractive -y "~/Downloads/RetroDECK-cooker.flatpak"` this will install RetroDECK Cooker. -### First Run +## Step 4: Upgrade + +**IMPORTANT:** + +Under **NO** circumstances press the `Full Wipe and Fresh Install` button. That is **NOT** to be confused with Configurators `Reset RetroDECK` option. This in fact a `Nuke Everything` option, it will remove all of RetroDECK including all ROMS/BIOS/Downloaded Media and everything else you have in RetroDECK's folders...forever. + +### Upgrading: + +- After the installation is complete type: `flatpak run --command=sh net.retrodeck.retrodeck` followed by `retrodeck`. +- Press the `Upgrade` button and keep the installation moving until all the steps are complete and RetroDECK will launch. +- Quit RetroDECK again and save all the output from the terminal into a text file. + +#### When upgrading **IMPORTANT:** Check for the message `"In version 0.8.0b, the following changes were made that required config file updates/reset or other changes to the filesystem:"` in the terminal. This is a sign that tell you the post update migration is running, this is crucial for RetroDECK's upgrade to fully happen. -**Start RetroDECK:** +This is what should happend in the post migration. -After the installation is complete type: `flatpak run --command=sh net.retrodeck.retrodeck` followed by `retrodeck`. -The upgrade process will now start. - - -## Step 4: Upgrade - -**IMPORTANT:** - -Under **NO** circumstances press the `Full Wipe and Fresh Install` button. That is **NOT** to be confused with Configurators `Reset RetroDECK` option, but this a `Nuke Everything` option. It will remove all of RetroDECK including all ROMS/BIOS/Downloaded Media and everything else you have forever. - -### Upgrading: - -- Press the `Upgrade` button and keep the installation moving until all the steps are complete and RetroDECK will launch. -- Quit RetroDECK again and save all the output from the terminal into a text file. +``` +- Remove any of the following files, if they exist: + "$HOME/.steam/steam/controller_base/templates/RetroDECK_controller_config.vdf" + "$HOME/.steam/steam/controller_base/templates/RetroDECK_controller_generic_standard.vdf" + "$HOME/.steam/steam/controller_base/templates/RetroDECK_controller_ps3_dualshock3.vdf" + "$HOME/.steam/steam/controller_base/templates/RetroDECK_controller_ps4_dualshock4.vdf" + "$HOME/.steam/steam/controller_base/templates/RetroDECK_controller_ps5_dualsense.vdf" + "$HOME/.steam/steam/controller_base/templates/RetroDECK_controller_steam_controller_gordon.vdf" + "$HOME/.steam/steam/controller_base/templates/RetroDECK_controller_neptune.vdf" + "$HOME/.steam/steam/controller_base/templates/RetroDECK_controller_switch_pro.vdf" + "$HOME/.steam/steam/controller_base/templates/RetroDECK_controller_xbox360.vdf" + "$HOME/.steam/steam/controller_base/templates/RetroDECK_controller_xboxone.vdf" +- The line "[nintendo_button_layout]" should be renamed "[abxy_button_swap]" in retrodeck.cfg +- The folder "/var/config/emulationstation" should be renamed to "/var/config/ES-DE" (internal Flatpak paths) +- ES-DE should be put through a reset process (verify via logs) +- MAME should be put through a reset process (verify via logs) +- Vita3K should be put through a reset process (verify via logs) +- GZDOOM should be put through a reset process (verify via logs) +- If the folder ~/retrodeck/.logs exists, it should be renamed to ~/retrodeck/logs +- The RPCS3 saves should be migrated by the following steps: + - The folder ~/retrodeck/backups should be created if it doesn't already exist + - A backup of current RPCS3 save data should be created at ~/retrodeck/backups/(date and time backup started)_rpcs3_save_data.zip + - The symlink and real folders for save data should be switched: + - The folder at ~/retrodeck/saves/ps3/rpcs3 should now be real + - The folder at ~/retrodeck/bios/rpcs3/dev_hdd0/home/00000001/savedata should now be a symlink back to ~/retrodeck/saves/ps3/rpcs3 +- Rename the folder ~/retrodeck/bios/switch/registered to ~/retrodeck/bios/switch/firmware +- Default ROMs folders should be recreated by ES-DE to add new systems +``` ## Step 5: Start testing @@ -63,8 +89,8 @@ On the SteamOS return to `Game Mode` for this step. Feel free to test all the new features of 0.8.0b and report any issues. -- Configurator -- External Controller Profiles +- Configurator functions +- Controller Layouts - Emulators / Engines All logs will be saved in the new `retrodeck/logs` folder