Deblevy at 15:02, 26 March 2015

2015-03-26T15:02:24Z

Move page script: Move page script moved page TotalRecall/Build to Build

2012-10-13T21:31:40Z

Move page script moved page TotalRecall/Build to Build

New page

#REDIRECT [[Build]]

← Older revision		Revision as of 15:02, 26 March 2015
Line 1:		Line 1:
−	#~~REDIRECT~~ [[~~Build~~]]	+	'''''This document is for developers only. We provide [[TotalRecall#Download\|easy installers]] for end-users.'''''
		+
		+	'''Open-source software is a collaborative effort. Please inform us if anything on this page is incorrect or out of date.'''
		+
		+	The main development guide is located [[TotalRecall_Development\|here]].
		+
		+	== Building [[TotalRecall]] from source ==
		+
		+	Compiling TotalRecall for use on your own computer is designed to be very easy. The following instructions have been tested on recent versions of the operating systems described. To see which ''exact'' compilers and buildtool versions we used, see the build.xml file in the project.
		+
		+	Fair warning: these instructions are only for getting the program running on your computer, not for packaging things into nice standalone applications/installers. So they do involve moving our shared libraries into system paths (`/usr/lib`, `C:\Windows\System32`, and `C:\Windows\SysWow64`). Don't forget they're there if you edit the source code and want to try out your changes.
		+
		+	=== Ubuntu ===
		+	* Install JDK 6
		+
		+	<pre><nowiki>
		+	sudo apt-get install default-jdk
		+	</nowiki></pre>
		+
		+
		+	* Install Apache Ant
		+
		+	<pre><nowiki>
		+	sudo apt-get install ant
		+	</nowiki></pre>
		+
		+
		+	* Install Git (skip if you don't plan to build version straight out of repository)
		+
		+	<pre><nowiki>
		+	sudo apt-get install git-core
		+	</nowiki></pre>
		+
		+
		+	* Install development headers for foreign architecture
		+
		+	<pre><nowiki>
		+	sudo apt-get install libc6-dev-i386 #if on 64-bit machine
		+	sudo apt-get install libc6-dev-amd64 #if on 32-bit machine
		+	</nowiki></pre>
		+
		+
		+	* Download a nightly version of the project source from the [[TotalRecall\|program homepage]] or get it straight out of the repository
		+
		+	<pre><nowiki>
		+	git clone git://github.com/memlab/Penn-TotalRecall.git
		+	cd Penn-TotalRecall
		+	</nowiki></pre>
		+
		+
		+	* Compile/install the native libraries
		+
		+	<pre><nowiki>
		+	ant install_native
		+	</nowiki></pre>
		+
		+
		+	* Compile the Java portion into a jar
		+
		+	<pre><nowiki>
		+	ant package_jar
		+	</nowiki></pre>
		+
		+
		+	* Run the program
		+
		+	<pre><nowiki>
		+	java -jar dist/PennTotalRecall.jar
		+	</nowiki></pre>
		+
		+
		+	=== Mac OS X ===
		+	* Install XCode developer tools. These come on your OSX installation disc. You can also download them [http://developer.apple.com/technologies/xcode.html from Apple] after registering.
		+	* Install Git using [http://code.google.com/p/git-osx-installer/downloads/list?can=3 this installer] (skip if you don't plan to build version straight out of repository)
		+	* Download a nightly version of the project source from the [[TotalRecall\|program homepage]] or get it straight out of the repository
		+
		+	<pre><nowiki>
		+	git clone git://github.com/memlab/Penn-TotalRecall.git
		+	cd Penn-TotalRecall
		+	</nowiki></pre>
		+
		+
		+	* Compile/install the native libraries
		+
		+	<pre><nowiki>
		+	ant install_native
		+	</nowiki></pre>
		+
		+
		+	* Compile the Java portion into a jar
		+
		+	<pre><nowiki>
		+	ant package_jar
		+	</nowiki></pre>
		+
		+
		+	* Run the program
		+
		+	<pre><nowiki>
		+	java -jar dist/PennTotalRecall.jar
		+	</nowiki></pre>
		+
		+
		+	=== Windows ===
		+	* Install [http://java.sun.com/javase/downloads/index.jsp JDK 6]. Add the Java bin folder to your Path so it can be used from the command line. For example you might add `C:\Program Files\Java\jdk1.6.0_20\bin` to the Path value.
		+	* Install Git using the [http://code.google.com/p/msysgit/downloads/list msysgit] installer (skip if you don't plan to build version straight out of repository). During the installation be sure to select Run Git from the Windows Command Prompt.
		+	* Install [http://ant.apache.org/bindownload.cgi Apache Ant]. On Windows XP drag the unzipped folder to `C:\Program Files\`. On Windows Vista\7 64-bit drag to `C:\Program Files (x86)\`. Now add the Ant bin folder to your Path variable so it can be used from the command line. For example, you might add `C:\Program Files (x86)\apache-ant-1.8.0\bin`.
		+	* Try running the command `ant` from the command line. It should succeed if you set your Path correctly. If you get a warning about being unable to find tools.jar you will have to create a system variable called `JAVA_HOME` which points to your JDK root directory. For example the value might be `C:\Program Files\Java\jdk1.6.0_20`.
		+	* Install Microsoft Visual Studio 2008. Add the vcpackages folder to your Path so it can be used from the command line. For example, you might add `C:\Program Files\Microsoft Visual Studio 9.0\VC\vcpackages`.
		+	* Open the Windows command prompt ''as an administrator''. This is the default behavior on Windows XP administrator accounts, but not Vista/7.
		+	* Download a nightly version of the project source from the [[TotalRecall\|program homepage]] or get it straight out of the repository
		+
		+	<pre><nowiki>
		+	git clone git://github.com/memlab/Penn-TotalRecall.git
		+	cd Penn-TotalRecall
		+	</nowiki></pre>
		+
		+
		+	* Compile/install the native libraries
		+
		+	<pre><nowiki>
		+	ant install_native
		+	</nowiki></pre>
		+
		+
		+	* Compile the Java portion into a jar
		+
		+	<pre><nowiki>
		+	ant package_jar
		+	</nowiki></pre>
		+
		+
		+	* Run the program
		+
		+	<pre><nowiki>
		+	java -jar dist\PennTotalRecall.jar
		+	</nowiki></pre>
		+
		+
		+	== The full build chain ==
		+	Our build.xml does some fancy stuff like creating native executables and installers for the supported platforms. Read the documentation in build.xml to find out how. This native integration allows us (with the help of a few tricks) to avoid complex installers that tamper with users' shared libraries.
		+	[[Category:TotalRecall]]

TotalRecall/Build - Revision history

Deblevy at 15:02, 26 March 2015

Move page script: Move page script moved page TotalRecall/Build to Build