doc/src/platforms/wince-signing.qdoc

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2015 The Qt Company Ltd.
   4 ** Contact: http://www.qt.io/licensing/
   5 **
   6 ** This file is part of the documentation of the Qt Toolkit.
   7 **
   8 ** $QT_BEGIN_LICENSE:FDL$
   9 ** Commercial License Usage
  10 ** Licensees holding valid commercial Qt licenses may use this file in
  11 ** accordance with the commercial license agreement provided with the
  12 ** Software or, alternatively, in accordance with the terms contained in
  13 ** a written agreement between you and The Qt Company. For licensing terms
  14 ** and conditions see http://www.qt.io/terms-conditions. For further
  15 ** information use the contact form at http://www.qt.io/contact-us.
  16 **
  17 ** GNU Free Documentation License Usage
  18 ** Alternatively, this file may be used under the terms of the GNU Free
  19 ** Documentation License version 1.3 as published by the Free Software
  20 ** Foundation and appearing in the file included in the packaging of
  21 ** this file.  Please review the following information to ensure
  22 ** the GNU Free Documentation License version 1.3 requirements
  23 ** will be met: http://www.gnu.org/copyleft/fdl.html.
  24 ** $QT_END_LICENSE$
  25 **
  26 ****************************************************************************/
  27
  28 /*!
  29     \page windowsce-signing.html
  30     \ingroup qtce
  31     \title Windows CE - Signing
  32     \brief How to sign Qt projects for use with Windows CE.
  33
  34     \section1 Signing on Windows CE
  35
  36 Windows CE provides a security mechanism to ask the user to confirm
  37 that they want to use an application/library that is unknown to the
  38 system. This process gets repeated for each dependency of an
  39 application, meaning each library the application links to, which is
  40 not recognized yet.
  41
  42 To simplify this process you can use signatures and certificates. A
  43 certificate gets installed on the device and each file which is
  44 signed with the according certificate can be launched without the
  45 security warning.
  46
  47 If you want to use signatures for your project written in Qt,
  48 configure provides the \c -signature option. You need to specify the
  49 location of the .pfx file and qmake adds the signing step to the
  50 build rules.
  51
  52 If you need to select a separate signature for a specific project,
  53 or you only want to sign a single project, you can use the
  54 "SIGNATURE_FILE = foo.pfx" rule inside the project file.
  55
  56 The above described rules apply for command line makefiles as well as
  57 Visual Studio projects generated by qmake.
  58
  59 Microsoft usually ships development signatures inside the SDK packages.
  60 You can find them in the Tools subdirectory of the SDK root folder.
  61
  62 Example:
  63
  64 \list
  65 \o Calling configure with signing enabled:
  66 \code
  67 configure.exe -platform win32-msvc2005 -xplatform wincewm50pocket-msvc2005 -signature C:\some\path\SDKSamplePrivDeveloper.pfx
  68 \endcode
  69
  70 \o Using pro file to specify signature
  71 \code
  72 ...
  73 TARGET = foo
  74
  75 wince*: {
  76    SIGNATURE_FILE = somepath\customSignature.pfx
  77 }
  78 ...
  79 \endcode
  80 \endlist
  81
  82 */