From 20d28e80a5c861a9d5f449ea911ab75b4f37ad0d Mon Sep 17 00:00:00 2001 From: Jef Date: Tue, 24 Sep 2024 14:54:57 +0200 Subject: Initial community commit --- Src/installer/winamp/Readme.txt | 130 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 130 insertions(+) create mode 100644 Src/installer/winamp/Readme.txt (limited to 'Src/installer/winamp/Readme.txt') diff --git a/Src/installer/winamp/Readme.txt b/Src/installer/winamp/Readme.txt new file mode 100644 index 00000000..a7f90550 --- /dev/null +++ b/Src/installer/winamp/Readme.txt @@ -0,0 +1,130 @@ +Winamp Installer (NSIS) + +Author: Eddy Richman +Date: 9 June 2022 +Revised: 26 June 2022 +Copyright: Winamp SA, c. 1997-2022 + + +Compilation instructions +======================== + +The easiest way to achieve success is to ensure all required Winamp files/folders are in the same parent directory. + + +1. Copy the required files from Winamp-Desktop + +Copy the following folders/files to the Output Dir, which in the case of the Winamp 32-bit release package is: + +..\..\..\..\Winamp_x86_Release + + +All the files must be in the correct subfolders! + +(maybe we can create a batch file or add this process to e.g. winampAll PostBuildEvent?) + + +- installer\winamp +- installer\shared +- resources\data +- resources\license +- resources\skins + - Note: "Nokia" subfolder is not required +- resources\libraries + - All files are required, EXCEPT: + - atl90.dll, msvcp90.dll, msvcr90.dll, Microsoft.VC90.ATL.manifest, Microsoft.VC90.CRT.manifest +- resources\plugins\dsp_sps.dll +- resources\media\demo.mp3 +- resources\media\winamp.m3u + +_________________________________________________________________________ + +Note: +===== + +resources\languages dir is only required for running specific international builds. + +With a couple of exceptions (en-us & pl-pl), all the lang packs need updating. +So we are currently only providing the en-us version (for v5.8 and v5.9). + +To create e.g. Winamp59_final_full_all.exe or Winamp59_final_full_fr-fr.exe, +the scripts in the Mastering folder need updating accordingly first... +which is something I'm currently working on... *gulp* + +_________________________________________________________________________ + + +2. Make sure the required NSIS plugins are present + +Extract the dll files from: %GitHub%\Radionomy\Nullsoft\nsis\nsis_plugins.zip +into the NSIS plugins folder, which by default will be found at: +%ProgramFiles%\NSIS\Unicode\Plugins\x86-unicode + +_________________________________________________________________________ + + +3. Digital Signing + +winamp.exe, winampa.exe, Elevator.exe & reporter.exe +all need to be digitally signed before we create the final public distribution package. + +The scripts in Mastering\Winamp would normally do this, but they need updating first. +Note that the Mastering scripts were written by previous devs (iirc, Justin, Francis, Benski, Maksim), and not by me. + +Codesign\sign.cmd can be used (and would be used by any mastering script), +but for manual signing, it's much easier to use DigiCertUtil.exe + +If you've already run DigiCertUtil.exe from Winamp-Desktop\codesign, then (unless you hack the registry), afaict, that's where it will always run from! + +a) Copy winamp.exe, winampa.exe, Elevator.exe & reporter.exe from the "Winamp_x86_Release" root folder to the "Winamp-Desktop\codesign" folder +b) Open Winamp-Desktop\Codesign\DigiCertUtil.exe +c) Select: "Code Signing" on the left - and the valid cert (Winamp SA, 13-Jun-2024, 08d4bf5a529c725997e0f6c526495d2f, DigiCert) +d) Note: If not already done so, you might need to install the cert first, so click the Install Cert button +e) Click the "Sign Files" button +f) Checkmark "Add a timestamp to the sig" if not already checked. +g) Click "Add Files" and use ctrl+click to add the 4 x *.exe files in a) +h) Click "Sign" +i) When done, close DigiCertUtil +j) cut+paste the 4 signed .exe files back into the "Winamp_x86_Release" root folder + +k) Repeat the above process for the installer file after step 5. + +So this is a bit of a shemozzle, but again, the updated scripts in Mastering will (eventually) automate the process. + +_________________________________________________________________________ + + +4. Create .wbm files + + Copy "Mastering\Winamp\build_wbm_2022.cmd" to the root of Winamp_x86_Release + Run "build_wbm_2022.cmd" to generate the System\*.wbm files + + - Note: .wbm = Lazy-load Wasabi Manifests + - This makes the respective .w5s files only load when required and not at Winamp startup. + + IMPORTANT + ========= + + The .wbm files need to be recreated every time new .w5s files are built! + +_________________________________________________________________________ + + +5. Create the installer + + - Open in Notepad or similar: Winamp_x86_Release\installer\winamp\make_full_installer_2022.bat + - Make sure the path to NSIS\makensis is correct + - Run: make_full_installer_2022.bat + + +Notes +===== + +The generated filename will be: Winamp_x86_Release\installer\winamp\$%INSTALL_NAME%_full.exe +Rename to e.g. Winamp59_9999_beta_rc1_en-us.exe or Winamp59_9999_final_full_en-us.exe, etc. + +Again, this is something the updated scripts in Mastering will do automatically... + +_________________________________________________________________________ + +END -- cgit