forked from appcelerator-archive/titanium_desktop
-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME
173 lines (116 loc) · 5.41 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
+=======================================================================================+
+ Appcelerator Titanium (for Desktop) +
+=======================================================================================+
For details on Titanium, please see <http://www.appcelerator.com>. Titanium source code
is licensed under the terms of the Apache Public License, version 2. Please see the
LICENSE file for more information.
---------------------
Build Prerequisites
---------------------
To build Titanium from source, you will need the following prerequisites:
- Python (see platform specific notes below)
- Scons package - <http://www.scons.org/>
- Platform compiler (see below for each platform)
Python and SCons are used to build Titanium but not required for end-development
or runtime.
To build Titanium, you will need to first checkout the Titanium source code
from <http://github.com/appcelerator/titanium_desktop/tree/master>.
Currently, we are building Titanium for 32-bit architectures but intend to support 64-bit
very soon. If you have patches or would like to assist, please contact us (see below for
IRC or email information).
-------
Setup
-------
You will first need to update the kroll submodule that is checked in to Titanium before
you can successfully build. You can run the following command from the root source
directory to update the submodule:
> git submodule update --init
> cd kroll && git checkout master && cd ..
This will pull the contents of the submodule into your local kroll folder.
----------
Building
----------
Titanium uses SCons for building. You can build and install the SDK by running:
> scons debug=1 sdkinstaller run=1
Titanium uses the Drillbit application under apps/ to perform tests. You can build
and run Drillbit:
> scons debug=1 drillbit run=1
To build the distribution packages run:
> scons debug=1 dist
The output of the build will be in a folder named build\<osname> such as
build/osx for OSX.
---------------
Platform Info
---------------
Titanium requires platform-specific builds. Currently, Titanium builds on Win32, Linux
and Mac OSX 10.5.4+.
Win32
------
You will need Microsoft Visual Studio 2005 + Service Packs to build Titanium. We have
not tested building Titanium on Visual Studio 2008. You will need to obtain the
Microsoft Visual Studio Service Pack 1 to compile Titanium.
Needed service packs from Microsoft:
- VS 2005 Team Suite SP1 <http://www.microsoft.com/downloads/details.aspx?familyid=BB4A75AB-E2D4-4C96-B39D-37BAF6B5B1DC&displaylang=en>
- MS Visual Studio 2005 SP1
- Windows Server 2003 SDK R2 <http://www.microsoft.com/downloads/details.aspx?familyid=0baf2b35-c656-4969-ace8-e4c0c0716adb&displaylang=en>
OSX
----
You will need XCode 3.0+ to build Titanium and it must be built on Leopard. Titanium
is only supported on Leopard (or later).
If you have xcode installed, you should be able to build Titanium with no additional
dependencies.
Linux
------
Each distribution varies slightly for building Titanium on a Linux distribution.
Ubuntu 8.10 32bit
=================
1. Install the required libraries:
sudo apt-get install build-essential ruby rubygems libzip-ruby scons libxml2-dev libgtk2.0-dev python-dev ruby-dev libdbus-glib-1-dev libnotify-dev libgstreamer0.10-dev libxss-dev libcurl4-openssl-dev libnotify-dev libgstreamer0.10-dev libcurl4-openssl-dev python2.5-dev libxss-dev
2. Install Git:
sudo apt-get install git-core
You may need a later version of Scons for Linux if you get build errors. (>=1.2.0)
--------------------
Getting Assistance
--------------------
For more details on Titanium, please see the website at <http://www.appcelerator.com>
We invite you to visit us on IRC at #titanium_app on irc.freenode.net. For core
developer conversation, please visit #titanium_dev.
If you need more assistance, please go to the Appcelerator Developer Community
at <http://www.appcelerator.com/community>.
To report a bug or make a feature request, please visit our Issue Tracking portal
at <http://support.appcelerator.net>.
We'd also encourage you to follow us on Twitter at <http://twitter.com/appcelerator> or
@appcelerator.
-- The Appcelerator Team
---------
Credits
---------
Titanium was made possible by a number of awesome contributors:
- Marshall Culpepper, Project Leader
- Tyrus Smalley, Creative Genius
- Jorge Servin, Win32
- Jeff Haynie, OSX
- Martin Robinson, Linux
- Nolan Wright, Apps + Testing
- Don Thorp, Mobile Lead
- Blain Hamon, OSX
- Chris Warner, Win32
- Paolo F, Apps + Testing
- Mark Obcena, Documentation + Testing (and moral support)
- Will Robertson, Build + Testing on various Linux distros
- Kevin Whinnery, Testing, Documentation and Developer Evangelism
- Josh Roesslein, Python
- Mital Vora, Win32
- Ben Ramsey, PHP
(and lots others who we don't necessarily know your name but we know you have helped)
Special thanks to all those who continually stop by the IRC channel to
offer assistance, bug reports and moral support. We love you!
If you are interested in becoming a community developer and contributing to
Titanium, please contact us at <[email protected]>.
-------------
Legal Stuff
-------------
Copyright (C) 2008-2009 by Appcelerator, Inc. All Rights Reserved.
For more information, please visit <http://license.appcelerator.org>.
Appcelerator, Titanium and logos are trademarks of Appcelerator, Inc.
Please see the file named LICENSE for the full license.