|
1 /**************************************************************************** |
|
2 ** |
|
3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). |
|
4 ** All rights reserved. |
|
5 ** Contact: Nokia Corporation (qt-info@nokia.com) |
|
6 ** |
|
7 ** This file is part of the documentation of the Qt Toolkit. |
|
8 ** |
|
9 ** $QT_BEGIN_LICENSE:LGPL$ |
|
10 ** No Commercial Usage |
|
11 ** This file contains pre-release code and may not be distributed. |
|
12 ** You may use this file in accordance with the terms and conditions |
|
13 ** contained in the Technology Preview License Agreement accompanying |
|
14 ** this package. |
|
15 ** |
|
16 ** GNU Lesser General Public License Usage |
|
17 ** Alternatively, this file may be used under the terms of the GNU Lesser |
|
18 ** General Public License version 2.1 as published by the Free Software |
|
19 ** Foundation and appearing in the file LICENSE.LGPL included in the |
|
20 ** packaging of this file. Please review the following information to |
|
21 ** ensure the GNU Lesser General Public License version 2.1 requirements |
|
22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. |
|
23 ** |
|
24 ** In addition, as a special exception, Nokia gives you certain additional |
|
25 ** rights. These rights are described in the Nokia Qt LGPL Exception |
|
26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. |
|
27 ** |
|
28 ** If you have questions regarding the use of this file, please contact |
|
29 ** Nokia at qt-info@nokia.com. |
|
30 ** |
|
31 ** |
|
32 ** |
|
33 ** |
|
34 ** |
|
35 ** |
|
36 ** |
|
37 ** |
|
38 ** $QT_END_LICENSE$ |
|
39 ** |
|
40 ****************************************************************************/ |
|
41 |
|
42 /*! |
|
43 \group qtce |
|
44 \title Qt for Windows CE |
|
45 \ingroup qt-embedded |
|
46 \brief Documents related to Qt on Windows CE |
|
47 |
|
48 Qt for Windows CE is a C++ framework for GUI and application development |
|
49 for embedded devices running Windows CE. It runs on a variety of processors, |
|
50 including ARM, Intel x86, MIPS and SH-4. |
|
51 |
|
52 \table 100% |
|
53 \header \o Getting Started \o Reference \o Performance and Optimization |
|
54 \row |
|
55 \o |
|
56 \list |
|
57 \o \l {Qt for Windows CE Requirements} |
|
58 \o \l {Installing Qt on Windows CE} |
|
59 \o \l {Windows CE - Introduction to using Qt}{Introduction to using Qt} |
|
60 \endlist |
|
61 \o |
|
62 \list |
|
63 \o \l {Windows CE - Using shadow builds}{Using shadow builds} |
|
64 \o \l {Windows CE - Working with Custom SDKs}{Working with Custom SDKs} |
|
65 \endlist |
|
66 \o |
|
67 \list |
|
68 \o \l {Windows CE OpenGL ES}{OpenGL ES} |
|
69 \o \l {Qt Performance Tuning} |
|
70 \o \l {Fine-Tuning Features in Qt} |
|
71 \endlist |
|
72 \endtable |
|
73 */ |
|
74 |
|
75 /*! |
|
76 \page wince-with-qt-introduction.html |
|
77 |
|
78 \title Windows CE - Introduction to using Qt |
|
79 \brief An introduction to Qt for Windows CE developers. |
|
80 \ingroup qtce |
|
81 |
|
82 \tableofcontents |
|
83 |
|
84 \section1 Required tools |
|
85 |
|
86 In order to use Qt for Windows CE you need to have Visual Studio |
|
87 2005 or 2008 and at least one of the supported Windows |
|
88 CE/Mobile SDKs installed. |
|
89 Note, that the Visual Studio 2008 Standard Edition doesn't come |
|
90 with Windows CE support. You will need the Professional Edition, |
|
91 if you're using Visual Studio 2008. |
|
92 |
|
93 We recommend the \e{Windows Mobile 5.0 SDK for Pocket PC} SDK available |
|
94 \l{http://www.microsoft.com/downloads/details.aspx?FamilyID=83a52af2-f524-4ec5-9155-717cbe5d25ed&DisplayLang=en}{here}. |
|
95 |
|
96 \section1 Installing Qt |
|
97 |
|
98 Follow the instructions found in \l{Installing Qt on Windows CE}. |
|
99 |
|
100 \section1 Building your own applications |
|
101 |
|
102 If you are new to Qt development, have a look at \l{How to Learn Qt} |
|
103 and \l{Tutorials}. In general there is little or no difference in |
|
104 developing Qt applications for Windows CE compared to any of the |
|
105 other platforms supported by Qt. |
|
106 |
|
107 Once you have a \c .pro file, there are two ways of building your |
|
108 application. You can either do it on the command line or inside of |
|
109 Visual Studio. To do it on the command line, simply write: |
|
110 |
|
111 \snippet doc/src/snippets/code/doc_src_wince-introduction.qdoc 0 |
|
112 |
|
113 To build the project inside of Visual Studio, on the command line write: |
|
114 |
|
115 \snippet doc/src/snippets/code/doc_src_wince-introduction.qdoc 1 |
|
116 |
|
117 then start Visual Studio with the generated \c .vcproj or \c .sln file and |
|
118 select \e{Build project}. |
|
119 |
|
120 For more information on how to use qmake have a look at the \l |
|
121 {qmake Tutorial}. |
|
122 |
|
123 \section1 Running the application |
|
124 |
|
125 In order to run the application, it needs to be deployed on the |
|
126 Windows CE/Mobile device you want to test it for. This can either |
|
127 be done manually or automated using Visual Studio. |
|
128 |
|
129 To do it manually, simply copy the executable, the Qt \c{.dll} |
|
130 files needed for the application to run, and the C-runtime library |
|
131 into a folder on the device, and then click on the executable to |
|
132 start the program. You can either use the \e Explorer found in |
|
133 ActiveSync or the \e{Remote File Viewer} found in Visual Studio to do |
|
134 this. |
|
135 |
|
136 Visual Studio can do this step automatically for you as well. If you have |
|
137 built the project inside Visual Studio, simply select \e Deploy and then |
|
138 \e Debug to deploy and then run the application. You can change the |
|
139 device type by changing the \e{Target Device} specified in the |
|
140 Visual Studio toolbar. |
|
141 |
|
142 Further information on deploying Qt applications for Windows can |
|
143 be found in the \l{Deploying an Application on Windows} |
|
144 {deployment document}. |
|
145 */ |