trace/tracebuilder/com.nokia.tracebuilder.help/html/tasks/setprojectandcompile.htm
author Matti Laitinen <matti.t.laitinen@nokia.com>
Wed, 23 Jun 2010 14:35:40 +0300
changeset 10 ed1c9f64298a
permissions -rw-r--r--
TraceBuilder 2.4.0

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>Setting project include paths and compiling</title>
<link href="../../book.css" type="text/css" rel="stylesheet">
</head>
<body>

<h2>Setting project include paths and compiling</h2>
<p>To use Open System Trace (OST) traces, you must include the <i>
OpenSystemTrace.h</i> header file from the environment. 
Currently TraceBuilder automatically adds the necessary system 
include macro to the MMP file if it does not exist.</p>

<p> If you get an error about a missing header when compiling, 
set the project's include paths: </p>
<ol>
	<li>Search the <i>/epoc32/include/</i> folder for the <i>OpenSystemTrace.h</i> file. </li>
	<li>Then add a following line to your component's MMP file: <br>
		<code>SYSTEMINCLUDE</code> &lt;the path where <i>OpenSystemTrace.h</i> was found.
		<p><b>Note:</b> If <i>OpenSystemTrace.h</i> was not found from your development environment,
		you cannot use OST traces.</p></li>
	<li>Compile your component using OST traces.
		<p>The compilation is handled by <a href="../concepts/tracecompiler.htm">Trace Compiler</a>.</p></li>
</ol>

<p>Note that you might also get errors such as <code>Userinclude path "/traces/" not found</code> or <code>Can't find following headers in User or System Include Paths "OstTraceDefinitions.h"</code> when you are compiling for the first time. This is because those paths and files are generated by TraceCompiler, and in the first time they do not exist when the Symbian Build System generates makefile.</p>

<p>When TraceCompiler is run to a component containing OST traces, you should see this kind of message:</p>

<pre>
******************* TRACECOMPILER STARTS *******************<br>Building traces for component Hello3. Component UID: 0xE1B04078.<br>******************* TRACECOMPILER ENDS *********************
</pre>

<p>After compilation, you should find a generated dictionary file for your component in the <i>/epoc32/ost_dictionaries/</i> folder.</p>

<div id="footer">Copyright &copy; 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. 
License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>.</div>
</body>
</html>