| 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | 
|---|
| 2 | <!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/doc/distributingqt.doc:36 --> | 
|---|
| 3 | <html> | 
|---|
| 4 | <head> | 
|---|
| 5 | <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> | 
|---|
| 6 | <title>Deploying Qt Applications</title> | 
|---|
| 7 | <style type="text/css"><!-- | 
|---|
| 8 | fn { margin-left: 1cm; text-indent: -1cm; } | 
|---|
| 9 | a:link { color: #004faf; text-decoration: none } | 
|---|
| 10 | a:visited { color: #672967; text-decoration: none } | 
|---|
| 11 | body { background: #ffffff; color: black; } | 
|---|
| 12 | --></style> | 
|---|
| 13 | </head> | 
|---|
| 14 | <body> | 
|---|
| 15 |  | 
|---|
| 16 | <table border="0" cellpadding="0" cellspacing="0" width="100%"> | 
|---|
| 17 | <tr bgcolor="#E5E5E5"> | 
|---|
| 18 | <td valign=center> | 
|---|
| 19 | <a href="index.html"> | 
|---|
| 20 | <font color="#004faf">Home</font></a> | 
|---|
| 21 | | <a href="classes.html"> | 
|---|
| 22 | <font color="#004faf">All Classes</font></a> | 
|---|
| 23 | | <a href="mainclasses.html"> | 
|---|
| 24 | <font color="#004faf">Main Classes</font></a> | 
|---|
| 25 | | <a href="annotated.html"> | 
|---|
| 26 | <font color="#004faf">Annotated</font></a> | 
|---|
| 27 | | <a href="groups.html"> | 
|---|
| 28 | <font color="#004faf">Grouped Classes</font></a> | 
|---|
| 29 | | <a href="functions.html"> | 
|---|
| 30 | <font color="#004faf">Functions</font></a> | 
|---|
| 31 | </td> | 
|---|
| 32 | <td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Deploying Qt Applications</h1> | 
|---|
| 33 |  | 
|---|
| 34 |  | 
|---|
| 35 |  | 
|---|
| 36 | <p> This document lists the platform-specific files needed to distribute | 
|---|
| 37 | Qt applications. We do not include any compiler-specific files that | 
|---|
| 38 | may also be required. (See also, <a href="winsystem.html">Window | 
|---|
| 39 | System-specific Notes</a>.) | 
|---|
| 40 | <p> <!-- toc --> | 
|---|
| 41 | <ul> | 
|---|
| 42 | <li><a href="#1"> Static Qt Applications | 
|---|
| 43 | </a> | 
|---|
| 44 | <li><a href="#2"> Dynamic Qt Applications | 
|---|
| 45 | </a> | 
|---|
| 46 | <ul> | 
|---|
| 47 | <li><a href="#2-1"> Distributing Plugins | 
|---|
| 48 | </a> | 
|---|
| 49 | </ul> | 
|---|
| 50 | <li><a href="#3"> Dynamic Dialogs | 
|---|
| 51 | </a> | 
|---|
| 52 | </ul> | 
|---|
| 53 | <!-- endtoc --> | 
|---|
| 54 |  | 
|---|
| 55 | <p> <h2> Static Qt Applications | 
|---|
| 56 | </h2> | 
|---|
| 57 | <a name="1"></a><p> To distribute static Qt applications, you need the following file for | 
|---|
| 58 | all platforms: | 
|---|
| 59 | <p> <ul> | 
|---|
| 60 | <li> your application's executable | 
|---|
| 61 | </ul> | 
|---|
| 62 | <p> <h2> Dynamic Qt Applications | 
|---|
| 63 | </h2> | 
|---|
| 64 | <a name="2"></a><p> To distribute dynamic Qt applications, you will need the following | 
|---|
| 65 | files for all platforms: | 
|---|
| 66 | <p> <ul> | 
|---|
| 67 | <li> application executable | 
|---|
| 68 | <li> the Qt library | 
|---|
| 69 | </ul> | 
|---|
| 70 | <p> The Qt library must either be in the same directory as the application | 
|---|
| 71 | executable or in a directory which is included in the system library | 
|---|
| 72 | path. | 
|---|
| 73 | <p> The library is in provided by the following platform specific files: | 
|---|
| 74 | <p> <center><table cellpadding="4" cellspacing="2" border="0"> | 
|---|
| 75 | <tr bgcolor="#a2c511"> <th valign="top">Platform <th valign="top">File | 
|---|
| 76 | <tr bgcolor="#f0f0f0"> <td valign="top">Windows <td valign="top"><tt>qt[version].dll</tt> | 
|---|
| 77 | <tr bgcolor="#d0d0d0"> <td valign="top">Unix/Linux <td valign="top"><tt>libqt[version].so</tt> | 
|---|
| 78 | <tr bgcolor="#f0f0f0"> <td valign="top">Mac <td valign="top"><tt>libqt[version].dylib</tt> | 
|---|
| 79 | </table></center> | 
|---|
| 80 | <p> <em>version</em> includes the three version numbers. For threaded builds the | 
|---|
| 81 | version is prefixed with <em>-mt</em>. | 
|---|
| 82 | <p> <h3> Distributing Plugins | 
|---|
| 83 | </h3> | 
|---|
| 84 | <a name="2-1"></a><p> You must include any plugin files required by the application. | 
|---|
| 85 | <p> Plugins must be put into a subdirectory under a directory known to | 
|---|
| 86 | Qt as a plugin directory. The subdirectory must have the name of the | 
|---|
| 87 | plugin category (e.g. <tt>styles</tt>, <tt>sqldrivers</tt>, <tt>designer</tt>, etc.). | 
|---|
| 88 | <p> Qt searches in the following directories for plugin categories: | 
|---|
| 89 | <p> <ul> | 
|---|
| 90 | <li> Application specific plugin paths | 
|---|
| 91 | <li> Build-directory of Qt | 
|---|
| 92 | <li> The application directory | 
|---|
| 93 | </ul> | 
|---|
| 94 | <p> Application specific plugin paths can be added using | 
|---|
| 95 | <a href="qapplication.html#addLibraryPath">QApplication::addLibraryPath</a>(). The build-directory of Qt is hardcoded | 
|---|
| 96 | in the Qt library and can be changed as a part of the installation | 
|---|
| 97 | process (see the <a href="distributor-example.html">distributor-example.html</a> Distributor example). | 
|---|
| 98 | <p> <h2> Dynamic Dialogs | 
|---|
| 99 | </h2> | 
|---|
| 100 | <a name="3"></a><p> For dynamic dialogs if you use <a href="qwidgetfactory.html">QWidgetFactory</a>, you need the following | 
|---|
| 101 | files for all platforms: | 
|---|
| 102 | <p> <ul> | 
|---|
| 103 | <li> The same files as used for dynamic Qt applications | 
|---|
| 104 | <li> The QUI Library | 
|---|
| 105 | </ul> | 
|---|
| 106 | <p> The QUI library is provided by the following platform specific files: | 
|---|
| 107 | <center><table cellpadding="4" cellspacing="2" border="0"> | 
|---|
| 108 | <tr bgcolor="#a2c511"> <th valign="top">Platform <th valign="top">File | 
|---|
| 109 | <tr bgcolor="#d0d0d0"> <td valign="top">Windows  <td valign="top"><tt>qui.lib</tt> | 
|---|
| 110 | <tr bgcolor="#f0f0f0"> <td valign="top">Unix/Linux  <td valign="top"><tt>libqui.so</tt> | 
|---|
| 111 | <tr bgcolor="#d0d0d0"> <td valign="top">Mac <td valign="top"><tt>libqui.dylib</tt> | 
|---|
| 112 | </table></center> | 
|---|
| 113 | <p> The QUI library must either be in the same directory as the | 
|---|
| 114 | application executable or in a directory which is included in the | 
|---|
| 115 | system library path. | 
|---|
| 116 | <p> | 
|---|
| 117 | <!-- eof --> | 
|---|
| 118 | <p><address><hr><div align=center> | 
|---|
| 119 | <table width=100% cellspacing=0 border=0><tr> | 
|---|
| 120 | <td>Copyright © 2007 | 
|---|
| 121 | <a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> | 
|---|
| 122 | <td align=right><div align=right>Qt 3.3.8</div> | 
|---|
| 123 | </table></div></address></body> | 
|---|
| 124 | </html> | 
|---|