X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/4e4cea52b3fde0133dd3ab7049ec83996025799c..013151c7443afaf751ba2aa76e867bcbfa492508:/docs/msw/wince/readme.txt diff --git a/docs/msw/wince/readme.txt b/docs/msw/wince/readme.txt index 81536c3645..aa837604cc 100644 --- a/docs/msw/wince/readme.txt +++ b/docs/msw/wince/readme.txt @@ -1,21 +1,19 @@ ================================================= - Welcome to wxWidgets/CE 2.5.4 + Welcome to wxWidgets/CE ================================================= -You have downloaded version 2.5.4 of the Windows CE port of -the wxWidgets GUI library. This runs on PocketPC 2002, -SmartPhone 2002, and Windows CE .NET 4.x. +You have downloaded the Windows CE port of the wxWidgets GUI library. +This runs on Pocket PC 2002/2003, Smartphone 2002/2003, +Windows CE .NET 4.x, and Windows Mobile 5. More information about the wxWidgets project as a whole can be found at: http://www.wxwidgets.org -Information about the Windows CE port in particular -can be found here: - -http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE +Information about the Windows CE port in particular can be found in +the wxWinCE topic in the wxWidgets reference manual. Supported platforms =================== @@ -23,28 +21,35 @@ Supported platforms These are the supported platforms at the moment: - x86 emulator build in eVC 3 and eVC 4.x -- PocketPC (StrongARM) +- Pocket PC (StrongARM) +- Smartphone (StrongARM) +- Windows Mobile 5 -You can test the library and applications using PocketPC emulator -and/or Compaq iPAQ or other PDAs using PocketPC +You can test the library and applications using the Pocket PC emulator +and/or Compaq iPAQ or other PDAs using Pocket PC. Compiler installation ===================== +1. Embedded Visual C++ +---------------------- + Get the Visual C++ embedded (FREE) from Microsoft website http://msdn.microsoft.com/vstudio/device/embedded/download.asp You must use Embedded Visual C++ 3.0 or Embedded Visual C++ 4.x. - -Install selecting only the two target platforms used: -- WCE x86em (PocketPC emulation) -- WCE ARM (PocketPC StrongARM) +You can download the Smartphone 2002/3 and Pocket PC 2002/3 +SDKs separately. -You can install other targets but you will need -to create new configurations for them in the -wxWidgets project files. +2. Visual Studio 2005 +--------------------- +VS 2005 Professional is required to write Windows Mobile 5 applications, although Pocket PC +2003 applications should also run on Mobile 5. VS 2005 must +be purchased, and you can then download the Mobile 5 2005 SDK +from Microsoft's site. + wxWidgets/CE Configuration ================================ @@ -58,19 +63,30 @@ wxWidgets/CE Compilation NOTE: to generate targets not in the standard project files, you should rebuild the project files using Bakefile. -See technote docs/tech/tn0016.txt for details. +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: + +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 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. +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 VC++ computes dependencies, and expect -to wait a long time for loading and saving the workspace. +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: @@ -80,26 +96,55 @@ To compile using the emulator on eVC++3: and compile. - Open samples/minimal/minimal.vcw, select the - WIN32 (WCE x86 Debug) configuration, select Pocket PC 2002 and - Pocket PC 2002 Emulation as before, and compile. + 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 Unicode configuration, and compile. + WIN32 (WCE Emulator) Debug configuration, and compile. -- Open samples/minimal/minimal.vcw with eCV 4.0, select the +- 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. + +To use Visual Studio 2005, you need to allow VS to convert the projects +first (but install all the SDKs you need to _before_ converting), and then +you need to adjust the library settings of each wxWidgets and sample project. + +Edit the configuration properties for each configuration and in the Librarian, +add a relative path ..\..\lib to each library path. For example: + +..\..\lib\$(PlatformName)\$(ConfigurationName)\wx_mono.lib + +Then, for a sample you want to compile, edit the configuration properties +and make sure ..\..\lib\$(PlatformName)\$(ConfigurationName) is in the Linker/General/Additional +Library Directories property. Also change the Linker/Input/Additional Dependencies +property to something like: + +coredll.lib wx_mono.lib wx_wxjpeg.lib wx_wxpng.lib wx_wxzlib.lib wx_wxexpat.lib commctrl.lib winsock.lib wininet.lib + +since the library names in the wxWidgets workspace were changed +by VS 2005. + 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 +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 ==========