3 2. Getting the source code
4 3. Install required libs
6 3.2. Install XBMC build depends
7 4. How to compile and run
12 -----------------------------------------------------------------------------
14 -----------------------------------------------------------------------------
16 This is a platform port of XBMC for the Apple OSX operating system. Both 10.6
17 and 10.7 Intel development platforms are supported. Xcode 3.2.6 and 4.3 and newer
18 are the recommended versions.
19 There are 3 ways to build XBMC for Mac, from command-line with make, from command-line
20 using xcodebuild or from Xcode.
22 Generally, Xcode is the easiest as it presents the build system in a GUI environment.
23 The command-line build is still under development.
25 XBMC for Mac is composed of a main binary with numerous dynamic libraries and
26 codecs that support a multitude of music and video formats.
28 On Snow Leopard (OSX 10.6.x) we recommend using Xcode 3.2.6.
29 On Lion (OSX 10.7.x) we recommend using Xcode 4.3.x.
31 NOTE TO NEW OS X USERS: All lines that are prefixed with the '$' character are
32 commands that need to be typed into a Terminal window. Note that the '$'
33 character itself should NOT be typed as part of the command.
36 -----------------------------------------------------------------------------
37 2. Getting the source code
38 -----------------------------------------------------------------------------
41 $ git clone git://github.com/xbmc/xbmc.git xbmc
43 -----------------------------------------------------------------------------
45 -----------------------------------------------------------------------------
46 Install latest Xcode (4.3.2 or 3.2.6 as of the writing). You can download it from
48 1. Apple's site after registration at http://developer.apple.com/tools/download (Xcode 3.2.6)
49 2. In the MacOSX AppStore (Xcode 4.3.x).
51 If you are using XCode 4.3.x or later you also need to install the "Command Line Tools". To do so
52 after installing Xcode you have to go to "Xcode->Preferences->Downloads" and install the
53 package "Command Line Tools".
55 Xcode 3.2.6 only runs on 10.6.x (Snow Leopard).
56 Xcode 4.3.x only runs on 10.7.x (Lion).
57 Xcode 4.4 only runs on 10.8.x (Mountain Lion).
59 -----------------------------------------------------------------------------
60 3.1 Install XBMC build depends
61 -----------------------------------------------------------------------------
63 3.1.1 Compiling as 32 Bit binary
65 $ cd tools/darwin/depends
67 $ ./configure --with-darwin=osx
70 3.1.2 Compiling as 64 Bit binary
72 $ cd tools/darwin/depends
74 $ ./configure --with-darwin=osx --with-arch=x86_64
77 IMPORTANT!! for Mountain Lion users. In Xcode 4.4 there is only SDK 10.7 and 10.8
78 available. The XBMC buildsystem defaults to 10.6. So for compiling with ML
79 you have to specify the 10.7 SDK explicitly on configure:
81 $ ./configure --with-darwin=osx --with-sdk=10.7
84 -----------------------------------------------------------------------------
86 -----------------------------------------------------------------------------
87 Both Xcode and Terminal compilation require that build environment be setup
88 first. This is a simple step and involves the following:
90 4.a Compilation by using command-line building via xcodebuild or
91 by compiling via Xcode GUI
94 $ make -C tools/darwin/depends/xbmc
98 4.b Compilation by using command-line building via make (experimental)
101 $ make -C tools/darwin/depends/xbmc
104 The configure operation will setup the build environment for codecs and
105 internal libraries that are used by XBMC. This step is required for both Xcode
106 and command-line building. The "make clean" ensures that there are no stale
107 binaries from git that might cause problems.
109 -----------------------------------------------------------------------------
111 -----------------------------------------------------------------------------
112 Start XCode and open the XBMC project (XBMC.xcodeproj) located in $HOME/XBMC.
113 For development, XBMC is run from the $HOME/XBMC directory and needs to have
114 the XBMC_HOME environment variable set to know where that directory is located.
115 To set XBMC_HOME environment variable:
118 Menu -> Project -> Edit Active Executable "XBMC", click "Arguments" tab and
119 add "XBMC_HOME" as an enviroment variable. Set the value to the path to the
120 XBMC root folder. For example, "/Users/bigdog/Documents/XBMC"
122 Xcode 4.3.x and later
123 Menu -> Product -> Edit Sheme -> "Run XBMC"/"Debug" -> Add XBMC_HOME into
124 the List of "Environment Variables".Set the value to the path to thev XBMC
125 root folder. For example, "/Users/bigdog/Documents/XBMC"
127 There are two build targets "XBMC" and "XBMC.app" (each in 32Bit and 64Bit flavour)
128 with debug and release settings. The "XBMC" target is used for rapid build and
129 debug cycles while the "XBMC.app" target is used to build a self contained
132 Set the build target to "XBMC" or "XBMC.app" and be sure to select the same
133 architecture as selected in step 3.1 (either i386 for 32Bit or x86_64 for 64Bit),
136 Mountain Lion users have to ensure to build against 10.7 SDK not 10.8 (which is
137 selected in Xcode 4.4 by default).
139 The build process will take a long time when building the first time.
140 You can see the progress in "Build Results". There are a large number of static
141 and dynamic libaries that will need to be built. Once these are built,
142 subsequent builds will be faster.
144 After the build, you can ether run XBMC for Mac from Xcode or run it from
145 the command-line. If you run it from the command-line, make sure your set
146 the XBMC_HOME environment variable (export XBMC_HOME=$HOME/XBMC). Then, to
147 run the debug version:
151 Or the release version:
153 $ ./build/Release/XBMC
155 You can also build via Xcode from the command-line using the following:
157 $ xcodebuild -configuration Release ONLY_ACTIVE_ARCH=YES ARCHS=i386 VALID_ARCHS=i386 \
158 -target "XBMC.app" -project XBMC.xcodeproj
160 You can specify "Release" instead of "Debug" as a configuration. Be sure to set *_ARCHS
161 variables to the same architecture as selected in step 3.1 (either i386 for 32Bit or x86_64
164 -----------------------------------------------------------------------------
165 4.2 Using Terminal (command-line) (this is a work in progress and might fail)
166 -----------------------------------------------------------------------------
167 There are two methods, a) make/Xcode and b) make (which might fail as it's under
170 If you want to build a cross-compiled version that can run under 10.6/10.7,
171 you could try xcodebuild from the command-line (normally unneeded - for advanced
176 $ export XBMC_HOME=`pwd`
178 $ xcodebuild -sdk macosx10.7 -project XBMC.xcodeproj -target XBMC.app ONLY_ACTIVE_ARCH=YES \
179 ARCHS=x86_64 VALID_ARCHS=x86_64 -configuration Release build
183 $ export XBMC_HOME=`pwd`
187 -----------------------------------------------------------------------------
189 -----------------------------------------------------------------------------
190 This section describes how to package XBMC in a disk image for
193 1. build XBMC.app from XCode so that the application bundle is correctly updated.
195 2. make -C tools/darwin/packaging/xbmc-osx
197 3. If completed successfully, a disk image named XBMC_for_Mac.dmg will be
198 present in the users XBMC build directory:
200 Remember to unmount/eject XBMC.dmg before attempting to recreate it,
201 otherwise dmgmaker.pl will fail.