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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
/****************************************************************************
**
** Copyright (C) 2019 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt Design Studio documentation.
**
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
**
****************************************************************************/
/*!
\previouspage studio-projects-managing.html
\page studio-projects.html
\nextpage creator-vcs-git.html
\title Creating Projects
Creating a project enables you to:
\list
\li Group files together
\li Include forms and assets files
\li Specify settings for previewing UIs
\endlist
Setting up a new project in \QDS is aided by a wizard that guides you
step-by-step through the project creation process. The wizards prompt you
to enter the settings needed for that particular type of project and create
the necessary files for you.
Studio projects are useful for creating UIs. You cannot use
them for application development, because they do not contain:
\list
\li C++ code
\li Resource files (.qrc)
\li Code needed for deploying applications to devices.
\endlist
Because the UIs do not contain any C++ code, you do not need
to build them. To test how well your designs work, you can preview the
UIs on the desktop or embedded Linux devices. For more
information, see \l{Previewing}.
\image studio-project-wizards.png "A list of project wizards"
You can export designs from other design tools and import them to projects
or create them from scratch using the following wizards:
\list
\li \uicontrol General generates projects that are suitable for all
target platforms.
\omit
\li \uicontrol Embedded generates projects that work well on embedded
Linux devices.
\endomit
\li \uicontrol Mobile generates projects that work well on mobile
devices.
\li \uicontrol Desktop generates projects that work well on the desktop.
\endlist
\section1 Using Project Wizards
\list 1
\li Select \uicontrol File > \uicontrol {New File or Project}.
\li Select the type of your project, and then select \uicontrol Choose.
\li In the \uicontrol Name field, enter a name for the project.
\li In the \uicontrol {Create in} field, enter the path for the project
files, and then select \uicontrol Next (or \uicontrol Continue on
\macos).
\li In the \uicontrol {Screen resolution} field, select the screen
resolution for previewing the UI on the desktop or on a device.
\li In the \uicontrol {Qt Quick Controls Style} field, select one of
the predefined \l{Styling Qt Quick Controls}{UI styles} to use,
and then select \uicontrol Finish (or \uicontrol Done on \macos).
\endlist
\QDS creates the following files and folders:
\list
\li .qmlproject project file defines that all QML, JavaScript, and image
files in the project folder belong to the project. Therefore, you do
not need to individually list all the files in the project.
\li .qml file defines a UI item, such as a component, screen, or the
whole UI.
\li ui.qml file defines a form for the UI.
\li qtquickcontrols2.conf file specifies the preferred style and some
style-specific arguments.
\li \e imports folder contains a \e {Constants.qml} file that specifies
a font loader for the Arial font and a \e qmldir module definition
file that declares the Constant QML type. For more information, see
\l {Module Definition qmldir Files}. In addition, the \e QtQuick
subfolder contains the Studio components and effects QML types.
\endlist
To use JavaScript and image files in the UI, copy them to the
project folder.
\section1 Adding Files to Projects
You can use wizards also to add individual files to your projects.
You can create the following types of files:
\list
\li \uicontrol {Qt Quick Files}
\list
\li \uicontrol {Qt Quick File} generates a QML type with one
of the following types as the root item: \l Item,
\l Rectangle, \l Image, \l BorderImage, \l Flickable,
\l Row, \l Column, \l Flow, or \li Grid.
\li \uicontrol {Qt Quick UI File} generates a UI form with one
of the above types as the root item.
\li \uicontrol {Qt Quick Views} generates a \l GridView or a
\l ListView.
\endlist
\li \uicontrol {Qt Quick Controls}
\list
\li \l [Qt Quick Controls 2] {Button}{Custom Button} creates a
push button with a text label.
\li \l [Qt Quick Controls 2] {Switch}{Custom Switch} creates a
switch with on and off states.
\li \l [Qt Quick Controls 2] {Pane} provides a background that
matches the UI style and theme.
\li \l [Qt Quick Controls 2] { StackView} provides a stack-based
navigation model.
\li \l [Qt Quick Controls 2] {SwipeView} enables users to
navigate pages by swiping sideways.
\endlist
\li \uicontrol {QML Files}
\list
\li \l FontLoader imports custom fonts to the project for
deployment to devices. For more information, see
\l {Using Custom Fonts}.
\li \l ListModel adds a list model to the project.
\endlist
\li \uicontrol {JavaScript File} generates files that you can use to
write the application logic. This is useful for testing the
application before the developers implement the application logic
in C++, for example. For more information, see
\l {Simulating Application Logic}.
\endlist
*/
|
