]> git.saurik.com Git - wxWidgets.git/blob - docs/msw/wince/readme.txt
Patches-1851591 ] dataview sample is crashing (under MSW)
[wxWidgets.git] / docs / msw / wince / readme.txt
1
2 =================================================
3 Welcome to wxWidgets/CE
4 =================================================
5
6 You have downloaded the Windows CE port of the wxWidgets GUI library.
7 This runs on Pocket PC 2002/2003, Smartphone 2002/2003,
8 Windows CE .NET 4.x, and Windows Mobile 5.
9
10 More information about the wxWidgets project as a whole
11 can be found at:
12
13 http://www.wxwidgets.org
14
15 Information about the Windows CE port in particular can be found in
16 the wxWinCE topic in the wxWidgets reference manual.
17
18 Supported platforms
19 ===================
20
21 These are the supported platforms at the moment:
22
23 - x86 emulator build in eVC 3 and eVC 4.x
24 - Pocket PC (StrongARM)
25 - Smartphone (StrongARM)
26 - Windows Mobile 5
27
28 You can test the library and applications using the Pocket PC emulator
29 and/or Compaq iPAQ or other PDAs using Pocket PC.
30
31 Compiler installation
32 =====================
33
34 1. Embedded Visual C++
35 ----------------------
36
37 Get the Visual C++ embedded (FREE) from Microsoft website
38 http://msdn.microsoft.com/vstudio/device/embedded/download.asp
39
40 You must use Embedded Visual C++ 3.0 or Embedded Visual C++ 4.x.
41
42 You can download the Smartphone 2002/3 and Pocket PC 2002/3
43 SDKs separately.
44
45 2. Visual Studio 2005
46 ---------------------
47
48 VS 2005 Professional is required to write Windows Mobile 5 applications, although Pocket PC
49 2003 applications should also run on Mobile 5. VS 2005 must
50 be purchased, and you can then download the Mobile 5 2005 SDK
51 from Microsoft's site.
52
53 wxWidgets/CE Configuration
54 ================================
55
56 You may wish to customize the following file
57 before compiling wxWinCE:
58
59 include/wx/msw/wince/setup.h
60
61 wxWidgets/CE Compilation
62 ================================
63
64 NOTE: to generate targets not in the standard project files,
65 you should rebuild the project files using Bakefile.
66 Also, if you are building from a CVS version of wxWidgets,
67 you need to create eVC++ project files or get them from
68 somewhere, such as the daily makefile builds here:
69
70 http://biolpc22.york.ac.uk/pub/CVS_Makefiles/
71
72 See technote docs/tech/tn0016.txt for details on using Bakefile,
73 and you can get Bakefile from:
74
75 http://bakefile.sf.net
76
77 Open build/wince/wx.vcw, select an ARM or x86 target (or emulator
78 target for eVC++ 4), and compile.
79
80 Then open samples/minimal/minimal.vcw, select an ARM, x86 or emulator
81 target, and compile. You can use the emulator or real hardware to run
82 the sample.
83
84 There may be long delays while eVC++ computes dependencies, and expect
85 to wait a long time for loading and saving workspaces. Do not attempt to
86 save the wxWidgets library project file: it will take forever and generate
87 a huge file, so make alterations either using Bakefile or by editing the
88 project file with a text editor, and reloading. Sample project files are OK
89 to save.
90
91 To compile using the emulator on eVC++3:
92
93 - Open build/wince/wx.vcw, select the
94 WIN32 (WCE x86) Debug Unicode configuration, close the dialog,
95 then select Pocket PC 2002 and Pocket PC 2002 Emulation on the toolbar,
96 and compile.
97
98 - Open samples/minimal/minimal.vcw, select the
99 WIN32 (WCE x86 Debug) configuration, and select Pocket PC 2002 and
100 Pocket PC 2002 Emulation as before.
101
102 To compile using the emulator on eVC++4:
103
104 - Open build/wince/wx.vcw, select the
105 WIN32 (WCE Emulator) Debug configuration, and compile.
106
107 - Open samples/minimal/minimal.vcw with eVC++, select the
108 WIN32 (WCE emulator) Debug configuration, and compile.
109
110 Note: builds for the different SDKs (Smartphone, PPC, .Net)
111 use the same directory and library names, so for the moment
112 these builds cannot co-exist simultaneously.
113
114 To use Visual Studio 2005, you need to allow VS to convert the projects
115 first (but install all the SDKs you need to _before_ converting), and then
116 you need to adjust the library settings of each wxWidgets and sample project.
117
118 Edit the configuration properties for each configuration and in the Librarian,
119 add a relative path ..\..\lib to each library path. For example:
120
121 ..\..\lib\$(PlatformName)\$(ConfigurationName)\wx_mono.lib
122
123 Then, for a sample you want to compile, edit the configuration properties
124 and make sure ..\..\lib\$(PlatformName)\$(ConfigurationName) is in the Linker/General/Additional
125 Library Directories property. Also change the Linker/Input/Additional Dependencies
126 property to something like:
127
128 coredll.lib wx_mono.lib wx_wxjpeg.lib wx_wxpng.lib wx_wxzlib.lib wx_wxexpat.lib commctrl.lib winsock.lib wininet.lib
129
130 since the library names in the wxWidgets workspace were changed
131 by VS 2005.
132
133 Status
134 ======
135
136 It's possible to create working Pocket PC or Smartphone
137 applications with this port. For further information
138 about how to use wxWidgets with Windows CE, and further
139 work that needs to be done, see the wxWinCE topic in the
140 reference manual, and also:
141
142 http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE
143
144 The "Life!" demo in demos/life has some adaptations for
145 wxWinCE, and also demonstrates how to make an installer for
146 a Pocket PC application.
147
148 Disclaimer
149 ==========
150
151 All product names are used for identification purposes and are trademarks
152 or registered trademarks owned by their respective companies.
153