<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" MadCap:lastBlockDepth="2" MadCap:lastHeight="120" MadCap:lastWidth="624" MadCap:disableMasterStylesheet="true" MadCap:tocPath="Community|Working With Source Code" MadCap:InPreviewMode="false" MadCap:RuntimeFileType="Topic" MadCap:TargetType="WebHelp" MadCap:PathToHelpSystem="../../../" MadCap:HelpSystemFileName="index.xml" MadCap:SearchType="Stem">
<head><title>Building db4o</title>
<script type="text/javascript">/* <![CDATA[ */
window.onload = function(){
var pathToFlash = $('html').attr('MadCap:PathToHelpSystem') + 'Content/Resources/Code/ZeroClipboard.swf';
ZeroClipboard.setMoviePath(pathToFlash);
function bindToClipBord(element,content){
var clip = new ZeroClipboard.Client();
clip.setText(content);
clip.glue(element);
};
if(location.protocol==='file:'){
$('.copylink-marker').remove();
} else{
$('.copylink-marker').each(function(){
var text = $(this).parent().parent().children('.prettyprint').html();
$(this).hover(function(){
bindToClipBord(this,text);
},
function(){});
});
}
prettyPrint();
};
/* ]]> */</script>
<link href="../../SkinSupport/MadCap.css" rel="stylesheet" />
<link href="../../Resources/Stylesheets/OnlineStyle.css" rel="stylesheet" />
<script src="../../Resources/Code/prettify.js">
</script>
<script src="../../Resources/Code/lang-vb.js">
</script>
<script src="../../Resources/Code/jquery.min.js">
</script>
<script src="../../Resources/Code/ZeroClipboard.js">
</script>
<script src="../../SkinSupport/MadCapAll.js" type="text/javascript">
</script>
</head>
<body>
<p class="MCWebHelpFramesetLink" style="display: none;"><a href="../../../index_CSH.html#community/working_with_source/building_full_distribution.htm" style="">Open topic with navigation</a>
</p>
<div class="MCBreadcrumbsBox"><span class="MCBreadcrumbsPrefix">You are here: </span><a class="MCBreadcrumbsLink" href="../../community.htm">Community</a><span class="MCBreadcrumbsDivider"> > </span><a class="MCBreadcrumbsLink" href="../working_with_source_code.htm">Working With Source Code</a><span class="MCBreadcrumbsDivider"> > </span><span class="MCBreadcrumbs">Building Full Distribution</span>
</div>
<p>
<script type="text/javascript">/*<![CDATA[*/document.write('<a href="' + location.href +'">');
document.write("Direct Link");
document.write('</a>');/*]]>*/</script>
</p>
<p>
</p>
<h1>Building db4o</h1>
<p>Building full distribution will allow you to get the same db4o packages as you can get from db4o download center. However, the flexibility of the build project also allows you to get only parts of it, like only java distro, only documentation, only tests etc.</p>
<p>The following documentation explains how to build a full distribution using Eclipse version 3.4 Ganymede. It is assumed that you have <a href="http://ant.apache.org/">ant</a> and one of Eclipse SVN clients (<a href="http://subclipse.tigris.org/">Subclipse</a> or <a href="http://www.eclipse.org/subversive/">Subversive</a>) installed. </p><a name="Projects Required "></a>
<h2>Projects Required </h2>
<p>In order to build db4o you will need to check out the following
projects.
</p>
<ul>
<li value="1">bloat: The byte code manipulation library db4o uses.</li>
<li value="2">db4o.cs: The client server implementation for db4o.</li>
<li value="3">db4o.cs.optional: Optional client server features for db4o.</li>
<li value="4">db4o.instrumentation: The instrumentation basic functionality for db4o.</li>
<li value="5">db4o.net: The .NET version of db4o.</li>
<li value="6">db4obuild: The build scripts for db4o.</li>
<li value="7">db4onqopt: The db4o native query optimizer.</li>
<li value="8">db4otaj: The db4o transparent activation/persistence enhancer.</li>
<li value="9">db4otools: The db4o tools like Ant scripts.</li>
<li value="10">db4ounit: The db4o test project.</li>
<li value="11">db4ounit.extensions: Additional unit test functionality.</li>
<li value="12">decaf: The Java 1.5 to Java 1.4 converter. You need to checkout all sub-projects on the same level as other db4o projects.</li>
<li value="13">drs: The db4o replication system.</li>
<li value="14">sharpen: The Java to C# converter. You need to checkout all sub-projects on the same level as other db4o projects.</li>
<li value="15">doctor: A tool for building the tutorial.</li>
<li value="16">tutorial: The db4o tutorial</li>
</ul><a name="machine.properties"></a>
<h3>machine.properties</h3>
<p>You will need to
create machine.properties file in db4obuild folder. The contents of the
file
can be copied from build.xml (see the comments at the beginning of the
file). Modify the paths where applicable to set the build variables for
your environment. </p>
<p>Read the instructions at top of the build.xml to find out what options are available. Here's an example:</p>
<pre class="monospace" xml:space="preserve">file.compiler.jdk1.3=%JAVA_HOME%/bin/javac.exe
file.compiler.jdk1.3.args.optional=-source 1.3
file.jvm.jdk1.5=%JAVA_HOME%/bin/java.exe
dir.workspace=C:/Users/Gamlor/Develop/db4o/db4o-src/
eclipse.home=C:/progs/eclipse
msbuild.executable="C:/Windows/Microsoft.NET/Framework/v4.0.30319/MSBuild.exe" </pre>
<h2>Build Preparation</h2>
<p>First you will need to run some preparation scripts. This is done only once per workspace and should not be repeated in the future.</p>
<p>Run build-db4obuild.xml, this will compile some of the tools used in the build process.</p>
<p>You will need to generate a key to sign the tutorial applet. Use the following commands:</p>
<p>keytool -genkey -alias db4objects -keyalg rsa</p>
<p>keytool -export -alias db4objects -file [path]/db4obuild/config/db4objects.crt </p>
<p>Use "kistoa" (without quotes) as your keypass and storepass. </p>
<p>Replace [path] with the path to db4obuild project on your system and make sure that db4objects.crt file is created in db4obuild/config folder.</p>
<p>If you've already generated db4objects key pair before, you will need to delete it before re-generating:</p>
<p>keytool -delete -alias db4objects </p>
<p>You will need to add ant-contrib.jar to your eclipse ant. You can download ant-contib.jar at:</p>
<p><a href="http://sourceforge.net/projects/ant-contrib/">http://sourceforge.net/projects/ant-contrib</a>
</p>
<ul>
<li value="1">Add ant-contib jar to ant folder in eclipse/plugins.</li>
<li value="2">After this is done go to Window->Preferences menu in Eclipse.</li>
<li value="3">Select Ant->Runtime in the list. </li>
<li value="4">Then select "Ant Home Entries".</li>
<li value="5">Press "Add External Jar"
and select ant-contib.jar location in the plugins folder.</li>
</ul><a name="Running The Build"></a>
<h2>Running The Build</h2>
<p>Now everything is ready to run db4o build. Right-click build.xml file and
select "Run As/Ant Build". You will need to run "buildall" target to generate java and .NET distribution. </p>
<script type="text/javascript" src="../../SkinSupport/MadCapBodyEnd.js">
</script>
</body>
</html>
