=================================================
- Welcome to wxWindows/CE 2.3.4 (is becoming 2.5.0)
+ Welcome to wxWidgets/CE
=================================================
-You have downloaded version 2.3.4 of the WinCE 3.0 port of
-the wxWindows GUI library. This runs on WindowsCE 3.0.
+This is the readme file for the Windows CE port of the wxWidgets GUI library
+which runs on Pocket PC 2002/2003, Smartphone 2002/2003, Windows CE .NET 4.x,
+and Windows Mobile 5. This port requires the use of Microsoft Visual Studio
+2005 and 2008, in particular eVC (Visual C++ Embedded) is not supported any
+longer.
-More information about the wxWindows project as a whole
-can be found at:
+More information about the wxWidgets project as a whole can be found at:
- http://www.wxwindows.org
+ http://www.wxwidgets.org/
+Information about the Windows CE port in particular can be found in
+the wxWinCE topic in the wxWidgets reference manual.
-Supported platforms
-===================
-These are the supported platform at the moment
-- x86 emulator
-- PocketPC (StrongARM)
-
-You can test the library and applications using PocketPC emulator
-and/or Compaq iPAQ or other PDAs using PocketPC
-
-WindowsCE.NET is not supported.
-
-
-
-Compiler installation
-=====================
+wxWidgets/CE Configuration
+================================
-Get the Visual C++ embedded (FREE) from Microsoft website
- http://msdn.microsoft.com/vstudio/device/embedded/download.asp
-
-You must use Visual Tools 3.0 for CE 3.0
- (this is the same we are currently using for wxWinCE)
-
-Install selecting only the two target platforms used:
-- WCE x86em (PocketPC emulation)
-- WCE ARM (PocketPC StrongARM)
+You may wish to customize the file include/wx/msw/wince/setup.h before building
+wxWinCE to disable any features that your program doesn't need and minimize the
+size of the library.
+wxWidgets/CE Compilation
+================================
-General installation notes
-==========================
+Unless the archive you downloaded already included CE-specific project files,
+you first need to generate them yourself. For this please install bakefile
+(from http://www.bakefile.org/, see technote docs/tech/tn0016.txt for more
+details about it) and create the file build/bakefiles/Bakefiles.local.bkgen
+with the following contents for Visual Studio 2008 (replace 2008 with 2005
+everywhere for the previous version):
-Alter your WXWIN environment variable to point to the root directory of the
-wxWindows installation.
+<?xml version="1.0" ?>
-Add wxWindows include and library paths into Tools-Options-Directories
+<bakefile-gen xmlns="http://www.bakefile.org/schema/bakefile-gen">
+ <add-formats>msvs2008prj(arm)</add-formats>
+ <add-flags files="wx.bkl" formats="msvs2008prj(arm)">
+ -o ../msw/wx_vc9arm.sln -DMSVS_PLATFORMS=pocketpc2003 -DCOMPILER_PREFIX=vc9arm
+ </add-flags>
+ <add-flags files="../../samples/*/*" formats="msvs2008prj(arm)">
+ -o $(INPUT_FILE_DIR)/$(INPUT_FILE_BASENAME_NOEXT)_vc9arm.sln -DMSVS_PLATFORMS=pocketpc2003 -DCOMPILER_PREFIX=vc9arm
+ </add-flags>
+</bakefile-gen>
+Notice that this will create the output files in the directories using "vc9arm"
+prefix instead of the usual "vc" one which allows to build the normal wxMSW and
+wxCE in the same wxWidgets source tree. You're, of course, free, to use
+different names for the project files suffix and the output directories prefix
+if you wish.
+Then do
-wxWindows/CE Compilation
-================================
-
-The following sections explain how to compile wxWindows/CE with the
-Visual C++ embedded compiler.
+cd %WXWIN%\build\bakefiles
+bakefile_gen -f msvs2008prj
+to create all *vc9arm.vcproj files. After this, simply open the solution file
+in Visual Studio and build it.
Status
======
-Currently develompment
-
-
-
-Disclaimer
-==========
-
-All product names are used for identification purposes and are trademarks
-or registered trademarks owned by their respective companies.
-
-
+It's possible to create working Pocket PC or Smartphone
+applications with this port. For further information
+about how to use wxWidgets with Windows CE, and further
+work that needs to be done, see the wxWinCE topic in the
+reference manual, and also:
- Marco Cavallini
-www.koansoftware.com
+http://wiki.wxwidgets.org/Developers_Notebook/WxWinCE
-.eof.
+The "Life!" demo in demos/life has some adaptations for
+wxWinCE, and also demonstrates how to make an installer for
+a Pocket PC application.