BUILDING QT APPLICATIONS
========================

Preferred build Environment is SBSv2 2.15.1
Deprecation Note: ABLD a.k.a SBSv1 is deprecated in Symbian^3 and will be removed from next release

Building with SBSv2
===================

	Through Qt Creator
	------------------
	
  Requirements:
    -	Latest Nokia Qt SDK is installed (Qt creator)
		-	Carbide 2.6 and higher is installed
		- Latest GCCE is installed onto target system (4.4.1)
		
	How to do IDE integration:
		-	Go to tools>Options from Qt creator IDE
		-	Go to Qt version tab in the options window and add new sdk (Click on the + button from the top right corner)
			Fill the required entries:
			
			e.g.
			
			Version name : Symbian3SDK (any convenient name can be given)
			qmake Location: c:\nokia\devices\nokia_symbian3_sdk_v1.0\epoc32\tools\qmake.exe
			S60 SDK: C:\Nokia\devices\Nokia_Symbian3_SDK_v1.0 (SDK root path)
			CSL/GCCE directory: C:\Program Files\CodeSourcery\Sourcery G++ Lite\bin
			Carbide directory: C:\Apps\carbide
			press Appy and Ok buttons.
		
	How to build and run with symbian3 emulator:
		- Create/import a project and choose the target as symbian emulator (e.g. Symbian Emulator->Symbian3SDK for the emulator targte of the Symbian^3 SDK)  		
		- Build and run the project. 		


	Through Carbide
	---------------
	
	- Carbide v2.6 or higher ( Upgrade Carbide higher version from ->help->check for updates )
	- If not Installed then install GCCE 4.4.1, follow the instructions from <sdk-root>\epoc32\tools\distrib\gcce_4_4_1_howto.txt
	- Import/Create applications for SBSV2 and build for the required target
	
	Through Command line
	--------------------
	
	- Set EPOCROOT to SDK Installation directory
	  For Ex: set EPOCROOT=\Nokia\devices\Nokia_Symbian3_SDK_v1.0\
	- Ensure qt path (<sdk-root>\epoc32\tools\qt) is added in PATH environment variable
	- Go to group directory of application
	- Use the commands  
		qmake -platform symbian-sbsv2
		sbs -c winscw_udeb for WINSCW
		sbs -c armv5_urel  for ARM target using RVCT compiler
		sbs -c armv5_urel_gcce4_4_1 for ARM target using GCCE 4 compiler

Building with SBSv1
===================

	Open command prompt and follow these steps for sdk set-up:

	Substitute the sdk environment to any drive letter which would be treated further as <sdk-root>
	For Ex :if the SDK is installed in C:\Nokia\devices\Nokia_Symbian3_SDK_v1.0
	subst R: C:\Nokia\devices\Nokia_Symbian3_SDK_v1.0

	Note: Substitution is required for both Carbide and Command line

	Through Carbide
	---------------
	
	- Upgrade Carbide from 2.3 to 2.6
	- Create a new entry in program files\common files\symbian\device.xml with new substitute drive/ Add New SDK from Carbide->windows->preference->carbide.c++->SDK Preferences for substituted drive
	- Restart the Carbide
	- Import/Create applications for SBSv1 and build for required target
	
	Through Command line
	--------------------
	
	- Set environment variable EPOCROOT
	       SET EPOCROOT=\  
	- Ensure qt path (%EPOCROOT%\epoc32\tools\qt) is in PATH environment variable
	
	Note: A bat file(Environment for Qt building.bat) included (<sdk-root>\examples\qt\) can also be used to configure environment, note that configuration is session long only.
	- Go to group directory of application
	- Use the commands  
	  qmake -platform symbian-abld 
		bldmake bldfiles
		abld build winscw udeb  For Emulator
    abld build gcce urel    For Device
