The sources File

As indicated previously in this chapter, the sources file is the project (text) file that determines what the target, how it is built and what resources it requires. It also specifies what is to be displayed in Solution Explorer. It is auto-generated when you run the Subproject Wizard. You can edit it in an unstructured manner as a text file by double-clicking on it Solution Explorer, or in a structured manner using the GUI by right-clicking on it in Solution explorer and choosing Properties. Revisiting the Hello console application sources file from Listing 15.2 we see that some of the project aspects are:

Table 14.1: The Hello application properties

• The RELEASETYPE can be:
  Specifies which output directory to place binaries and libraries in after they are built.
  • LOCAL (Subprojects/Components that aren’t distributed))
  • OAK (Core OS components that will be rebuilt)
  • PLATFORM (BSPs)
  • Others such as SDK, MANAGED
• The TARGETTYPE can be:
  • PROGRAM (Application)
  • DYNLINK (DLL)
  • LIBRARY (Static Lib)
  • The Entry Point can be :
    These alias to CRTstartup
• Applications: Windows CE supports the following CRT entry points:
  • mainACRTStartup for applications that define the main function
    A means ASCII. Use for ”simple” C style apps
  • mainWCRTStartup for applications that define the wmain function
    W means Wide (Unicode)
    Use this or the next for Unicode Console apps.
    Specified by Subproject Wizard generated Console apps.
  • WinMainCRTStartup for applications that define the WinMain function
    This is required for WinForm Unicode apps.
    Specified by Subproject Wizard generated WinForm apps.
  • wWinMainCRTStartup for applications that define the wWinMain function
    Wide version: This is not required because the previous version uses Unicode in WCE
• DLL:
  • Implicit: _DllMainCRTStartup
    Its the only option for a DLL so it is not explicitly specified
• Lib: None

An example of a DLL sources file is that from the TimeDLL project:

RELEASETYPE=LOCAL
_ISVINCPATH=$(_WINCEROOT)\public\common\sdk\inc;
_OEMINCPATH=$(_WINCEROOT)\public\common\oak\inc;$(_WINCEROOT)\public\common\sdk\inc;
TARGETNAME=TimeDLL
FILE_VIEW_ROOT_FOLDER= \
    ReadMe.txt \
    StdAfx.cpp \
    prelink.bat \
    postlink.bat \
FILE_VIEW_RESOURCE_FOLDER= \
FILE_VIEW_INCLUDES_FOLDER= \
    StdAfx.h \
    TimeDLL.h \
SOURCES= \
    TimeDLL.cpp \
PRECOMPILED_PCH=StdAfx.pch
PRECOMPILED_CXX=1
TARGETLIBS= \
    $(SG_OUTPUT_ROOT)\sdk\lib\$(_CPUINDPATH)\coredll.lib \
PRECOMPILED_OBJ=StdAfx.obj
CDEFINES=$(CDEFINES) -DTimeDLL_EXPORTS
TARGETTYPE=DYNLINK
PRECOMPILED_INCLUDE=StdAfx.h
POSTLINK_PASS_CMD=postlink.bat
PRELINK_PASS_CMD=prelink.bat
FILE_VIEW_PARAMETER_FOLDER= \
    TimeDLL.bib \
    TimeDLL.reg \
    TimeDLL.dat \
    TimeDLL.db \
    TimeDLL.def \
    ProjSysgen.bat \

Listing 14.23 The TimeDLL sources file.

Table 14.2: The TimeDLL Project Properties

NEXT: Native Code Application Development Summary

Click here to provide feedback and input