docs/msw/wince/readme.txt

   1
   2   =================================================
   3   Welcome to wxWidgets/CE
   4   =================================================
   5
   6 This is the readme file for the Windows CE port of the wxWidgets GUI library
   7 which runs on Pocket PC 2002/2003, Smartphone 2002/2003, Windows CE .NET 4.x,
   8 and Windows Mobile 5. This port requires the use of Microsoft Visual Studio
   9 2005 and 2008, in particular eVC (Visual C++ Embedded) is not supported any
  10 longer.
  11
  12 More information about the wxWidgets project as a whole can be found at:
  13
  14   http://www.wxwidgets.org/
  15
  16 Information about the Windows CE port in particular can be found in
  17 the wxWinCE topic in the wxWidgets reference manual.
  18
  19
  20 wxWidgets/CE Configuration
  21 ================================
  22
  23 You may wish to customize the file include/wx/msw/wince/setup.h before building
  24 wxWinCE to disable any features that your program doesn't need and minimize the
  25 size of the library.
  26
  27
  28 wxWidgets/CE Compilation
  29 ================================
  30
  31 Unless the archive you downloaded already included CE-specific project files,
  32 you first need to generate them yourself. For this please install bakefile
  33 (from http://www.bakefile.org/, see technote docs/tech/tn0016.txt for more
  34 details about it) and create the file build/bakefiles/Bakefiles.local.bkgen
  35 with the following contents for Visual Studio 2008 (replace 2008 with 2005
  36 everywhere for the previous version):
  37
  38 <?xml version="1.0" ?>
  39
  40 <bakefile-gen xmlns="http://www.bakefile.org/schema/bakefile-gen">
  41     <add-formats>msvs2008prj(arm)</add-formats>
  42     <add-flags files="wx.bkl" formats="msvs2008prj(arm)">
  43         -o ../msw/wx_vc9arm.sln -DMSVS_PLATFORMS=pocketpc2003 -DCOMPILER_PREFIX=vc9arm
  44     </add-flags>
  45     <add-flags files="../../samples/*/*" formats="msvs2008prj(arm)">
  46         -o $(INPUT_FILE_DIR)/$(INPUT_FILE_BASENAME_NOEXT)_vc9arm.sln -DMSVS_PLATFORMS=pocketpc2003 -DCOMPILER_PREFIX=vc9arm
  47     </add-flags>
  48 </bakefile-gen>
  49
  50 Notice that this will create the output files in the directories using "vc9arm"
  51 prefix instead of the usual "vc" one which allows to build the normal wxMSW and
  52 wxCE in the same wxWidgets source tree. You're, of course, free, to use
  53 different names for the project files suffix and the output directories prefix
  54 if you wish.
  55
  56 Then do
  57
  58 cd %WXWIN%\build\bakefiles
  59 bakefile_gen -f msvs2008prj
  60
  61 to create all *vc9arm.vcproj files. After this, simply open the solution file
  62 in Visual Studio and build it.
  63
  64
  65 Status
  66 ======
  67
  68 It's possible to create working Pocket PC or Smartphone
  69 applications with this port. For further information
  70 about how to use wxWidgets with Windows CE, and further
  71 work that needs to be done, see the wxWinCE topic in the
  72 reference manual, and also:
  73
  74 http://wiki.wxwidgets.org/Developers_Notebook/WxWinCE
  75
  76 The "Life!" demo in demos/life has some adaptations for
  77 wxWinCE, and also demonstrates how to make an installer for
  78 a Pocket PC application.