]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/msw/wince/readme.txt
s/wxWindows/wxWidgets/g
[wxWidgets.git] / docs / msw / wince / readme.txt
index 030f8551a1c0dc978b6dd84dcbef88d601ea20e2..c47ef56aba5496593f90017c61c32cd8098afbcd 100644 (file)
@@ -1,30 +1,31 @@
 
   =================================================
-  Welcome to wxWindows/CE 2.3.4 (is becoming 2.5.0)
+  Welcome to wxWidgets/CE 2.6.2
   =================================================
 
-You have downloaded version 2.3.4 of the WinCE 3.0 port of
-the wxWindows GUI library. This runs on WindowsCE 3.0.
+You have downloaded version 2.6.2 of the Windows CE port of
+the wxWidgets GUI library. This runs on Pocket PC 2002/2003,
+Smartphone 2002/2003, and Windows CE .NET 4.x.
 
-More information about the wxWindows project as a whole
+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.
+These are the supported platforms at the moment:
 
+- x86 emulator build in eVC 3 and eVC 4.x
+- Pocket PC (StrongARM)
+- Smartphone (StrongARM)
 
+You can test the library and applications using the Pocket PC emulator 
+and/or Compaq iPAQ or other PDAs using Pocket PC.
 
 Compiler installation
 =====================
@@ -32,39 +33,86 @@ Compiler installation
 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) 
+You must use Embedded Visual C++ 3.0 or Embedded Visual C++ 4.x.
+
+You can download the Smartphone 2002/3 and Pocket PC 2002/3
+SDKs separately.
  
-Install selecting only the two target platforms used:
-- WCE x86em (PocketPC emulation)
-- WCE ARM (PocketPC StrongARM)
+wxWidgets/CE Configuration
+================================
 
+You may wish to customize the following file
+before compiling wxWinCE:
 
+include/wx/msw/wince/setup.h
 
-General installation notes
-==========================
+wxWidgets/CE Compilation
+================================
 
-Alter your WXWIN environment variable to point to the root directory of the
-wxWindows installation.
+NOTE: to generate targets not in the standard project files,
+you should rebuild the project files using Bakefile.
+Also, if you are building from a CVS version of wxWidgets,
+you need to create eVC++ project files or get them from
+somewhere, such as the daily makefile builds here:
 
-Add wxWindows include and library paths into Tools-Options-Directories
+http://biolpc22.york.ac.uk/pub/CVS_Makefiles/
 
+See technote docs/tech/tn0016.txt for details on using Bakefile,
+and you can get Bakefile from:
 
+http://bakefile.sf.net
 
-wxWindows/CE Compilation
-================================
+Open build/wince/wx.vcw, select an ARM or x86 target (or emulator
+target for eVC++ 4), and compile.
+
+Then open samples/minimal/minimal.vcw, select an ARM, x86 or emulator
+target, and compile. You can use the emulator or real hardware to run
+the sample.
+
+There may be long delays while eVC++ computes dependencies, and expect
+to wait a long time for loading and saving workspaces. Do not attempt to
+save the wxWidgets library project file: it will take forever and generate
+a huge file, so make alterations either using Bakefile or by editing the
+project file with a text editor, and reloading. Sample project files are OK
+to save.
 
-The following sections explain how to compile wxWindows/CE with the 
-Visual C++ embedded compiler.
+To compile using the emulator on eVC++3:
 
+- Open build/wince/wx.vcw, select the
+  WIN32 (WCE x86) Debug Unicode configuration, close the dialog,
+  then select Pocket PC 2002 and Pocket PC 2002 Emulation on the toolbar,
+  and compile.
 
+- Open samples/minimal/minimal.vcw, select the
+  WIN32 (WCE x86 Debug) configuration, and select Pocket PC 2002 and
+  Pocket PC 2002 Emulation as before.
+
+To compile using the emulator on eVC++4:
+
+- Open build/wince/wx.vcw, select the
+  WIN32 (WCE Emulator) Debug configuration, and compile.
+
+- Open samples/minimal/minimal.vcw with eVC++, select the
+  WIN32 (WCE emulator) Debug configuration, and compile.
+
+Note: builds for the different SDKs (Smartphone, PPC, .Net)
+use the same directory and library names, so for the moment
+these builds cannot co-exist simultaneously.
 
 Status
 ======
 
-Currently develompment
+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:
 
+http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE
 
+The "Life!" demo in demos/life has some adaptations for
+wxWinCE, and also demonstrates how to make an installer for
+a Pocket PC application.
 
 Disclaimer
 ==========
@@ -72,9 +120,3 @@ Disclaimer
 All product names are used for identification purposes and are trademarks 
 or registered trademarks owned by their respective companies.
 
-
-
-  Marco Cavallini
-www.koansoftware.com
-
-.eof.