Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 152 lines (117 sloc) 6.177 kb
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
1 TOC
2 1. Introduction
3 2. Getting the source code
4 3. Install required libs
5 3.1. Install Xcode
590224a @davilla [osx] changed, osx readme and xcode project to support new osx build sys...
davilla authored
6 3.2. Install XBMC build depends
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
7 4. How to compile and run
8 4.1 Using XCode
9 4.2 Using Command line
10 5. Packaging
11
12 -----------------------------------------------------------------------------
13 1. Introduction
14 -----------------------------------------------------------------------------
15
16 This is a platform port of XBMC for the Apple OSX operating system. Both 10.5
6c110ed @davilla [osx] update info about building under 10.7
davilla authored
17 and 10.6 Intel development platforms are supported. Xcode 4.x is not supported.
18 The current build system is Xcode 3.2.5 There are two ways to build XBMC for Mac,
19 from command-line or from Xcode.
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
20
21 Generally, Xcode is the easiest as it presents the build system in a GUI environment.
22 The command-line build is still under development.
23
24 XBMC for Mac is composed of a main binary with numerous dynamic libraries and
25 codecs that support a multitude of music and video formats.
26
27 NOTE TO NEW OS X USERS: All lines that are prefixed with the '$' character are
28 commands that need to be typed into a Terminal window. Note that the '$'
29 character itself should NOT be typed as part of the command.
30
31
32 -----------------------------------------------------------------------------
33 2. Getting the source code
34 -----------------------------------------------------------------------------
35
36 $ cd $HOME
98d0f9c changed: point to git in README.xxx files
spiff authored
37 $ git clone git://github.com/xbmc/xbmc.git xbmc
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
38
39 -----------------------------------------------------------------------------
40 3.0 Install XCODE
41 -----------------------------------------------------------------------------
42 Install latest Xcode. You can download it from Apple's site after registration at
43 (http://developer.apple.com/tools/download). You also need to install the 10.4
6c110ed @davilla [osx] update info about building under 10.7
davilla authored
44 sdk. If using Xcode 3.x, you MUST use Xcode 3.1.2 or a newer version, so update
45 your existing version. if you are running a previous Xcode 3.x version.
46 Xcode 3.x only runs on 10.5 and above. If you are running 10.7, DO NOT USE Xcode 4.x,
47 it will fail. Use Xcode 3.x under 10.7.
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
48
49 -----------------------------------------------------------------------------
590224a @davilla [osx] changed, osx readme and xcode project to support new osx build sys...
davilla authored
50 3.1 Install XBMC build depends
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
51 -----------------------------------------------------------------------------
52
590224a @davilla [osx] changed, osx readme and xcode project to support new osx build sys...
davilla authored
53 $ cd $HOME/XBMC
9f49fd3 @davilla [osx/ios] change build system to use tools/darwin depends
davilla authored
54 $ cd tools/darwin/depends
55 $ ./bootstrap
56 $ ./configure --with-darwin=osx
57 $ make
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
58
59 -----------------------------------------------------------------------------
60 4. How to compile
61 -----------------------------------------------------------------------------
62 Both Xcode and Terminal compilation require that build environment be setup
63 first. This is a simple step and involves the following:
64
65 $ cd $HOME/XBMC
9f49fd3 @davilla [osx/ios] change build system to use tools/darwin depends
davilla authored
66 $ make -C tools/darwin/depends/xbmc
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
67 $ make clean
68 $ make xcode_depends
69
70 The configure operation will setup the build environment for codecs and
71 internal libraries that are used by XBMC. This step is required for both Xcode
58c8ed6 [osx] update to include out-of-make depends, this is getting very icky
davilla authored
72 and command-line building. The "make clean" ensures that there are no stale
98d0f9c changed: point to git in README.xxx files
spiff authored
73 binaries from git that might cause problems. The last step will pre-build
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
74 the majority of the codecs and libs:
75
76 -----------------------------------------------------------------------------
0222318 @davilla [osx] update README
davilla authored
77 4.1 Using Xcode
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
78 -----------------------------------------------------------------------------
79 Start XCode and open the XBMC project (XBMC.xcodeproj) located in $HOME/XBMC.
80 For development, XBMC is run from the $HOME/XBMC directory and needs to have
81 the XBMC_HOME environment variable set to know where that directory is located.
82 To set XBMC_HOME environment variable:
83
84 Menu -> Project -> Edit Active Executable "XBMC", click "Arguments" tab and
85 add "XBMC_HOME" as an enviroment variable. Set the value to the path to the
86 XBMC root folder. For example, "/Users/bigdog/Documents/XBMC"
87
88 There are two build targets "XBMC" and "XBMC.app" with debug and release
89 settings. The "XBMC" target is used for rapid build and debug cycles while
90 the "XBMC.app" target is used to build a self contained OSX application.
91
92 Set the build target to "XBMC" or "XBMC.app", then build. The build process
93 will take a long time when builting the first time. You can see the progress
94 in "Build Results". There are a large number of static and dynamic libaries
95 that will need to be built. Once these are built, subsequent builds will be
96 faster.
97
98 After the build, you can ether run XBMC for Mac from Xcode or run it from
99 the command-line. If you run it from the command-line, make sure your set
100 the XBMC_HOME environment variable (export XBMC_HOME=$HOME/XBMC). Then, to
101 run the debug version:
102
103 $ ./build/Debug/XBMC
104
105 Or the release version:
106
107 $ ./build/Release/XBMC
108
109 You can also build via Xcode from the command-line using the following:
110
111 $ xcodebuild -configuration Release -target "XBMC.app" -project XBMC.xcodeproj
112
113 You can specify "Release" instead of "Debug" as a configuration.
114
115 -----------------------------------------------------------------------------
116 4.2 Using Terminal (command-line) (this is a work in progress and might fail)
117 -----------------------------------------------------------------------------
118 There are two methods, a) make/Xcode and b) make (which might fail as it's under
119 construction).
120
121 If you want to build a cross-compiled version that can run under 10.5/10.4/AppleTV,
122 then you'll need to follow the additional steps listed in $HOME/XBMC/tools/XBMCTex/README.osx
123 before running xcodebuild from the command-line.
124
125 a)
126 $ cd $HOME/XBMC
127 $ export XBMC_HOME=`pwd`
128 $ make xcode_depends
129 $ xcodebuild -sdk macosx10.4 -project XBMC.xcodeproj -target XBMC.app -configuration Release build
130
131 b)
132 $ cd $HOME/XBMC
133 $ export XBMC_HOME=`pwd`
134 $ make xbmc
135 $ ./xbmc.bin
136
137 -----------------------------------------------------------------------------
138 5. Packaging
139 -----------------------------------------------------------------------------
140 This section describes how to package XBMC in a disk image for
141 distribution.
142
58c8ed6 [osx] update to include out-of-make depends, this is getting very icky
davilla authored
143 1. build XBMC.app from XCode so that the application bundle is correctly updated.
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
144
9f49fd3 @davilla [osx/ios] change build system to use tools/darwin depends
davilla authored
145 2. make -C tools/darwin/packaging/xbmc-osx
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
146
58c8ed6 [osx] update to include out-of-make depends, this is getting very icky
davilla authored
147 3. If completed successfully, a disk image named XBMC_for_Mac.dmg will be
122a3c1 [osx] update README.osx to reflect packagemaker changes
davilla authored
148 present in the users XBMC build directory:
45285e8 step 3/4: Move linuxport to trunk. How'd I get roped into this?
AlTheKiller authored
149
150 Remember to unmount/eject XBMC.dmg before attempting to recreate it,
151 otherwise dmgmaker.pl will fail.
Something went wrong with that request. Please try again.