Development/Tutorials/Using Qt Creator: Difference between revisions

    From KDE TechBase
    m (→‎Run cmake: Fix syntax highlighting.)
    m (Reverted edits by Yurchor (talk) to last revision by Ochurlaud)
     
    (25 intermediate revisions by 8 users not shown)
    Line 1: Line 1:
    {{Template:I18n/Language Navigation Bar|Development/Tutorials/Using Qt Creator}}
    {{Moved To Community | Guidelines_and_HOWTOs/Using_Qt_Creator}}
     
    QtCreator is an IDE from Nokia for Qt. It contains QtDesigner for UI design. This article describes:
    * how to create a new program
    * how to load an existing program
     
    = Creating a new program =
     
    Qt Designer is a graphical program which allows you to easily build user interfaces, using a ''drag n drop'' interface. Here is a short example how it can go, for more information read the [http://qt.nokia.com/doc/designer-manual.html user documentation].
     
    ;Step 0:
    Call Qt Designer from within the [http://labs.trolltech.com/page/Projects/Tools/QtCreator QtCreator] [http://en.wikipedia.org/wiki/Integrated_development_environment IDE]:
    <pre>
    qtcreator
    </pre>
     
    ;Step 1:
    Add the widgets you want by drag-and-drop
     
    [[File:Designer-step1.png|200px]]
     
    ;Step 2:
    Select the mainwindow. This is the one un-intuitive step. To lay out the objects in the mainwindow, you do not select the objects in the mainwindow, but the mainwindow itself.
     
    [[File:Designer-step2.png|200px]]
     
    ;Step 3:
    Select Form -> Lay Out in a <u>G</u>rid
     
    [[File:Designer-step3.png|200px]]
     
    ;Result:
    You get a decent look, and if you resize the window, the widgets resize as well.
     
    [[File:Designer-result.png|200px]]
     
    == Using KDE libraries ==
    To use KDE classes like KMessageBox, you need to tell qtcreator to use the KDE libraries when building. Go to your home directory, cd into ''yourproject'' and modify ''yourproject.pro''. Add a line
    <pre>
    LIBS += -lkdeui
    </pre>
    Then you can start using KDE classes in your code.
     
    == Adding a toolbar ==
    To add a toolbar, right-click on the UI and choose "Add Toolbar". Then you can set icons and text in your mainwindow's constructor with code like this:
    <syntaxhighlight lang="cpp-qt">
    ui->toolBar->addAction(QIcon("/usr/share/icons/oxygen/22x22/apps/ktip.png"),"hello world");
    </syntaxhighlight>
    [[Development/Tutorials/Using_Qt_Designer|More Info...]]
     
    = Load an existing project =
    This describes how to use QtCreator to integrate existing KDE 4 applications. It has been tested with QtCreator 1.2.80 and SUSE Linux 11.1 but should work same or similar with every combination. As an example KDE application we use [http://userbase.kde.org/ktimetracker ktimetracker] from the kdepim module, other applications should work analog.
     
    You can either work with code on your disk or have QtCreator do the subversion checkout.
     
    == use code from your disk ==
    * Import the CMakeLists.txt file (File -> Open -> kdepim/CMakeLists.txt)
    * As build directory choose kdepim.
    * You will automatically come to a screen where you can run cmake
    * Continue with the step "Run cmake"
     
    == have QtCreator do the subversion checkout ==
    * Choose File -> New File or Project -> Version Control -> Subversion Checkout.
    * Enter a subversion URL like svn://anonsvn.kde.org/home/kde/trunk/KDE/kdepim
    * Enter a checkout directory, so the local directory where the checkout will be loaded in
    * Type finish, see how the checkout starts
    * You will automatically come to a screen where you can run cmake
    * Continue with the step "Run cmake"
     
    == have QtCreator do the git checkout ==
    * Choose File -> New File or Project -> Version Control -> Git Checkout.
    * Enter a git URL like [email protected]:/kdepim
    * accept kdepim as checkout directory
    * Type finish, see how the checkout starts
    * You will automatically come to a screen where you can run cmake
    * Continue with the step "Run cmake"
     
    == Run cmake ==
    * Enter arguments for cmake like
    <syntaxhighlight lang="bash">
    /root/kdepim -DCMAKE_INSTALL_PREFIX=/usr/local -DLIB_SUFFIX=64 -DCMAKE_BUILD_TYPE=debugfull
    </syntaxhighlight>
    <tt>DLIB_SUFFIX=64</tt> means that you want to install your libraries into directories named <tt>lib64</tt>, not <tt>lib</tt>. ''/root/kdepim'' is where your source code is.
    * click "Run cmake"
    * Note a .cbp file gets created containing many information about the build.
    * click "Finish"
     
    == Build it ==
    * Configure qtcreator to build only ktimetracker:
    Projects -> Active run configuration=ktimetracker -> build settings -> build steps -> make -> show details -> activate ktimetracker.
    * Configure qtcreator to use 8 logical processors:
    Projects -> Active run configuration=ktimetracker -> build settings -> build steps -> make -> show details -> addtional Arguments = -j8
    * Choose Build -> Build All
     
    = See also =
    * [[Development/Tutorials/Using Qt Designer]]
    * [[Getting_Started/Set_up_KDE_4_for_development#QtCreator]]
     
    [[Category:KDE4]]

    Latest revision as of 12:31, 9 February 2018

    This page is now on the community wiki.