Commit 8d3ce48afc3854409a98340b07db024c6d271b30
-
- con <qtc-committer @no…a.com>
- Diff rendering mode:
- inline
- side by side
Binary files differ
doc/images/qtcreator-qt4-s60sdks.png
(341 / 0)
Binary files differ
Binary files differ
Binary files differ
Binary files differ
Binary files differ
Binary files differ
doc/qtcreator.qdoc
(145 / 27)
| 19 | 19 | {qt-creator-request@trolltech.com}. For more information on Qt mailing | |
| 20 | 20 | lists, visit \l{http://lists.trolltech.com}{http://lists.trolltech.com}. | |
| 21 | 21 | ||
| 22 | Qt Creator includes a wide range of useful features. Among them are: | ||
| 23 | \list 1 | ||
| 24 | \o \bold{Smart Code Editor}: The code editor provides syntax | ||
| 25 | highlighting as well as code completion. | ||
| 26 | \o \bold{Qt4 Project Generating Wizard}: This wizard allows the user | ||
| 27 | to generate a project for a console application, a GUI application, | ||
| 28 | or a C++ library. | ||
| 29 | \o \bold{Qt Help Integration}: Qt's entire documentation can be | ||
| 30 | accessed easily by clicking on the \gui{Help} button. | ||
| 31 | \o \bold{Qt Designer Integration}: User interface forms can be designed | ||
| 32 | within Qt Creator. Simply double-click on a \c{.ui} file within the | ||
| 33 | \gui{Project Explorer} to launch the integration. | ||
| 34 | \o \bold{Locator}: A powerful navigation tool that lets the user locate | ||
| 35 | files and classes using minimal keystrokes. | ||
| 36 | \o \bold{Support for qmake's .pro file format}: The project's \c{.pro} | ||
| 37 | file is used as a project description file. | ||
| 38 | \o \bold{Debugging Interface}: Applications can be debugged | ||
| 39 | within Qt Creator using a graphical frontend to the GNU symbolic | ||
| 40 | debugger (GDB) and the Microsoft Console Debugger (CDB). | ||
| 41 | \endlist | ||
| 42 | |||
| 43 | To learn more about the Qt Creator, click on one of the links below: | ||
| 44 | |||
| 45 | |||
| 46 | 22 | \raw HTML | |
| 47 | 23 | <img border="0" style="float:right;" src="images/qtcreator-screenshots.png" /> | |
| 48 | 24 | \endraw | |
| … | … | ||
| 36 | 36 | \o \l{Debugging with Qt Creator} | |
| 37 | 37 | \o \l{CMake Support in Qt Creator} | |
| 38 | 38 | \o \l{Support for Generic Projects in Qt Creator} | |
| 39 | \o \l{Development of Qt for Symbian Based Applications} | ||
| 39 | 40 | \o \l{Handling External Libraries} | |
| 40 | 41 | \o \l{Tips and Tricks} | |
| 41 | 42 | \o \l{Keyboard Shortcuts} | |
| … | … | ||
| 439 | 439 | \i \image qtcreator-qt4-qtversions-win-symbian.png | |
| 440 | 440 | If you are using Qt for Symbian and your S60 SDK is registered | |
| 441 | 441 | with \c devices.exe, Qt Creator will detect the Qt version automatically. | |
| 442 | If this does not work, point Creator to \c qmake.exe of Qt for Symbian. | ||
| 442 | A known issue is that you cannot just point Creator to \c qmake.exe of Qt for Symbian. | ||
| 443 | 443 | You can add the path to the Metrowerks Compiler (\gui {MWC Directory}) | |
| 444 | 444 | if you want to use to build for the emulator. This requires Carbide 2.0 | |
| 445 | 445 | to be installed. the MWC directory should then point to the directory | |
| … | … | ||
| 1472 | 1472 | \contentspage index.html | |
| 1473 | 1473 | \previouspage creator-cmake-support.html | |
| 1474 | 1474 | \page creator-generic-projects.html | |
| 1475 | \nextpage creator-external-library-handling.html | ||
| 1475 | \nextpage creator-qt-for-symbian.html | ||
| 1476 | 1476 | ||
| 1477 | 1477 | \title Support for Generic Projects in Qt Creator | |
| 1478 | 1478 | ||
| … | … | ||
| 1531 | 1531 | \c{$BUILDDIR} which should work fine. | |
| 1532 | 1532 | */ | |
| 1533 | 1533 | ||
| 1534 | |||
| 1535 | 1534 | /*! | |
| 1536 | 1535 | \contentspage index.html | |
| 1537 | 1536 | \previouspage creator-generic-projects.html | |
| 1537 | \page creator-qt-for-symbian.html | ||
| 1538 | \nextpage creator-external-library-handling.html | ||
| 1539 | |||
| 1540 | \title Development of Qt for Symbian Based Applications | ||
| 1541 | |||
| 1542 | Qt Creator 1.3 comes with preliminary support for development of | ||
| 1543 | applications using Qt for the Symbian Platform. | ||
| 1544 | |||
| 1545 | \e{Note that this is highly experimental, and not intended for production use. | ||
| 1546 | The primary aim is to allow Symbian developers to familiarize themselves with Qt Creator | ||
| 1547 | and provide feedback that will help us improve Symbian support in future versions of | ||
| 1548 | Qt Creator.} | ||
| 1549 | |||
| 1550 | Please provide us with feedback, using the mailing list or IRC, as described on the | ||
| 1551 | \l{http://qt.gitorious.org/qt-creator/pages/Home}{Qt Creator Development Wiki}. | ||
| 1552 | |||
| 1553 | \section2 Getting Started | ||
| 1554 | |||
| 1555 | You need the following software installed on your PC. | ||
| 1556 | Only Windows development is supported. | ||
| 1557 | |||
| 1558 | \list | ||
| 1559 | \o \l{http://www.forum.nokia.com/main/resources/tools_and_sdks/S60SDK/} | ||
| 1560 | {S60 Platform SDK 3rd Edition FP1 or higher} | ||
| 1561 | \o \l{http://www.forum.nokia.com/main/resources/technologies/openc_cpp/} | ||
| 1562 | {Open C/C++ v1.6.0 or higher.} Install this to all S60 SDKs you plan to use Qt with. | ||
| 1563 | This is included in the Qt for Symbian binary installers. | ||
| 1564 | \o Either the GCCE Arm Toolchain that is included in the S60 Platform SDKs, or | ||
| 1565 | RVCT 2.2 [build 686] or later (which is not available free of charge). | ||
| 1566 | Your environment needs to find the compiler in the PATH. | ||
| 1567 | \o Qt for Symbian 4.6.0, installed into the S60 SDKs you want to use. | ||
| 1568 | |||
| 1569 | \endlist | ||
| 1570 | |||
| 1571 | And for deploying and running applications on the device | ||
| 1572 | \list | ||
| 1573 | \o The Nokia USB drivers that come e.g. with PC Suite. | ||
| 1574 | \o The \l{http://tools.ext.nokia.com/trk/}{App TRK} application for your device. | ||
| 1575 | \endlist | ||
| 1576 | |||
| 1577 | Running Qt based applications on real devices requires the following packages to be installed on | ||
| 1578 | your device. The packages can be found in the S60 SDK where you installed Open C/C++: | ||
| 1579 | \list | ||
| 1580 | \o nokia_plugin\\openc\\s60opencsis\\pips_s60_\<version\>.sis | ||
| 1581 | \o nokia_plugin\\openc\\s60opencsis\\openc_ssl_s60_\<version\>.sis | ||
| 1582 | \o nokia_plugin\\opencpp\\s60opencppsis\\stdcpp_s60_\<version\>.sis | ||
| 1583 | \endlist | ||
| 1584 | |||
| 1585 | If you want to run your applications in the Symbian Emulator, you also need to install | ||
| 1586 | Carbide.c++ v2.0.0 or higher. | ||
| 1587 | |||
| 1588 | \section2 Setting up Qt Creator | ||
| 1589 | |||
| 1590 | When you run Qt Creator after installing the S60 Platform SDK and Qt for Symbian, | ||
| 1591 | the installed SDKs and their corresponding Qt versions are automatically detected. | ||
| 1592 | For each detected S60 SDK with Qt, a special entry is made in the Qt Version Management settings | ||
| 1593 | \gui{Tools -> Options... -> Qt4 -> Qt Versions}. | ||
| 1594 | |||
| 1595 | \e{Note that you must use one of these special Qt version entries for building projects | ||
| 1596 | for the emulator or devices. You can not just point Qt Creator to the qmake executable | ||
| 1597 | like you would do for a desktop version of Qt.} | ||
| 1598 | |||
| 1599 | \image qtcreator-qt4-qtversions-win-symbian.png | ||
| 1600 | |||
| 1601 | If you want to run your applications in the Symbian Emulator, you need to point Qt Creator | ||
| 1602 | to the Metrowerks Compiler that you want to use, by setting the \gui{MWC Directory} | ||
| 1603 | of the Qt version to the corresponding Carbide.c++ installation directory. | ||
| 1604 | |||
| 1605 | You can check what S60 SDKs and corresponding Qt versions are found in the | ||
| 1606 | \gui{Tools -> Options... -> Qt4 -> S60 SDKs} preference page. | ||
| 1607 | At the moment it is not possible to override the autodetected settings. | ||
| 1608 | |||
| 1609 | \image qtcreator-qt4-s60sdks.png | ||
| 1610 | |||
| 1611 | \section2 Setting up Your Project | ||
| 1612 | |||
| 1613 | After installing all the prerequisites and checking the setup in Qt Creator as described | ||
| 1614 | above, you need to make some settings for your project. | ||
| 1615 | \e{Note that the only supported build system for Qt for Symbian applications in Qt Creator | ||
| 1616 | is qmake.} | ||
| 1617 | |||
| 1618 | \section3 Building your Project | ||
| 1619 | |||
| 1620 | Before you can build your project for the Symbian Platform you need to create build | ||
| 1621 | configurations for it. | ||
| 1622 | Open \gui{Projects mode} and make sure that your project is selected for editing in | ||
| 1623 | \gui{Edit Project Settings for Project ...}. Add debug and release build configurations | ||
| 1624 | for the Symbian target by selecting the corresponding Qt version from the build configuration | ||
| 1625 | \gui{Add} menu. | ||
| 1626 | |||
| 1627 | \image qtcreator-symbian-add-buildconfiguration.png | ||
| 1628 | |||
| 1629 | The created build configurations default to using the GCCE tool chain. If you want to build | ||
| 1630 | for the device using RVCT, or for the Symbian Emulator using WINSCW, change the tool chain in | ||
| 1631 | the \gui{General} section of the build configuration settings (press the \gui{Show Details} | ||
| 1632 | button first). | ||
| 1633 | |||
| 1634 | Now you can switch to building your project for the device by selecting one of the | ||
| 1635 | new build configurations as the active configuration at the top of \gui{Projects mode}. | ||
| 1636 | |||
| 1637 | \image qtcreator-symbian-change-buildconfiguration.png | ||
| 1638 | |||
| 1639 | \section3 Running your Project on the Device | ||
| 1640 | |||
| 1641 | Similar to the build configuration setup for your project you need to create a run configuration | ||
| 1642 | for running your project on a Symbian device. Add a new run configuration in \gui{Projects mode} | ||
| 1643 | via \gui{Run Settings}, \gui{Add -> YourApplication on Symbian Device} button. | ||
| 1644 | |||
| 1645 | \image qtcreator-symbian-add-runconfiguration.png | ||
| 1646 | |||
| 1647 | \image qtcreator-symbian-details-runconfiguration.png | ||
| 1648 | |||
| 1649 | In the details of the run configuration you can specify a certificate to use, and | ||
| 1650 | select one of the devices that you have currently attached to your computer. | ||
| 1651 | The only connection mode supported at the moment is USB in \e{PC Suite} mode. | ||
| 1652 | For actually running your application on the device, you need to set the device run configuration | ||
| 1653 | as the active configuration at the top of \gui{Projects mode}. | ||
| 1654 | Start the \gui{App TRK} application on your device and press the run button to create | ||
| 1655 | a package for your application, deploy, install and run it automatically on your device. | ||
| 1656 | |||
| 1657 | \image qtcreator-symbian-change-runconfiguration.png | ||
| 1658 | |||
| 1659 | When something goes wrong check the following things: | ||
| 1660 | \list | ||
| 1661 | \o Is the device run configuration selected as the active run configuration? | ||
| 1662 | \o Did you build your application with one of the special Qt versions created for the | ||
| 1663 | S60 SDKs? | ||
| 1664 | \o Is the device connected via USB in \e{PC Suite} mode? | ||
| 1665 | \o Is App TRK running on the device, using the USB connection, and does it have status | ||
| 1666 | \e{connected}? | ||
| 1667 | \o Is your device detected and selected in the run configuration details? | ||
| 1668 | \endlist | ||
| 1669 | |||
| 1670 | If neither of this helps to solve your problem, search the qt-creator@trolltech.com | ||
| 1671 | mailinglist archives or provide feedback to us via the methods described on the | ||
| 1672 | \l{http://qt.gitorious.org/qt-creator/pages/Home}{Qt Creator Development Wiki}. | ||
| 1673 | |||
| 1674 | */ | ||
| 1675 | |||
| 1676 | /*! | ||
| 1677 | \contentspage index.html | ||
| 1678 | \previouspage creator-qt-for-symbian.html | ||
| 1538 | 1679 | \page creator-external-library-handling.html | |
| 1539 | 1680 | \nextpage creator-tips.html | |
| 1540 | 1681 |
