Compilation guide (Linux)

Noah Krohn edited this page Jun 27, 2017 · 31 revisions

Compilation on Linux and BSD does not have many surprises, as its foundation is Unix-based.

Dependencies

  • At least one libretro implementation
  • pkgconfig
  • Working OpenGL headers (should be included by default, but you might need to install libgl/mesa development packages)

Optional dependencies

  • libxml2-devel - For XML shaders and cheat support.
  • freetype-devel - TTF font rendering
  • ffmpeg/libavcodec - FFmpeg recording
  • nvidia-cg-toolkit - Cg shaders
  • libudev-devel
  • zlib-devel

Some other libraries can be built support for as well, please refer to ./configure --help.

Satisfying dependencies under Fedora 23

sudo dnf install make automake gcc gcc-c++ kernel-devel mesa-libEGL-devel libv4l-devel libxkbcommon-devel mesa-libgbm-devel Cg libCg zlib-devel freetype-devel libxml2-devel ffmpeg-devel SDL2-devel SDL-devel perl-X11-Protocol perl-Net-DBus pulseaudio-libs-devel openal-soft-devel libusb-devel

Satisfying dependencies under Debian/Ubuntu

apt-get -y install build-essential libxkbcommon-dev zlib1g-dev libfreetype6-dev libegl1-mesa-dev libgles2-mesa-dev libgbm-dev nvidia-cg-toolkit nvidia-cg-dev libavcodec-dev libsdl2-dev libsdl-image1.2-dev libxml2-dev yasm

This list of packages may not be complete.

Getting the code

git clone git://github.com/libretro/libretro-super.git
cd libretro-super
SHALLOW_CLONE=1 ./libretro-fetch.sh

Building RetroArch

./retroarch-build.sh

Building libretro cores

You should at least build one libretro implementation so RetroArch can do stuff. There is a super-project that is designed to easily build every libretro port out there. To build every core:

NOCLEAN=1 ./libretro-build.sh

Omit NOCLEAN=1 if you wish to perform "make clean" on every repo before building

Installing

Let's assume you'd like to install RetroArch into a folder called ~/ra

mkdir -p ~/ra/cores
cd retroarch
make DESTDIR=~/ra install
cd .. #to libretro-super directory
./libretro-install.sh ~/ra/cores

You should now have a fully functional RetroArch build in ~/ra Enjoy! :)