Merge remote-tracking branch 'origin/8.0'
Change-Id: I37a1f78caf9ae258c6b052efa3be15b3dbcbe164
10
README.md
@@ -149,6 +149,16 @@ like Qt and LLVM, additionally run
|
|||||||
|
|
||||||
cmake --install . --prefix /path/to/qtcreator_install --component Dependencies
|
cmake --install . --prefix /path/to/qtcreator_install --component Dependencies
|
||||||
|
|
||||||
|
### Performance Analyzer
|
||||||
|
|
||||||
|
If you have not installed Qt with the Maintenance Tool, you must
|
||||||
|
either set the path to the `perfparser` executable as a value of
|
||||||
|
the `PERFPROFILER_PARSER_FILEPATH` environment variable or copy
|
||||||
|
the executable to from the Qt Creator installation directory to
|
||||||
|
the build directory. That is, copy it from
|
||||||
|
`/path/to/qtcreator_install/Tools/QtCreator/libexec/qtcreator/` to
|
||||||
|
/path/to/qtcreator_buid/libexec/qtcreator/`.
|
||||||
|
|
||||||
## Getting LLVM/Clang for the Clang Code Model
|
## Getting LLVM/Clang for the Clang Code Model
|
||||||
|
|
||||||
The Clang code model uses `Clangd` and the ClangFormat plugin depends on the
|
The Clang code model uses `Clangd` and the ClangFormat plugin depends on the
|
||||||
|
@@ -148,7 +148,7 @@ instructions:
|
|||||||
equals_value: Windows
|
equals_value: Windows
|
||||||
|
|
||||||
- type: UploadArtifact
|
- type: UploadArtifact
|
||||||
archiveDirectory: "{{.AgentWorkingDir}}"
|
archiveDirectory: "{{.AgentWorkingDir}}/qt-creator/qt-creator_build/build"
|
||||||
transferType: UploadModuleBuildArtifact
|
transferType: UploadModuleBuildArtifact
|
||||||
maxTimeInSeconds: 1800
|
maxTimeInSeconds: 1800
|
||||||
maxTimeBetweenOutput: 1800
|
maxTimeBetweenOutput: 1800
|
||||||
|
@@ -1,5 +1,11 @@
|
|||||||
type: Group
|
type: Group
|
||||||
instructions:
|
instructions:
|
||||||
|
- type: InstallBinaryArchive
|
||||||
|
relativeStoragePath: "{{.Env.MODULE_ARTIFACTS_RELATIVE_STORAGE_PATH}}/artifacts.tar.gz"
|
||||||
|
directory: "qt-creator/qt-creator_build/build"
|
||||||
|
maxTimeInSeconds: 1800
|
||||||
|
maxTimeBetweenOutput: 1800
|
||||||
|
userMessageOnFailure: "Failed to unarchive build artifacts, check logs"
|
||||||
- type: ChangeDirectory
|
- type: ChangeDirectory
|
||||||
directory: "{{.AgentWorkingDir}}/qt-creator/qt-creator_build/build"
|
directory: "{{.AgentWorkingDir}}/qt-creator/qt-creator_build/build"
|
||||||
- type: ExecuteCommand
|
- type: ExecuteCommand
|
||||||
|
@@ -66,6 +66,7 @@ make_instructions: &make_instructions
|
|||||||
test_instructions: &test_instructions
|
test_instructions: &test_instructions
|
||||||
type: Group
|
type: Group
|
||||||
instructions:
|
instructions:
|
||||||
|
- !include "{{qt-creator/qt-creator}}/provision.yaml"
|
||||||
- !include "{{qt-creator/qt-creator}}/test.yaml"
|
- !include "{{qt-creator/qt-creator}}/test.yaml"
|
||||||
|
|
||||||
instructions:
|
instructions:
|
||||||
@@ -74,6 +75,7 @@ instructions:
|
|||||||
- *make_instructions
|
- *make_instructions
|
||||||
|
|
||||||
Test:
|
Test:
|
||||||
|
- *common_environment
|
||||||
- *test_instructions
|
- *test_instructions
|
||||||
|
|
||||||
LicenseCheck:
|
LicenseCheck:
|
||||||
|
Before Width: | Height: | Size: 3.5 KiB After Width: | Height: | Size: 3.6 KiB |
BIN
doc/qtcreator/images/qtcreator-android-create-template.png
Normal file
After Width: | Height: | Size: 9.6 KiB |
Before Width: | Height: | Size: 3.8 KiB After Width: | Height: | Size: 4.2 KiB |
BIN
doc/qtcreator/images/qtcreator-docker-image-selection.png
Normal file
After Width: | Height: | Size: 23 KiB |
BIN
doc/qtcreator/images/qtcreator-docker-preferences.png
Normal file
After Width: | Height: | Size: 56 KiB |
Before Width: | Height: | Size: 25 KiB After Width: | Height: | Size: 26 KiB |
Before Width: | Height: | Size: 50 KiB After Width: | Height: | Size: 47 KiB |
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 10 KiB |
BIN
doc/qtcreator/images/qtcreator-qml-js-editing.png
Normal file
After Width: | Height: | Size: 5.8 KiB |
Before Width: | Height: | Size: 5.5 KiB After Width: | Height: | Size: 5.4 KiB |
Before Width: | Height: | Size: 33 KiB |
Before Width: | Height: | Size: 9.3 KiB After Width: | Height: | Size: 22 KiB |
Before Width: | Height: | Size: 31 KiB |
Before Width: | Height: | Size: 9.6 KiB After Width: | Height: | Size: 22 KiB |
Before Width: | Height: | Size: 52 KiB After Width: | Height: | Size: 19 KiB |
BIN
doc/qtcreator/images/qtdesigner-add-profile.png
Normal file
After Width: | Height: | Size: 7.4 KiB |
BIN
doc/qtcreator/images/qtdesigner-embedded-design.png
Normal file
After Width: | Height: | Size: 5.1 KiB |
@@ -1,6 +1,6 @@
|
|||||||
/****************************************************************************
|
/****************************************************************************
|
||||||
**
|
**
|
||||||
** Copyright (C) 2021 The Qt Company Ltd.
|
** Copyright (C) 2022 The Qt Company Ltd.
|
||||||
** Contact: https://www.qt.io/licensing/
|
** Contact: https://www.qt.io/licensing/
|
||||||
**
|
**
|
||||||
** This file is part of the Qt Creator documentation.
|
** This file is part of the Qt Creator documentation.
|
||||||
@@ -471,14 +471,23 @@
|
|||||||
|
|
||||||
The Performance Analyzer might fail to record data for the following reasons:
|
The Performance Analyzer might fail to record data for the following reasons:
|
||||||
|
|
||||||
\list 1
|
\list
|
||||||
\li Perf events may be globally disabled on your system. The
|
\li Perf events may be globally disabled on your system.
|
||||||
preconfigured \l Boot2Qt images come with perf events enabled. For
|
The preconfigured \l Boot2Qt images come with perf events enabled.
|
||||||
a custom configuration you need to make sure that the file
|
For a custom configuration you need to make sure that the file
|
||||||
\c {/proc/sys/kernel/perf_event_paranoid} contains a value smaller
|
\c {/proc/sys/kernel/perf_event_paranoid} contains a value smaller
|
||||||
than \c {2}. For maximum flexibility in recording traces you can
|
than \c {2}. For maximum flexibility in recording traces you can
|
||||||
set the value to \c {-1}. This allows any user to record any kind
|
set the value to \c {-1}. This allows any user to record any kind
|
||||||
of trace, even using raw kernel trace points.
|
of trace, even using raw kernel trace points.
|
||||||
|
|
||||||
|
The way to enable Perf events depends on your Linux distribution.
|
||||||
|
On some distributions, you can run the following command with
|
||||||
|
root (or equivalent) privileges:
|
||||||
|
|
||||||
|
\badcode
|
||||||
|
echo -e "kernel.perf_event_paranoid=-1\nkernel.kptr_restrict=0" | sudo tee /etc/sysctl.d/10-perf.conf
|
||||||
|
\endcode
|
||||||
|
|
||||||
\li The connection between the target device and the host may not be
|
\li The connection between the target device and the host may not be
|
||||||
fast enough to transfer the data produced by Perf. Try modifying
|
fast enough to transfer the data produced by Perf. Try modifying
|
||||||
the values of the \uicontrol {Stack snapshot size} or
|
the values of the \uicontrol {Stack snapshot size} or
|
||||||
@@ -501,8 +510,21 @@
|
|||||||
drives the sampling from software. After the sampling has failed,
|
drives the sampling from software. After the sampling has failed,
|
||||||
reboot the device. The kernel may have disabled important parts of
|
reboot the device. The kernel may have disabled important parts of
|
||||||
the performance counters system.
|
the performance counters system.
|
||||||
|
\li Perf might not be installed. The way to install it depends on your
|
||||||
|
Linux distribution. For example, you might try the following
|
||||||
|
commands:
|
||||||
|
|
||||||
|
\list
|
||||||
|
\li On Ubuntu 22.04:
|
||||||
|
\c {sudo apt install linux-tools-$(uname -r)}
|
||||||
|
\li On Debian:
|
||||||
|
\c {apt install linux-perf}
|
||||||
|
\endlist
|
||||||
\endlist
|
\endlist
|
||||||
|
|
||||||
Output from the helper program that processes the data is displayed in
|
Output from the helper program that processes the data is displayed in
|
||||||
\l{Viewing Output}{General Messages}.
|
\l{Viewing Output}{General Messages}.
|
||||||
|
|
||||||
|
Some information is displayed in \l {Application Output} even if the
|
||||||
|
Performance Analyzer displays error messages.
|
||||||
*/
|
*/
|
||||||
|
@@ -135,7 +135,7 @@
|
|||||||
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Analyzer >
|
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Analyzer >
|
||||||
\uicontrol {Clang Tools}.
|
\uicontrol {Clang Tools}.
|
||||||
|
|
||||||
\image qtcreator-clang-tools-options.png "Clang Tools options tab"
|
\image qtcreator-clang-tools-options.png "Clang Tools preferences"
|
||||||
|
|
||||||
\li In the \uicontrol Clang-Tidy and \uicontrol Clazy-Standalone fields,
|
\li In the \uicontrol Clang-Tidy and \uicontrol Clazy-Standalone fields,
|
||||||
set the paths to the executables to use.
|
set the paths to the executables to use.
|
||||||
|
@@ -98,8 +98,8 @@
|
|||||||
|
|
||||||
\section1 Changing Fonts and Colors
|
\section1 Changing Fonts and Colors
|
||||||
|
|
||||||
To change the default fonts and colors, select \uicontrol Tools >
|
To change the default fonts and colors, select \uicontrol Edit >
|
||||||
\uicontrol Options > \uicontrol {Text Editor} > \uicontrol {Font & Colors}.
|
\uicontrol Preferences > \uicontrol {Text Editor} > \uicontrol {Font & Colors}.
|
||||||
Create your own color scheme and select new fonts and colors for the
|
Create your own color scheme and select new fonts and colors for the
|
||||||
following results:
|
following results:
|
||||||
|
|
||||||
|
@@ -58,7 +58,7 @@
|
|||||||
For more information about analyzing applications for which you do not have
|
For more information about analyzing applications for which you do not have
|
||||||
a project, see \l{Running Valgrind Tools on External Applications}.
|
a project, see \l{Running Valgrind Tools on External Applications}.
|
||||||
|
|
||||||
To select options for the Valgrind tools, select \uicontrol Edit >
|
To set preferences for the Valgrind tools, select \uicontrol Edit >
|
||||||
\uicontrol Preferences > \uicontrol Analyzer. You can override the general
|
\uicontrol Preferences > \uicontrol Analyzer. You can override the general
|
||||||
settings for each project in the \uicontrol {Run Settings} for the project.
|
settings for each project in the \uicontrol {Run Settings} for the project.
|
||||||
|
|
||||||
|
@@ -84,7 +84,7 @@
|
|||||||
\uicontrol Android on Windows and Linux or \uicontrol {\QC} >
|
\uicontrol Android on Windows and Linux or \uicontrol {\QC} >
|
||||||
\uicontrol Preferences > \uicontrol Devices > \uicontrol Android on
|
\uicontrol Preferences > \uicontrol Devices > \uicontrol Android on
|
||||||
\macos.
|
\macos.
|
||||||
\image qtcreator-options-android-main.png "Android options"
|
\image qtcreator-options-android-main.png "Android preferences"
|
||||||
\li In the \uicontrol {JDK location} field, set the path to the JDK.
|
\li In the \uicontrol {JDK location} field, set the path to the JDK.
|
||||||
\QC checks the JDK installation and reports errors.
|
\QC checks the JDK installation and reports errors.
|
||||||
|
|
||||||
@@ -94,7 +94,7 @@
|
|||||||
\inlineimage icons/online.png
|
\inlineimage icons/online.png
|
||||||
to open the JDK download web page in the default browser.
|
to open the JDK download web page in the default browser.
|
||||||
|
|
||||||
\note We recommended using a 64-bit JDK, because the 32-bit one
|
\note We recommended using a 64-bit JDK because the 32-bit one
|
||||||
might cause issues with \c cmdline-tools, and some packages might
|
might cause issues with \c cmdline-tools, and some packages might
|
||||||
not be listed.
|
not be listed.
|
||||||
\li In the \uicontrol {Android SDK location} field, set the path to the
|
\li In the \uicontrol {Android SDK location} field, set the path to the
|
||||||
@@ -130,7 +130,7 @@
|
|||||||
\section2 Manual Setup
|
\section2 Manual Setup
|
||||||
|
|
||||||
\note We recommend that you use the latest Android SDK Command-Line Tools.
|
\note We recommend that you use the latest Android SDK Command-Line Tools.
|
||||||
Using Android SDK Tools version 25.2.5 or earlier is not supported, because
|
Using Android SDK Tools version 25.2.5 or earlier is not supported because
|
||||||
they cannot be fully integrated with \QC.
|
they cannot be fully integrated with \QC.
|
||||||
|
|
||||||
However, if the automatic setup does not meet your needs, you can download
|
However, if the automatic setup does not meet your needs, you can download
|
||||||
|
@@ -161,7 +161,7 @@
|
|||||||
|
|
||||||
\section3 Building AABs
|
\section3 Building AABs
|
||||||
|
|
||||||
For testing the application locally, use the APK format, because
|
For testing the application locally, use the APK format because
|
||||||
the package can be uploaded directly to the device and run. For
|
the package can be uploaded directly to the device and run. For
|
||||||
distribution to the Google Play store, create an AAB by selecting
|
distribution to the Google Play store, create an AAB by selecting
|
||||||
the \uicontrol {Build Android App Bundle (*.aab)} check box.
|
the \uicontrol {Build Android App Bundle (*.aab)} check box.
|
||||||
@@ -185,7 +185,7 @@
|
|||||||
verify that the future versions of your application are actually created by
|
verify that the future versions of your application are actually created by
|
||||||
you.
|
you.
|
||||||
|
|
||||||
\warning Keep the key pair in a safe place and take back up copies, because
|
\warning Keep the key pair in a safe place and take back up copies because
|
||||||
you cannot update the application if you lose the key pair.
|
you cannot update the application if you lose the key pair.
|
||||||
|
|
||||||
You can use \QC to generate a keystore and a \e {self-signed} certificate.
|
You can use \QC to generate a keystore and a \e {self-signed} certificate.
|
||||||
@@ -461,6 +461,16 @@
|
|||||||
\li Select \uicontrol Projects > \uicontrol Build >
|
\li Select \uicontrol Projects > \uicontrol Build >
|
||||||
\uicontrol {Build Android APK} > \uicontrol {Create Templates}.
|
\uicontrol {Build Android APK} > \uicontrol {Create Templates}.
|
||||||
|
|
||||||
|
\li Check the path in \uicontrol {Android package source directory}.
|
||||||
|
|
||||||
|
\image qtcreator-android-create-template.png "Create Template dialog"
|
||||||
|
|
||||||
|
\li Select \uicontrol {Copy the Gradle files to Android directory} if you
|
||||||
|
plan to extend the Java part of your Qt application.
|
||||||
|
|
||||||
|
\li Select \uicontrol Finish to copy the template files to the \c android
|
||||||
|
directory and to open the manifest file for editing.
|
||||||
|
|
||||||
\li In the \uicontrol {Package name} field, enter a valid
|
\li In the \uicontrol {Package name} field, enter a valid
|
||||||
\l{Package Names}{package name} for the application.
|
\l{Package Names}{package name} for the application.
|
||||||
For example, \c {org.example.myapplication}.
|
For example, \c {org.example.myapplication}.
|
||||||
|
@@ -61,7 +61,7 @@
|
|||||||
\endlist
|
\endlist
|
||||||
|
|
||||||
The bare metal device type accepts custom GDB commands that you specify in
|
The bare metal device type accepts custom GDB commands that you specify in
|
||||||
the device options. You can specify the commands to execute when connecting
|
the device preferences. You can specify the commands to execute when connecting
|
||||||
using a particular debug server provider.
|
using a particular debug server provider.
|
||||||
|
|
||||||
The following debug server providers are supported when using GDB:
|
The following debug server providers are supported when using GDB:
|
||||||
@@ -101,7 +101,7 @@
|
|||||||
\l{https://github.com/EmBitz/EBlink}{EBlink} is an ARM Cortex-M debug tool
|
\l{https://github.com/EmBitz/EBlink}{EBlink} is an ARM Cortex-M debug tool
|
||||||
that supports squirrel scripting, live variables, and hot-plugging.
|
that supports squirrel scripting, live variables, and hot-plugging.
|
||||||
|
|
||||||
\image qtcreator-baremetal-eblink.png "Bare metal device options for EBlink"
|
\image qtcreator-baremetal-eblink.png "Bare metal device preferences for EBlink"
|
||||||
|
|
||||||
To specify settings for \EBlink:
|
To specify settings for \EBlink:
|
||||||
|
|
||||||
@@ -138,7 +138,7 @@
|
|||||||
\l{https://www.segger.com/products/debug-probes/j-link/}{J-Link} is a line
|
\l{https://www.segger.com/products/debug-probes/j-link/}{J-Link} is a line
|
||||||
of debug probes by Segger.
|
of debug probes by Segger.
|
||||||
|
|
||||||
\image qtcreator-baremetal-jlink.png "Bare metal device options for J-Link"
|
\image qtcreator-baremetal-jlink.png "Bare metal device preferences for J-Link"
|
||||||
|
|
||||||
To specify settings for J-Link debug probes:
|
To specify settings for J-Link debug probes:
|
||||||
|
|
||||||
@@ -170,7 +170,7 @@
|
|||||||
(JTAG) facility. It enables source level debugging with the GDB compiled
|
(JTAG) facility. It enables source level debugging with the GDB compiled
|
||||||
for the ARM architecture.
|
for the ARM architecture.
|
||||||
|
|
||||||
\image qtcreator-baremetal-openocd.png "Bare metal device options for OpenOCD"
|
\image qtcreator-baremetal-openocd.png "Bare metal device preferences for OpenOCD"
|
||||||
|
|
||||||
To specify settings for \OpenOCD:
|
To specify settings for \OpenOCD:
|
||||||
|
|
||||||
@@ -196,7 +196,7 @@
|
|||||||
\l{https://www.st.com/en/development-tools/stm32-programmers.html#products}
|
\l{https://www.st.com/en/development-tools/stm32-programmers.html#products}
|
||||||
{ST-LINK Utility} is used for programming STM32 microcontrollers.
|
{ST-LINK Utility} is used for programming STM32 microcontrollers.
|
||||||
|
|
||||||
\image qtcreator-baremetal-stlink.png "Bare metal device options for St-Link"
|
\image qtcreator-baremetal-stlink.png "Bare metal device preferences for St-Link"
|
||||||
|
|
||||||
To specify settings for St-Link:
|
To specify settings for St-Link:
|
||||||
|
|
||||||
@@ -234,7 +234,7 @@
|
|||||||
|
|
||||||
\section3 uVision Simulator
|
\section3 uVision Simulator
|
||||||
|
|
||||||
\image qtcreator-baremetal-uvision-simulator.png "Bare metal device options for uVision Simulator"
|
\image qtcreator-baremetal-uvision-simulator.png "Bare metal device preferences for uVision Simulator"
|
||||||
|
|
||||||
To specify settings for uVision Simulator or uVision St-Link Debugger:
|
To specify settings for uVision Simulator or uVision St-Link Debugger:
|
||||||
|
|
||||||
@@ -251,7 +251,7 @@
|
|||||||
|
|
||||||
\section3 uVision St-Link Debugger
|
\section3 uVision St-Link Debugger
|
||||||
|
|
||||||
\image qtcreator-baremetal-uvision-st-link.png "Bare metal device options for uVision St-Link"
|
\image qtcreator-baremetal-uvision-st-link.png "Bare metal device preferences for uVision St-Link"
|
||||||
|
|
||||||
To specify settings for uVision St-Link Debugger:
|
To specify settings for uVision St-Link Debugger:
|
||||||
|
|
||||||
@@ -268,7 +268,7 @@
|
|||||||
|
|
||||||
\section1 Adding Bare Metal Devices
|
\section1 Adding Bare Metal Devices
|
||||||
|
|
||||||
\image qtcreator-baremetal-devices.png "Bare Metal device options"
|
\image qtcreator-baremetal-devices.png "Bare Metal device preferences"
|
||||||
|
|
||||||
To add a bare metal device:
|
To add a bare metal device:
|
||||||
|
|
||||||
@@ -291,7 +291,7 @@
|
|||||||
devices, select \uicontrol Edit > \uicontrol Preferences > \uicontrol Kits
|
devices, select \uicontrol Edit > \uicontrol Preferences > \uicontrol Kits
|
||||||
> \uicontrol Add. For more information, see \l{Adding Kits}.
|
> \uicontrol Add. For more information, see \l{Adding Kits}.
|
||||||
|
|
||||||
\image qtcreator-baremetal-kit.png "Kit options for Bare Metal"
|
\image qtcreator-baremetal-kit.png "Kit preferences for Bare Metal"
|
||||||
|
|
||||||
You can build applications for and run them on bare metal devices
|
You can build applications for and run them on bare metal devices
|
||||||
in the same way as for and on the desktop. For more information, see
|
in the same way as for and on the desktop. For more information, see
|
||||||
|
@@ -33,7 +33,7 @@
|
|||||||
> \uicontrol Preferences > \uicontrol Debugger. In the \uicontrol General tab,
|
> \uicontrol Preferences > \uicontrol Debugger. In the \uicontrol General tab,
|
||||||
you can specify settings that are common to all debuggers.
|
you can specify settings that are common to all debuggers.
|
||||||
|
|
||||||
\image qtcreator-debugger-general-options.png
|
\image qtcreator-debugger-general-options.png "Debugger General preferences"
|
||||||
|
|
||||||
You can customize the appearance and behavior of the debug views,
|
You can customize the appearance and behavior of the debug views,
|
||||||
\l{Specifying Breakpoint Settings}{specify settings for breakpoints},
|
\l{Specifying Breakpoint Settings}{specify settings for breakpoints},
|
||||||
@@ -74,7 +74,7 @@
|
|||||||
To specify settings for managing the GDB process, select \uicontrol Edit >
|
To specify settings for managing the GDB process, select \uicontrol Edit >
|
||||||
\uicontrol Preferences > \uicontrol Debugger > \uicontrol GDB.
|
\uicontrol Preferences > \uicontrol Debugger > \uicontrol GDB.
|
||||||
|
|
||||||
\image qtcreator-gdb-options.png "GDB options"
|
\image qtcreator-gdb-options.png "GDB preferences"
|
||||||
|
|
||||||
To specify a timeout for terminating non-responsive GDB processes, set the
|
To specify a timeout for terminating non-responsive GDB processes, set the
|
||||||
number of seconds to wait in the \uicontrol {GDB timeout} field. The default
|
number of seconds to wait in the \uicontrol {GDB timeout} field. The default
|
||||||
@@ -140,7 +140,7 @@
|
|||||||
Enabling them may negatively impact your debugging experience, so use
|
Enabling them may negatively impact your debugging experience, so use
|
||||||
them with care.
|
them with care.
|
||||||
|
|
||||||
\image qtcreator-gdb-extended-options.png "GDB Extended options"
|
\image qtcreator-gdb-extended-options.png "GDB Extended preferences"
|
||||||
|
|
||||||
To use asynchronous mode to control the inferior, select the
|
To use asynchronous mode to control the inferior, select the
|
||||||
respective check box.
|
respective check box.
|
||||||
@@ -165,7 +165,7 @@
|
|||||||
To specify settings for managing the CDB process, select \uicontrol Edit >
|
To specify settings for managing the CDB process, select \uicontrol Edit >
|
||||||
\uicontrol Preferences > \uicontrol Debugger > \uicontrol CDB.
|
\uicontrol Preferences > \uicontrol Debugger > \uicontrol CDB.
|
||||||
|
|
||||||
\image qtcreator-cdb-options.png "CDB options"
|
\image qtcreator-cdb-options.png "CDB preferences"
|
||||||
|
|
||||||
You can specify additional arguments for starting CDB in the
|
You can specify additional arguments for starting CDB in the
|
||||||
\uicontrol {Additional arguments} field.
|
\uicontrol {Additional arguments} field.
|
||||||
|
@@ -42,7 +42,7 @@
|
|||||||
specify the debugger and compiler to use for each kit, select
|
specify the debugger and compiler to use for each kit, select
|
||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol Kits.
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol Kits.
|
||||||
|
|
||||||
You need to set up the debugger only if the automatic setup fails, because
|
You need to set up the debugger only if the automatic setup fails because
|
||||||
the native debugger is missing (as is usually the case for the CDB debugger
|
the native debugger is missing (as is usually the case for the CDB debugger
|
||||||
on Windows, which you always must install yourself) or because the installed
|
on Windows, which you always must install yourself) or because the installed
|
||||||
version is not supported (for example, when your system contains no, or an
|
version is not supported (for example, when your system contains no, or an
|
||||||
|
@@ -110,8 +110,9 @@
|
|||||||
\QC checks whether the compiled program is up-to-date, and rebuilds and
|
\QC checks whether the compiled program is up-to-date, and rebuilds and
|
||||||
deploys it if the \uicontrol {Build before deploying} field is set to
|
deploys it if the \uicontrol {Build before deploying} field is set to
|
||||||
build the whole project or the application to run and the
|
build the whole project or the application to run and the
|
||||||
\uicontrol {Always deploy before running} check box is selected in the
|
\uicontrol {Always deploy before running} check box is selected in
|
||||||
\uicontrol {Build and Run} options. To debug the program without deploying
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Build & Run} >
|
||||||
|
\uicontrol General. To debug the program without deploying
|
||||||
it, select \uicontrol Debug > \uicontrol {Start Debugging} >
|
it, select \uicontrol Debug > \uicontrol {Start Debugging} >
|
||||||
\uicontrol {Start Debugging Without Deployment}.
|
\uicontrol {Start Debugging Without Deployment}.
|
||||||
|
|
||||||
@@ -674,7 +675,7 @@
|
|||||||
the bottom of the view. Output is displayed in the right pane of the
|
the bottom of the view. Output is displayed in the right pane of the
|
||||||
\uicontrol {Debugger Log} view.
|
\uicontrol {Debugger Log} view.
|
||||||
|
|
||||||
\note Usually, you do not need this feature, because \QC provides you
|
\note Usually, you do not need this feature because \QC provides you
|
||||||
with better ways to handle the task. For example, instead of using the GDB
|
with better ways to handle the task. For example, instead of using the GDB
|
||||||
\c print command from the command line, you can evaluate an expression in
|
\c print command from the command line, you can evaluate an expression in
|
||||||
the \uicontrol {Expressions} view.
|
the \uicontrol {Expressions} view.
|
||||||
@@ -900,7 +901,7 @@
|
|||||||
\uicontrol Debugger > \uicontrol {Locals & Expressions}, and enter the
|
\uicontrol Debugger > \uicontrol {Locals & Expressions}, and enter the
|
||||||
commands in the \uicontrol {Debugging Helper Customization} field.
|
commands in the \uicontrol {Debugging Helper Customization} field.
|
||||||
|
|
||||||
\image qtcreator-debugging-helper-options.png
|
\image qtcreator-debugging-helper-options.png "Locals & Expressions preferences"
|
||||||
|
|
||||||
If you receive error messages about receiving signals when using GDB, you
|
If you receive error messages about receiving signals when using GDB, you
|
||||||
can specify \l{https://sourceware.org/gdb/onlinedocs/gdb/Signals.html}
|
can specify \l{https://sourceware.org/gdb/onlinedocs/gdb/Signals.html}
|
||||||
@@ -1564,7 +1565,7 @@
|
|||||||
\l{http://wiki.ubuntu.com/SecurityTeam/Roadmap/KernelHardening#ptrace%20Protection}
|
\l{http://wiki.ubuntu.com/SecurityTeam/Roadmap/KernelHardening#ptrace%20Protection}
|
||||||
{KernelHardening}.
|
{KernelHardening}.
|
||||||
|
|
||||||
However, the usefulness of this security measure seems dubious, because this
|
However, the usefulness of this security measure seems dubious because this
|
||||||
feature can be easily disabled. With root permissions, you can disable the
|
feature can be easily disabled. With root permissions, you can disable the
|
||||||
feature temporarily by writing \c{0} into
|
feature temporarily by writing \c{0} into
|
||||||
\c{/proc/sys/kernel/yama/ptrace_scope} or permanently by changing the value
|
\c{/proc/sys/kernel/yama/ptrace_scope} or permanently by changing the value
|
||||||
|
133
doc/qtcreator/src/docker/creator-docker.qdoc
Normal file
@@ -0,0 +1,133 @@
|
|||||||
|
/****************************************************************************
|
||||||
|
**
|
||||||
|
** Copyright (C) 2022 The Qt Company Ltd.
|
||||||
|
** Contact: https://www.qt.io/licensing/
|
||||||
|
**
|
||||||
|
** This file is part of the Qt Creator 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.
|
||||||
|
**
|
||||||
|
****************************************************************************/
|
||||||
|
|
||||||
|
/*!
|
||||||
|
\page creator-adding-docker-devices.html
|
||||||
|
\previouspage creator-developing-b2qt.html
|
||||||
|
\nextpage creator-developing-generic-linux.html
|
||||||
|
|
||||||
|
\title Adding Docker Devices
|
||||||
|
|
||||||
|
You can add \l{ https://docs.docker.com/get-started/overview/}
|
||||||
|
{Docker images} as \e devices to run, debug, and analyze applications
|
||||||
|
built for the Docker container from \QC. A Docker device operates like
|
||||||
|
a virtual machine but uses less system resources at the cost of being
|
||||||
|
less flexible.
|
||||||
|
|
||||||
|
Docker support is experimental. While Linux, \macos, and Windows hosts are
|
||||||
|
supported in principle, Linux is the recommended platform.
|
||||||
|
|
||||||
|
Currently, only CMake is supported for building applications in the Docker
|
||||||
|
container.
|
||||||
|
|
||||||
|
You can run applications locally or in a compatible Docker container. To be
|
||||||
|
able to run and debug applications on Docker devices, you must install Docker
|
||||||
|
as well as add Docker devices and select them in the kit. \QC automatically
|
||||||
|
detects kits in the shared Docker directories, but you need to check that
|
||||||
|
they point to the correct kit items.
|
||||||
|
|
||||||
|
Use a wizard to search for Docker images available on your local Docker
|
||||||
|
installation and add them as devices. To access images from Docker hub or
|
||||||
|
other registries, you first need to pull the images using the
|
||||||
|
\l{https://docs.docker.com/engine/reference/commandline/pull/}{docker pull}
|
||||||
|
command. You can edit the Docker device preferences later in
|
||||||
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol Devices.
|
||||||
|
|
||||||
|
To enable the experimental Docker plugin:
|
||||||
|
|
||||||
|
\list 1
|
||||||
|
\li In \QC, select \uicontrol Help > \uicontrol {About Plugins} >
|
||||||
|
\uicontrol Utilities > \uicontrol {Docker (experimental)}.
|
||||||
|
\li Select \uicontrol {Restart Now} to restart \QC and load the plugin.
|
||||||
|
\endlist
|
||||||
|
|
||||||
|
To add a Docker image as a device:
|
||||||
|
|
||||||
|
\list 1
|
||||||
|
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Devices
|
||||||
|
> \uicontrol Devices > \uicontrol Add > \uicontrol {Docker Device}
|
||||||
|
> \uicontrol {Start Wizard} to search for images in your local Docker
|
||||||
|
installation.
|
||||||
|
\image qtcreator-docker-image-selection.png "Docker Image Selection dialog"
|
||||||
|
\li Select the Docker image to use, and then select \uicontrol OK.
|
||||||
|
\note If the Docker process is not found, make sure that Docker is
|
||||||
|
running and the Docker CLI executable is set in PATH.
|
||||||
|
\li In \uicontrol Devices, check and modify Docker device preferences.
|
||||||
|
\image qtcreator-docker-preferences.png "Docker Device preferences"
|
||||||
|
\li Select \uicontrol {Run as outside user} to use the user ID and
|
||||||
|
group ID of the user running \QC in the Docker container.
|
||||||
|
\li In \uicontrol {Paths to mount}, specify host directories to mount
|
||||||
|
into the container, such as the project directory.
|
||||||
|
\li Select \uicontrol {Auto-detect Kit Items} to generate an initial
|
||||||
|
\l{Adding Kits}{build and run kit} for the Docker device.
|
||||||
|
\endlist
|
||||||
|
|
||||||
|
\section1 Specifying Paths to Mount
|
||||||
|
|
||||||
|
You can either copy your project files into the Docker container or specify
|
||||||
|
paths to them in \uicontrol {Paths to mount}. Shared mounts are restricted
|
||||||
|
to locations in the host system that can end up in the same absolute location
|
||||||
|
in the Docker container. On Windows, mounted drives cannot be used as shared
|
||||||
|
mounts.
|
||||||
|
|
||||||
|
The paths in \uicontrol {Paths to mount} are mapped one-to-one to the Docker
|
||||||
|
container. Select \uicontrol Insert to browse directories to add. Select
|
||||||
|
\uicontrol {Delete Line} to delete the selected path or \uicontrol Clear
|
||||||
|
to delete all paths.
|
||||||
|
|
||||||
|
\section1 Auto-detecting Kit Items
|
||||||
|
|
||||||
|
Select \uicontrol {Auto-detect Kit Items} to generate an initial
|
||||||
|
\l{Adding Kits}{build and run kit} for the Docker device. You can
|
||||||
|
either set the kit items, such \l{Adding Debuggers}{debuggers} and
|
||||||
|
\l{Adding Qt Versions}{Qt version}, in PATH or install them in the
|
||||||
|
Docker container.
|
||||||
|
|
||||||
|
Select \uicontrol {Search in PATH} to detect kit items that are set in PATH.
|
||||||
|
|
||||||
|
Select \uicontrol {Search in Selected Directories} to detect kit items in
|
||||||
|
the selected directories.
|
||||||
|
|
||||||
|
To view the automatically detected kit items, select
|
||||||
|
\uicontrol {List Auto-Detected Kit Items}. To remove
|
||||||
|
them, select \uicontrol {Remove Auto-Detected Kit Items}.
|
||||||
|
|
||||||
|
\section1 Editing Docker Device Kits
|
||||||
|
|
||||||
|
Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Kits to check
|
||||||
|
that the automatically generated kit points to the appropriate kit items.
|
||||||
|
|
||||||
|
To specify build settings:
|
||||||
|
|
||||||
|
\list 1
|
||||||
|
\li Open a project for an application you want to develop for the
|
||||||
|
device.
|
||||||
|
\li Select \uicontrol Projects > \uicontrol {Build & Run} to enable
|
||||||
|
the kit that you specified above.
|
||||||
|
\endlist
|
||||||
|
|
||||||
|
Select \uicontrol Run to specify run settings. Usually, you can use
|
||||||
|
the default settings.
|
||||||
|
*/
|
@@ -53,7 +53,7 @@
|
|||||||
To specify settings for code completion, select \uicontrol Edit >
|
To specify settings for code completion, select \uicontrol Edit >
|
||||||
\uicontrol Preferences > \uicontrol {Text Editor} > \uicontrol Completion.
|
\uicontrol Preferences > \uicontrol {Text Editor} > \uicontrol Completion.
|
||||||
|
|
||||||
\image qtcreator-options-texteditor-completion.png "Text Editor Completion options"
|
\image qtcreator-options-texteditor-completion.png "Text Editor Completion preferences"
|
||||||
|
|
||||||
By default, code completion does not consider case. To apply full or
|
By default, code completion does not consider case. To apply full or
|
||||||
first-letter case-sensitivity, select \uicontrol Full or
|
first-letter case-sensitivity, select \uicontrol Full or
|
||||||
@@ -181,7 +181,7 @@
|
|||||||
\if defined(qtcreator)
|
\if defined(qtcreator)
|
||||||
The following image shows built-in C++ code snippets:
|
The following image shows built-in C++ code snippets:
|
||||||
|
|
||||||
\image qtcreator-edit-code-snippets.png "C++ snippet options"
|
\image qtcreator-edit-code-snippets.png "C++ snippet preferences"
|
||||||
\endif
|
\endif
|
||||||
|
|
||||||
The following image shows built-in QML code snippets:
|
The following image shows built-in QML code snippets:
|
||||||
@@ -257,7 +257,7 @@
|
|||||||
project containing the file that is currently open in the editor:
|
project containing the file that is currently open in the editor:
|
||||||
\c {%{CurrentDocument:Project:Name}}.
|
\c {%{CurrentDocument:Project:Name}}.
|
||||||
|
|
||||||
Use unique variable names within a snippet, because all instances of a
|
Use unique variable names within a snippet because all instances of a
|
||||||
variable are renamed when you specify a value for it.
|
variable are renamed when you specify a value for it.
|
||||||
|
|
||||||
To determine the case of values you enter in snippets, use the following
|
To determine the case of values you enter in snippets, use the following
|
||||||
|
@@ -31,7 +31,7 @@
|
|||||||
\title Indenting Text or Code
|
\title Indenting Text or Code
|
||||||
|
|
||||||
When you type text or code, it is indented automatically according to the
|
When you type text or code, it is indented automatically according to the
|
||||||
selected text editor or code style options. Select a block to indent it when
|
selected text editor or code style preferences. Select a block to indent it when
|
||||||
you press \key Tab. Press \key {Shift+Tab} to decrease the indentation. You
|
you press \key Tab. Press \key {Shift+Tab} to decrease the indentation. You
|
||||||
can disable automatic indentation.
|
can disable automatic indentation.
|
||||||
|
|
||||||
@@ -82,13 +82,13 @@
|
|||||||
the \uicontrol {Skip clean whitespace for file types} check box to
|
the \uicontrol {Skip clean whitespace for file types} check box to
|
||||||
exclude the specified file types.
|
exclude the specified file types.
|
||||||
|
|
||||||
\image qtcreator-options-text-editor-behavior.png "Text Editor Behavior options"
|
\image qtcreator-options-text-editor-behavior.png "Text Editor Behavior preferences"
|
||||||
|
|
||||||
To visualize whitespace in the editor, select \uicontrol Edit >
|
To visualize whitespace in the editor, select \uicontrol Edit >
|
||||||
\uicontrol Preferences > \uicontrol {Text Editor} > \uicontrol Display >
|
\uicontrol Preferences > \uicontrol {Text Editor} > \uicontrol Display >
|
||||||
\uicontrol {Visualize whitespace}.
|
\uicontrol {Visualize whitespace}.
|
||||||
|
|
||||||
\image qtcreator-options-text-editor-display.png "Text Editor Display options"
|
\image qtcreator-options-text-editor-display.png "Text Editor Display preferences"
|
||||||
|
|
||||||
To help you keep line length at a particular number of characters, set the
|
To help you keep line length at a particular number of characters, set the
|
||||||
number of characters in the \uicontrol {Display right margin at column}
|
number of characters in the \uicontrol {Display right margin at column}
|
||||||
@@ -106,7 +106,7 @@
|
|||||||
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol {C++}.
|
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol {C++}.
|
||||||
\li In the \uicontrol {Current settings} field, select the settings to
|
\li In the \uicontrol {Current settings} field, select the settings to
|
||||||
modify and click \uicontrol Copy.
|
modify and click \uicontrol Copy.
|
||||||
\image qtcreator-options-code-style-cpp.png "C++ Code Style options"
|
\image qtcreator-options-code-style-cpp.png "C++ Code Style preferences"
|
||||||
\li Give a name to the settings and click \uicontrol OK.
|
\li Give a name to the settings and click \uicontrol OK.
|
||||||
\li Click \uicontrol Edit to specify code style settings for the project.
|
\li Click \uicontrol Edit to specify code style settings for the project.
|
||||||
\image qtcreator-code-style-settings-edit-cpp.png "Edit Code Style dialog"
|
\image qtcreator-code-style-settings-edit-cpp.png "Edit Code Style dialog"
|
||||||
@@ -126,7 +126,7 @@
|
|||||||
\li Name getter functions.
|
\li Name getter functions.
|
||||||
\endlist
|
\endlist
|
||||||
|
|
||||||
You can use the live preview to see how the options change the indentation.
|
You can use the live preview to see how the preferences change the indentation.
|
||||||
|
|
||||||
To specify different settings for a particular project, select
|
To specify different settings for a particular project, select
|
||||||
\uicontrol Projects > \uicontrol {Code Style}.
|
\uicontrol Projects > \uicontrol {Code Style}.
|
||||||
@@ -143,7 +143,7 @@
|
|||||||
\uicontrol {Qt Quick}.
|
\uicontrol {Qt Quick}.
|
||||||
\li In the \uicontrol {Current settings} field, select the settings to
|
\li In the \uicontrol {Current settings} field, select the settings to
|
||||||
modify and click \uicontrol Copy.
|
modify and click \uicontrol Copy.
|
||||||
\image qtcreator-options-code-style-qml.png "QML Code Style options"
|
\image qtcreator-options-code-style-qml.png "QML Code Style preferences"
|
||||||
\li Give a name to the settings and click \uicontrol OK.
|
\li Give a name to the settings and click \uicontrol OK.
|
||||||
\li Click \uicontrol Edit to specify code style settings for the project.
|
\li Click \uicontrol Edit to specify code style settings for the project.
|
||||||
\image qtcreator-code-style-settings-edit-qtquick.png "Edit Code Style dialog"
|
\image qtcreator-code-style-settings-edit-qtquick.png "Edit Code Style dialog"
|
||||||
@@ -167,7 +167,7 @@
|
|||||||
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Nim.
|
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Nim.
|
||||||
\li In the \uicontrol {Current settings} field, select the settings to
|
\li In the \uicontrol {Current settings} field, select the settings to
|
||||||
modify and click \uicontrol Copy.
|
modify and click \uicontrol Copy.
|
||||||
\image qtcreator-options-code-style-nim.png "Nim Code Style options"
|
\image qtcreator-options-code-style-nim.png "Nim Code Style preferences"
|
||||||
\li Give a name to the settings and click \uicontrol OK.
|
\li Give a name to the settings and click \uicontrol OK.
|
||||||
\li Click \uicontrol Edit to specify code style settings for the project.
|
\li Click \uicontrol Edit to specify code style settings for the project.
|
||||||
\image qtcreator-code-style-settings-edit-nim.png "Edit Code Style dialog"
|
\image qtcreator-code-style-settings-edit-nim.png "Edit Code Style dialog"
|
||||||
@@ -186,7 +186,7 @@
|
|||||||
QML code (such as Python code files), select \uicontrol Edit >
|
QML code (such as Python code files), select \uicontrol Edit >
|
||||||
\uicontrol Preferences > \uicontrol {Text Editor} > \uicontrol Behavior.
|
\uicontrol Preferences > \uicontrol {Text Editor} > \uicontrol Behavior.
|
||||||
|
|
||||||
\image qtcreator-indentation.png "Text Editor Behavior options"
|
\image qtcreator-indentation.png "Text Editor Behavior preferences"
|
||||||
|
|
||||||
To specify different settings for a particular project, select
|
To specify different settings for a particular project, select
|
||||||
\uicontrol Projects > \uicontrol Editor.
|
\uicontrol Projects > \uicontrol Editor.
|
||||||
@@ -229,10 +229,10 @@
|
|||||||
select \uicontrol {With Spaces}. To follow the \uicontrol {Tab policy},
|
select \uicontrol {With Spaces}. To follow the \uicontrol {Tab policy},
|
||||||
select \uicontrol {With Regular Indent}.
|
select \uicontrol {With Regular Indent}.
|
||||||
|
|
||||||
\section1 Specifying Typing Options
|
\section1 Setting Typing Preferences
|
||||||
|
|
||||||
When you type text or code, it is indented automatically according to the
|
When you type text or code, it is indented automatically according to the
|
||||||
selected text editor or code style options. To specify typing options,
|
selected text editor or code style preferences. To set typing preferences,
|
||||||
select \uicontrol Edit > \uicontrol Preferences > \uicontrol {Text Editor} >
|
select \uicontrol Edit > \uicontrol Preferences > \uicontrol {Text Editor} >
|
||||||
\uicontrol Behavior > \uicontrol Typing.
|
\uicontrol Behavior > \uicontrol Typing.
|
||||||
|
|
||||||
@@ -266,21 +266,21 @@
|
|||||||
You can also indent statements within functions and blocks and declarations
|
You can also indent statements within functions and blocks and declarations
|
||||||
within namespaces.
|
within namespaces.
|
||||||
|
|
||||||
\image qtcreator-code-style-content.png "Content options"
|
\image qtcreator-code-style-content.png "Content preferences"
|
||||||
|
|
||||||
\section1 Specifying Settings for Braces
|
\section1 Specifying Settings for Braces
|
||||||
|
|
||||||
You can indent class, namespace, enum and function declarations and code
|
You can indent class, namespace, enum and function declarations and code
|
||||||
blocks.
|
blocks.
|
||||||
|
|
||||||
\image qtcreator-code-style-braces.png "Braces options"
|
\image qtcreator-code-style-braces.png "Braces preferences"
|
||||||
|
|
||||||
\section1 Specifying Settings for Switch Statements
|
\section1 Specifying Settings for Switch Statements
|
||||||
|
|
||||||
You can indent case or default statements, or statements or blocks related
|
You can indent case or default statements, or statements or blocks related
|
||||||
to them within switch statements.
|
to them within switch statements.
|
||||||
|
|
||||||
\image qtcreator-code-style-switch.png "Switch options"
|
\image qtcreator-code-style-switch.png "Switch preferences"
|
||||||
|
|
||||||
\section1 Specifying Alignment
|
\section1 Specifying Alignment
|
||||||
|
|
||||||
@@ -293,7 +293,7 @@
|
|||||||
aligned with the following line. Usually, this only affects \c if
|
aligned with the following line. Usually, this only affects \c if
|
||||||
statements.
|
statements.
|
||||||
|
|
||||||
\image qtcreator-code-style-alignment.png "Alignment options"
|
\image qtcreator-code-style-alignment.png "Alignment preferences"
|
||||||
|
|
||||||
\section1 Binding Pointers and References
|
\section1 Binding Pointers and References
|
||||||
|
|
||||||
@@ -304,6 +304,6 @@
|
|||||||
The \c * and \c & characters are automatically bound to identifiers of
|
The \c * and \c & characters are automatically bound to identifiers of
|
||||||
pointers to functions and pointers to arrays.
|
pointers to functions and pointers to arrays.
|
||||||
|
|
||||||
\image qtcreator-pointers-references.png "Pointers and References options"
|
\image qtcreator-pointers-references.png "Pointers and References preferences"
|
||||||
\endif
|
\endif
|
||||||
*/
|
*/
|
||||||
|
@@ -31,35 +31,25 @@
|
|||||||
\title Checking Code Syntax
|
\title Checking Code Syntax
|
||||||
|
|
||||||
As you write code, \QC checks code syntax. When \QC spots a syntax error in
|
As you write code, \QC checks code syntax. When \QC spots a syntax error in
|
||||||
your code it underlines it and shows error details when you move the mouse
|
your code, it underlines it, displays an icon, and shows error details when
|
||||||
pointer over the error. Similarly, when you are working on an instance of a
|
you move the mouse pointer over the error or the icon. If a fix is available,
|
||||||
JavaScript object notation (JSON) entity, \QC underlines errors in JSON data
|
you can apply it by clicking \inlineimage icons/refactormarker.png
|
||||||
structure.
|
.
|
||||||
|
|
||||||
|
Similarly, when you are working on an instance of a JavaScript object
|
||||||
|
notation (JSON) entity, \QC underlines errors in the JSON data structure.
|
||||||
|
|
||||||
\if defined(qtcreator)
|
\if defined(qtcreator)
|
||||||
In the following screenshot, \QC points out an error, because a semicolon is
|
In the following screenshot, \QC annotates an error because a semicolon is
|
||||||
missing at the end of the line:
|
missing at the end of the line:
|
||||||
|
|
||||||
\image qtcreator-syntaxerror.png
|
\image qtcreator-syntaxerror.png
|
||||||
|
|
||||||
In the following screenshot, \QC issues a warning, because the variable is
|
In the following screenshot, \QC issues a warning because the variable is
|
||||||
not used:
|
not used:
|
||||||
|
|
||||||
\image qtcreator-semanticerror.png
|
\image qtcreator-semanticerror.png
|
||||||
|
|
||||||
To modify the colors used for underlining errors and warnings, select
|
|
||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Text Editor} >
|
|
||||||
\uicontrol {Font & Colors} > \uicontrol Copy, and select new colors for
|
|
||||||
\uicontrol Error and \uicontrol Warning.
|
|
||||||
|
|
||||||
\section1 Viewing Annotations
|
|
||||||
|
|
||||||
When using the Clang code model, errors and warnings are additionally marked
|
|
||||||
with icons and annotated. If a \l{http://clang.llvm.org/diagnostics.html}
|
|
||||||
{Clang fix-it} is available, you can execute it by clicking the
|
|
||||||
\inlineimage icons/refactormarker.png
|
|
||||||
icon and pressing \key Enter.
|
|
||||||
|
|
||||||
In the following screenshot, a Qt class name contains a typo:
|
In the following screenshot, a Qt class name contains a typo:
|
||||||
|
|
||||||
\image qtcreator-typo-clang.png
|
\image qtcreator-typo-clang.png
|
||||||
@@ -69,14 +59,10 @@
|
|||||||
the \uicontrol {Annotation Settings} link to specify the position
|
the \uicontrol {Annotation Settings} link to specify the position
|
||||||
of the line annotations.
|
of the line annotations.
|
||||||
|
|
||||||
In the following screenshot, a semicolon is missing at the end of the
|
To modify the colors used for underlining errors and warnings, select
|
||||||
line.
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Text Editor} >
|
||||||
|
\uicontrol {Font & Colors} > \uicontrol Copy, and select new colors for
|
||||||
\image qtcreator-syntaxerror-clang.png
|
\uicontrol Error and \uicontrol Warning.
|
||||||
|
|
||||||
In the following screenshot, the variable is not used.
|
|
||||||
|
|
||||||
\image qtcreator-semanticerror-clang.png
|
|
||||||
|
|
||||||
\else
|
\else
|
||||||
In addition to underlining, errors and warnings are marked with icons and
|
In addition to underlining, errors and warnings are marked with icons and
|
||||||
@@ -87,7 +73,7 @@
|
|||||||
|
|
||||||
\image qml-syntax-check.png
|
\image qml-syntax-check.png
|
||||||
|
|
||||||
\section2 Specifying Line Annotation Positions
|
\section1 Specifying Line Annotation Positions
|
||||||
|
|
||||||
To specify the position where the annotations are displayed, select
|
To specify the position where the annotations are displayed, select
|
||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Text Editor} >
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Text Editor} >
|
||||||
@@ -97,7 +83,7 @@
|
|||||||
between lines can be useful if there is usually not enough space to
|
between lines can be useful if there is usually not enough space to
|
||||||
display annotations next to the text.
|
display annotations next to the text.
|
||||||
|
|
||||||
\image qtcreator-options-text-editor-display.png "Text Editor Display options"
|
\image qtcreator-options-text-editor-display.png "Text Editor Display preferences"
|
||||||
|
|
||||||
If you hide the annotations by deselecting the check box, you can move the
|
If you hide the annotations by deselecting the check box, you can move the
|
||||||
mouse pointer over an icon to view them.
|
mouse pointer over an icon to view them.
|
||||||
@@ -750,4 +736,6 @@
|
|||||||
To automatically format QML/JS files upon saving, select \uicontrol Edit >
|
To automatically format QML/JS files upon saving, select \uicontrol Edit >
|
||||||
\uicontrol Preferences > \uicontrol {Qt Quick} > \uicontrol {QML/JS Editing} >
|
\uicontrol Preferences > \uicontrol {Qt Quick} > \uicontrol {QML/JS Editing} >
|
||||||
\uicontrol {Enable auto format on file save}.
|
\uicontrol {Enable auto format on file save}.
|
||||||
|
|
||||||
|
\image qtcreator-qml-js-editing.png "QML/JS Editing preferences"
|
||||||
*/
|
*/
|
||||||
|
@@ -124,7 +124,7 @@
|
|||||||
|
|
||||||
To change the default colors, select \uicontrol Edit > \uicontrol Preferences >
|
To change the default colors, select \uicontrol Edit > \uicontrol Preferences >
|
||||||
\uicontrol {Text Editor} > \uicontrol {Font & Colors}. Create your own color
|
\uicontrol {Text Editor} > \uicontrol {Font & Colors}. Create your own color
|
||||||
scheme and select new colors for the following options:
|
scheme and select new colors for the following items:
|
||||||
|
|
||||||
\list
|
\list
|
||||||
|
|
||||||
|
@@ -42,10 +42,10 @@
|
|||||||
|
|
||||||
Set the font preferences and apply color schemes for syntax highlighting,
|
Set the font preferences and apply color schemes for syntax highlighting,
|
||||||
diff editor, and code analysis results in \uicontrol Edit >
|
diff editor, and code analysis results in \uicontrol Edit >
|
||||||
\uicontrol Preferences\uicontrol Tools > \uicontrol {Text Editor} >
|
\uicontrol Preferences > \uicontrol {Text Editor} >
|
||||||
\uicontrol {Font & Colors}.
|
\uicontrol {Font & Colors}.
|
||||||
|
|
||||||
\image qtcreator-font-colors.png "Text editor options"
|
\image qtcreator-font-colors.png "Text editor preferences"
|
||||||
|
|
||||||
\section2 Configuring Fonts
|
\section2 Configuring Fonts
|
||||||
|
|
||||||
@@ -120,7 +120,7 @@
|
|||||||
\uicontrol Preferences > \uicontrol {Text Editor} > \uicontrol Behavior, and
|
\uicontrol Preferences > \uicontrol {Text Editor} > \uicontrol Behavior, and
|
||||||
then select a suitable option in \uicontrol {Default encoding}.
|
then select a suitable option in \uicontrol {Default encoding}.
|
||||||
|
|
||||||
\image qtcreator-options-texteditor-behavior-file-encodings.png "File encoding options"
|
\image qtcreator-options-texteditor-behavior-file-encodings.png "File encoding preferences"
|
||||||
|
|
||||||
Qt 5 and Qt 6 require UTF-8 encoded source files, and therefore the default
|
Qt 5 and Qt 6 require UTF-8 encoded source files, and therefore the default
|
||||||
encoding is set to \uicontrol UTF-8.
|
encoding is set to \uicontrol UTF-8.
|
||||||
|
@@ -43,7 +43,7 @@
|
|||||||
You can configure the text editor to suit your specific needs by selecting
|
You can configure the text editor to suit your specific needs by selecting
|
||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol{Text Editor}.
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol{Text Editor}.
|
||||||
|
|
||||||
\image qtcreator-font-colors.png "Text Editor options"
|
\image qtcreator-font-colors.png "Text Editor preferences"
|
||||||
|
|
||||||
The settings you specify apply globally to all projects.
|
The settings you specify apply globally to all projects.
|
||||||
|
|
||||||
|
@@ -247,7 +247,7 @@
|
|||||||
|
|
||||||
\li In the locator, click \inlineimage icons/magnifier.png
|
\li In the locator, click \inlineimage icons/magnifier.png
|
||||||
(\uicontrol Options) and select \uicontrol Configure to open the
|
(\uicontrol Options) and select \uicontrol Configure to open the
|
||||||
\uicontrol Locator options.
|
\uicontrol Locator preferences.
|
||||||
|
|
||||||
\li Select a filter, and then select \uicontrol Edit.
|
\li Select a filter, and then select \uicontrol Edit.
|
||||||
|
|
||||||
@@ -256,7 +256,7 @@
|
|||||||
\li To implicitly include the filter even when not typing a prefix as a
|
\li To implicitly include the filter even when not typing a prefix as a
|
||||||
part of the search string, select \uicontrol {Include by default}.
|
part of the search string, select \uicontrol {Include by default}.
|
||||||
|
|
||||||
\li Specify other available options. For more information, see
|
\li Set other available preferences. For more information, see
|
||||||
\l{Adding Web Search Engines}.
|
\l{Adding Web Search Engines}.
|
||||||
|
|
||||||
\endlist
|
\endlist
|
||||||
@@ -305,9 +305,9 @@
|
|||||||
\list 1
|
\list 1
|
||||||
|
|
||||||
\li In the locator, select \uicontrol Options >
|
\li In the locator, select \uicontrol Options >
|
||||||
\uicontrol Configure to open the \uicontrol Locator options.
|
\uicontrol Configure to open the \uicontrol Locator preferences.
|
||||||
|
|
||||||
\image qtcreator-locator-customize.png "Locator options tab"
|
\image qtcreator-locator-customize.png "Locator preferences"
|
||||||
|
|
||||||
\li Select \uicontrol Add > \uicontrol {Files in Directories} to add
|
\li Select \uicontrol Add > \uicontrol {Files in Directories} to add
|
||||||
a directory filter or \uicontrol {URL Template} to add a URL
|
a directory filter or \uicontrol {URL Template} to add a URL
|
||||||
|
@@ -51,7 +51,7 @@
|
|||||||
|
|
||||||
The Beautifier plugin parses the source code into component structures, such
|
The Beautifier plugin parses the source code into component structures, such
|
||||||
as assignment statements, if blocks, loops, and so on, and formats them as
|
as assignment statements, if blocks, loops, and so on, and formats them as
|
||||||
specified in the Beautifier options. You can use a predefined style or
|
specified in the Beautifier preferences. You can use a predefined style or
|
||||||
define your own style.
|
define your own style.
|
||||||
|
|
||||||
To use the Beautifier plugin:
|
To use the Beautifier plugin:
|
||||||
@@ -82,7 +82,7 @@
|
|||||||
automatically beautify files when you save them using the tool you
|
automatically beautify files when you save them using the tool you
|
||||||
select in the \uicontrol Tool field.
|
select in the \uicontrol Tool field.
|
||||||
|
|
||||||
\image qt-creator-beautifier-options-general.png "General Beautifier options"
|
\image qt-creator-beautifier-options-general.png "General Beautifier preferences"
|
||||||
|
|
||||||
\li In the \uicontrol {Restrict to MIME types} field, define the MIME
|
\li In the \uicontrol {Restrict to MIME types} field, define the MIME
|
||||||
types of the files to beautify, separated by semicolons. Leave the
|
types of the files to beautify, separated by semicolons. Leave the
|
||||||
@@ -101,7 +101,7 @@
|
|||||||
\uicontrol Uncrustify to specify settings for the tool you want to
|
\uicontrol Uncrustify to specify settings for the tool you want to
|
||||||
use.
|
use.
|
||||||
|
|
||||||
\image beautifier_options.png "Uncrustify Beautifier options"
|
\image beautifier_options.png "Uncrustify Beautifier preferences"
|
||||||
|
|
||||||
\li In the \uicontrol Configuration group, specify the path to
|
\li In the \uicontrol Configuration group, specify the path to
|
||||||
the tool executable in the \uicontrol {Artistic Style command},
|
the tool executable in the \uicontrol {Artistic Style command},
|
||||||
@@ -140,7 +140,7 @@
|
|||||||
button, and then selecting the style to use from the list of
|
button, and then selecting the style to use from the list of
|
||||||
available styles.
|
available styles.
|
||||||
|
|
||||||
\image qtcreator-beautifier-options-clangformat.png "Clang Format Beautifier options"
|
\image qtcreator-beautifier-options-clangformat.png "Clang Format Beautifier preferences"
|
||||||
|
|
||||||
Select \uicontrol File to load the style configuration from
|
Select \uicontrol File to load the style configuration from
|
||||||
the \c .clang-format or \c _clang-format file located in the
|
the \c .clang-format or \c _clang-format file located in the
|
||||||
|
@@ -127,7 +127,7 @@
|
|||||||
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol C++ >
|
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol C++ >
|
||||||
\uicontrol {Code Model}.
|
\uicontrol {Code Model}.
|
||||||
|
|
||||||
\image qtcreator-clang-code-model-options.png
|
\image qtcreator-clang-code-model-options.png "C++ Code Model preferences"
|
||||||
|
|
||||||
\li To instruct the code model to interpret ambiguous header files as C
|
\li To instruct the code model to interpret ambiguous header files as C
|
||||||
language files if you develop mainly using C, select the
|
language files if you develop mainly using C, select the
|
||||||
@@ -163,7 +163,7 @@
|
|||||||
\list 1
|
\list 1
|
||||||
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol C++ >
|
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol C++ >
|
||||||
\uicontrol Clangd > \uicontrol {Use clangd}.
|
\uicontrol Clangd > \uicontrol {Use clangd}.
|
||||||
\image qtcreator-options-clangd.png "clangd options"
|
\image qtcreator-options-clangd.png "clangd preferences"
|
||||||
\li In \uicontrol {Path to executable}, enter the path to clangd
|
\li In \uicontrol {Path to executable}, enter the path to clangd
|
||||||
version 13, or later.
|
version 13, or later.
|
||||||
\li For more accurate results during global symbol searches, select
|
\li For more accurate results during global symbol searches, select
|
||||||
|
@@ -47,7 +47,7 @@
|
|||||||
\list 1
|
\list 1
|
||||||
\li Select \uicontrol Edit > \uicontrol Preferences >
|
\li Select \uicontrol Edit > \uicontrol Preferences >
|
||||||
\uicontrol {Code Pasting}.
|
\uicontrol {Code Pasting}.
|
||||||
\image qtcreator-code-pasting-options.png "Code Pasting options"
|
\image qtcreator-code-pasting-options.png "Code Pasting preferences"
|
||||||
\li In the \uicontrol {Default protocol} field, select a code pasting
|
\li In the \uicontrol {Default protocol} field, select a code pasting
|
||||||
service to use by default.
|
service to use by default.
|
||||||
\li In the \uicontrol Username field, enter your username.
|
\li In the \uicontrol Username field, enter your username.
|
||||||
|
@@ -118,7 +118,7 @@
|
|||||||
for particular plugins, select \uicontrol Edit > \uicontrol Preferences >
|
for particular plugins, select \uicontrol Edit > \uicontrol Preferences >
|
||||||
\uicontrol FakeVim > \uicontrol General > \uicontrol {Plugin Emulation}.
|
\uicontrol FakeVim > \uicontrol General > \uicontrol {Plugin Emulation}.
|
||||||
|
|
||||||
\image qtcreator-fakevim-options-general-plugin-emulation.png "FakeVim Plugin Emulation options"
|
\image qtcreator-fakevim-options-general-plugin-emulation.png "FakeVim Plugin Emulation preferences"
|
||||||
|
|
||||||
Currently emulated plugins:
|
Currently emulated plugins:
|
||||||
\list
|
\list
|
||||||
@@ -296,7 +296,7 @@
|
|||||||
Enter a string in the \uicontrol Filter field to search for a specific
|
Enter a string in the \uicontrol Filter field to search for a specific
|
||||||
\QC function.
|
\QC function.
|
||||||
|
|
||||||
\image qtcreator-fakevim-options-ex-command-mapping.png "FakeVim Ex Command Mapping options"
|
\image qtcreator-fakevim-options-ex-command-mapping.png "FakeVim Ex Command Mapping preferences"
|
||||||
|
|
||||||
Select a function in the list, and enter a string that will trigger the
|
Select a function in the list, and enter a string that will trigger the
|
||||||
function in the \uicontrol {Regular expression} field. You can view the
|
function in the \uicontrol {Regular expression} field. You can view the
|
||||||
@@ -311,14 +311,14 @@
|
|||||||
\uicontrol {User Command Mapping}. The user command mapped to the shortcut
|
\uicontrol {User Command Mapping}. The user command mapped to the shortcut
|
||||||
is executed by FakeVim as if you were typing it (as when replaying a macro).
|
is executed by FakeVim as if you were typing it (as when replaying a macro).
|
||||||
|
|
||||||
\image qtcreator-fakevim-options-user-command-mapping.png "FakeVim User Command Mapping options"
|
\image qtcreator-fakevim-options-user-command-mapping.png "FakeVim User Command Mapping preferences"
|
||||||
|
|
||||||
\section1 Specifying FakeVim Options
|
\section1 Setting FakeVim Preferences
|
||||||
|
|
||||||
To make changes to the Vim-style settings, select \uicontrol Edit >
|
To make changes to the Vim-style settings, select \uicontrol Edit >
|
||||||
\uicontrol Preferences > \uicontrol FakeVim > \uicontrol General.
|
\uicontrol Preferences > \uicontrol FakeVim > \uicontrol General.
|
||||||
|
|
||||||
\image qtcreator-fakevim-options.png "FakeVim options"
|
\image qtcreator-fakevim-options.png "FakeVim preferences"
|
||||||
|
|
||||||
To preselect the indentation settings specified for the text editor, select
|
To preselect the indentation settings specified for the text editor, select
|
||||||
\uicontrol {Copy Text Editor Settings}. To preselect the Qt coding style,
|
\uicontrol {Copy Text Editor Settings}. To preselect the Qt coding style,
|
||||||
|
@@ -189,7 +189,7 @@
|
|||||||
\image qtcreator-language-client-inspector-log.png "Language Client Inspector dialog"
|
\image qtcreator-language-client-inspector-log.png "Language Client Inspector dialog"
|
||||||
|
|
||||||
The dialog shows a list of running language servers. The value of the
|
The dialog shows a list of running language servers. The value of the
|
||||||
\uicontrol {Startup behavior} field in the language server options
|
\uicontrol {Startup behavior} field in the language server preferences
|
||||||
determines when the server is started. The information displayed depends on
|
determines when the server is started. The information displayed depends on
|
||||||
the language server.
|
the language server.
|
||||||
|
|
||||||
|
@@ -99,7 +99,7 @@
|
|||||||
numerical types, whereas masks for strings must be in base 16, and
|
numerical types, whereas masks for strings must be in base 16, and
|
||||||
start with 0x.
|
start with 0x.
|
||||||
|
|
||||||
\note You are recommended not to change the range and priority,
|
\note You are recommended not to change the range and priority
|
||||||
because it might cause problems when opening files in \QC.
|
because it might cause problems when opening files in \QC.
|
||||||
|
|
||||||
\li Click \uicontrol OK to return to the \uicontrol {MIME Types} tab.
|
\li Click \uicontrol OK to return to the \uicontrol {MIME Types} tab.
|
||||||
|
@@ -1,6 +1,6 @@
|
|||||||
/****************************************************************************
|
/****************************************************************************
|
||||||
**
|
**
|
||||||
** Copyright (C) 2021 The Qt Company Ltd.
|
** Copyright (C) 2022 The Qt Company Ltd.
|
||||||
** Contact: https://www.qt.io/licensing/
|
** Contact: https://www.qt.io/licensing/
|
||||||
**
|
**
|
||||||
** This file is part of the Qt Creator documentation.
|
** This file is part of the Qt Creator documentation.
|
||||||
@@ -109,12 +109,13 @@
|
|||||||
|
|
||||||
To specify custom settings for a particular project, select
|
To specify custom settings for a particular project, select
|
||||||
\uicontrol Projects > \uicontrol {Project Settings} >
|
\uicontrol Projects > \uicontrol {Project Settings} >
|
||||||
\uicontrol {Quick Fixes} > \uicontrol {Custom Settings}.
|
\uicontrol {Quick Fixes}, and then deselect \uicontrol {Use global settings}.
|
||||||
|
|
||||||
\image qtcreator-refactoring-options-locations.png "Quick Fixes settings"
|
\image qtcreator-refactoring-options-locations.png "Quick Fixes settings"
|
||||||
|
|
||||||
To revert to global settings, select \uicontrol {Reset to Global}. To
|
To revert to global settings, select \uicontrol {Reset to Global}. To
|
||||||
delete the custom settings, select \uicontrol {Delete Custom Settings File}.
|
delete the custom settings, select \uicontrol {Use global settings}, and
|
||||||
|
then select \uicontrol {Delete Custom Settings File}.
|
||||||
|
|
||||||
\section2 Function Locations
|
\section2 Function Locations
|
||||||
|
|
||||||
|
@@ -81,7 +81,7 @@
|
|||||||
> \uicontrol {Generic Highlighter} and add the pattern to the
|
> \uicontrol {Generic Highlighter} and add the pattern to the
|
||||||
\uicontrol {Ignored file patterns} field.
|
\uicontrol {Ignored file patterns} field.
|
||||||
|
|
||||||
\image qtcreator-syntax-highlighter.png "Generic Highlighter options"
|
\image qtcreator-syntax-highlighter.png "Generic Highlighter preferences"
|
||||||
|
|
||||||
If you have written your own syntax definition files, you
|
If you have written your own syntax definition files, you
|
||||||
can provide an additional definition search path in the
|
can provide an additional definition search path in the
|
||||||
@@ -109,7 +109,7 @@
|
|||||||
\uicontrol {Text Editor} > \uicontrol Display >
|
\uicontrol {Text Editor} > \uicontrol Display >
|
||||||
\uicontrol {Display folding markers}. This option is enabled by default.
|
\uicontrol {Display folding markers}. This option is enabled by default.
|
||||||
|
|
||||||
\image qtcreator-options-text-editor-display.png "Text Editor Display options"
|
\image qtcreator-options-text-editor-display.png "Text Editor Display preferences"
|
||||||
|
|
||||||
When the cursor is on a brace, the matching brace is animated by default. To
|
When the cursor is on a brace, the matching brace is animated by default. To
|
||||||
turn off the animation and just highlight the block and the braces, select
|
turn off the animation and just highlight the block and the braces, select
|
||||||
@@ -128,5 +128,5 @@
|
|||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Text Editor} >
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Text Editor} >
|
||||||
\uicontrol Behavior > \uicontrol {Enable smart selection changing}.
|
\uicontrol Behavior > \uicontrol {Enable smart selection changing}.
|
||||||
|
|
||||||
\image qtcreator-options-text-editor-behavior.png "Text Editor Behavior options"
|
\image qtcreator-options-text-editor-behavior.png "Text Editor Behavior preferences"
|
||||||
*/
|
*/
|
||||||
|
@@ -69,7 +69,7 @@
|
|||||||
family, style, and size in \uicontrol Edit > \uicontrol Preferences >
|
family, style, and size in \uicontrol Edit > \uicontrol Preferences >
|
||||||
\uicontrol Help > \uicontrol General.
|
\uicontrol Help > \uicontrol General.
|
||||||
|
|
||||||
\image qtcreator-help-options.png
|
\image qtcreator-help-options.png "Help General preferences"
|
||||||
|
|
||||||
You can set the default zoom level in the \uicontrol Zoom field. When
|
You can set the default zoom level in the \uicontrol Zoom field. When
|
||||||
viewing help pages, you can use the mouse scroll wheel to zoom them. To
|
viewing help pages, you can use the mouse scroll wheel to zoom them. To
|
||||||
@@ -235,7 +235,7 @@
|
|||||||
> \uicontrol {On help start} field.
|
> \uicontrol {On help start} field.
|
||||||
To display the page and help views that were open when you exited the mode,
|
To display the page and help views that were open when you exited the mode,
|
||||||
select the \uicontrol {Show My Tabs from Last Session} option. However, Web pages
|
select the \uicontrol {Show My Tabs from Last Session} option. However, Web pages
|
||||||
are not opened, because loading them would slow down opening the \uicontrol Help
|
are not opened because loading them would slow down opening the \uicontrol Help
|
||||||
mode.
|
mode.
|
||||||
|
|
||||||
To display a particular page, select \uicontrol {Show My Home Page}, and specify
|
To display a particular page, select \uicontrol {Show My Home Page}, and specify
|
||||||
@@ -264,7 +264,7 @@
|
|||||||
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Help >
|
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Help >
|
||||||
\uicontrol Filters.
|
\uicontrol Filters.
|
||||||
|
|
||||||
\image qtcreator-help-filter-attributes.png "Filters tab in Help options"
|
\image qtcreator-help-filter-attributes.png "Filters tab in Help preferences"
|
||||||
|
|
||||||
\li Select \inlineimage icons/plus.png
|
\li Select \inlineimage icons/plus.png
|
||||||
to add a new filter in the \uicontrol {Add Filter} dialog.
|
to add a new filter in the \uicontrol {Add Filter} dialog.
|
||||||
|
@@ -80,7 +80,7 @@
|
|||||||
in context menus} check box indicates whether the platform default value
|
in context menus} check box indicates whether the platform default value
|
||||||
is \c on or \c off.
|
is \c on or \c off.
|
||||||
|
|
||||||
\image qtcreator-options-environment-interface.png "Interface tab in the Environment options"
|
\image qtcreator-options-environment-interface.png "Interface tab in the Environment preferences"
|
||||||
|
|
||||||
\section1 Configuring Keyboard Shortcuts
|
\section1 Configuring Keyboard Shortcuts
|
||||||
|
|
||||||
|
@@ -418,7 +418,7 @@
|
|||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Testing} >
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Testing} >
|
||||||
\uicontrol General.
|
\uicontrol General.
|
||||||
|
|
||||||
\image qtcreator-autotests-options.png
|
\image qtcreator-autotests-options.png "Testing General preferences"
|
||||||
|
|
||||||
You can customize some settings at project level. To change settings
|
You can customize some settings at project level. To change settings
|
||||||
for the current project instead of globally, select \uicontrol Projects >
|
for the current project instead of globally, select \uicontrol Projects >
|
||||||
@@ -541,7 +541,7 @@
|
|||||||
\li To specify settings for running Catch2 tests, select
|
\li To specify settings for running Catch2 tests, select
|
||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Testing} >
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Testing} >
|
||||||
\uicontrol {Catch Test}.
|
\uicontrol {Catch Test}.
|
||||||
\image qtcreator-autotests-options-catch2.png "Catch Test options"
|
\image qtcreator-autotests-options-catch2.png "Catch Test preferences"
|
||||||
\li Select the \uicontrol {Show success} check box to show succeeding
|
\li Select the \uicontrol {Show success} check box to show succeeding
|
||||||
expressions as well. By default Catch2 will print only fails.
|
expressions as well. By default Catch2 will print only fails.
|
||||||
\li Select the \uicontrol {Break on failure while debugging} check box
|
\li Select the \uicontrol {Break on failure while debugging} check box
|
||||||
@@ -573,7 +573,7 @@
|
|||||||
\li To specify settings for running CTest-based tests, select
|
\li To specify settings for running CTest-based tests, select
|
||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Testing} >
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Testing} >
|
||||||
\uicontrol {CTest}.
|
\uicontrol {CTest}.
|
||||||
\image qtcreator-autotests-options-ctest.png "CTest options"
|
\image qtcreator-autotests-options-ctest.png "CTest preferences"
|
||||||
\li Select the \uicontrol {Output on failure} check box to show test
|
\li Select the \uicontrol {Output on failure} check box to show test
|
||||||
specific output if a test fails. Contrary to the CTest default
|
specific output if a test fails. Contrary to the CTest default
|
||||||
this is enabled by default.
|
this is enabled by default.
|
||||||
|
@@ -319,7 +319,7 @@
|
|||||||
\li The common solution is to give the user the ability to reorder
|
\li The common solution is to give the user the ability to reorder
|
||||||
tabs. Now user has to manage tabs instead of writing code.
|
tabs. Now user has to manage tabs instead of writing code.
|
||||||
|
|
||||||
\li Tabs force you to limit the amount of open editors, because
|
\li Tabs force you to limit the amount of open editors because
|
||||||
otherwise you get confused.
|
otherwise you get confused.
|
||||||
|
|
||||||
\endlist
|
\endlist
|
||||||
|
@@ -65,7 +65,7 @@
|
|||||||
|
|
||||||
\image qtcreator-incredibuild-build-steps-linux.png
|
\image qtcreator-incredibuild-build-steps-linux.png
|
||||||
|
|
||||||
You can specify the following options for Linux builds:
|
You can specify the following settings for Linux builds:
|
||||||
|
|
||||||
\list
|
\list
|
||||||
\li \uicontrol {Nice value} is a numeric value between -20 and 19
|
\li \uicontrol {Nice value} is a numeric value between -20 and 19
|
||||||
@@ -78,7 +78,7 @@
|
|||||||
|
|
||||||
\image qtcreator-incredibuild-build-steps-windows.png
|
\image qtcreator-incredibuild-build-steps-windows.png
|
||||||
|
|
||||||
You can specify the following options for Windows builds:
|
You can specify the following settings for Windows builds:
|
||||||
|
|
||||||
\list
|
\list
|
||||||
\li \uicontrol {Profile.xml} defines how Automatic Interception
|
\li \uicontrol {Profile.xml} defines how Automatic Interception
|
||||||
|
@@ -113,7 +113,7 @@
|
|||||||
|
|
||||||
\endlist
|
\endlist
|
||||||
|
|
||||||
\note If you cannot deploy applications, because a provisioning profile is
|
\note If you cannot deploy applications because a provisioning profile is
|
||||||
missing, check that provisioning profiles are listed in Xcode by selecting
|
missing, check that provisioning profiles are listed in Xcode by selecting
|
||||||
\uicontrol Xcode > \uicontrol Preferences > \uicontrol Accounts. For more
|
\uicontrol Xcode > \uicontrol Preferences > \uicontrol Accounts. For more
|
||||||
information about how to acquire and install a provisioning profile, see
|
information about how to acquire and install a provisioning profile, see
|
||||||
|
@@ -26,7 +26,7 @@
|
|||||||
/*!
|
/*!
|
||||||
\page creator-developing-b2qt.html
|
\page creator-developing-b2qt.html
|
||||||
\previouspage creator-developing-baremetal.html
|
\previouspage creator-developing-baremetal.html
|
||||||
\nextpage creator-developing-generic-linux.html
|
\nextpage creator-adding-docker-devices.html
|
||||||
|
|
||||||
\title Connecting Boot2Qt Devices
|
\title Connecting Boot2Qt Devices
|
||||||
|
|
||||||
|
@@ -44,7 +44,7 @@
|
|||||||
directories where the tools are installed in \uicontrol Edit >
|
directories where the tools are installed in \uicontrol Edit >
|
||||||
\uicontrol Preferences > \uicontrol Devices > \uicontrol SSH:
|
\uicontrol Preferences > \uicontrol Devices > \uicontrol SSH:
|
||||||
|
|
||||||
\image qtcreator-ssh-options.png
|
\image qtcreator-ssh-options.png "SSH preferences"
|
||||||
|
|
||||||
\list
|
\list
|
||||||
\li Deselect the \uicontrol {Enable connection sharing} check box to
|
\li Deselect the \uicontrol {Enable connection sharing} check box to
|
||||||
|
@@ -29,7 +29,7 @@
|
|||||||
\previouspage creator-developing-android.html
|
\previouspage creator-developing-android.html
|
||||||
\nextpage studio-advanced.html
|
\nextpage studio-advanced.html
|
||||||
\else
|
\else
|
||||||
\previouspage creator-developing-b2qt.html
|
\previouspage creator-adding-docker-devices.html
|
||||||
\nextpage creator-developing-ios.html
|
\nextpage creator-developing-ios.html
|
||||||
\endif
|
\endif
|
||||||
|
|
||||||
|
@@ -85,7 +85,7 @@
|
|||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol Devices >
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol Devices >
|
||||||
\uicontrol MCU:
|
\uicontrol MCU:
|
||||||
|
|
||||||
\image qtcreator-mcu-options.png "MCU options"
|
\image qtcreator-mcu-options.png "MCU preferences"
|
||||||
|
|
||||||
\list 1
|
\list 1
|
||||||
\li In the \uicontrol {Qt for MCUs SDK} field, specify the path
|
\li In the \uicontrol {Qt for MCUs SDK} field, specify the path
|
||||||
|
@@ -73,7 +73,7 @@
|
|||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol Kits > \uicontrol Kits
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol Kits > \uicontrol Kits
|
||||||
tab to add the Meson and Ninja tools to a build and run kit:
|
tab to add the Meson and Ninja tools to a build and run kit:
|
||||||
|
|
||||||
\image qtcreator-kits-meson.png "Setting Meson executable in Kit options"
|
\image qtcreator-kits-meson.png "Setting Meson executable in Kit preferences"
|
||||||
|
|
||||||
For more information, see \l {Adding Kits}.
|
For more information, see \l {Adding Kits}.
|
||||||
|
|
||||||
|
@@ -1,6 +1,6 @@
|
|||||||
/****************************************************************************
|
/****************************************************************************
|
||||||
**
|
**
|
||||||
** Copyright (C) 2021 The Qt Company Ltd.
|
** Copyright (C) 2022 The Qt Company Ltd.
|
||||||
** Contact: https://www.qt.io/licensing/
|
** Contact: https://www.qt.io/licensing/
|
||||||
**
|
**
|
||||||
** This file is part of the Qt Creator documentation.
|
** This file is part of the Qt Creator documentation.
|
||||||
@@ -74,6 +74,13 @@
|
|||||||
You can connect \l{Boot2Qt} devices to the development PC to run,
|
You can connect \l{Boot2Qt} devices to the development PC to run,
|
||||||
debug, and analyze applications built for them from \QC.
|
debug, and analyze applications built for them from \QC.
|
||||||
|
|
||||||
|
\if defined(qtcreator)
|
||||||
|
\li \l {Adding Docker Devices}
|
||||||
|
|
||||||
|
You can add Docker images as \e devices to run, debug, and analyze
|
||||||
|
applications built for Docker containers from \QC.
|
||||||
|
\endif
|
||||||
|
|
||||||
\li \l{Connecting Generic Remote Linux Devices}
|
\li \l{Connecting Generic Remote Linux Devices}
|
||||||
|
|
||||||
If you have a tool chain for building applications for embedded
|
If you have a tool chain for building applications for embedded
|
||||||
|
@@ -1,6 +1,6 @@
|
|||||||
/****************************************************************************
|
/****************************************************************************
|
||||||
**
|
**
|
||||||
** Copyright (C) 2020 The Qt Company Ltd.
|
** Copyright (C) 2022 The Qt Company Ltd.
|
||||||
** Contact: https://www.qt.io/licensing/
|
** Contact: https://www.qt.io/licensing/
|
||||||
**
|
**
|
||||||
** This file is part of the Qt Creator documentation.
|
** This file is part of the Qt Creator documentation.
|
||||||
@@ -53,7 +53,7 @@
|
|||||||
|
|
||||||
\section1 Specifying Settings for Custom Output Parsers
|
\section1 Specifying Settings for Custom Output Parsers
|
||||||
|
|
||||||
\image qtcreator-custom-parser-options.png
|
\image qtcreator-custom-parser-options.png "Custom Output Parsers preferences"
|
||||||
|
|
||||||
A custom output parser enables you to capture errors and
|
A custom output parser enables you to capture errors and
|
||||||
warnings separately, according to the settings you specify
|
warnings separately, according to the settings you specify
|
||||||
@@ -99,4 +99,7 @@
|
|||||||
\li Select custom parsers to activate them for building or running
|
\li Select custom parsers to activate them for building or running
|
||||||
the project.
|
the project.
|
||||||
\endlist
|
\endlist
|
||||||
|
|
||||||
|
Select \uicontrol {Parse standard output during build} to make output
|
||||||
|
parsers look for diagnostics on \c stdout in addition to \c stderr.
|
||||||
*/
|
*/
|
||||||
|
@@ -162,7 +162,7 @@
|
|||||||
change the default suffix of a file, select \uicontrol Edit > \uicontrol Preferences >
|
change the default suffix of a file, select \uicontrol Edit > \uicontrol Preferences >
|
||||||
\uicontrol {C++} > \uicontrol {File Naming}.
|
\uicontrol {C++} > \uicontrol {File Naming}.
|
||||||
|
|
||||||
\image qtcreator-options-cpp-files.png "File Naming tab in Options"
|
\image qtcreator-options-cpp-files.png "C++ File Naming preferences"
|
||||||
|
|
||||||
In the \uicontrol {License template} field, you can use
|
In the \uicontrol {License template} field, you can use
|
||||||
\l{Using Variables in Wizards}{predefined wizard variables} to specify the
|
\l{Using Variables in Wizards}{predefined wizard variables} to specify the
|
||||||
|
@@ -45,7 +45,7 @@
|
|||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Build & Run}
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Build & Run}
|
||||||
> \uicontrol General.
|
> \uicontrol General.
|
||||||
|
|
||||||
\image qtcreator-project-options-deploy.png "Project General Options"
|
\image qtcreator-project-options-deploy.png "Project General preferences"
|
||||||
|
|
||||||
By default, the \uicontrol {Always deploy project before running it} (1) and
|
By default, the \uicontrol {Always deploy project before running it} (1) and
|
||||||
\uicontrol {Build the Whole Project} (2) options are enabled. Therefore,
|
\uicontrol {Build the Whole Project} (2) options are enabled. Therefore,
|
||||||
|
@@ -166,7 +166,7 @@
|
|||||||
with a single QML file that contains the main view. You can
|
with a single QML file that contains the main view. You can
|
||||||
preview Qt Quick 2 UI projects in the
|
preview Qt Quick 2 UI projects in the
|
||||||
\l{Validating with Target Hardware}{QML Scene preview tool}.
|
\l{Validating with Target Hardware}{QML Scene preview tool}.
|
||||||
You do not need to build them, because they do not contain any
|
You do not need to build them because they do not contain any
|
||||||
C++ code.
|
C++ code.
|
||||||
|
|
||||||
Use this template only if you are prototyping. You cannot create
|
Use this template only if you are prototyping. You cannot create
|
||||||
|
@@ -34,7 +34,7 @@
|
|||||||
actually copied from the \QC source directory into the \QC build directory
|
actually copied from the \QC source directory into the \QC build directory
|
||||||
as part of the next \QC build.
|
as part of the next \QC build.
|
||||||
|
|
||||||
If you do not run CMake or qmake, your new wizard will not show up, because
|
If you do not run CMake or qmake, your new wizard will not show up because
|
||||||
it does not exist in the build directory you run your newly built \QC from.
|
it does not exist in the build directory you run your newly built \QC from.
|
||||||
It never got copied there because CMake or qmake did not inform the
|
It never got copied there because CMake or qmake did not inform the
|
||||||
build tool, such as make or ninja, about the new files in the source tree.
|
build tool, such as make or ninja, about the new files in the source tree.
|
||||||
|
@@ -53,7 +53,7 @@
|
|||||||
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Kits >
|
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Kits >
|
||||||
\uicontrol Debuggers > \uicontrol Add.
|
\uicontrol Debuggers > \uicontrol Add.
|
||||||
|
|
||||||
\image qtcreator-options-build-run-debuggers.png
|
\image qtcreator-options-build-run-debuggers.png "Adding debuggers"
|
||||||
|
|
||||||
\li In the \uicontrol Name field, give a descriptive name for the debugger.
|
\li In the \uicontrol Name field, give a descriptive name for the debugger.
|
||||||
|
|
||||||
|
@@ -67,7 +67,7 @@
|
|||||||
|
|
||||||
\list 1
|
\list 1
|
||||||
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Qbs.
|
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Qbs.
|
||||||
\image qtcreator-options-qbs.png
|
\image qtcreator-options-qbs.png "Qbs preferences"
|
||||||
\li Deselect the \uicontrol {Use \QC settings directory for Qbs} check
|
\li Deselect the \uicontrol {Use \QC settings directory for Qbs} check
|
||||||
box to store Qbs profiles in the Qbs settings directory.
|
box to store Qbs profiles in the Qbs settings directory.
|
||||||
\li In the \uicontrol {Path to qbs executable} field, you can view
|
\li In the \uicontrol {Path to qbs executable} field, you can view
|
||||||
|
@@ -48,7 +48,7 @@
|
|||||||
version, select it in the list and select \uicontrol Details in the
|
version, select it in the list and select \uicontrol Details in the
|
||||||
\uicontrol {Qt version for} section.
|
\uicontrol {Qt version for} section.
|
||||||
|
|
||||||
\image qtcreator-qt-versions.png "Qt Versions tab in Kit options"
|
\image qtcreator-qt-versions.png "Qt Versions tab in Kit preferences"
|
||||||
|
|
||||||
To remove invalid Qt versions, select \uicontrol {Clean Up}.
|
To remove invalid Qt versions, select \uicontrol {Clean Up}.
|
||||||
|
|
||||||
|
@@ -104,7 +104,7 @@
|
|||||||
default.
|
default.
|
||||||
|
|
||||||
\note On Windows, the build will fail if the application
|
\note On Windows, the build will fail if the application
|
||||||
is running, because the executable file cannot be
|
is running because the executable file cannot be
|
||||||
overwritten. To avoid this issue, you can deselect this
|
overwritten. To avoid this issue, you can deselect this
|
||||||
check box and add a \uicontrol {Qbs Install} deployment step
|
check box and add a \uicontrol {Qbs Install} deployment step
|
||||||
in the run settings that will be performed just before
|
in the run settings that will be performed just before
|
||||||
|
@@ -1,6 +1,6 @@
|
|||||||
/****************************************************************************
|
/****************************************************************************
|
||||||
**
|
**
|
||||||
** Copyright (C) 2020 The Qt Company Ltd.
|
** Copyright (C) 2022 The Qt Company Ltd.
|
||||||
** Contact: https://www.qt.io/licensing/
|
** Contact: https://www.qt.io/licensing/
|
||||||
**
|
**
|
||||||
** This file is part of the Qt Creator documentation.
|
** This file is part of the Qt Creator documentation.
|
||||||
@@ -52,7 +52,7 @@
|
|||||||
\li Select \uicontrol Projects > \uicontrol {Project Settings} >
|
\li Select \uicontrol Projects > \uicontrol {Project Settings} >
|
||||||
\uicontrol Editor.
|
\uicontrol Editor.
|
||||||
|
|
||||||
\li In the \uicontrol {Editor settings} field, select \uicontrol {Custom}.
|
\li Deselect \uicontrol {Use global settings}.
|
||||||
|
|
||||||
\li Specify text editor settings for the project.
|
\li Specify text editor settings for the project.
|
||||||
|
|
||||||
|
@@ -45,7 +45,7 @@
|
|||||||
\uicontrol Environment > \uicontrol System, and then select
|
\uicontrol Environment > \uicontrol System, and then select
|
||||||
\uicontrol Change in the \uicontrol Environment field.
|
\uicontrol Change in the \uicontrol Environment field.
|
||||||
|
|
||||||
\image qtcreator-options-environment-system.png "Environment options System tab"
|
\image qtcreator-options-environment-system.png "Environment preferences System tab"
|
||||||
|
|
||||||
In addition, you can specify custom environment variables in the
|
In addition, you can specify custom environment variables in the
|
||||||
\uicontrol {Project Settings} > \uicontrol Environment settings.
|
\uicontrol {Project Settings} > \uicontrol Environment settings.
|
||||||
|
@@ -80,7 +80,7 @@
|
|||||||
\l {Application Output} displays the status of the
|
\l {Application Output} displays the status of the
|
||||||
application while it is running. You can select the \uicontrol Run button
|
application while it is running. You can select the \uicontrol Run button
|
||||||
to re-run applications without building them first. This is
|
to re-run applications without building them first. This is
|
||||||
useful when developing Qt Quick applications, because the QML files are
|
useful when developing Qt Quick applications because the QML files are
|
||||||
interpreted at runtime. Therefore, the application does not need to be
|
interpreted at runtime. Therefore, the application does not need to be
|
||||||
built again if you edited only QML files. This saves time especially if
|
built again if you edited only QML files. This saves time especially if
|
||||||
the application contains large image files that would need to be bundled
|
the application contains large image files that would need to be bundled
|
||||||
|
@@ -72,7 +72,6 @@
|
|||||||
|
|
||||||
\badcode
|
\badcode
|
||||||
import sys
|
import sys
|
||||||
from pathlib import Path
|
|
||||||
|
|
||||||
from PySide6.QtWidgets import QApplication, QWidget
|
from PySide6.QtWidgets import QApplication, QWidget
|
||||||
\endcode
|
\endcode
|
||||||
@@ -179,9 +178,8 @@
|
|||||||
to QGuiApplication and QQmlApplicationEngine:
|
to QGuiApplication and QQmlApplicationEngine:
|
||||||
|
|
||||||
\badcode
|
\badcode
|
||||||
import os
|
|
||||||
from pathlib import Path
|
|
||||||
import sys
|
import sys
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
from PySide6.QtGui import QGuiApplication
|
from PySide6.QtGui import QGuiApplication
|
||||||
from PySide6.QtQml import QQmlApplicationEngine
|
from PySide6.QtQml import QQmlApplicationEngine
|
||||||
@@ -201,7 +199,8 @@
|
|||||||
|
|
||||||
\badcode
|
\badcode
|
||||||
engine = QQmlApplicationEngine()
|
engine = QQmlApplicationEngine()
|
||||||
engine.load(os.fspath(Path(__file__).resolve().parent / "main.qml"))
|
qml_file = Path(__file__).resolve().parent / "main.qml"
|
||||||
|
engine.load(qml_file)
|
||||||
\endcode
|
\endcode
|
||||||
|
|
||||||
Finally, the wizard adds code that checks whether the file was successfully
|
Finally, the wizard adds code that checks whether the file was successfully
|
||||||
|
@@ -169,6 +169,8 @@
|
|||||||
\list
|
\list
|
||||||
\li \l{Connecting Android Devices}
|
\li \l{Connecting Android Devices}
|
||||||
\li \l{Connecting Bare Metal Devices}
|
\li \l{Connecting Bare Metal Devices}
|
||||||
|
\li \l{Connecting Boot2Qt Devices}
|
||||||
|
\li \l{Adding Docker Devices}
|
||||||
\li \l{Connecting Generic Remote Linux Devices}
|
\li \l{Connecting Generic Remote Linux Devices}
|
||||||
\li \l{Connecting iOS Devices}
|
\li \l{Connecting iOS Devices}
|
||||||
\li \l{Connecting MCUs}
|
\li \l{Connecting MCUs}
|
||||||
|
@@ -43,7 +43,7 @@
|
|||||||
asks you whether you would like to open the file in \QDS instead. Select
|
asks you whether you would like to open the file in \QDS instead. Select
|
||||||
\uicontrol {Open in \QDS} to open the file in \QDS. To continue editing
|
\uicontrol {Open in \QDS} to open the file in \QDS. To continue editing
|
||||||
the file in \QC, close the info bar. However, we do not recommend editing
|
the file in \QC, close the info bar. However, we do not recommend editing
|
||||||
\l{UI Files}{UI files} in the \uicontrol Edit mode, because it is easy to
|
\l{UI Files}{UI files} in the \uicontrol Edit mode because it is easy to
|
||||||
add code that is not supported by \QDS. To hide the question, select
|
add code that is not supported by \QDS. To hide the question, select
|
||||||
\uicontrol {Do Not Show Again}.
|
\uicontrol {Do Not Show Again}.
|
||||||
|
|
||||||
|
@@ -62,7 +62,7 @@
|
|||||||
\li Qt Quick UI Prototype
|
\li Qt Quick UI Prototype
|
||||||
\li Creates a Qt Quick UI project with a single QML file that
|
\li Creates a Qt Quick UI project with a single QML file that
|
||||||
contains the main view. You can preview Qt Quick 2 UI projects
|
contains the main view. You can preview Qt Quick 2 UI projects
|
||||||
in the QML Scene preview tool. You do not need to build them,
|
in the QML Scene preview tool. You do not need to build them
|
||||||
because they do not contain any C++ code.
|
because they do not contain any C++ code.
|
||||||
|
|
||||||
This project type is compatible with \QDS. However, use this
|
This project type is compatible with \QDS. However, use this
|
||||||
@@ -168,7 +168,7 @@
|
|||||||
Qt Quick UI Prototype projects are useful for testing or prototyping user
|
Qt Quick UI Prototype projects are useful for testing or prototyping user
|
||||||
interfaces,
|
interfaces,
|
||||||
or for setting up a separate project just for QML editing, for example. You
|
or for setting up a separate project just for QML editing, for example. You
|
||||||
cannot use them for application development, because they do not contain:
|
cannot use them for application development because they do not contain:
|
||||||
|
|
||||||
\list
|
\list
|
||||||
\li C++ code
|
\li C++ code
|
||||||
|
@@ -76,7 +76,7 @@
|
|||||||
|
|
||||||
The first time you preview a UI on devices, the preview utility
|
The first time you preview a UI on devices, the preview utility
|
||||||
is copied to them. This might take some time. Thereafter, previewing will
|
is copied to them. This might take some time. Thereafter, previewing will
|
||||||
get faster, because only the UI files need to be copied to the
|
get faster because only the UI files need to be copied to the
|
||||||
device.
|
device.
|
||||||
|
|
||||||
\section2 Previewing on Boot2Qt Devices
|
\section2 Previewing on Boot2Qt Devices
|
||||||
|
@@ -53,7 +53,7 @@
|
|||||||
\if defined(qtcreator)
|
\if defined(qtcreator)
|
||||||
Triggering long-running C++ functions, such as paint methods and signal
|
Triggering long-running C++ functions, such as paint methods and signal
|
||||||
handlers, also takes time in the GUI thread, but is more difficult to see in
|
handlers, also takes time in the GUI thread, but is more difficult to see in
|
||||||
the QML Profiler, because it does not profile C++ code.
|
the QML Profiler because it does not profile C++ code.
|
||||||
\endif
|
\endif
|
||||||
|
|
||||||
To find excessive use of JavaScript, check the frame rate in animations and
|
To find excessive use of JavaScript, check the frame rate in animations and
|
||||||
@@ -65,7 +65,7 @@
|
|||||||
frames and check that you are not using too many short bindings or signal
|
frames and check that you are not using too many short bindings or signal
|
||||||
handlers that are updated per frame. You can also \l{Visualizing Overdraw}
|
handlers that are updated per frame. You can also \l{Visualizing Overdraw}
|
||||||
{visualize Scene Graph overdraw} to check scene layout and find items that
|
{visualize Scene Graph overdraw} to check scene layout and find items that
|
||||||
are never visible to the users, because they are located outside the screen
|
are never visible to the users because they are located outside the screen
|
||||||
or hidden beneath other, visible elements.
|
or hidden beneath other, visible elements.
|
||||||
|
|
||||||
\if defined(qtcreator)
|
\if defined(qtcreator)
|
||||||
@@ -127,7 +127,7 @@
|
|||||||
takes time, and therefore, there might be a delay
|
takes time, and therefore, there might be a delay
|
||||||
before the data is displayed.
|
before the data is displayed.
|
||||||
|
|
||||||
Do not use application commands to exit the application, because data is
|
Do not use application commands to exit the application because data is
|
||||||
sent to the QML Profiler when you select the \uicontrol {Enable Profiling} button.
|
sent to the QML Profiler when you select the \uicontrol {Enable Profiling} button.
|
||||||
The application continues to run for some seconds, after which it is stopped
|
The application continues to run for some seconds, after which it is stopped
|
||||||
automatically. If you exit the application, the data is not sent.
|
automatically. If you exit the application, the data is not sent.
|
||||||
|
@@ -48,10 +48,12 @@
|
|||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Qt Quick} >
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol {Qt Quick} >
|
||||||
\uicontrol {QML/JS Editing} > \uicontrol {Always show Qt Quick Toolbar}.
|
\uicontrol {QML/JS Editing} > \uicontrol {Always show Qt Quick Toolbar}.
|
||||||
|
|
||||||
|
\image qtcreator-qml-js-editing.png "QML/JS Editing preferences"
|
||||||
|
|
||||||
Drag the toolbar to pin it to another location. Select
|
Drag the toolbar to pin it to another location. Select
|
||||||
\inlineimage icons/pin.png
|
\inlineimage icons/pin.png
|
||||||
to unpin the toolbar and move it to its default location. To pin toolbars
|
to unpin the toolbar and move it to its default location. To pin toolbars
|
||||||
by default, select \uicontrol {Pin Quick Toolbar}.
|
by default, select \uicontrol {Pin Qt Quick Toolbar}.
|
||||||
|
|
||||||
\section1 Previewing Images
|
\section1 Previewing Images
|
||||||
|
|
||||||
|
@@ -53,7 +53,7 @@
|
|||||||
\uicontrol Edit > \uicontrol Preferences > \uicontrol Environment >
|
\uicontrol Edit > \uicontrol Preferences > \uicontrol Environment >
|
||||||
\uicontrol System:
|
\uicontrol System:
|
||||||
|
|
||||||
\image qtcreator-options-environment-system.png "Environment options System tab"
|
\image qtcreator-options-environment-system.png "Environment preferences System tab"
|
||||||
|
|
||||||
\list
|
\list
|
||||||
\li In the \uicontrol {When files are externally modified} field,
|
\li In the \uicontrol {When files are externally modified} field,
|
||||||
|
@@ -160,7 +160,7 @@
|
|||||||
> \uicontrol Environment, and then select a theme in the \uicontrol Theme
|
> \uicontrol Environment, and then select a theme in the \uicontrol Theme
|
||||||
field.
|
field.
|
||||||
|
|
||||||
\image qtcreator-options-environment-interface.png "Interface settings"
|
\image qtcreator-options-environment-interface.png "Interface preferences"
|
||||||
|
|
||||||
\section1 Changing Languages
|
\section1 Changing Languages
|
||||||
|
|
||||||
@@ -183,7 +183,7 @@
|
|||||||
\li On Windows, if no \l{High DPI}{scaling environment variables} are
|
\li On Windows, if no \l{High DPI}{scaling environment variables} are
|
||||||
set, \QC instructs Qt to detect the scaling factor and use it for
|
set, \QC instructs Qt to detect the scaling factor and use it for
|
||||||
\QC.
|
\QC.
|
||||||
\li On Linux, \QC leaves it to the user to enable high DPI scaling,
|
\li On Linux, \QC leaves it to the user to enable high DPI scaling
|
||||||
because the process varies so much on different distributions
|
because the process varies so much on different distributions
|
||||||
and windowing systems that it cannot be reliably done automatically.
|
and windowing systems that it cannot be reliably done automatically.
|
||||||
\endlist
|
\endlist
|
||||||
@@ -448,7 +448,7 @@
|
|||||||
\uicontrol Preferences > \uicontrol Environment > \uicontrol Interface, and
|
\uicontrol Preferences > \uicontrol Environment > \uicontrol Interface, and
|
||||||
then select the codec in the \uicontrol {Text codec for tools} field.
|
then select the codec in the \uicontrol {Text codec for tools} field.
|
||||||
|
|
||||||
\image qtcreator-options-environment-interface.png "Interface tab in the Environment options"
|
\image qtcreator-options-environment-interface.png "Interface tab in the Environment preferences"
|
||||||
|
|
||||||
\section1 Finding and Filtering Output
|
\section1 Finding and Filtering Output
|
||||||
|
|
||||||
@@ -610,7 +610,7 @@
|
|||||||
In the \uicontrol {Limit output to} field, you can specify the maximum
|
In the \uicontrol {Limit output to} field, you can specify the maximum
|
||||||
amount of build output lines to display.
|
amount of build output lines to display.
|
||||||
|
|
||||||
You can also reach the options page by clicking \inlineimage icons/settings.png
|
You can also open the preferences page by clicking \inlineimage icons/settings.png
|
||||||
(\uicontrol {Open Settings Page}).
|
(\uicontrol {Open Settings Page}).
|
||||||
|
|
||||||
To copy the output to the clipboard, select \uicontrol {Select All} in the
|
To copy the output to the clipboard, select \uicontrol {Select All} in the
|
||||||
@@ -658,7 +658,7 @@
|
|||||||
\uicontrol {To-Do} > \uicontrol Add. Set an icon and a line background color
|
\uicontrol {To-Do} > \uicontrol Add. Set an icon and a line background color
|
||||||
for the keyword.
|
for the keyword.
|
||||||
|
|
||||||
\image qtcreator-todo-options.png
|
\image qtcreator-todo-options.png "To-Do preferences"
|
||||||
|
|
||||||
To change the icon and line background color of the selected keyword, select
|
To change the icon and line background color of the selected keyword, select
|
||||||
\uicontrol Edit.
|
\uicontrol Edit.
|
||||||
|
@@ -46,7 +46,7 @@
|
|||||||
|
|
||||||
\section1 Configuring Perforce
|
\section1 Configuring Perforce
|
||||||
|
|
||||||
In the Perforce options, you can specify workspace details:
|
In the Perforce preferences, you can specify workspace details:
|
||||||
\uicontrol {P4 user}, \uicontrol {P4 client}, and \uicontrol {P4 port}. To
|
\uicontrol {P4 user}, \uicontrol {P4 client}, and \uicontrol {P4 port}. To
|
||||||
specify the details individually for several projects, use configuration
|
specify the details individually for several projects, use configuration
|
||||||
files instead. Create a \c {p4config.txt} configuration file for each
|
files instead. Create a \c {p4config.txt} configuration file for each
|
||||||
|
@@ -577,7 +577,7 @@
|
|||||||
Select the \uicontrol HTTPS check box to prepend \c https to the Gerrit URL
|
Select the \uicontrol HTTPS check box to prepend \c https to the Gerrit URL
|
||||||
if Gerrit does not provide it.
|
if Gerrit does not provide it.
|
||||||
|
|
||||||
\image qtcreator-gerrit-options.png
|
\image qtcreator-gerrit-options.png "Gerrit preferences"
|
||||||
|
|
||||||
\section1 Working with Git Tools
|
\section1 Working with Git Tools
|
||||||
|
|
||||||
|
@@ -100,7 +100,7 @@
|
|||||||
\li \QC configures the \uicontrol {Emscripten SDK environment} for you
|
\li \QC configures the \uicontrol {Emscripten SDK environment} for you
|
||||||
if the \c emsdk is supported by the Qt for WebAssembly version that
|
if the \c emsdk is supported by the Qt for WebAssembly version that
|
||||||
you will use for developing the application.
|
you will use for developing the application.
|
||||||
\image qtcreator-webassembly-options.png "Qt for WebAssembly device options"
|
\image qtcreator-webassembly-options.png "Qt for WebAssembly device preferences"
|
||||||
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Kits.
|
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Kits.
|
||||||
\image qtcreator-kit-webassembly.png "Qt for WebAssembly kit"
|
\image qtcreator-kit-webassembly.png "Qt for WebAssembly kit"
|
||||||
\li In the \uicontrol Compiler group, \uicontrol {Emscripten Compiler}
|
\li In the \uicontrol Compiler group, \uicontrol {Emscripten Compiler}
|
||||||
|
@@ -1,6 +1,6 @@
|
|||||||
/****************************************************************************
|
/****************************************************************************
|
||||||
**
|
**
|
||||||
** Copyright (C) 2019 The Qt Company Ltd.
|
** Copyright (C) 2022 The Qt Company Ltd.
|
||||||
** Contact: https://www.qt.io/licensing/
|
** Contact: https://www.qt.io/licensing/
|
||||||
**
|
**
|
||||||
** This file is part of the Qt Creator documentation.
|
** This file is part of the Qt Creator documentation.
|
||||||
@@ -75,9 +75,6 @@
|
|||||||
|
|
||||||
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Designer.
|
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Designer.
|
||||||
|
|
||||||
\li Specify settins for generating classes and code in \uicontrol {Class
|
|
||||||
Generation}.
|
|
||||||
|
|
||||||
\li Specify embedded device profiles, that determine style, font, and
|
\li Specify embedded device profiles, that determine style, font, and
|
||||||
screen resolution, for example, in \uicontrol{Embedded Design}.
|
screen resolution, for example, in \uicontrol{Embedded Design}.
|
||||||
|
|
||||||
@@ -91,29 +88,40 @@
|
|||||||
To preview the settings, select \uicontrol Tools > \uicontrol{Form Editor} >
|
To preview the settings, select \uicontrol Tools > \uicontrol{Form Editor} >
|
||||||
\uicontrol Preview, or press \key Alt+Shift+R.
|
\uicontrol Preview, or press \key Alt+Shift+R.
|
||||||
|
|
||||||
\section1 Previewing Forms Using Device Skins
|
\section1 Previewing Forms Using Device Profiles
|
||||||
|
|
||||||
A \e {device skin} is a set of configuration files that describe a mobile
|
A \e {device profile} is a set of configuration files that describe a mobile
|
||||||
device. It includes a border image that surrounds the form and depicts a
|
device. It includes a border image that surrounds the form and depicts a
|
||||||
mobile device with its buttons.
|
mobile device with its buttons.
|
||||||
|
|
||||||
To preview your form using device skins:
|
To preview your form using device profiles, select \uicontrol Tools >
|
||||||
|
\uicontrol {Form Editor} > \uicontrol {Preview In}, and then select a
|
||||||
|
device profile.
|
||||||
|
|
||||||
|
\section2 Adding Device Profiles
|
||||||
|
|
||||||
|
To add device profiles:
|
||||||
|
|
||||||
\list 1
|
\list 1
|
||||||
|
|
||||||
\li Select \uicontrol Edit > \uicontrol Preferences > \uicontrol Designer.
|
\li \uicontrol Edit > \uicontrol Preferences > \uicontrol Designer.
|
||||||
|
\image qtdesigner-embedded-design.png "Qt Designer Embedded Design preferences"
|
||||||
\li Select the \uicontrol{Print/Preview Configuration} check box.
|
\li In \uicontrol {Embedded Design}, select \inlineimage icons/plus.png
|
||||||
|
to open the \uicontrol {Add Profile} dialog.
|
||||||
\li In the \uicontrol {Device skin} field, select a device skin.
|
\image qtdesigner-add-profile.png "Add Profile dialog"
|
||||||
|
\li In \uicontrol Name, enter a name for the device. The name is
|
||||||
\li When the form is open in \uicontrol Design mode, press \key Alt+Shift+R.
|
displayed as an option in \uicontrol {Preview In}.
|
||||||
|
\li In \uicontrol Family, select the font to use.
|
||||||
\li To end the preview, right-click the skin and select \uicontrol Close in
|
\li In \uicontrol {Point Size}, select the font size.
|
||||||
the context menu.
|
\li In \uicontrol Style, select one of the predefined styles.
|
||||||
|
\li In \uicontrol {Device DPI}, select one of the predefined DPI
|
||||||
|
values or \uicontrol {User defined} to specify a custom value.
|
||||||
|
\li Select \uicontrol OK to add the device profile to the list.
|
||||||
\endlist
|
\endlist
|
||||||
|
|
||||||
|
To import device profiles from .qdp files, select \uicontrol Open. To save
|
||||||
|
them as .qdp files, select \uicontrol Save.
|
||||||
|
|
||||||
\section1 Adding Widgets
|
\section1 Adding Widgets
|
||||||
|
|
||||||
You can use Qt APIs to create plugins that extend Qt applications. This
|
You can use Qt APIs to create plugins that extend Qt applications. This
|
||||||
|
@@ -179,7 +179,7 @@
|
|||||||
|
|
||||||
The \c {\else} command is sometimes used to replace some \QC specific text
|
The \c {\else} command is sometimes used to replace some \QC specific text
|
||||||
with text that applies to \QDS. For example, the following \c if-else
|
with text that applies to \QDS. For example, the following \c if-else
|
||||||
statement is needed in the \QC Manual sources, because the project wizards
|
statement is needed in the \QC Manual sources because the project wizards
|
||||||
in \QDS are different from those in \QC, and are therefore described in
|
in \QDS are different from those in \QC, and are therefore described in
|
||||||
a new topic that is located in the \QDS Manual sources:
|
a new topic that is located in the \QDS Manual sources:
|
||||||
|
|
||||||
@@ -251,7 +251,7 @@
|
|||||||
It is mostly used in the \QC Manual sources to specify values for the
|
It is mostly used in the \QC Manual sources to specify values for the
|
||||||
\c {\previouspage} and \c {\nextpage} commands depending on whether
|
\c {\previouspage} and \c {\nextpage} commands depending on whether
|
||||||
the \QDS Manual or \QC Manual is being built. For example, the
|
the \QDS Manual or \QC Manual is being built. For example, the
|
||||||
following \c if-else statement is needed, because only the Git
|
following \c if-else statement is needed because only the Git
|
||||||
version control system is integrated to \QDS, and information about
|
version control system is integrated to \QDS, and information about
|
||||||
the other systems integrated to \QC is hidden:
|
the other systems integrated to \QC is hidden:
|
||||||
|
|
||||||
@@ -349,7 +349,7 @@
|
|||||||
topic in the Qt reference documentation.
|
topic in the Qt reference documentation.
|
||||||
|
|
||||||
This improves the consistency of the look and feel of Qt documentation,
|
This improves the consistency of the look and feel of Qt documentation,
|
||||||
and eliminates the need to describe parts of the UI in the text, because
|
and eliminates the need to describe parts of the UI in the text because
|
||||||
you can just insert the number of the element you are referring to in
|
you can just insert the number of the element you are referring to in
|
||||||
brackets.
|
brackets.
|
||||||
|
|
||||||
|
@@ -259,7 +259,7 @@
|
|||||||
Use \c{QDir::toNativeSeparators()} for file and directory names that you
|
Use \c{QDir::toNativeSeparators()} for file and directory names that you
|
||||||
pass to \c{tr().arg()}.
|
pass to \c{tr().arg()}.
|
||||||
|
|
||||||
Do not use markup that spans the whole string, because that can be confusing
|
Do not use markup that spans the whole string because that can be confusing
|
||||||
for translators. For example, instead of:
|
for translators. For example, instead of:
|
||||||
|
|
||||||
\code
|
\code
|
||||||
|
@@ -41,6 +41,7 @@ excludedirs += ../../qtcreator/examples/accelbubble \
|
|||||||
../../qtcreator/src/cmake \
|
../../qtcreator/src/cmake \
|
||||||
../../qtcreator/src/conan \
|
../../qtcreator/src/conan \
|
||||||
../../qtcreator/src/debugger/creator-only \
|
../../qtcreator/src/debugger/creator-only \
|
||||||
|
../../qtcreator/src/docker \
|
||||||
../../qtcreator/src/editors/creator-only \
|
../../qtcreator/src/editors/creator-only \
|
||||||
../../qtcreator/src/howto/creator-only \
|
../../qtcreator/src/howto/creator-only \
|
||||||
../../qtcreator/src/incredibuild \
|
../../qtcreator/src/incredibuild \
|
||||||
|
@@ -168,7 +168,7 @@
|
|||||||
\image coffee-machine-timeline-settings.png
|
\image coffee-machine-timeline-settings.png
|
||||||
|
|
||||||
We set the start frame for the \c {"selection"} state to 400 and
|
We set the start frame for the \c {"selection"} state to 400 and
|
||||||
the end frame to 200, because we are moving back on the timeline to display
|
the end frame to 200 because we are moving back on the timeline to display
|
||||||
the selection sidebar.
|
the selection sidebar.
|
||||||
|
|
||||||
In the \uicontrol {Transition to state} field, we select the state to
|
In the \uicontrol {Transition to state} field, we select the state to
|
||||||
|
@@ -90,7 +90,7 @@
|
|||||||
\l {basic-image}{Image}, \l Text, and \l {Mouse Area} components. For the
|
\l {basic-image}{Image}, \l Text, and \l {Mouse Area} components. For the
|
||||||
screen background, we use the \l {basic-rectangle}{Rectangle} component.
|
screen background, we use the \l {basic-rectangle}{Rectangle} component.
|
||||||
|
|
||||||
The text might look different on the desktop and MCUs, because on the
|
The text might look different on the desktop and MCUs because on the
|
||||||
desktop we use dynamic font loading, whereas on MCUs fonts are compiled
|
desktop we use dynamic font loading, whereas on MCUs fonts are compiled
|
||||||
into application sources. Therefore, the text will always be Maven Pro
|
into application sources. Therefore, the text will always be Maven Pro
|
||||||
on MCUs, whereas on the desktop you'd need to have Maven Pro installed
|
on MCUs, whereas on the desktop you'd need to have Maven Pro installed
|
||||||
@@ -227,7 +227,7 @@
|
|||||||
\skipto Item {
|
\skipto Item {
|
||||||
\printuntil }
|
\printuntil }
|
||||||
|
|
||||||
We have to do it this way, because we are developing for MCUs. We have to
|
We have to do it this way because we are developing for MCUs. We have to
|
||||||
use either \c when conditions or set the state directly through code,
|
use either \c when conditions or set the state directly through code,
|
||||||
which overrides \c when conditions. Otherwise, we could just select the
|
which overrides \c when conditions. Otherwise, we could just select the
|
||||||
action to change to the state that we want in the \uicontrol Action field.
|
action to change to the state that we want in the \uicontrol Action field.
|
||||||
|
@@ -198,7 +198,7 @@
|
|||||||
\inlineimage icons/anchor-fill.png
|
\inlineimage icons/anchor-fill.png
|
||||||
(\uicontrol {Fill to Parent}) button to always make the
|
(\uicontrol {Fill to Parent}) button to always make the
|
||||||
image the same size as its parent. This makes the button
|
image the same size as its parent. This makes the button
|
||||||
component scalable, because the image size is bound to the
|
component scalable because the image size is bound to the
|
||||||
component size.
|
component size.
|
||||||
\endlist
|
\endlist
|
||||||
\li Select the other border image to edit the values of its properties
|
\li Select the other border image to edit the values of its properties
|
||||||
|
@@ -70,7 +70,7 @@
|
|||||||
components, unless it has been explicitly set for them.
|
components, unless it has been explicitly set for them.
|
||||||
|
|
||||||
\note Take care when enabling wheel events for controls within scrollable
|
\note Take care when enabling wheel events for controls within scrollable
|
||||||
components, such as \l Flickable, because the control will consume the
|
components, such as \l Flickable because the control will consume the
|
||||||
events, and therefore interrupt scrolling of the flickable.
|
events, and therefore interrupt scrolling of the flickable.
|
||||||
|
|
||||||
\uicontrol Spacing is useful for controls that have multiple or repetitive
|
\uicontrol Spacing is useful for controls that have multiple or repetitive
|
||||||
@@ -130,7 +130,7 @@
|
|||||||
The button text should be a verb describing the action, or a noun matching
|
The button text should be a verb describing the action, or a noun matching
|
||||||
the title of the popup that will be opened.
|
the title of the popup that will be opened.
|
||||||
|
|
||||||
Don't use a button to set state, because a \l Switch is more suitable for
|
Don't use a button to set state because a \l Switch is more suitable for
|
||||||
that purpose.
|
that purpose.
|
||||||
|
|
||||||
\section3 Highlighted Buttons
|
\section3 Highlighted Buttons
|
||||||
|
@@ -118,7 +118,7 @@
|
|||||||
|
|
||||||
If the source is an intrinsically scalable image (such as SVG), source size
|
If the source is an intrinsically scalable image (such as SVG), source size
|
||||||
determines the size of the loaded image regardless of intrinsic size.
|
determines the size of the loaded image regardless of intrinsic size.
|
||||||
Avoid changing the source size property dynamically, because rendering an
|
Avoid changing the source size property dynamically because rendering an
|
||||||
SVG is slow compared with rendering other image formats.
|
SVG is slow compared with rendering other image formats.
|
||||||
|
|
||||||
If the source is a non-scalable image (such as JPEG), the loaded image will
|
If the source is a non-scalable image (such as JPEG), the loaded image will
|
||||||
|
@@ -98,7 +98,7 @@
|
|||||||
\endqml
|
\endqml
|
||||||
|
|
||||||
This works nicely for applications but \uicontrol {Form Editor} displays a
|
This works nicely for applications but \uicontrol {Form Editor} displays a
|
||||||
zero-sized component. A parent for the opened file does not exist, because
|
zero-sized component. A parent for the opened file does not exist because
|
||||||
the context is missing. To get around the missing context, the idea of a
|
the context is missing. To get around the missing context, the idea of a
|
||||||
\e {dummy context} is introduced. If you place a file with the same name as
|
\e {dummy context} is introduced. If you place a file with the same name as
|
||||||
the application (here, example.qml) in the \c {dummydata/context} directory,
|
the application (here, example.qml) in the \c {dummydata/context} directory,
|
||||||
|
@@ -54,7 +54,7 @@
|
|||||||
\list 1
|
\list 1
|
||||||
\li In the File Explorer, create a new folder for the mock data
|
\li In the File Explorer, create a new folder for the mock data
|
||||||
inside the \e imports folder in your project folder (for example, \e Data).
|
inside the \e imports folder in your project folder (for example, \e Data).
|
||||||
\note Make sure to capitalize the \e Data folder name, because you
|
\note Make sure to capitalize the \e Data folder name because you
|
||||||
will need to import it as a component later, and component names must
|
will need to import it as a component later, and component names must
|
||||||
be capitalized.
|
be capitalized.
|
||||||
\note If you place this folder somewhere else in the project, you will
|
\note If you place this folder somewhere else in the project, you will
|
||||||
@@ -73,7 +73,7 @@
|
|||||||
\li Follow the instructions of the wizard to create the Qt Quick file
|
\li Follow the instructions of the wizard to create the Qt Quick file
|
||||||
in the data folder. In these instructions, the file is called
|
in the data folder. In these instructions, the file is called
|
||||||
\e Values.qml.
|
\e Values.qml.
|
||||||
\note Make sure to capitalize the filename, because it will become
|
\note Make sure to capitalize the filename because it will become
|
||||||
a custom component.
|
a custom component.
|
||||||
\li Select \uicontrol File > \uicontrol {New File} >
|
\li Select \uicontrol File > \uicontrol {New File} >
|
||||||
\uicontrol {JavaScript} >
|
\uicontrol {JavaScript} >
|
||||||
|
@@ -67,7 +67,7 @@
|
|||||||
The \uicontrol Cached property allows the effect output pixels to be cached
|
The \uicontrol Cached property allows the effect output pixels to be cached
|
||||||
in order to improve the rendering performance. Every time the source or
|
in order to improve the rendering performance. Every time the source or
|
||||||
effect properties are changed, the pixels in the cache must be updated.
|
effect properties are changed, the pixels in the cache must be updated.
|
||||||
Memory consumption is increased, because an extra buffer of memory is
|
Memory consumption is increased because an extra buffer of memory is
|
||||||
required for storing the effect output. We recommend that you disable the
|
required for storing the effect output. We recommend that you disable the
|
||||||
cache when the source or the effect properties are animated.
|
cache when the source or the effect properties are animated.
|
||||||
|
|
||||||
|
@@ -186,7 +186,7 @@
|
|||||||
\uicontrol {Sibling component spacing} field, specify the
|
\uicontrol {Sibling component spacing} field, specify the
|
||||||
distance in pixels between siblings and the snapping lines.
|
distance in pixels between siblings and the snapping lines.
|
||||||
|
|
||||||
\image qtquick-designer-options.png "Qt Quick Designer options"
|
\image qtquick-designer-options.png "Qt Quick Designer preferences"
|
||||||
|
|
||||||
The following image shows the snapping lines (1) when
|
The following image shows the snapping lines (1) when
|
||||||
\uicontrol {Parent component padding} is set to 5 pixels.
|
\uicontrol {Parent component padding} is set to 5 pixels.
|
||||||
|
@@ -439,7 +439,7 @@
|
|||||||
The value of the \uicontrol Format field specifies the internal OpenGL
|
The value of the \uicontrol Format field specifies the internal OpenGL
|
||||||
format of the texture. Depending on the OpenGL implementation, it might
|
format of the texture. Depending on the OpenGL implementation, it might
|
||||||
allow you to save some texture memory. However, use the \uicontrol RGB
|
allow you to save some texture memory. However, use the \uicontrol RGB
|
||||||
and \uicontrol Alpha values with caution, because the underlying hardware
|
and \uicontrol Alpha values with caution because the underlying hardware
|
||||||
and driver might not support them.
|
and driver might not support them.
|
||||||
|
|
||||||
In the \uicontrol {Texture mirroring} field, specify whether the generated
|
In the \uicontrol {Texture mirroring} field, specify whether the generated
|
||||||
|
@@ -1,48 +1 @@
|
|||||||
<?xml version="1.0" encoding="UTF-8"?>
|
<?xml version="1.0" encoding="UTF-8"?><QtAdvancedDockingSystem version="1" userVersion="0" containers="1"><container floating="false"><splitter orientation="Horizontal" count="3"><splitter orientation="Vertical" count="3"><area tabs="2" current="Navigator"><widget name="Navigator" closed="false"/><widget name="DebugView" closed="false"/></area><area tabs="2" current="Assets"><widget name="Assets" closed="false"/><widget name="Components" closed="false"/></area><area tabs="3" current="Projects"><widget name="Projects" closed="false"/><widget name="FileSystem" closed="false"/><widget name="OpenDocuments" closed="false"/></area><sizes>355 428 404</sizes></splitter><splitter orientation="Vertical" count="4"><splitter orientation="Horizontal" count="2"><area tabs="2" current="FormEditor"><widget name="FormEditor" closed="false"/><widget name="TextEditor" closed="false"/></area><area tabs="1" current="MaterialEditor"><widget name="MaterialEditor" closed="false"/></area><sizes>678 678</sizes></splitter><splitter orientation="Horizontal" count="2"><area tabs="1" current="Editor3D"><widget name="Editor3D" closed="false"/></area><area tabs="1" current="MaterialBrowser"><widget name="MaterialBrowser" closed="false"/></area><sizes>678 678</sizes></splitter><area tabs="2" current="Timelines"><widget name="StatesEditor" closed="true"/><widget name="Timelines" closed="true"/></area><area tabs="1" current="OutputPane"><widget name="OutputPane" closed="true"/></area><sizes>641 547 0 0</sizes></splitter><splitter orientation="Vertical" count="2"><area tabs="1" current="Properties"><widget name="Properties" closed="false"/></area><area tabs="1" current="ConnectionView"><widget name="ConnectionView" closed="false"/></area><sizes>831 357</sizes></splitter><sizes>453 1357 453</sizes></splitter></container></QtAdvancedDockingSystem>
|
||||||
<QtAdvancedDockingSystem version="1" containers="1">
|
|
||||||
<container floating="false">
|
|
||||||
<splitter orientation="Horizontal" count="3">
|
|
||||||
<splitter orientation="Vertical" count="2">
|
|
||||||
<area tabs="4" current="Components">
|
|
||||||
<widget name="Components" closed="false"/>
|
|
||||||
<widget name="Assets" closed="false"/>
|
|
||||||
<widget name="Navigator" closed="false"/>
|
|
||||||
<widget name="DebugView" closed="false"/>
|
|
||||||
</area>
|
|
||||||
<area tabs="3" current="Projects">
|
|
||||||
<widget name="Projects" closed="false"/>
|
|
||||||
<widget name="FileSystem" closed="false"/>
|
|
||||||
<widget name="OpenDocuments" closed="false"/>
|
|
||||||
</area>
|
|
||||||
<sizes>653 436</sizes>
|
|
||||||
</splitter>
|
|
||||||
<splitter orientation="Vertical" count="4">
|
|
||||||
<area tabs="2" current="FormEditor">
|
|
||||||
<widget name="FormEditor" closed="false"/>
|
|
||||||
<widget name="TextEditor" closed="false"/>
|
|
||||||
</area>
|
|
||||||
<area tabs="1" current="Editor3D">
|
|
||||||
<widget name="Editor3D" closed="false"/>
|
|
||||||
</area>
|
|
||||||
<area tabs="2" current="Timelines">
|
|
||||||
<widget name="StatesEditor" closed="true"/>
|
|
||||||
<widget name="Timelines" closed="true"/>
|
|
||||||
</area>
|
|
||||||
<area tabs="1" current="OutputPane">
|
|
||||||
<widget name="OutputPane" closed="true"/>
|
|
||||||
</area>
|
|
||||||
<sizes>600 600 0 0</sizes>
|
|
||||||
</splitter>
|
|
||||||
<splitter orientation="Vertical" count="2">
|
|
||||||
<area tabs="1" current="Properties">
|
|
||||||
<widget name="Properties" closed="false"/>
|
|
||||||
</area>
|
|
||||||
<area tabs="1" current="ConnectionView">
|
|
||||||
<widget name="ConnectionView" closed="false"/>
|
|
||||||
</area>
|
|
||||||
<sizes>762 327</sizes>
|
|
||||||
</splitter>
|
|
||||||
<sizes>376 1127 376</sizes>
|
|
||||||
</splitter>
|
|
||||||
</container>
|
|
||||||
</QtAdvancedDockingSystem>
|
|
||||||
|
@@ -74,7 +74,7 @@ bool AndroidPotentialKit::isEnabled() const
|
|||||||
}
|
}
|
||||||
|
|
||||||
return QtSupport::QtVersionManager::version([](const QtSupport::QtVersion *v) {
|
return QtSupport::QtVersionManager::version([](const QtSupport::QtVersion *v) {
|
||||||
return v->isValid() && v->type() == QString::fromLatin1(Constants::ANDROID_QT_TYPE);
|
return v->type() == QString::fromLatin1(Constants::ANDROID_QT_TYPE);
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@@ -96,7 +96,8 @@ bool AndroidQtVersion::supportsMultipleQtAbis() const
|
|||||||
|
|
||||||
Abis AndroidQtVersion::detectQtAbis() const
|
Abis AndroidQtVersion::detectQtAbis() const
|
||||||
{
|
{
|
||||||
return Utils::transform<Abis>(androidAbis(), &AndroidManager::androidAbi2Abi);
|
const bool conf = AndroidConfigurations::currentConfig().sdkFullyConfigured();
|
||||||
|
return conf ? Utils::transform<Abis>(androidAbis(), &AndroidManager::androidAbi2Abi) : Abis();
|
||||||
}
|
}
|
||||||
|
|
||||||
void AndroidQtVersion::addToEnvironment(const Kit *k, Utils::Environment &env) const
|
void AndroidQtVersion::addToEnvironment(const Kit *k, Utils::Environment &env) const
|
||||||
|