Skip to content

Latest commit

 

History

History
262 lines (197 loc) · 9.21 KB

README.macOS.md

File metadata and controls

262 lines (197 loc) · 9.21 KB

Kodi Logo

macOS build guide

This guide has been tested with macOS 10.13.4()17E199 High Sierra and Xcode 9.3(9E145). It is meant to build Kodi for macOS using Kodi's unified depends build system. Please read it in full before you proceed to familiarize yourself with the build procedure.

Table of Contents

  1. Document conventions
  2. Prerequisites
  3. Get the source code
  4. Configure and build tools and dependencies
  5. Build binary add-ons
  6. Build Kodi
    6.1. Build with Xcode
    6.2. Build with xcodebuild
    6.3. Build with make
  7. Run Kodi
    7.1. Built with Xcode or xcodebuild
    7.2. Built with make
  8. Package
  9. Install

1. Document conventions

This guide assumes you are using terminal, also known as console, command-line or simply cli. Commands need to be run at the terminal, one at a time and in the provided order.

This is a comment that provides context:

this is a command
this is another command
and yet another one

Example: Clone Kodi's current master branch:

git clone https://github.com/xbmc/xbmc kodi

Commands that contain strings enclosed in angle brackets denote something you need to change to suit your needs.

git clone -b <branch-name> https://github.com/xbmc/xbmc kodi

Example: Clone Kodi's current Krypton branch:

git clone -b Krypton https://github.com/xbmc/xbmc kodi

Several different strategies are used to draw your attention to certain pieces of information. In order of how critical the information is, these items are marked as a note, tip, or warning. For example:

NOTE: Linux is user friendly... It's just very particular about who its friends are.
TIP: Algorithm is what developers call code they do not want to explain.
WARNING: Developers don't change light bulbs. It's a hardware problem.

back to top | back to section top

2. Prerequisites

Building for OSX/macOS should work with the following constellations of Xcode and OSX/macOS versions:

  • Xcode 8.x on OSX 10.11.x (El Capitan)
  • Xcode 9.x on OSX 10.12.x (Sierra)
  • Xcode 9.x on macOS 10.13.x (High Sierra)

WARNING: Start Xcode after installation finishes. You need to accept the licenses and install missing components.

back to top

3. Get the source code

Change to your home directory:

cd $HOME

Clone Kodi's current master branch:

git clone https://github.com/xbmc/xbmc kodi

back to top

4. Configure and build tools and dependencies

Kodi can be built as either a 32bit or 64bit program. The dependencies are built in $HOME/kodi/tools/depends and installed into /Users/Shared/xbmc-depends.

TIP: Look for comments starting with Or ... and only execute the command(s) you need.

Configure build for 64bit (recommended):

cd $HOME/kodi/tools/depends
./bootstrap
./configure --host=x86_64-apple-darwin

Or configure build for 32bit:

cd $HOME/kodi/tools/depends
./bootstrap
./configure --host=i386-apple-darwin

Build tools and dependencies:

make -j$(getconf _NPROCESSORS_ONLN)

TIP: By adding -j<number> to the make command, you can choose how many concurrent jobs will be used and expedite the build process. It is recommended to use -j$(getconf _NPROCESSORS_ONLN) to compile on all available processor cores. The build machine can also be configured to do this automatically by adding export MAKEFLAGS="-j$(getconf _NPROCESSORS_ONLN)" to your shell config (e.g. ~/.bashrc).

WARNING: Look for the Dependencies built successfully. success message. If in doubt run a single threaded make command until the message appears. If the single make fails, clean the specific library by issuing make -C target/<name_of_failed_lib> distclean and run makeagain.

NOTE: Advanced developers may want to specify an SDK version (if multiple versions are installed) in the configure line(s) shown above. The example below would use SDK 10.9:

./configure --host=x86_64-apple-darwin --with-sdk=10.9

back to top | back to section top

5. Build binary add-ons

You can find a complete list of available binary add-ons here.

Change to Kodi's source code directory:

cd $HOME/kodi

There are multiple possibilities to choose which addons are built. The following 3 examples will give an idea.

(1) Build all add-ons:

