X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/fc2171bd4c660b8554dae2a1cbf34ff09f3032a6..32753ae949d861ddaf7c66f4c483bc57493c6c6c:/docs/msw/wince/readme.txt?ds=sidebyside diff --git a/docs/msw/wince/readme.txt b/docs/msw/wince/readme.txt index da81b4291e..d48ba9a8ea 100644 --- a/docs/msw/wince/readme.txt +++ b/docs/msw/wince/readme.txt @@ -1,124 +1,78 @@ ================================================= - Welcome to wxWidgets/CE 2.5.1 + Welcome to wxWidgets/CE ================================================= -You have downloaded version 2.5.1 of the Windows CE port of -the wxWidgets GUI library. This runs on PocketPC 2002, -SmartPhone 2002, and Windows CE .NET 4.x. +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 wxWidgets project as a whole -can be found at: +More information about the wxWidgets project as a whole can be found at: - http://www.wxwidgets.org + http://www.wxwidgets.org/ -Information about the Windows CE port in particular -can be found here: +Information about the Windows CE port in particular can be found in +the wxWinCE topic in the wxWidgets reference manual. -http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE - -Supported platforms -=================== - -These are the supported platforms 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 - -Compiler installation -===================== - -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 install other targets but you will need -to create new configurations for them in the -wxWidgets project files. wxWidgets/CE Configuration ================================ -You may wish to customize the following file -before compiling wxWinCE: +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. -include/wx/msw/wince/setup.h - -These are some of the Windows CE-specific settings -you can adjust. - -wxUSE_POCKETPC_UI - - If you are compiling with Windows CE .NET, you may - wish to emulate PocketPC behaviour (set it to 1), or - take advantage of the greater flexibility of - Windows CE .NET (set it to 0). - If 0, the PocketPC-specific toolbar class will be - used, which uses commandbar to combine the toolbar - and menubar in one control. If 1, the normal menubar - and toolbar behaviour will be used, as per - desktop Windows. - -wxUSE_SMARTPHONE - - Set this to 1 if you wish to compile for the SmartPhone - platform (with eVC++ 3). wxWidgets/CE Compilation ================================ -Open src/msw/wince/wxWidgetsCE.vcp, select an -ARM or x86 target (or emulator target for eVC++ 4), -and compile. - -Then open samples/minimal/minimalCE.vcp, select an -ARM, x86 or emulator target, and compile. You can -use the emulator or real hardware to run the -sample. +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): -There may be long delays while VC++ computes dependencies, and expect -to wait a long time for loading and saving the workspace. + -To compile using the emulator on eVC++3: + + msvs2008prj(arm) + + -o ../msw/wx_vc9arm.sln -DMSVS_PLATFORMS=pocketpc2003 -DCOMPILER_PREFIX=vc9arm + + + -o $(INPUT_FILE_DIR)/$(INPUT_FILE_BASENAME_NOEXT)_vc9arm.sln -DMSVS_PLATFORMS=pocketpc2003 -DCOMPILER_PREFIX=vc9arm + + -- Open src/msw/wince/wxWidgetsCE.vcp, 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. +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. -- Open samples/minimal/minimalCE.vcp, select the - WIN32 (WCE x86 Debug) configuration, select Pocket PC 2002 and - Pocket PC 2002 Emulation as before, and compile. +Then do -To compile using the emulator on eVC++4: +cd %WXWIN%\build\bakefiles +bakefile_gen -f msvs2008prj -- Open src/msw/wince/wxWidgetsCE.vcp, select the - WIN32 (WCE Emulator) Debug Unicode configuration, and compile. +to create all *vc9arm.vcproj files. After this, simply open the solution file +in Visual Studio and build it. -- Open samples/minimal/minimalCE.vcp with eCV 4.0, select the - WIN32 (WCE emulator) Debug configuration, and compile. Status ====== -Currently under development. For further information -about what has been done and what needs to be -done, see: - -http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE - -Disclaimer -========== +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: -All product names are used for identification purposes and are trademarks -or registered trademarks owned by their respective companies. +http://wiki.wxwidgets.org/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.