diff options
Diffstat (limited to 'doc/distributingqt.doc')
-rw-r--r-- | doc/distributingqt.doc | 129 |
1 files changed, 129 insertions, 0 deletions
diff --git a/doc/distributingqt.doc b/doc/distributingqt.doc new file mode 100644 index 000000000..b7b24ccaf --- /dev/null +++ b/doc/distributingqt.doc @@ -0,0 +1,129 @@ +/**************************************************************************** +** +** Documentation on deploying Qt +** +** Copyright (C) 2000-2008 Trolltech ASA. All rights reserved. +** +** This file is part of the Qt GUI Toolkit. +** +** This file may be used under the terms of the GNU General +** Public License versions 2.0 or 3.0 as published by the Free +** Software Foundation and appearing in the files LICENSE.GPL2 +** and LICENSE.GPL3 included in the packaging of this file. +** Alternatively you may (at your option) use any later version +** of the GNU General Public License if such license has been +** publicly approved by Trolltech ASA (or its successors, if any) +** and the KDE Free Qt Foundation. +** +** Please review the following information to ensure GNU General +** Public Licensing retquirements will be met: +** http://trolltech.com/products/qt/licenses/licensing/opensource/. +** If you are unsure which license is appropriate for your use, please +** review the following information: +** http://trolltech.com/products/qt/licenses/licensing/licensingoverview +** or contact the sales department at sales@trolltech.com. +** +** This file may be used under the terms of the Q Public License as +** defined by Trolltech ASA and appearing in the file LICENSE.QPL +** included in the packaging of this file. Licensees holding valid Qt +** Commercial licenses may use this file in accordance with the Qt +** Commercial License Agreement provided with the Software. +** +** This file is provided "AS IS" with NO WARRANTY OF ANY KIND, +** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR +** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted +** herein. +** +**********************************************************************/ + +/*! +\page distributingqt.html + +\title Deploying Qt Applications + +This document lists the platform-specific files needed to distribute +Qt applications. We do not include any compiler-specific files that +may also be retquired. (See also, \link winsystem.html Window +System-specific Notes\endlink.) + +\tableofcontents + +\section1 Static Qt Applications + +To distribute static Qt applications, you need the following file for +all platforms: + +\list +\i your application's executable +\endlist + +\section1 Dynamic Qt Applications + +To distribute dynamic Qt applications, you will need the following +files for all platforms: + +\list +\i application executable +\i the Qt library +\endlist + +The Qt library must either be in the same directory as the application +executable or in a directory which is included in the system library +path. + +The library is in provided by the following platform specific files: + +\table +\header \i Platform \i File +\row \i Windows \i \c qt[version].dll +\row \i Unix/Linux \i \c libqt[version].so +\row \i Mac \i \c libqt[version].dylib +\endtable + +\e version includes the three version numbers. For threaded builds the +version is prefixed with \e {-mt}. + +\section2 Distributing Plugins + +You must include any plugin files retquired by the application. + +Plugins must be put into a subdirectory under a directory known to +Qt as a plugin directory. The subdirectory must have the name of the +plugin category (e.g. \c styles, \c sqldrivers, \c designer, etc.). + +Qt searches in the following directories for plugin categories: + +\list +\i Application specific plugin paths +\i Build-directory of Qt +\i The application directory +\endlist + +Application specific plugin paths can be added using +QApplication::addLibraryPath(). The build-directory of Qt is hardcoded +in the Qt library and can be changed as a part of the installation +process (see the \l distributor-example.html Distributor example). + +\section1 Dynamic Dialogs + +For dynamic dialogs if you use QWidgetFactory, you need the following +files for all platforms: + +\list +\i The same files as used for dynamic Qt applications +\i The QUI Library +\endlist + +The QUI library is provided by the following platform specific files: +\table +\header \i Platform \i File +\row \i Windows \i\c tqui.lib +\row \i Unix/Linux \i\c libtqui.so +\row \i Mac \i \c libtqui.dylib +\endtable + +The QUI library must either be in the same directory as the +application executable or in a directory which is included in the +system library path. + +*/ |