fix some missing audio dependencies & modify troubleshooting steps

cobalt2727 2022-01-13 11:20:49 -05:00
parent 25f310cb07
commit 37f98d73c5

@ -7,17 +7,14 @@
## Additional Dependencies Examples
### For Ubuntu 20.04+ with Dolphin versions ~5.0-13001 or newer
`sudo apt install git cmake ffmpeg libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libevdev-dev libudev-dev libxrandr-dev libxi-dev libpangocairo-1.0-0 qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools qtbase5-private-dev`
```bash
sudo apt install git cmake ffmpeg libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libevdev-dev libudev-dev libxrandr-dev libxi-dev libpangocairo-1.0-0 qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools qtbase5-private-dev libbluetooth-dev libasound2-dev libpulse-dev
```
### Other Debian based (Debian, Kali, etc.):
`sudo apt install git cmake ffmpeg libavcodec-dev libevdev-dev libusb-1.0-0-dev libavformat-dev libswscale-dev libsfml-dev libminiupnpc-dev libmbedtls-dev curl libhidapi-dev libpangocairo-1.0-0 libgtk2.0-dev libbluetooth-dev qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools qtbase5-private-dev libudev-dev portaudio19-dev`
### Troubleshooting
Your build may fail in some cases on Ubuntu 18.04 and/or some of its forks.
In that case try the following:
`sudo apt remove liblzma-dev libzstd-dev`
You can reinstall them after Dolphin builds successfully if you like.
```bash
sudo apt install git cmake ffmpeg libavcodec-dev libevdev-dev libusb-1.0-0-dev libavformat-dev libswscale-dev libsfml-dev libminiupnpc-dev libmbedtls-dev curl libhidapi-dev libpangocairo-1.0-0 libgtk2.0-dev libbluetooth-dev qtbase5-dev qtchooser qt5-qmake qtbase5-dev-tools qtbase5-private-dev libudev-dev portaudio19-dev libasound2-dev
```
## Checkout Dolphin
1. Create a directory to store Dolphin in
@ -28,7 +25,7 @@ You can reinstall them after Dolphin builds successfully if you like.
6. `git pull --recurse-submodules` (if you've cloned Dolphin previously in this folder, this line will make sure everything is updated)
## Building
### Global Build
### Global Build (if unsure, use this option)
```bash
mkdir build && cd build
@ -78,10 +75,15 @@ cpack -G DEB
## Externally Managed Packages
On some distributions of Linux, package maintainers provide unmodified builds of Dolphin. These are listed below:
- [Ubuntu](https://launchpad.net/~dolphin-emu/+archive/ubuntu/ppa) **as of the time of this writing, 16.04 and 18.04 only**
- [Ubuntu](https://launchpad.net/~dolphin-emu/+archive/ubuntu/ppa) **as of the time of this writing, 16.04 and 18.04 only for whatever reason**
- [Debian](https://packages.debian.org/buster/games/dolphin-emu) **uses a highly outdated 5-year-old build**
- [Arch Linux](https://aur.archlinux.org/packages/dolphin-emu-git/)
- [Fedora](https://apps.fedoraproject.org/packages/dolphin-emu) **Follows the latest beta version but isn't quite always caught up with the most recent**
- [OpenSUSE](https://software.opensuse.org/package/dolphin-emu)
- [Gentoo](https://packages.gentoo.org/packages/games-emulation/dolphin)
- [Flatpak](https://flathub.org/apps/details/org.DolphinEmu.dolphin-emu) **updated with latest "beta" versions**
- [Flatpak](https://flathub.org/apps/details/org.DolphinEmu.dolphin-emu) **updated with latest "beta" versions**
### Troubleshooting
Ubuntu 18.04 users will not have a working emulated Wii remote cursor. To fix this, install `gcc-11` from [this PPA](https://launchpad.net/~ubuntu-toolchain-r/+archive/ubuntu/test) and instead of `cmake ..` type `cmake .. -DCMAKE_C_COMPILER=gcc-11 -DCMAKE_CXX_COMPILER=g++-11` during the build process. This may become necessary in the in the long term anyway to solve issues for anyone still building on 18.04 in the future.