|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-B6B54E07-3B34-5D5C-8815-93383FA8FB4B" xml:lang="en"><title>How |
|
13 to use abld</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>The <filepath>abld.bat</filepath> batch file is used to control all aspects |
|
15 of building a project. It is created in the current directory by the <filepath>bldmake</filepath> tool |
|
16 from a component description file <filepath>bld.inf</filepath>. </p> |
|
17 <p>The syntax reference for this tool exhaustively lists all of the possible |
|
18 build operations which can be performed using <filepath>abld</filepath>. The |
|
19 tool's flexibility obscures the fact that most Symbian developers will only |
|
20 need to use two commands: one for cleaning up all files created in a previous |
|
21 build, and another for building the current project. </p> |
|
22 <section><title>Cleaning</title> <p>Cleaning removes all the intermediate |
|
23 files created during compilation, and all the executables and import libraries |
|
24 created by the linker. The simplest invocation of this operation deletes the |
|
25 files for all platforms, and projects belonging to the component. </p> <p><userinput>abld |
|
26 clean</userinput> </p> <p>It is also possible to specify the platform and |
|
27 build variant to be cleaned. </p> </section> |
|
28 <section><title>Building</title> <p> <filepath>abld</filepath> builds projects |
|
29 based on the makefiles created by <filepath>bldmake</filepath> from the component |
|
30 information file and project files. </p> <p>The simplest invocation of this |
|
31 command builds the project for all possible build variants: </p> <p><userinput>abld |
|
32 build</userinput> </p> <p>However building for a platform can take some time, |
|
33 and it is usual to only specify the platform required. For example, to build |
|
34 the debug version on the WINSCW platform specify: </p> <p><userinput>abld |
|
35 build winscw udeb</userinput> </p> <p>or to build the release version for |
|
36 ARMV5 use: </p> <p><userinput>abld build armv5 urel</userinput> </p><note>The <codeph>build</codeph> command |
|
37 combines the other <filepath>abld</filepath> commands: <codeph>export</codeph>, <codeph>makefile</codeph>, <codeph>library</codeph>, <codeph>resource</codeph>, <codeph>target</codeph> and <codeph>final</codeph>, which are carried out |
|
38 in turn. </note> <p><b>See also </b> </p> <p><xref href="GUID-5A3A3EA0-6C03-56F2-B277-B61A27ABFF9E.dita">Abld |
|
39 syntax</xref> </p><p><xref href="GUID-793A5EF9-CC16-5EEB-9011-6431EA76EB15.dita">Using |
|
40 bldmake</xref> </p> </section> |
|
41 </conbody></concept> |