massive overhaul to Troubleshooting, unify Debian/Ubuntu info under QT6
cobalt2727
parent
9d129f5696
commit
f2942bc966
|
|
@ -6,18 +6,21 @@
|
|||
|
||||
## Additional Dependencies Examples
|
||||
|
||||
### For Ubuntu 20.04+ with Dolphin versions ~5.0-13001 or newer
|
||||
```
|
||||
sudo apt install build-essential 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
|
||||
### For Ubuntu (22.04 and up)/Debian with Dolphin versions ~5.0-13001 or newer
|
||||
Ubuntu **_18.04_** and _**20.04**_ users, please install QT6 from source or an outside repo. One way to do so is to add [this PPA](https://launchpad.net/~okirby/+archive/ubuntu/qt6-backports) by running `sudo add-apt-repository ppa:okirby/qt6-backports && sudo apt update` before running the next command.
|
||||
```sh
|
||||
sudo apt install build-essential git cmake ffmpeg libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libevdev-dev libusb-1.0-0-dev libxrandr-dev libxi-dev libpangocairo-1.0-0 qt6-base-private-dev libbluetooth-dev libasound2-dev libpulse-dev
|
||||
|
||||
sudo apt install libudev-dev libsystemd-dev || sudo apt install libeudev-dev #distros without systemd like AntiX must use eudev instead
|
||||
```
|
||||
|
||||
### Other Debian based (Debian, Kali, etc.):
|
||||
```
|
||||
sudo apt install build-essential 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 qtchooser qmake6 libudev-dev portaudio19-dev libasound2-dev libzypp-dev libcubeb-dev libfmt-dev llvm-dev
|
||||
### Fedora:
|
||||
```sh
|
||||
sudo dnf install vulkan-loader vulkan-loader-devel cmake git gcc-c++ libXext-devel libgudev qt6-qtbase-devel qt6-qtbase-private-devel systemd-devel openal-soft-devel libevdev-devel libao-devel SOIL-devel libXrandr-devel pulseaudio-libs-devel bluez-libs-devel libusb-devel libXi-devel
|
||||
```
|
||||
|
||||
### Chrome/Chromium OS (via [Chromebrew](https://github.com/chromebrew/chromebrew)):
|
||||
```
|
||||
### (!WIP) Chrome/Chromium OS (via [Chromebrew](https://github.com/chromebrew/chromebrew)):
|
||||
```sh
|
||||
crew install binutils wayland cmake gcc buildessential git libx11 pkg-config libxi libxext qtbase qtwayland mesa libxfixes libxxf86vm libusb libdrm libxrandr gettext linuxheaders enet libxshmfence libunwind lm_sensors elfutils patchelf vulkan_icd_loader
|
||||
|
||||
#Intel hardware
|
||||
|
|
@ -41,6 +44,9 @@ git pull --recurse-submodules
|
|||
```
|
||||
|
||||
## Building
|
||||
If your system has an old compiler in its system repos, a higher version can be specified with build flags. For example, Ubuntu 18.04 users should install `gcc-11` from something like [this PPA](https://launchpad.net/~ubuntu-toolchain-r/+archive/ubuntu/test) and then instead of `cmake ..` type `cmake .. -DCMAKE_C_COMPILER=gcc-11 -DCMAKE_CXX_COMPILER=g++-11` during the build process.
|
||||
|
||||
|
||||
### Global Build (if unsure, use this option)
|
||||
```bash
|
||||
mkdir build && cd build
|
||||
|
|
@ -99,10 +105,12 @@ On some distributions of Linux, package maintainers provide unofficial, unmodifi
|
|||
- [Fedora](https://packages.fedoraproject.org/pkgs/dolphin-emu/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 - Steam Deck users may recognize this as the version distributed in the desktop mode's Discover store**
|
||||
|
||||
|
||||
### Troubleshooting
|
||||
|
||||
- Ubuntu 18.04 users must install `gcc-11` from [this PPA](https://launchpad.net/~ubuntu-toolchain-r/+archive/ubuntu/test) and then instead of `cmake ..` type `cmake .. -DCMAKE_C_COMPILER=gcc-11 -DCMAKE_CXX_COMPILER=g++-11` during the build process.
|
||||
- Whenever QT5 support is eventually dropped, the proper QT6 dependencies will need to be installed from source or from a repo (such as [this PPA for outdated Ubuntu releases](https://launchpad.net/~okirby/+archive/ubuntu/qt6-backports)).
|
||||
- The compiler will normally tell you what's going on if you run into an error. Read the error messages closely and look them up verbatim to see if it's something missing on your system and/or a typo in recent Dolphin commits.
|
||||
- QT5 support has been [officially been deprecated](https://dolphin-emu.org/blog/2022/06/09/leaving-a-legend/) by the Dolphin development team. While it's still technically possible to build using QT5, as of [5.0-17764](https://dolphin-emu.org/download/dev/950e1f94dc73b56309c090d7b04033506b057ae0/) the minimum requirement was raised to 5.15. It's recommended to install the proper QT6 dependencies instead - by the time you're reading this, it's possible that not even 5.15 works anymore.
|
||||
- That being said, there _is_ a [known bug](https://bugs.dolphin-emu.org/issues/12913) as of QT **6.3** where mouse clicks don't work on Linux. No one's really sure why yet.
|
||||
- Need more speed? As an alternative to `cmake ..` during the build process, type `cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_FLAGS=-mcpu=native -DCMAKE_C_FLAGS=-mcpu=native` instead. The resulting build will be optimized specifically for YOUR processor! The difference is more noticeable the weaker your computer is. Note that this may result in longer compile times, and the binaries you build will almost certainly be unusable on any computer besides your own.
|
||||
Loading…
Reference in New Issue