The-Homebrew-Cloud/dolphin
2
0
Fork 0
mirror of https://github.com/dolphin-emu/dolphin.git synced 2025-01-09 15:49:25 +01:00
Code Issues Packages Projects Releases Wiki Activity

Destroyed Building for Linux (markdown)

Ryan Houdek 2015-09-19 16:05:05 -05:00
parent e79197171a
commit d3f73f75dd
1 changed files with 0 additions and 123 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

123
Building-for-Linux.md

@ -1,123 +0,0 @@
## Introduction
---
Dolphin runs on 64-bit Linux distributions. These instructions explain how to build Dolphin on Linux using the cmake build system.
## Step 1 – Install the Correct Dependencies
---
**Downloading build dependencies**
See the [build dependencies](#build-dependencies) below for a list of packages you will need to install.
On Debian-based distributions, you can use `apt-get` to install them.
**Installing SDL**
Note: SDL 2.0 must be compiled from source to prevent a bug causing Dolphin to crash with rumble-enabled controllers.
Install Mercurial (`sudo apt-get install mercurial`), and clone the SDL repo to the directory of your choice:
```
cd /tmp; hg clone http://hg.libsdl.org/SDL
```
Build SDL and install:
```
cd SDL; ./configure && make && sudo make install
```
## Step 2 – Get the Dolphin Repository
---
Get a local copy of the dolphin-emu repository:
```bash
git clone https://github.com/dolphin-emu/dolphin.git dolphin-emu
```
Change to the directory created:
```bash
cd dolphin-emu
```
Later, if you wish to update your local copy:
```bash
git pull origin master
```
## Step 3 – Building Dolphin
---
Create a build subdirectory, and change into it:
```bash
mkdir Build && cd Build
```
Configure the build:
```bash
cmake ..
```
You may also want to change the install prefix by adding `-D CMAKE_INSTALL_PREFIX=/new/path`.
Note that this path does not need to be absolute. cmake will complete it to its absolute equivalent.
The default prefix is `/usr`. This means that the executable will be installed as `/usr/bin/dolphin-emu`, the plugins will be installed into `/usr/lib/dolphin-emu`, and the shared data files will be installed into `/usr/share/dolphin-emu`.
From here build and install in the standard make way:
```bash
make && make install
```
Note that you may need superuser privileges for the last command.
## Step 4 – Run Dolphin!
---
You can run dolphin from anywhere by typing:
`dolphin-emu`
If you changed the prefix and `$prefix/bin` is not in your path, then you will have to precede this with the path to the executable.
## FAQ
---
**Where can I get help?**
Go to the [forums](http://forums.dolphin-emu.org/). Lots of Dolphin users use Linux, and they are very experienced with this process.
**My build failed, but I did nothing wrong!**
Most of the time, any problems in the build process are due to user error. It's understandable, it is a complicated process and can be quite daunting for a first timer. But sometimes even with everything right, triple checked, and it's still not working. It's rare, but sometimes a build will just be bugged. But many of Dolphin devs are Linux users, so just wait a day or so, and it will be sorted out.
## Build Dependencies
---
- git
- cmake (>= 2.8.8)
- g++ (>= 4.9)
- libwxbase3.0-dev (>= 3.0.1)
- libwxgtk3.0-dev (>= 3.0.1)
- libgtk2.0-dev
- libbluetooth-dev (optional, for real Wiimotes)
- libxrandr-dev (optional, for switching desktop resolution in fullscreen mode)
- libxext-dev
- libreadline-dev
- libevdev-dev
- libasound-dev (optional, for ALSA sound backend)
- libpulse-dev (optional, for PulseAudio sound backend)
- libao-dev (optional, for AO sound backend)
- libopenal-dev (optional, for OpenAL sound backend)
- portaudio (>=19?) (optional, if not found will be built statically)
- libavcodec-dev (optional, for dumping frames in AVI format)
- libavformat-dev (optional, for dumping frames in AVI format)
- libswscale-dev (optional, for dumping frames in AVI format)
- libusb-1.0-0-dev (>= 1.0.19) (optional, for USB peripherals)
- libenet-dev (>= 1.3.12) (optional, if not found will be built statically)
- liblzo2-dev (>= 2.04) (optional, if not found will be built statically)
- libminiupnpc-dev (>= 1.8) (optional, if not found will be built statically)
- libpolarssl-dev (>= 1.3.8) (optional, if not found will be built statically)
- libsoil-dev (optional, if not found will be built statically)
- libsfml-dev (>= 2.1) (optional, if not found will be built statically)
- zlib1g-dev (>= 1.2.8)
- SDL 2.0 (build from source to avoid a bug with rumble-enabled controllers)
- [The bug](https://bugzilla.libsdl.org/show_bug.cgi?id=2648) in question is present in SDL 2.0.2 and SDL 2.0.3. The bug has been fixed in the development version of SDL, which can be downloaded [from here.](http://libsdl.org/hg.php)