Skip to content
This repository
Newer
Older
100644 256 lines (195 sloc) 10.117 kb
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
1 TOC
2 1. Introduction
3 2. Getting the source code
c0691142 » modhack2
2009-01-26 [OSX]: updated for missing's libs and xcode's version
4 3. Install required libs
5 3.1. Install Xcode
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
6 3.2. Install MacPorts 1.7
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
7 4. How to compile and run
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
8 4.1 Using XCode
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
9 4.2 Using Command line
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
10 5. Packaging
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
11
12 -----------------------------------------------------------------------------
13 1. Introduction
14 -----------------------------------------------------------------------------
15
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
16 This is a platform port of XBMC for the Apple OSX operating system. Both 10.5
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
17 and 10.4 Intel development platforms are supported. The current build system
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
18 is Xcode 2.5 or Xcode 3.1.2 There are two ways to build XBMC for Mac.
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
19 1) command-line or
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
20 2) Xcode.
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
21
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.
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
24
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.
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
27
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
28 NOTE TO NEW OS X USERS: All lines that are prefixed with the '$' character are
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
29 commands that need to be typed into a Terminal window. Note that the '$'
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
30 character itself should NOT be typed as part of the command.
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
31
32
33 -----------------------------------------------------------------------------
34 2. Getting the source code
35 -----------------------------------------------------------------------------
36
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
37 $ cd $HOME
10013537 » davilla
2009-09-23 update svn path
38 $ svn checkout https://xbmc.svn.sourceforge.net/svnroot/xbmc/trunk
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
39
40 -----------------------------------------------------------------------------
c0691142 » modhack2
2009-01-26 [OSX]: updated for missing's libs and xcode's version
41 3.0 Install XCODE
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
42 -----------------------------------------------------------------------------
c0691142 » modhack2
2009-01-26 [OSX]: updated for missing's libs and xcode's version
43 Install latest Xcode. You can download it from Apple's site after registration at
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
44 (http://developer.apple.com/tools/download). You also need to install the 10.4
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
45 sdk. If using Xcode 3.x, you MUST use Xcode 3.1.2 so update your existing version
46 if you are running a previous Xcode 3.x version. Xcode 3.x only runs on 10.5.
0d50dcc0 » davilla
2008-07-23 XCode project cleansing. 1st step to 10.4 sdk migration
47
07ca4247 » davilla
2008-08-01 OSX final 10.4 sdk migration -- see readme.osx
48
49 -----------------------------------------------------------------------------
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
50 3.1 Install MacPorts 1.7
07ca4247 » davilla
2008-08-01 OSX final 10.4 sdk migration -- see readme.osx
51 -----------------------------------------------------------------------------
c0691142 » modhack2
2009-01-26 [OSX]: updated for missing's libs and xcode's version
52
6f73960b » davilla
2009-11-21 [osx] must build universal against 10.4uSDK
53 These build instructions depend on MacPorts 1.7.1 from xbmc-port-depends.
54 If you have another version of MacPorts installed, it's best to remove it and
55 install this 1.7.1 version. To remove a previous install of MacPorts, enter the
56 following from a terminal windows:
07ca4247 » davilla
2008-08-01 OSX final 10.4 sdk migration -- see readme.osx
57
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
58 $ sudo rm -rf \
59 /opt/local \
60 /etc/manpaths.d/macports \
61 /etc/paths.d/macports \
62 /Applications/DarwinPorts \
63 /Applications/MacPorts \
64 /Library/LaunchDaemons/org.macports.* \
65 /Library/Receipts/DarwinPorts*.pkg \
66 /Library/Receipts/MacPorts*.pkg \
67 /Library/StartupItems/DarwinPortsStartup \
68 /Library/Tcl/darwinports1.0 \
69 /Library/Tcl/macports1.0
0d50dcc0 » davilla
2008-07-23 XCode project cleansing. 1st step to 10.4 sdk migration
70
55fe9410 » davilla
2009-11-17 [osx] update readme.osx, remove samba3 and mysql5 portfile mods, thes…
71 Install MacPorts 1.7.1 (see http://code.google.com/p/xbmc-port-depends/). No NOT
31cc236f » davilla
2009-11-04 [osx] update OSX build info to build macports from xbmc-port-depends
72 install the versions from http://www.macports.org, they were hopelessly broke
6f73960b » davilla
2009-11-21 [osx] must build universal against 10.4uSDK
73 for XBMC usage when their devs released MacPorts 1.8. Change MacPorts's behavior
74 to always build universal against 10.4sdk using the following instructions.
07ca4247 » davilla
2008-08-01 OSX final 10.4 sdk migration -- see readme.osx
75
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
76 1)
77 $ sudo nano /opt/local/etc/macports/macports.conf
78 a) change "universal_target 10.5" to "universal_target 10.4"
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
79
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
80 b) change "universal_sysroot /Developer/SDKs/MacOSX10.5.sdk" to
81 "universal_sysroot /Developer/SDKs/MacOSX10.4u.sdk"
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
82
83 c) change "universal_archs ppc i386"
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
84 to reflect the arch you are building by removing the unused arch.
85
86 2) These are needed to build openssl (used by samba3 and mysql5) against 10.4sdk
87 $ sudo ln -s /Developer/SDKs/MacOSX10.4u.sdk/usr/lib/dylib1.o /Developer/SDKs/MacOSX10.4u.sdk/usr/lib/dylib1.10.5.o
88 $ sudo ln -s /Developer/SDKs/MacOSX10.4u.sdk/usr/lib/crt1.o /Developer/SDKs/MacOSX10.4u.sdk/usr/lib/crt1.10.5.o
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
89
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
90
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
91 Then install the following port packages (order is very important):
07ca4247 » davilla
2008-08-01 OSX final 10.4 sdk migration -- see readme.osx
92
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
93 $ sudo port install pcre +universal
94 $ sudo port install expat +universal
95 $ sudo port install libiconv +universal
605f9452 » beenje
2009-05-12 update:[OSX] MacPorts instructions updated to install libmad and gett…
96 $ sudo port install gettext +universal
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
97 $ sudo port install libtool yasm cmake gmake pkgconfig
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
98
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
99 $ sudo port install lzo +universal
d530482e » davilla
2009-09-01 sync xcode project, two new depends, see README.osx
100 $ sudo port install lzo2 +universal
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
101 $ sudo port install bzip2 +universal
102 $ sudo port install fontconfig +universal
103 $ sudo port install boost +universal
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
104
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
105 $ sudo port install jpeg +universal
106 $ sudo port install tiff +universal
107 $ sudo port install libpng +universal
108 $ sudo port install libogg +universal
109 $ sudo port install libvorbis +universal
605f9452 » beenje
2009-05-12 update:[OSX] MacPorts instructions updated to install libmad and gett…
110 $ sudo port install libmad macosx_deployment_target=10.4
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
111 $ sudo port install fribidi +universal
d530482e » davilla
2009-09-01 sync xcode project, two new depends, see README.osx
112 $ sudo port install libmms +universal
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
113
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
114 $ sudo port install glew +universal
115 $ sudo port install libcdio +universal
116 $ sudo port install openssl +universal
ca2e00a6 » davilla
2009-03-25 update for build against 10.4sdk under 10.5
117 $ sudo port install samba3 macosx_deployment_target=10.4
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
118 $ sudo port install mysql5 +universal
184e010f » davilla
2009-05-05 fixed [osx] /usr/lib/libsqlite.dylib under ATV refuses to update our …
119 $ sudo port install sqlite3 +universal
e58f1879 » davilla
2009-05-12 fixed:[osx] add macports libsamplerate install
120 $ sudo port install libsamplerate +universal
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
121
ca2e00a6 » davilla
2009-03-25 update for build against 10.4sdk under 10.5
122 $ sudo port install libsdl +no_x11 +universal
90eb8b1b » davilla
2009-03-30 updated, readme.osx, smpeg depends on libSDL so need to be installed …
123 $ sudo port install smpeg +universal
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
124 $ sudo port install libsdl_mixer +universal
62a22060 » davilla
2009-07-05 [osx] restore macport install of libsdl_image, needed for xbmctex.
125 $ sudo port install libsdl_image +universal
07ca4247 » davilla
2008-08-01 OSX final 10.4 sdk migration -- see readme.osx
126
c29ea08c » d4rkm4ster
2009-05-15 updated: README.osx with two-liner to automate port installation
127 If you understand the following two lines, you can run it to automate
128 the installation of the ports in the above order:
129
130 sudo bash
131 cat README.osx | perl -ne 'print `port install $1` if /^ \$ sudo port install (.*)$/;'
132
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
133 Finally, fix the mysql package default install location with this symlink:
d4e3ef4c » davilla
2008-05-28 Udate Xcode build instructions
134
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
135 $ sudo ln -s /opt/local/include/mysql5/mysql/ /opt/local/include/mysql
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
136
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
137 -----------------------------------------------------------------------------
138 4. How to compile
139 -----------------------------------------------------------------------------
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
140 Both Xcode and Terminal compilation require that build environment be setup
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
141 first. This is a simple step and involves the following:
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
142
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
143 $ cd $HOME/XBMC
1ef68bed » AlTheKiller
2009-09-04 added: Bootstrap script to generate build system files. NOTE: This MU…
144 $ ./bootstrap
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
145 $ ./configure
66659c6e » davilla
2009-01-24 updated: [OSX] add make clean step to remove svn binaries
146 $ make clean
0b0460fc » davilla
2009-05-21 fixed:[osx] more make changes and it's "make xcode-depends" for build…
147 $ make xcode_depends
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
148
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
149 The configure operation will setup the build environment for codecs and
150 internal libraries that are used by XBMC. This step is required for both Xcode
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
151 and command-line building. The "make clean" ensures that there areno stale
152 binaries from svn that might cause problems The last step will pre-build
b938ef67 » davilla
2009-03-15 updated, clarify the initial setup via command-line
153 the majority of the codecs and libs:
66659c6e » davilla
2009-01-24 updated: [OSX] add make clean step to remove svn binaries
154
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
155
580f72ed » davilla
2009-01-24 updated: [OSX] add how to build release codecs/libraries
156 The configure operation will default to building "debug". To build "release"
157 codecs and libraries for Xcode, do the configure step with "--disable-debug"
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
158 but remember that Xcode will need to be also built "Release":
580f72ed » davilla
2009-01-24 updated: [OSX] add how to build release codecs/libraries
159
160 $ ./configure --disable-debug
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
161
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
162 -----------------------------------------------------------------------------
163 4.1 Using Xcode
164 -----------------------------------------------------------------------------
165 Start XCode and open the XBMC project (XBMC.xcodeproj) located in $HOME/XBMC.
166 For development, XBMC is run from the $HOME/XBMC directory and needs to have
167 the XBMC_HOME environment variable set to know where that directory is located.
168 To set XBMC_HOME environment variable:
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
169
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
170 Menu -> Project -> Edit Active Executable "XBMC", click "Arguments" tab and
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
171 add "XBMC_HOME" as an enviroment variable. Set the value to the path to the
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
172 XBMC root folder. For example, "/Users/bigdog/Documents/XBMC"
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
173
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
174 There are two build targets "XBMC" and "XBMC.app" with debug and release
175 settings. The "XBMC" target is used for rapid build and debug cycles while
176 the "XBMC.app" target is used to build a self contained OSX application.
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
177
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
178 Set the build target to "XBMC" or "XBMC.app", then build. The build process
179 will take a long time when builting the first time. You can see the progress
180 in "Build Results". There are a large number of static and dynamic libaries
181 that will need to be built. Once these are built, subsequent builds will be
182 faster.
183
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
184 After the build, you can ether run XBMC for Mac from Xcode or run it from
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
185 the command-line. If you run it from the command-line, make sure your set
186 the XBMC_HOME environment variable (export XBMC_HOME=$HOME/XBMC). Then, to
187 run the debug version:
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
188
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
189 $ ./build/Debug/XBMC
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
190
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
191 Or the release version:
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
192
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
193 $ ./build/Release/XBMC
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
194
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
195 You can also build via Xcode from the command-line using the following:
196
66659c6e » davilla
2009-01-24 updated: [OSX] add make clean step to remove svn binaries
197 $ xcodebuild -configuration Release -target "XBMC.app" -project XBMC.xcodeproj
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
198
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
199 You can specify "Release" instead of "Debug" as a configuration.
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
200
201 -----------------------------------------------------------------------------
3c7375c2 » davilla
2009-03-09 update README.osx
202 4.2 Using Terminal (command-line) (this is a work in progress and might fail)
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
203 -----------------------------------------------------------------------------
851bb76d » davilla
2009-05-11 update:[osx] remove "make externals and "make more_libs" from Xcode r…
204 There are two methods, a) make/Xcode and b) make (which might fail as it's under
205 construction).
206
8b3f15fd » davilla
2009-05-27 update:[osx] README.osx build instructions to include XBMCTex info.
207 If you want to build a cross-compiled version that can run under 10.5/10.4/AppleTV,
208 then you'll need to follow the additional steps listed in $HOME/XBMC/tools/XBMCTex/README.osx
209 before running xcodebuild from the command-line.
210
851bb76d » davilla
2009-05-11 update:[osx] remove "make externals and "make more_libs" from Xcode r…
211 a)
212 $ cd $HOME/XBMC
213 $ export XBMC_HOME=`pwd`
0b0460fc » davilla
2009-05-21 fixed:[osx] more make changes and it's "make xcode-depends" for build…
214 $ make xcode_depends
851bb76d » davilla
2009-05-11 update:[osx] remove "make externals and "make more_libs" from Xcode r…
215 $ xcodebuild -sdk macosx10.4 -project XBMC.xcodeproj -target XBMC.app -configuration Release build
216
217 b)
dd8f25bb » davilla
2009-01-23 updated: [OSX] Integrate configure/make with Xcode project. Xcode pro…
218 $ cd $HOME/XBMC
86fd2c13 » davilla
2009-03-24 update, OSX readme.osx for building MacPorts 1.7 against 10.4 SDK.
219 $ export XBMC_HOME=`pwd`
b30e9178 » davilla
2009-02-12 updated:[OSX] command-line build errors
220 $ make xbmc
221 $ ./xbmc.bin
5bda456b » leafmuncher
2008-02-08 Added this, hopefully a good start.
222
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
223 -----------------------------------------------------------------------------
224 5. Packaging
225 -----------------------------------------------------------------------------
226 This section describes how to package XBMC in a disk image for
227 distribution.
228
229 1. Create 2 directories "extras/user" and "extras/system" in the root of
230 the source tree.
231
232 1.1. "extras/user" - anything found in this directory will be
122a3c13 » davilla
2009-11-28 [osx] update README.osx to reflect packagemaker changes
233 copied to the users XBMC directory (~/Library/Application
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
234 Support/XBMC) on first run. Examples:
235
236 extras/user/scripts/XBMC Lyrics
237 extras/user/plugins/music/iTunes
238
239 1.2. "extras/system" - anything found in this directory will be
240 copied to the XBMC application bundle at build time
241 (XBMC.app/Contents/Resources/XBMC/). Examples:
242
243 extras/system/skin/MediaStream
244 extras/system/skin/My Skin
245
246
247 2. After performing step 1, build XBMC.app from XCode so that the
248 application bundle is correctly updated.
249
122a3c13 » davilla
2009-11-28 [osx] update README.osx to reflect packagemaker changes
250 3. make -C tools/PackageMaker/
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
251
122a3c13 » davilla
2009-11-28 [osx] update README.osx to reflect packagemaker changes
252 4. If completed successfully, a disk image named XBMC_for_Mac.dmg will be
253 present in the users XBMC build directory:
94a946da » d4rkm4ster
2009-03-31 added: Packaging section in README.osx
254
255 Remember to unmount/eject XBMC.dmg before attempting to recreate it,
256 otherwise dmgmaker.pl will fail.
Something went wrong with that request. Please try again.