doc/src/platforms/wince-introduction.qdoc
branchRCL_3
changeset 8 3f74d0d4af4c
equal deleted inserted replaced
6:dee5afe5301f 8:3f74d0d4af4c
       
     1 /****************************************************************************
       
     2 **
       
     3 ** Copyright (C) 2010 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 {Qt for Windows CE Hardware Accelerated Graphics}{Hardware Accelerated Graphics}
       
    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 */