Difference between revisions of "Building RetroArch"

From Emulation General Wiki
Jump to navigation Jump to search
(Added cd command to core building section)
Line 38: Line 38:
  
 
==To build RetroArch:==
 
==To build RetroArch:==
Download the [http://themaister.net/retroarch-dl/RetroArch-win64-headers.zip headers] and [http://themaister.net/retroarch-dl/RetroArch-win64-libs.zip libs] and extract them to the folder where the RetroArch repository was cloned (in \libretro-super\retroarch if you used the fetch script). Then do these commands from the Git Bash shell:
+
Download the [http://themaister.net/retroarch-dl/RetroArch-win64-headers.zip headers] and [http://themaister.net/retroarch-dl/RetroArch-win64-libs.zip libs] and extract them to the folder where the RetroArch repository was cloned (in \libretro-super\retroarch if you used the fetch script). Then execute these commands from the Git Bash shell:
  
 
  cd libretro-super
 
  cd libretro-super
Line 62: Line 62:
 
You can do to build all cores at once:
 
You can do to build all cores at once:
  
 +
cd libretro-super
 
  sh libretro-build.sh
 
  sh libretro-build.sh
  

Revision as of 05:02, 6 February 2014

Building on Windows

Note - the following is for 64-bit Windows only. 32-bit Windows will need to get 32-bit MinGW instead and use 32-bit headers and libs for RetroArch.

Download the prepackaged toolchain from here.

Extract it somewhere, for example C:\MinGW.

Run Git Bash.vbs. Then do the following commands:

git clone https://github.com/libretro/libretro-super.git
cd libretro-super
sh libretro-fetch.sh

You should now have all the libretro organization repositories cloned in the libretro-super folder within your MinGW folder. You can use libretro-fetch.sh again to update all repositories.

Just as a tip, always do a "git pull" to update the repository and "make clean" to clean up old build files before building anything. -j sets the number of jobs to do simultaneously, if you have a quad-core CPU, use -j4.

If you change a file in one of the cloned repositories and git won't let you update, do:

git reset --hard
git pull

It should update after that. If not, delete the whole repository and run libretro-fetch.sh again.

To change directories/folders do:

cd folder
or
cd folder/subfolder

etc.

To go up one directory:

cd ..

Other basic UNIX shell commands like "ls" can be useful as well.

To build RetroArch:

Download the headers and libs and extract them to the folder where the RetroArch repository was cloned (in \libretro-super\retroarch if you used the fetch script). Then execute these commands from the Git Bash shell:

cd libretro-super
cd retroarch
git pull
make -f Makefile.win clean
make -f Makefile.win -j4

You should see a list of files being compiled, ending with "LD RetroArch.exe". You can then copy the newly compiled retroarch.exe and \tools\retroarch-joyconfig.exe from libretro-super\retroarch to wherever you keep your RetroArch installation.

To build libretro cores:

After running the fetch script, you should have a folder for each libretro core in your libretro-super folder. For most cores all you need to do is do:

git pull
make -f Makefile.libretro clean
make -f Makefile.libretro -j4

If there isn't a Makefile.libretro in the top level, try to find a "libretro" folder within the repository and there should be a makefile in there. After the core is built, it will be in the same folder as the makefile used to compile it.

Refer to the libretro-build-common.sh for exact commands for each core.

You can do to build all cores at once:

cd libretro-super
sh libretro-build.sh

You may need to open the script in text editor and add the following to the script around line 84 to make it work if you're using the prepackaged toolchain:

MAKE=make
CC=gcc
CXX=g++

Cores that build successfully are put in /dist/win in your libretro-super folder.

Some cores need special commands for building:

bSNES Performance

cd libretro-bsnes/perf
make ui='target-libretro' profile='performance' clean
make ui='target-libretro' profile='performance' -j4

bSNES Balanced

cd libretro-bsnes/balanced
make ui='target-libretro' profile='balanced' clean
make ui='target-libretro' profile='balanced' -j4

bSNES Accuracy

cd libretro-bsnes
make ui='target-libretro' profile='accuracy' clean
make ui='target-libretro' profile='accuracy' -j4

Mednafen

make core=[CORE] clean
make core=[CORE] -j4

Replace [CORE] with psx for PlayStation, pce-fast for PC-Engine, wswan for WonderSwan, ngp for Neo-Geo Pocket, or vb for Virtual Boy. Do not bother with snes or gba, those cores do not function correctly on Windows and are based on old versions of bSNES and VBA-M.

Mupen64plus

To make a build with the dynarec available:

make WITH_DYNAREC=x86_64 clean
make WITH_DYNAREC=x86_64 -j4

MAME 2013

Download and install Python 2.7.5 to the default location.

Then do:

make -f Makefile.libretro PTR64=1 PYTHON="C:/Python27/pythonw.exe" clean
make -f Makefile.libretro PTR64=1 PYTHON="C:/Python27/pythonw.exe" -j4

This core will take a while to build, depending on how fast your CPU is, how many jobs you specify, and how many cores your CPU has.

Libretro Super

Libretro-super is a series of scripts used to ease the compilation and installation of each and every libretro emulation core and RetroArch itself. Thus this is the simplest route to a fully functional installation. If you need or want to build each core individually then you can refer to the build-common.sh script for direction.

git clone git://github.com/libretro/libretro-super.git
cd libretro-super
sh libretro-fetch.sh
sh libretro-build.sh
sh libretro-install.sh <path where you'd like RetroArch installed>