Create and enter a build directory
mkdir peripheral.joystick-build
cd peripheral.joystick-build
Generate a build environment with config for debugging (assuming you cloned Kodi into the folder $HOME/workspace/kodi
)
cmake -DADDONS_TO_BUILD=peripheral.joystick \
-DCMAKE_BUILD_TYPE=Debug \
-DCMAKE_INSTALL_PREFIX=$HOME/workspace/kodi/addons \
-DPACKAGE_ZIP=1 \
$HOME/workspace/kodi/project/cmake/addons
The add-on can then be built with make
.
Stand-alone builds are closer to "normal" software builds. The build system looks for its dependencies, by default with /usr
and /usr/local
prefixes.
To provide these dependencies yourself in a local working directory ($HOME/kodi
), build Kodi with an installation prefix
cd $HOME/workspace/kodi
./bootstrap
./configure --prefix=$HOME/kodi
make
make install
Clone kodi-platform and create a CMake build directory
git clone https://github.com/xbmc/kodi-platform.git
cd kodi-platform
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Debug \
-DCMAKE_INSTALL_PREFIX=$HOME/kodi \
..
make
make install
The platform library was split from kodi-platform. Do the same as above for the new platform library:
git clone https://github.com/Pulse-Eight/platform.git
...
With these dependencies in place, the add-on can be built. Use the CMake command for kodi-platform above, or use this command to copy add-ons to your Kodi source tree:
cmake -DCMAKE_BUILD_TYPE=Debug \
-DCMAKE_PREFIX_PATH=$HOME/kodi \
-DCMAKE_INSTALL_PREFIX=$HOME/workspace/kodi/addons \
-DPACKAGE_ZIP=1 \
..
I'm still working on build instructions for stand-alone builds on Windows. The closest instructions may come from this helpful forum post: http://forum.kodi.tv/showthread.php?tid=173361&pid=2097898#pid2097898.
For now, follow the Windows instructions below.
Kodi's build system will fetch the add-on from the GitHub URL and git hash specified in peripheral.joystick.txt.
Ensure that kodi has been built successfully with the desired prefix ($HOME/kodi
for a local prefix, or omitted for the system prefix (usually /usr
or /usr/local
). Then, from the root of Kodi's source tree, run
make install
Build the add-on
make -C tools/depends/target/binary-addons PREFIX=$HOME/kodi ADDONS="peripheral.joystick"
The compiled .so can be found at
$HOME/kodi/lib/kodi/addons/peripheral.joystick/peripheral.joystick.so
To rebuild the add-on or compile a different one, clean the build directory
make -C tools/depends/target/binary-addons clean
First, download and install CMake.
To compile on windows, open a command prompt at tools\buildsteps\win32
and run the script:
make-addons.bat install peripheral.joystick
Alternatively, generate the kodi-addons.sln
Visual Studio solution and project files.
tools\windows\prepare-binary-addons-dev.bat
The generated solution can be found at
project\cmake\addons\build\kodi-addons.sln
Add-ons can be built individually through their specific project, or all at once by building the solution.
No source code is downloaded at the CMake stage; when the project is built, the add-on's source will be downloaded and compiled.
Per README.osx, enter the tools/depends
directory and make the add-on:
cd tools/depends
make -C target/binary-addons ADDONS="peripheral.joystick"
To rebuild the add-on or compile a different one, clean the build directory
make -C target/binary-addons clean