mirror of
https://github.com/cookiengineer/audacity
synced 2025-10-12 17:43:37 +02:00
Update the build documentation
This commit is contained in:
committed by
Dmitry Vedenko
parent
f66381b967
commit
66a85bf97c
136
win/build.txt
136
win/build.txt
@@ -1,136 +0,0 @@
|
||||
Instructions for building on Windows.
|
||||
|
||||
Fuller instructions that include
|
||||
* Installing CMake
|
||||
* Portable Settings
|
||||
* Building an Installer
|
||||
can be found on our wiki at
|
||||
http://wiki.audacityteam.org/wiki/Building_On_Windows
|
||||
|
||||
|
||||
1. MSVC 2019: Download and install Microsoft Visual Studio 2019
|
||||
|
||||
https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=Community&rel=16
|
||||
be sure to include the Desktop Development with C++ Workflow
|
||||
this build was testing using VS 16.8.5
|
||||
|
||||
2. Git: Download and install Git, for example by installing:
|
||||
|
||||
Git for Windows: https://git-scm.com/download/win
|
||||
and optionally GitExtensions: http://gitextensions.github.io/
|
||||
|
||||
download and run the .msi installer. GitExtensions has a GUI interface,
|
||||
includes Git for Windows and has a Git bash command line in the bottom panel
|
||||
of the screen.
|
||||
|
||||
3. Python
|
||||
|
||||
We no longer use Python 2.7.18 during the build. Instead we must use Python 3.
|
||||
You can download Python 3.9.1 from https://www.python.org/downloads/windows/
|
||||
Select the Python 3.9.1 Windows Installer (32-bit)
|
||||
|
||||
4. wxWidgets:
|
||||
|
||||
a) Clone wxWidgets and checkout 3.1.3 from the Audacity fork of the
|
||||
wxWidgets project:
|
||||
https://github.com/audacity/wxWidgets/
|
||||
|
||||
for example, in the git-bash command line:
|
||||
mkdir wxWidgets
|
||||
git clone --recurse-submodules https://github.com/audacity/wxWidgets/
|
||||
|
||||
IF you forgot the --recurse-submodules, you can correct that later by:
|
||||
git submodule update --init
|
||||
|
||||
It is instructive to review but do NOT follow the instructions for
|
||||
building at
|
||||
https://github.com/audacity/wxWidgets/blob/audacity-fixes-3.1.3/README-GIT.md
|
||||
https://github.com/audacity/wxWidgets/blob/audacity-fixes-3.1.3/docs/msw/install.md
|
||||
|
||||
b) We (currently) build the 32 bit DLL version,
|
||||
and Audacity is built 32 bit too.
|
||||
|
||||
Set WXWIN environment variable to the appropriate directory where you
|
||||
installed wxWidgets. This will tell CMake where to find wxWidgets later.
|
||||
|
||||
To set WXWIN, click on Settings (the cogwheel icon from the start menu)
|
||||
Then in the 'find a setting' search box type 'env'.
|
||||
Choose 'Edit the system environment variables'
|
||||
Then the 'Environment Variables' button
|
||||
Then in system variables, for variable and value, add (for example)
|
||||
|
||||
WXWIN C:\aud300\wxWidgets
|
||||
|
||||
You will be building a dll version with MSVC2019 IDE, so...
|
||||
|
||||
In Windows File Manager, right-click on ../wxWidgets/build/msw/wx_vc16.sln,
|
||||
Select Visual Studio 2019.
|
||||
In the solutions configurations drop-down list, change "Debug" to
|
||||
"DLL Release",
|
||||
Then select Build > Build Solution.
|
||||
|
||||
When the build completes, you will get a message such as:
|
||||
========= Build: 24 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========
|
||||
|
||||
Close Visual Studio.
|
||||
|
||||
You can check this worked also by looking in C:\aud300\wxWidgets\lib\vc_dll
|
||||
There should be dll files there with _'ud' in their name.
|
||||
The ud stands for 'unicode debug'. If you only have files with 'u' then
|
||||
you only have release.
|
||||
|
||||
|
||||
5. Audacity
|
||||
|
||||
a) Clone Audacity from the Audacity GitHub project.
|
||||
https://github.com/audacity/audacity/
|
||||
|
||||
for example, in the git-bash command line
|
||||
mkdir audacity
|
||||
git clone https://github.com/audacity/audacity/
|
||||
|
||||
b) Open the CMake GUI
|
||||
|
||||
Open VS 2019 > "continue without code" > File > Open > CMake
|
||||
Open CMakeLists.txt in root of audacity source folder you cloned
|
||||
|
||||
Wait for the CMake Overview Pages tab to appear (be patient)
|
||||
Click "Open the CMake Settings Editor" in this new tab
|
||||
Scroll up to the top of the window and settings
|
||||
In the Configurations window, click the green "+", then select x86-Release
|
||||
Set Configuration type: Release
|
||||
|
||||
Verify Toolset: msvc_86
|
||||
Keep Build Root: ${projectDir}\out\build\${name} (default, you can
|
||||
change it) (this corresponds to CMAKE_BINARY_DIR)
|
||||
|
||||
Click on "Show advanced settings" (scroll down).
|
||||
Change CMake generator: VS 16 2019 (was Ninja)
|
||||
Click "Save and Generate CMake cache to load variables" once, then
|
||||
Click "Save and Generate CMake cache to load variables" a second time
|
||||
or select Project > Generate CMake Cache
|
||||
|
||||
c) Switch to the Ouput tab
|
||||
|
||||
Wait for "CMake generation finished".
|
||||
Check the Error List window:
|
||||
you should have 0 Errors and 0 Warnings.
|
||||
|
||||
d) Return to the CMakeSettings.json window
|
||||
Review CMake variables and cache
|
||||
Note that:
|
||||
|
||||
wxWidgets_LIB_DIR > 'C:/aud300/wxWidgets/lib/vc_dll' (your path
|
||||
may be slightly different)
|
||||
wxWidgets_ROOT_DIR > 'C:/aud300/wxWidgets' (your path
|
||||
may be slightly different)
|
||||
|
||||
|
||||
e) Build
|
||||
|
||||
Select Build > Build All
|
||||
Click on the Output tab and wait for the message "Build All succeeded"
|
||||
Check the Error List tab. There should be 0 Errors and 17 Warnings.
|
||||
Check the output directory indicated in step 6 to find
|
||||
`../bin/Release/Audacity.exe`
|
||||
|
Reference in New Issue
Block a user