summaryrefslogtreecommitdiffstats
path: root/release-tools/dist/binary-packages/README.txt
blob: a94601aba7b516c008a7a9330188fd35e45c5f2f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

Welcome to Qt!
==============

Qt is a cross-platform application and user interface framework. It
consists of a number of software libraries and development tools.

Qt is developed as an open source project. It is available under both
open source and commercial licenses.

All information on Qt is available on the Qt Developer Network:
http://qt-project.org

Be sure to check out the release notes, which will list any known
problems or limitations of this version:
http://qt-project.org/wiki/Category:Release


Understanding the Qt packages: Have you installed the right one?
----------------------------------------------------------------

This package contains a binary distribution of Qt. It contains the the
Qt libraries and basic development tools, prebuilt for a certain
platform (operating system and compiler).

Note that this package does NOT contain Qt Creator, i.e. Qt's IDE
(Integrated Development Environment) application. If you are a
developer and you find yourself asking "How do I start Qt?", then you
should install Qt Creator, which comes in a separate package. The Qt
SDK (Software Development Kit) packages combine Qt Creator and a
binary Qt distribution in a single handy install.

This binary package is the right choice if you either
- Just need the Qt runtimes in order to run another application that
  needs them, or
- Want to try out some example programs built with Qt, or
- Intend to develop using a 3rd party IDE (e.g. MS Visual Studio), or
  just an editor and command line, in addition to Qt's basic
  development tools (Designer, Assistant, qmlscene, etc.), or
- Already have installed, or are planning to install Qt Creator


Directory structure
-------------------

The default top-level installation directory is the
directory "Qt-[version]" in your home directory.

The base directory of this particular binary distribution is something
similar to [installdir]/Desktop/Qt/[version]/[compiler]. This basedir
contains a number of subdirectories; "bin", "doc", "examples", etc.


Starting the development tools
------------------------------

The directory [basedir]/bin contains all the Qt development
tools. Most are intended to be used from command line or an IDE, but
some may be launched as standalone applications. For example:
Assistant: The Qt documentation reader
qmlscene: Viewer for Qt Quick2 declarative QML applications
QMLViewer: Viewer for Qt Quick1 declarative QML applications
Designer: GUI designer for Qt widgets-based applications.


Running the example programs
----------------------------

Ready to run example programs can be found in [basedir]/examples. The
C++ based examples can be launched directly either from command line or
your file system browser.

The QML based Quick 2 examples are in [basedir]/examples/qtdeclarative. They
can be run with the qmlscene application (ref. above).

The QML based Quick 1 examples are in [basedir]/examples/qtquick1. They
can be run with the QMLViewer application (ref. above).


Using it for developing software
--------------------------------

With Qt Creator, you can use this Qt version by selecting
Tools->Options->Build & Run->Add.., and point it to [basedir]/bin/qmake.

Otherwise, to compile C++ Qt applications, add [basedir]/include to
your build tool's search path for include files, and [basedir]/lib to
the search path for libraries.


Much more information is available at

http://qt-project.org/resources/getting_started
http://qt-project.org/doc/
http://qt-project.org


We hope you will enjoy using Qt!

- The Qt developers @ qt-project.org