make -j$(getconf _NPROCESSORS_ONLN) -C tools/depends/target/binary-addons

OR

(2) Build specific add-ons:

make -j$(getconf _NPROCESSORS_ONLN) -C tools/depends/target/binary-addons ADDONS="audioencoder.flac pvr.vdr.vnsi audiodecoder.snesapu"

OR

(3) Build a specific group of add-ons:

make -j$(getconf _NPROCESSORS_ONLN) -C tools/depends/target/binary-addons ADDONS="pvr.*"

back to top

6. Build Kodi

Before you can use Xcode to build Kodi, the Xcode project has to be generated with CMake. CMake is built as part of the dependencies and doesn't have to be installed separately. A toolchain file is also generated and is used to configure CMake.

6.1. Build with Xcode

Create an out-of-source build directory:

mkdir $HOME/kodi-build

Change to build directory:

cd $HOME/kodi-build

Generate Xcode project for 64bit (recommended):

/Users/Shared/xbmc-depends/x86_64-darwin17.5.0-native/bin/cmake -G Xcode -DCMAKE_TOOLCHAIN_FILE=/Users/Shared/xbmc-depends/macosx10.13_x86_64-target-debug/share/Toolchain.cmake ../kodi

Or generate Xcode project for 32bit:

/Users/Shared/xbmc-depends/x86_64-darwin17.5.0-native/bin/cmake -G Xcode -DCMAKE_TOOLCHAIN_FILE=/Users/Shared/xbmc-depends/macosx10.13_i386-target-debug/share/Toolchain.cmake ../kodi

WARNING: The toolchain file location differs depending on SDK version. You have to replace x86_64-darwin17.5.0-native and macosx10.13_x86_64-target-debug or macosx10.13_i386-target-debug in the paths above with the correct ones on your system.

You can check Users/Shared/xbmc-depends directory content with:

ls -l /Users/Shared/xbmc-depends

Start Xcode, open the Kodi project file (kodi.xcodeproj) located in $HOME/kodi-build and hit Build.

WARNING: If you have selected a specific SDK version in step 4 then you might need to adapt the active target to use the same SDK version, otherwise build will fail. Be sure to select a device configuration. Building for simulator is not supported.

6.2. Build with xcodebuild

Alternatively, you can also build via Xcode from the command-line with xcodebuild, triggered by CMake:

Change to build directory:

cd $HOME/kodi-build

Build Kodi:

/Users/Shared/xbmc-depends/x86_64-darwin17.5.0-native/bin/cmake --build . --config "Debug" -- -verbose -jobs $(getconf _NPROCESSORS_ONLN)

TIP: You can specify Release instead of Debug as --config parameter.

6.3. Build with make

CMake is also able to generate makefiles that can be used to build with make.

Change to Kodi's source code directory:

cd $HOME/kodi

Generate makefiles:

make -C tools/depends/target/cmakebuildsys

Build Kodi:

make -j$(getconf _NPROCESSORS_ONLN) -C build

back to top | back to section top

7. Run Kodi

7.1. Built with Xcode or xcodebuild

After build finishes, you can run Kodi from Xcode or from terminal.

Run Debug config from terminal:

$HOME/kodi-build/Debug/kodi.bin

Run Release config from terminal:

$HOME/kodi-build/Release/kodi.bin

7.2. Built with make

After build finishes, you can run Kodi from terminal:

$HOME/kodi/build/kodi.bin

back to top

8. Package

CMake generates a target called dmg which will package Kodi ready for distribution. After Kodi has been built, the target can be triggered by selecting it in Xcode active scheme or manually running

cd $HOME/kodi-build/build
/Users/Shared/xbmc-depends/x86_64-darwin17.5.0-native/bin/cmake --build . --target "dmg" --config "Debug"

Generated dmg file will be inside $HOME/kodi-build/tools/darwin/packaging/osx/.

Alternatively, if you built using make:

cd $HOME/kodi/build
make dmg

Generated dmg file will be inside $HOME/kodi/build/tools/darwin/packaging/osx/.

back to top

9. Install

Kodi can be installed like any other app.

back to top