<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<title>FreeGuide : Build The Latest Source </title>
<meta http-equiv='Content-Style-Type' content='text/css' />
<link rel='stylesheet' href='../pub/skins/plain-freeguide/plain1.css' type='text/css' />
<link rel="icon" href="../pub/skins/plain-freeguide/favicon.gif" type="image/x-icon" />
<link rel="shortcut icon" href="../pub/skins/plain-freeguide/favicon.gif" type="image/x-icon" />
<!--HeaderText--><style type='text/css'><!--
ul, ol, pre, dl, p { margin-top:0px; margin-bottom:0px; }
code.escaped { white-space: nowrap; }
.vspace { margin-top:1.33em; }
.indent { margin-left:40px; }
.outdent { margin-left:40px; text-indent:-40px; }
a.createlinktext { text-decoration:none; border-bottom:1px dotted gray; }
a.createlink { text-decoration:none; position:relative; top:-0.5em;
font-weight:bold; font-size:smaller; border-bottom:none; }
img { border:0px; }
.editconflict { color:green;
font-style:italic; margin-top:1.33em; margin-bottom:1.33em; }
table.markup { border:2px dotted #ccf; width:90%; }
td.markup1, td.markup2 { padding-left:10px; padding-right:10px; }
table.vert td.markup1 { border-bottom:1px solid #ccf; }
table.horiz td.markup1 { width:23em; border-right:1px solid #ccf; }
table.markup caption { text-align:left; }
div.faq p, div.faq pre { margin-left:2em; }
div.faq p.question { margin:1em 0 0.75em 0; font-weight:bold; }
.frame
{ border:1px solid #cccccc; padding:4px; background-color:#f9f9f9; }
.lfloat { float:left; margin-right:0.5em; }
.rfloat { float:right; margin-left:0.5em; }
a.varlink { text-decoration:none; }
--></style> <meta name='robots' content='index,follow' />
<link rel='stylesheet' href='../pub/skins/plain-freeguide/plain2.css' type='text/css' />
</head>
<body>
<!--PageHeaderFmt-->
<table id='wikihead' cellspacing='0' cellpadding='0' align='center'><tr>
<td id='homelink'><img src='../pub/skins/plain-freeguide/favicon.gif' /> <a href='http://www.artificialworlds.net/freeguide'>FreeGuide</a></td>
<td id='location'><span class='pagegroup'><a href='Developers.html'>Developers</a> »</span>
<h1 class='pagetitle'>Build The Latest Source</h1></td>
<td id='wikicmds'><ul><li class='browse'><a accesskey='' class='selflink' href='BuildTheLatestSource.html'>View</a>
</li><li class='edit'>
</li><li class='diff'>
</li><li class='print'>
</li></ul>
</td>
</tr></table>
<!--/PageHeaderFmt-->
<table id='wikimid' cellspacing='0' cellpadding='0' align='center'><tr>
<!--PageLeftFmt-->
<td id='wikileft' valign='top'>
<p><form action='http://www.artificialworlds.net/freeguide'>
<input type='hidden' name='n' value='Developers.BuildTheLatestSource' />
<input type='hidden' name='action' value='search' />
<input type='text' name='q' value=' Search ' class='inputbox searchbox'
onfocus="if(this.value=' Search ') {this.value=''}"
onblur="if(this.value=='') {this.value=' Search '}"
/><input type='submit' class='inputbutton searchbutton'
value='Go' /></form></p><br />
<ul><li><a class='wikilink' href='../Main/HomePage.html'>Home Page</a>
</li><li><a class='wikilink' href='../DownloadAndInstall/DownloadAndInstall.html'>Download And Install</a>
</li><li><a class='wikilink' href='../UserGuide/UserGuide.html'>User Guide</a>
</li><li><a class='wikilink' href='../FAQ/FAQ.html'>Help And FAQ</a>
</li><li><a class='wikilink' href='Developers.html'>Developers</a>
<ul><li><span style='font-size:83%'><a class='wikilink' href='HelpUsMakeFreeGuide.html'>How to help</a></span>
</li><li><span style='font-size:83%'><a class='wikilink' href='RunTheNightlyBuild.html'>Nightly Builds</a></span>
</li><li><span style='font-size:83%'><a class='selflink' href='BuildTheLatestSource.html'>Build The Latest Source</a></span>
</li><li><span style='font-size:83%'><a class='wikilink' href='CodeRules.html'>Code Rules</a></span>
</li><li><span style='font-size:83%'><a class='wikilink' href='CreateInstallationPackagesForDifferentPlatforms.html'>Building Installers</a></span>
</li><li><span style='font-size:83%'><a class='wikilink' href='TranslateFreeGuide.html'>Translate FreeGuide</a></span>
</li><li><span style='font-size:83%'><a class='wikilink' href='Design.html'>Design</a></span>
</li><li><span style='font-size:83%'><a class='wikilink' href='Roles.html'>Roles</a></span>
</li><li><span style='font-size:83%'><a class='wikilink' href='SourceLayout.html'>Source Layout</a></span>
</li><li><span style='font-size:83%'><a class='wikilink' href='ChangingTheVersion.html'>Changing The Version</a></span>
</li><li><span style='font-size:83%'><a class='urllink' href='http://bugs.launchpad.net/freeguide-tv/+bugs' rel='nofollow'>Bug tracker -></a></span>
</li><li><span style='font-size:83%'><a class='urllink' href='http://freeguide-tv.git.sourceforge.net/git/gitweb.cgi?p=freeguide-tv/freeguide-tv;a=tree' rel='nofollow'>Browse source -></a></span>
</li><li><span style='font-size:83%'><a class='urllink' href='http://sourceforge.net/projects/freeguide-tv' rel='nofollow'>Sourceforge -></a></span>
</li></ul></li><li><a class='wikilink' href='../Main/Credits.html'>Credits</a>
</li><li><a class='wikilink' href='../Main/Screenshots.html'>Screenshots</a>
</li><li><a class='wikilink' href='../Main/Links.html'>Links</a>
</li><li><a class='wikilink' href='../Main/SiteMap.html'>Site Map</a>
<div class='vspace'></div></li><li><a class='wikilink' href='../Main/ContactUs.html'>Contact Us</a>
</li></ul><div class='vspace'></div>
</td>
<!--/PageLeftFmt-->
<td id='wikibody' valign='top'>
<!--PageText-->
<div id='wikitext'>
<h1>Build the latest source</h1>
<p>Some instructions on how to build the very latest version of <span class='wikiword'>FreeGuide</span>. If you have developer access to Git you will want to read the <a class='wikilink' href='CodeRules.html'>Code Rules</a>. There is also more useful info on the <a class='wikilink' href='HelpUsMakeFreeGuide.html'>Help us make FreeGuide</a> page.
</p>
<div class='vspace'></div><h2>Windows</h2>
<h3>Getting git</h3>
<p>(Needed for downloading latest source code files for developers.)
</p>
<p class='vspace'>You will need a <a class='urllink' href='http://git-scm.com/' rel='nofollow'>Git</a> client installed. You can use <a class='urllink' href='http://code.google.com/p/msysgit/' rel='nofollow'>msys Git</a> to install Git for windows, from the following link: <a class='urllink' href='https://git.wiki.kernel.org/index.php/MSysGit:InstallMSysGit' rel='nofollow'>install msysGit</a>.
</p>
<div class='vspace'></div><h3>Getting Ant</h3>
<p>(Needed to compile to the, unless you use Eclipse)
</p>
<p class='vspace'>You will need to download and install the <a class='urllink' href='http://ant.apache.org/' rel='nofollow'>Ant</a> tool. You can download ant from <a class='urllink' href='http://ant.apache.org/bindownload.cgi' rel='nofollow'>http://ant.apache.org/bindownload.cgi</a>.
</p>
<p class='vspace'>(From here on we will be assuming you extracted the downloaded archive to <code>C:\ant</code>)
</p>
<div class='vspace'></div><ul><li>Add the <code>C:\ant\bin</code> directory to your <code>PATH</code> environment variable.
</li><li>Set the <code>ANT_HOME</code> environment variable to <code>C:\ant\bin</code>.
</li><li>You will set up the <code>JAVA_HOME</code> in the next step (Getting the JDK)
</li></ul><p class='vspace'>Check the Apache documentation on <a class='urllink' href='http://ant.apache.org/manual/install.html#installing' rel='nofollow'>Installing Ant</a> for further details on how to set up the environment variables and path.
</p>
<p class='vspace'>You will also need Ant's "optional tasks", which may be distributed under a separate package, possibly called "ant-optional".
</p>
<div class='vspace'></div><h3>Getting the JDK (Java)</h3>
<p>In order to compile <span class='wikiword'>FreeGuide</span> you will need the Java Developer Kit (JDK), not just the Java Runtime Environment (JRE) version of Java. To get the JDK, got to <a class='urllink' href='http://java.sun.com/j2se' rel='nofollow'>http://java.sun.com/j2se</a> and follow the link on the right to download <span class='wikiword'>J2SE</span>, and then choose to install the JDK. Its easiest to choose the Windows Online Installation, Multi-language version.
</p>
<p class='vspace'>Now you will need to set two environment variables: <code>PATH</code>, which should give the location of the "bin" directory inside the directory where you installed the JDK, and <code>JAVA_HOME</code>, which should give the location of the main JDK directory (the one that contains "bin" and other directories). Right-click on My Computer and choose Properties, you will find PATH under Advanced/Environment Variables/System Variables. Find PATH and select edit. The PATHS to the various applications are to be found between semicolons. For example, if your PATH looks like this:
</p>
<div class='vspace'></div><pre> <code>%<span class='wikiword'>SystemRoot</span>%\system32;C:\Ant\bin</code>
</pre><p class='vspace'>You need to edit it to this, assuming that your JDK is in directory <code>C:\Program Files\Java\jdk1.5.0_06</code>:
</p>
<div class='vspace'></div><pre> <code>%<span class='wikiword'>SystemRoot</span>%\system32;C:\Ant\bin;C:\Program Files\Java\jdk1.5.0_06\bin</code>
</pre><p class='vspace'>Don't forget to add "\bin" on the end.
</p>
<p class='vspace'>You will also need to add a new environment variable, called <code>JAVA_HOME</code>. The value of that should just be the directory in which the JDK is installed, e.g. <code>C:\Program Files\Java\jdk1.5.0_06\bin</code>.
</p>
<p class='vspace'>Now, close any DOS/Cmd windows you have opened, and start a new one (to make sure the changes you have made are registered) and type:
</p>
<div class='vspace'></div><pre> <code>javac</code>
</pre><p class='vspace'>The output should be a long usage message complaining that you haven't provided any source files. If so, you are ready to go - continue to the next section.
</p>
<p class='vspace'>If, instead you get something like this:
</p>
<div class='vspace'></div><pre> <code>'javac' is not recognised as an internal or external command, blah blah blah</code>
</pre><p class='vspace'>or something similar, then you either don't have the JDK installed, or it is not in your PATH. Ask on the <span class='wikiword'>FreeGuide</span> developers' mailing list if you need help getting this set up.
</p>
<p class='vspace'>Now type:
</p>
<div class='vspace'></div><pre> <code class='escaped'>echo %JAVA_HOME%</code>
</pre><p class='vspace'>If you get no response, you haven't set up your JAVA_HOME environment variable properly (try logging out and logging in again if you think you have). Ask on our developers' mailing list if you need help here.
</p>
<div class='vspace'></div><h3>Getting the code from Git</h3>
<p>To download a full copy of the latest source files from <span class='wikiword'>FreeGuide</span> just open DOS command line (cmd), change directory to a suitable directory (e.g. My Documents) and type the following:
</p>
<div class='vspace'></div><pre> <code>git clone git://freeguide-tv.git.sourceforge.net/gitroot/freeguide-tv/freeguide-tv</code>
</pre><p class='vspace'>The simplest way to start is just to take the default settings and you will get the latest of everything. Just enter the directory where you want to save the files, preferably something short and simple without long file names, and download.
</p>
<p class='vspace'>To get new updates, do this:
</p>
<div class='vspace'></div><pre> <code>git pull</code>
</pre><p class='vspace'>Below, we assume you checked the source out into a directory called <code>C:\My Documents\freeguide-tv</code>.
</p>
<div class='vspace'></div><h3>Running the classes from the command line</h3>
<p>[Note: this is the hard way to do it, but simple. Normally you will want to use an IDE such as Eclipse.]
</p>
<p class='vspace'>To build the code, open a DOS or Cmd window and use the "cd" command to change into the directory where you checked out the code:
</p>
<div class='vspace'></div><pre> <code>cd "C:\My Documents\freeguide-tv"</code>
</pre><p class='vspace'>To compile, type this:
</p>
<div class='vspace'></div><pre> <code>ant</code>
</pre><p class='vspace'>Run <span class='wikiword'>FreeGuide</span> (after building as above) like this:
</p>
<div class='vspace'></div><pre> <code>ant run</code>
</pre><p class='vspace'>or, alternatively, you can do this:
</p>
<div class='vspace'></div><pre> <code>cd bin</code>
<code>java freeguide.startup.Startup</code>
</pre><div class='vspace'></div><h3>Running using Eclipse</h3>
<p>See <a href='BuildTheLatestSource.html#eclipse'>Using Eclipse</a> in the Linux section.
</p>
<div class='vspace'></div><h2>Linux</h2>
<h3>Getting the JDK (Java)</h3>
<p>In order to compile <span class='wikiword'>FreeGuide</span> you will need the Java Developer Kit (JDK), not just the Java Runtime Environment (JRE) version of Java. To get the JDK, got to <a class='urllink' href='http://java.sun.com/j2se' rel='nofollow'>http://java.sun.com/j2se</a> and follow the link on the right to download <span class='wikiword'>J2SE</span>, and then choose to install the JDK.
</p>
<p class='vspace'>When you have downloaded and installed the JDK, open a DOS/Cmd window or terminal, and type:
</p>
<div class='vspace'></div><pre> <code>javac -version</code>
</pre><p class='vspace'>The output should be a long usage message complaining that you haven't provided any source files. Check the very first line of this output (you may need to scroll up). It should be something like "javac 1.5.0_06" - make sure it matches the version you downloaded, not an earlier version. If so, you are ready to go - continue to the next section.
</p>
<p class='vspace'>If, instead you get something like this:
</p>
<div class='vspace'></div><pre> <code>bash: javac: command not found</code>
</pre><p class='vspace'>or something similar, then you either don't have the JDK installed, or it is not in your PATH. Ask on the <span class='wikiword'>FreeGuide</span> developers' mailing list if you need help getting this set up.
</p>
<div class='vspace'></div><h3>XMLTV</h3>
<p>I really do not recommend installing XMLTV from source - it is very difficult. It is better to use a package for your operating system. On Debian and Ubuntu, this should work:
</p>
<div class='vspace'></div><pre> <code>apt-get install xmltv</code>
</pre><p class='vspace'>If you do compile from source, ensure you install Tk, so that XMLTV's --gui configuration mode will work from within <span class='wikiword'>FreeGuide</span> (i.e. when you click "Choose channels for XMLTV" something will happen).
</p>
<div class='vspace'></div><h3>Getting the code from Git</h3>
<p>If git is not installed on your system you will have to install it. On Ubuntu or Debian this should be just:
</p>
<div class='vspace'></div><pre> <code>sudo apt-get install git-core</code>
</pre><p class='vspace'>To download a full copy of the latest source files from <span class='wikiword'>FreeGuide</span> just open a terminal, change directory to a suitable directory (e.g. Documents) and type the following:
</p>
<p class='vspace'>Change directory to the Documents directory
</p>
<div class='vspace'></div><pre> <code>cd Documents</code>
</pre><p class='vspace'>Download the project files using the git command
</p>
<div class='vspace'></div><pre> <code>git clone git://freeguide-tv.git.sourceforge.net/gitroot/freeguide-tv/freeguide-tv</code>
</pre><p class='vspace'>To get the latest updates, do this:
</p>
<div class='vspace'></div><pre> <code>git pull</code>
</pre><p class='vspace'>Now you have two options: you can build on the project from command line, or use Eclipse.
</p>
<div class='vspace'></div><h3>Building on the command line</h3>
<p>You will need to install Apache Ant. On Ubuntu or Debian this should be:
</p>
<div class='vspace'></div><pre> <code>sudo apt-get install ant ant-optional</code>
</pre><p class='vspace'>Change directory to <code>Documents/freeguide-tv</code>.
</p>
<p class='vspace'>Build the project by typing:
</p>
<div class='vspace'></div><pre> <code>ant</code>
</pre><p class='vspace'>and run it with:
</p>
<div class='vspace'></div><pre> <code>ant run</code>
</pre><p class='vspace'>or:
</p>
<div class='vspace'></div><pre> <code>cd bin</code>
<code>java freeguide.startup.Startup</code>
</pre><p class='vspace'>To test a different language translation:
</p>
<div class='vspace'></div><pre> <code>java -Duser.language=it freeguide.startup.Startup</code> (for italian)
<code>java -Duser.language=zh -Duser.country=TW freeguide.startup.Startup</code> (for Chinese)
</pre><div class='vspace'></div><h3>Using Eclipse</h3>
<ul><li>Install Eclipse and launch it
<div class='vspace'></div></li><li>Create a new project (named e.g. <span class='wikiword'>MyFreeGuideProject</span>)
</li></ul><p class='vspace'>(Note that project source files will be copied from now on to your eclipse <span class='wikiword'>MyFreeGuideProject</span> location any modifications you make will affect these files.)
</p>
<div class='vspace'></div><ul><li>On the left pane (Package) right-click on the <code>src</code> folder and choose Import.
<div class='vspace'></div></li><li>Select General>File System, click Next, browse to <code>Documents/freeguide-tv/</code>
<div class='vspace'></div></li><li>Highlight the <code>src</code> folder, and click ok, eclipse should import all the source files and present them in a tree
<div class='vspace'></div></li><li>Open the class freeguide.startup.Startup and run it by right-clicking and choosing "Run", then "Run". (To test different language translations, select Run Configurations from the same menu.)
<div class='vspace'></div></li><li>In the main tab make sure that the Main Class is: freeguide.startup.Startup
<div class='vspace'></div></li><li>In the Arguments tab, type the following in the VM Arguments field:
</li></ul><div class='vspace'></div><pre> <code>java -Duser.language=it freeguide.startup.Startup</code>
</pre><p class='vspace'>After you've done that, if someone else has made changes and you want to get the latest version, do this:
</p>
<div class='vspace'></div><pre> <code>cd freeguide-tv</code>
<code>git pull</code>
</pre><div class='vspace'></div><h3>Building the jars</h3>
<p>Ensure you have ant and ant-optional installed, and do this:
</p>
<div class='vspace'></div><pre> <code>cd freeguide-tv</code>
<code>ant jar</code>
</pre><p class='vspace'>Now to run the program do this:
</p>
<div class='vspace'></div><pre> <code>cd jar</code>
<code>java -jar <span class='wikiword'>FreeGuide</span>.jar</code>
</pre><p class='vspace'>Please <a class='wikilink' href='../Main/ContactUs.html'>Contact Us</a> if you have questions.
</p>
</div>
</td>
</tr></table>
<!--PageFooterFmt-->
<table id='wikifoot' cellspacing='0' cellpadding='0' align='center'>
<tr><td class='passwordlink' colspan='2'>If you would like to help improve this site, please <a class='wikilink' href='../Main/ContactUs.html'>Contact Us</a> and we will give you the password to edit pages.</td></tr>
<tr>
<td class='lastmod'>Page last modified on May 23, 2010, at 05:22 PM <a class='pmwikiinfolink' href="../Main/PmWikiInfo.html">PmWiki Info</a></td>
<td class='footnav'><div style='text-align: right;' >
<p> -
-
-
() -
</p></div>
</td>
</tr>
</table>
<!--/PageFooterFmt-->
</body>
</html>
distrib
>
Mageia
>
5
>
i586
>
media
>
core-release
>
by-pkgid
>
95b449427091cb0cd153a8618e92dbe9
>
files
>
3
