1
0
mirror of https://github.com/cookiengineer/audacity synced 2025-10-21 14:02:57 +02:00

BUILDING.md: Document that wxWidgets 3.0 can work too

Co-authored-by: Sol Fisher Romanoff <sol@solfisher.com>
Signed-off-by: Mart Raudsepp <leio@gentoo.org>
Signed-off-by: Sol Fisher Romanoff <sol@solfisher.com>
This commit is contained in:
Mart Raudsepp
2021-09-06 00:48:56 +03:00
parent 929d423721
commit b558f0d57c

View File

@@ -5,8 +5,12 @@
### Linux
Most distributions do not package all of Tenacity's dependencies (yet).
wxWidgets 3.1 is required for building Tenacity but many distributions only
package wxWidgets 3.0. [PortMidi](https://github.com/mixxxdj/portmidi) and
wxWidgets 3.1 is suggested for building Tenacity but many distributions only
package wxWidgets 3.0. When 3.0 is used instead of 3.1, the main user visible
known drawback is that a few user interface texts will not be localized, and
the effects of not having various wxWidgets bug fixes that have not been
backported to the stable 3.0 series.
[PortMidi](https://github.com/mixxxdj/portmidi) and
[PortSMF](https://github.com/tenacityteam/portsmf) are required for MIDI support
but some distributions do not package PortSMF (Tenacity can still build without
MIDI support). [libsbsms](https://github.com/claytonotey/libsbsms) is an
@@ -64,7 +68,7 @@ to the CMake configuration step.
package called `libjack0`, you may need to install `libjack-jack2-dev` instead
of `libjack-dev`.
- wxWidgets 3.1 is required but not packaged in Debian or Ubuntu. Refer
- wxWidgets 3.1 is suggested but not packaged in Debian or Ubuntu. Refer
to the
[wxWidgets documentation](https://docs.wxwidgets.org/3.1/overview_cmake.html)
for how to install it from source code, or see the [previous section](#wxwidgets-from-source). The above package list
@@ -78,6 +82,12 @@ example, if you installed wxWidgets to /home/user/local:
export WX_CONFIG=/home/user/local/bin/wx-config
```
- Alternatively, you may skip installing wxWidgets 3.1 and use 3.0 instead:
```
sudo apt-get install libwxgtk3.0-dev
```
#### Fedora
First, if you want to build Tenacity with FFmpeg support, enable the
@@ -114,7 +124,8 @@ export WX_CONFIG=/home/user/local/bin/wx-config
#### Arch
Install `wxgtk3-dev-light` with your AUR helper of choice, for example:
To use wxWidgets 3.1, install `wxgtk3-dev-light` with your AUR helper of
choice, for example:
```
paru -S wxgtk3-dev-light
@@ -127,6 +138,9 @@ this AUR package:
export WX_CONFIG=/usr/bin/wx-config-gtk3-3.1
```
Alternatively, install `wxgtk3` with pacman to use wxWidgets 3.0, and set
`WX_CONFIG=/usr/bin/wx-config-gtk3`.
Install the rest of the build dependencies from the main Arch repository:
```
@@ -144,7 +158,7 @@ community repository:
sudo apk add cmake samurai lame-dev libsndfile-dev soxr-dev sqlite-dev portaudio-dev portmidi-dev libid3tag-dev soundtouch-dev libmad-dev ffmpeg-dev
```
wxWidgets 3.1 is required but not packaged in Alpine Linux. Refer to the
wxWidgets 3.1 is suggested but not packaged in Alpine Linux. Refer to the
[wxWidgets documentation](https://github.com/wxWidgets/wxWidgets/blob/master/docs/gtk/install.md)
for how to install it from source code, and make sure to set
`--disable-xlocale` in the configuration.
@@ -155,6 +169,9 @@ To install wxWidgets' dependencies:
sudo apk add gtk+3.0-dev zlib-dev libpng-dev tiff-dev libjpeg-turbo-dev expat-dev
```
Alternatively, install `wxgtk3-dev` with apk to use wxWidgets 3.0, and set
`WX_CONFIG=/usr/bin/wx-config-gtk3`.
TODO: add portsmf and libsbsms to this package list when aports are accepted.