Skip to content

Latest commit

 

History

History
103 lines (70 loc) · 3.28 KB

Readme.md

File metadata and controls

103 lines (70 loc) · 3.28 KB
Raw

game.libretro

Libretro compatibility layer for the Kodi Game API

Building out-of-tree (recommended)

Linux

Clone the repo and create a build directory

git clone https://github.com/kodi-game/game.libretro.git
cd game.libretro
mkdir build
cd build

Generate a build environment with config for debugging

cmake -DADDONS_TO_BUILD=game.libretro \
      -DADDON_SRC_PREFIX=$HOME/workspace \
      -DCMAKE_BUILD_TYPE=Debug \
      -DCMAKE_INSTALL_PREFIX=$HOME/workspace/xbmc/addons \
      -DPACKAGE_ZIP=1 \
      $HOME/workspace/xbmc/project/cmake/addons

If you are developing in Eclipse, you can create a "makefile project with existing code" using game.libretro/ as the existing code location. To build, enter Properties -> "C/C++ Build" and change the build command to make -C build.

It is also possible to generate Eclipse project files with cmake

cmake -G"Eclipse CDT4 - Unix Makefiles" \
      -D_ECLIPSE_VERSION=4.4 \
      -DADDONS_TO_BUILD=game.libretro \
      -DADDON_SRC_PREFIX=$HOME/workspace \
      -DCMAKE_BUILD_TYPE=Debug \
      -DCMAKE_INSTALL_PREFIX=$HOME/workspace/xbmc/addons \
      -DPACKAGE_ZIP=1 \
      $HOME/workspace/xbmc/project/cmake/addons

Windows

First, download and install CMake.

To build on windows, change to the addons folder:

cd D:\Projects\xbmx\xbmc\project\cmake\addons

Generate Visual Studio 2013 solution

cmake -DADDONS_TO_BUILD=game.libretro -DADDON_SRC_PREFIX="D:\Projects\demo" -DCMAKE_BUILD_TYPE=Debug -G "Visual Studio 12"  -DCMAKE_USER_MAKE_RULES_OVERRIDE="D:\Projects\xbmx\xbmc\project\cmake\scripts\windows\c-flag-overrides.cmake" -DCMAKE_USER_MAKE_RULES_OVERRIDE_CXX="D:\Projects\xbmx\xbmc\project\cmake\scripts\windows\cxx-flag-overrides.cmake" -DCMAKE_INSTALL_PREFIX="D:\Projects\xbmx\xbmc\adons" -DPACKAGE_ZIP=1

Open Visual Studio, load and build this solution:

D:\Projects\xbmx\xbmc\project\cmake\addons\kodi-addons.sln

Altarnatively, wait for the prepare-addons-dev.bat build script in PR #6658 to be merged. Enter tools/buildsteps/win32 and execute it from there. If you want to execute it from somewhere else you need to adjust the default value of WORKDIR in the batch file.

Available options are:

  • clean to simply clean the whole generated buildsystem
  • <addon-id> to only generate the buildsystem for that addon

Building in-tree

Kodi's build system will fetch the add-on from the GitHub URL and git hash specified in game.libretro.txt.

Windows

Remember, CMake is needed.

cd tools\buildsteps\win32
make-addons.bat game.libretro

The compiled .dll will be placed in project\cmake\addons\build\game.libretro-prefix\src\game.libretro-build.

OSX

Per README.osx, enter the tools/depends directory and make the add-on:

cd tools/depends
make -C target/binary-addons ADDONS="game.libretro"

Cleaning build directory

Run the following to clean the build directory. Note, this will clean all add-ons, not just game.libretro.

make -C target/binary-addons clean