Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/strawberrymusicplayer/strawberry-msvc
:strawberry: Instructions and batch files for building Strawberry with Visual Studio 2022
https://github.com/strawberrymusicplayer/strawberry-msvc
building msvc msvc2019
Last synced: about 2 months ago
JSON representation
:strawberry: Instructions and batch files for building Strawberry with Visual Studio 2022
- Host: GitHub
- URL: https://github.com/strawberrymusicplayer/strawberry-msvc
- Owner: strawberrymusicplayer
- Created: 2022-02-07T20:29:39.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-11-02T13:56:16.000Z (about 2 months ago)
- Last Synced: 2024-11-02T14:29:02.443Z (about 2 months ago)
- Topics: building, msvc, msvc2019
- Language: Batchfile
- Homepage: https://www.strawberrymusicplayer.org/
- Size: 183 KB
- Stars: 8
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# :hammer_and_wrench: Strawberry - Build with Visual Studio 2022
This guide uses Visual Studio 2022 to build Strawberry Music Player as well as required dependencies.
These instructions are provided as-is, they are primarily intended for developers working on Strawberry on Windows.
We do not offer support to users for building Strawberry on Windows.
Build tools (Git, CMake, Meson, Perl, Python, etc) versions are not regulary updated, so make sure you bump the versions in versions.bat before you run install.bat.
### Requirements
* [Git for Windows](https://gitforwindows.org/)
* [Visual Studio 2022](https://visualstudio.microsoft.com/vs/)
* [Qt Visual Studio Tools](https://marketplace.visualstudio.com/items?itemName=TheQtCompany.QtVisualStudioTools2022)
* [CMake](https://cmake.org/)
* [Meson](https://mesonbuild.com/)
* [NASM](https://www.nasm.us/)
* [Strawberry Perl](https://strawberryperl.com/)
* [Python](https://www.python.org/downloads/windows/)
* [7-Zip](https://www.7-zip.org/download.html)
* [Win Flex/Bison](https://sourceforge.net/projects/winflexbison/)
* [NSIS](https://nsis.sourceforge.io/)
* [NSIS LockedList Plugin](https://nsis.sourceforge.io/LockedList_plug-in)
* [NSIS Inetc Plugin](https://nsis.sourceforge.io/Inetc_plug-in)
* [NSIS Registry Plugin](https://nsis.sourceforge.io/Registry_plug-in)
## Windows setup
### Manual installation on Windows
Download and install manually:
- [Git](https://git-scm.com/downloads)
- Default settings can be used
- [Visual Studio 2022 Community](https://visualstudio.microsoft.com/vs/)
- Select `Desktop development with C++`
### Clone repositories and download tools/dependencies
Open a `Command Prompt` and type:
```
mkdir C:\data\projects\strawberry
cd C:\data\projects\strawberry
git clone https://github.com/strawberrymusicplayer/strawberry.git
git clone https://github.com/strawberrymusicplayer/strawberry-msvc.git
cd strawberry-msvc
.\download.bat
```
### Installation
Install manually from `C:\data\projects\strawberry\msvc_\downloads`:
- **Required**:
- Install `7z-x64.exe`
- Install `cmake--windows-x86_64.msi`
- Install `python--amd64.exe`
- In first dialog:
- Check: `Add python.exe to PATH`
- Click `Install Now` (to use defaults)
- In dialog `Setup was successful`:
- Click: `Disable path length limit`
- Install `strawberry-perl--64bit.msi`
- Extract `win_flex_bison-.zip` to `C:\win_flex_bison`
- **Recommended: When building dependencies from source**:
- Install `nasm--installer-x64.exe`
- Run as `Administrator` and install into `C:\Program Files\NASM`.
- **Recommended: When creating NSIS Windows installer**:
- Install NSIS: `nsis--setup.exe`
- Extract NSIS `LockedList.zip` plugin:
- Copy `LockedList\Plugins\LockedList64.dll` to `C:\Program Files (x86)\NSIS\Plugins\LockedList64.dll`
- Copy `LockedList\Plugins\x86-unicode\LockedList.dll` to `C:\Program Files (x86)\NSIS\Plugins\x86-unicode\LockedList.dll`
- Extract NSIS `Inetc.zip` plugin:
- Copy `Inetc\Plugins\x86-unicode\INetC.dll` to `C:\Program Files (x86)\NSIS\Plugins\x86-unicode\INetC.dll`
- Extract NSIS `Registry.zip` plugin:
- Copy `Registry\Desktop\Plugin\registry.dll` to `C:\Program Files (x86)\NSIS\Plugins\registry.dll`
- Copy `Registry\Desktop\Plugin\registry.dll` to `C:\Program Files (x86)\NSIS\Plugins\x86-unicode\registry.dll`
### Configure PATH environment variable
Delete `pkg-config` files to prevent conflicts with Strawberry's own `pkg-config`:
- Delete `C:\strawberry\perl\bin\pkg-config`
- Delete `C:\strawberry\perl\bin\pkg-config.bat`
Windows Settings | System | About | Advanced system settings | Tab Advanced | Environment Variables:
- System variables | Path | Edit:
- Delete: `C:\Strawberry\c\bin` (To prevent conflicts with other utilities)
- Add: `C:\Program Files\Git\bin` (This is for `sed` and `patch` utilities)
- Add: `C:\Program Files (x86)\NSIS`
- Make sure no MinGW-W64 (gcc, g++, etc) installation is in `PATH`, as this can cause those to be picked up as compiler instead of MSVC.
### Meson installation
Building with Meson 1.6.0 installation results in build issues
[meson: error: unrecognized arguments:](https://github.com/strawberrymusicplayer/strawberry-msvc/issues/6).
A temporary solution is to remove Meson via Windows Settings | `Apps or remove programs`.
Then install Meson via Python PIP system wide. Start | `x64 Native Tools Command Prompt for VS 2022` and type:
```
pip install meson
```
### Optional: Prebuilt binary dependencies
Prebuilt MSVC binaries can be optionally used to speed-up the build process. When this step is skipped, all libraries and dependencies are build from source.
To use prebuilds, download the following `tar.xz` files from Github [strawberry-msvc-dependencies/releases](https://github.com/strawberrymusicplayer/strawberry-msvc-dependencies/releases):
- For debug, extract `strawberry-msvc-x86_64-debug.tar.xz` to `C:\strawberry_msvc_x86_64_debug`
- For release, extract `strawberry-msvc-x86_64-release.tar.xz` to `C:\strawberry_msvc_x86_64_release`
## Build Strawberry from source including dependencies
- Set one debug or release in `PATH` environment variable:
- For debug: `C:\strawberry_msvc_x86_64_debug\bin`, or:
- For release: `C:\strawberry_msvc_x86_64_release\bin`
- Start | `x64 Native Tools Command Prompt for VS 2022`:
```
cd C:\data\projects\strawberry\strawberry-msvc
```
For debug build:
```
.\build.bat
```
For release build:
```
.\build.bat release
```
Strawberry and Windows installer executables are generated in:
- For debug: `C:\data\projects\strawberry\msvc_\build_debug\strawberry\build\`
- For release: `C:\data\projects\strawberry\msvc_\build_release\strawberry\build\`
## Setting up Strawberry for development in Visual Studio 2022
Optional `Qt Visual Studio Tools` can be installed via the toolbar `Extensions | Manage Extensions` and search for `Qt Visual Studio Tools`. Then click `Install`.
Debug build:
- Make sure the path `C:\strawberry_msvc_x86_64_debug\bin` is added to the `PATH` environment variable before starting Visual Studio 2022.
- Start | Visual Studio 2022
- Open a local folder `C:\data\projects\strawberry\strawberry`
- Toolbar Project | CMake Settings:
- Select Configurations `x64-Debug`
- Add `CMake command arguments`: `-DARCH=x86_64 -DICU_ROOT=c:\\strawberry_msvc_x86_64_debug`
- Select in the toolbar `x64-Debug`
- Toolbar: Build | Build All
Release build:
- Make sure the path `C:\strawberry_msvc_x86_64_release\bin` is added to the `PATH` environment variable before starting Visual Studio 2022.
- Start | Visual Studio 2022
- Open a local folder `C:\data\projects\strawberry\strawberry`
- Toolbar Project | CMake Settings:
- Create new `x64-Release`
- Select Configurations `x64-Release`
- Add `CMake command arguments`: `-DARCH=x86_64 -DICU_ROOT=c:\\strawberry_msvc_x86_64_release -DENABLE_WIN32_CONSOLE=OFF`
- Save the changes
- In the toolbar select `x64-Release`
- Project | Delete Cache and Reconfigure
- Toolbar: Build | Build All
Set breakpoint and press F5 to start debugging and use F10 to step into and F11 to step over.