buildframework/helium/doc/src/manual/configuring.rst
changeset 588 c7c26511138f
parent 587 85df38eb4012
child 645 b8d81fa19e7d
equal deleted inserted replaced
587:85df38eb4012 588:c7c26511138f
    82         
    82         
    83         All build configurations must import helium.ant.xml to use Helium. -->
    83         All build configurations must import helium.ant.xml to use Helium. -->
    84         <import file="${helium.dir}/helium.ant.xml"/>
    84         <import file="${helium.dir}/helium.ant.xml"/>
    85     </project>
    85     </project>
    86 
    86 
    87 Note that here the default target is ``product-build`` so this would be used for a product build configuration. In reality it would need many more properties to be complete.
    87 Note that here the default target is :hlm-t:`product-build` so this would be used for a product build configuration. In reality it would need many more properties to be complete.
    88 
    88 
    89 Refer to the `configuration reference`_ for a full list of all Helium Ant properties.
    89 Refer to the `configuration reference`_ for a full list of all Helium Ant properties.
    90 
    90 
    91 .. _`configuration reference`: ../api/helium/index.html
    91 .. _`configuration reference`: ../api/helium/index.html
    92 
    92 
   296 To include an XML element with a ``hlm:`` prefix the Helium namespace must be defined in the root element of the XML file::
   296 To include an XML element with a ``hlm:`` prefix the Helium namespace must be defined in the root element of the XML file::
   297 
   297 
   298     <project name="myproject" xmlns:hlm="http://www.nokia.com/helium">
   298     <project name="myproject" xmlns:hlm="http://www.nokia.com/helium">
   299     ....
   299     ....
   300     </project>
   300     </project>
       
   301     
       
   302 If it is necessary to use the Helium tasks before importing ``helium.ant.xml``, first import ``helium_preinclude.ant.xml``, e.g::
       
   303 
       
   304     <project name="helium-test" default="test" xmlns:hlm="http://www.nokia.com/helium"> 
       
   305         <description>
       
   306         Helium pre include test.
       
   307         </description>
       
   308         <property environment="env"/>
       
   309         <import file="${helium.dir}\helium_preinclude.ant.xml"/>   
       
   310             
       
   311         <target name="test">
       
   312            <hlm:logtoconsole action="stop"/>
       
   313                 <echo>Should not print anything.</echo>
       
   314            <hlm:logtoconsole action="resume"/>
       
   315            <echo>Should print something.</echo>       
       
   316         </target>
       
   317         
       
   318         <import file="${helium.dir}\helium.ant.xml"/>           
       
   319     </project> 
       
   320 
   301 
   321 
   302 .. index::
   322 .. index::
   303   single: System definition configuration files
   323   single: System definition configuration files
   304 
   324 
   305 System Definition configuration files
   325 System Definition configuration files