X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/93f467a3b4d1eda959b44cc01df34b4463383cfe..bf354396f61a2e1bd5544b67ecde341b6ff9bf35:/docs/msw/wince/readme.txt diff --git a/docs/msw/wince/readme.txt b/docs/msw/wince/readme.txt index 8666f0a9bd..c47ef56aba 100644 --- a/docs/msw/wince/readme.txt +++ b/docs/msw/wince/readme.txt @@ -1,34 +1,31 @@ ================================================= - Welcome to wxWindows/CE 2.5.1 + Welcome to wxWidgets/CE 2.6.2 ================================================= -You have downloaded version 2.5.1 of the Windows CE port of -the wxWindows GUI library. This runs on PocketPC 2002 -and SmartPhone 2002. +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 here: - -http://wiki.wxwindows.org/wiki.pl?Windows_CE_Port +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) +These are the supported platforms at the moment: -You can test the library and applications using PocketPC emulator -and/or Compaq iPAQ or other PDAs using PocketPC +- x86 emulator build in eVC 3 and eVC 4.x +- Pocket PC (StrongARM) +- Smartphone (StrongARM) -WindowsCE.NET is not supported. +You can test the library and applications using the Pocket PC emulator +and/or Compaq iPAQ or other PDAs using Pocket PC. Compiler installation ===================== @@ -36,40 +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: +wxWidgets/CE Configuration +================================ -- WCE x86em (PocketPC emulation) -- WCE ARM (PocketPC StrongARM) +You may wish to customize the following file +before compiling wxWinCE: -Download an archive containing the library project file -and a sample project file: +include/wx/msw/wince/setup.h -http://www.anthemion.co.uk/wxwin/wxWinCE.zip +wxWidgets/CE Compilation +================================ -Unarchive this over your 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: -wxWindows/CE Compilation -================================ +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 + +Open build/wince/wx.vcw, select an ARM or x86 target (or emulator +target for eVC++ 4), and compile. -Open src/msw/wince/wxWindowsCE.vcp, select an -ARM or x86 target, 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. -Then open samples/minimal/minimalCE.vcp, select an -ARM or x86 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. + +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 under development. For further information -about what has been done and what needs to be -done, see: +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 -http://wiki.wxwindows.org/wiki.pl?Windows_CE_Port +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 ==========