Files
qt-creator/doc/qtdesignstudio/src/qtdesignstudio-qt-ui-viewer.qdoc
Pranta Dastider 43f9c2abbc QmlDesigner: Update the documentation for Run dropdown and Qt UI viewer
The Run dropdown button is a new inclusion which has
changed the way how applications can be run or preview
in Qt Design Studio. This document updates the basic
idea of that across a few documents. It also updates
the old Qt UI viewer document to include the new way
of intracting with the Android app and Qt design studio.

Fixes: QDS-13920
Fixes: QDS-14311
Fixes: QDS-13918
Change-Id: I66d3bdbf147c750f59d5521878015d6a8a7c0c92
Reviewed-by: Mats Honkamaa <mats.honkamaa@qt.io>
2025-02-07 10:51:49 +00:00

93 lines
3.5 KiB
Plaintext

// Copyright (C) 2025 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\previouspage design-viewer-single-page-navigation.html
\page qt-ui-viewer.html
\nextpage studio-exporting-and-importing.html
\title Viewing applications on Android
Run and preview your \QDS projects in \QUV with a
direct network connection in real-time.
\section1 Installing Qt UI Viewer
To install \QUV on your Android device:
\list 1
\li Open the Google Play store on your Android device.
\li Search for \QUV.
\li Select \uicontrol Install.
\endlist
\image qtuiviewer-appstore.webp Qt UI Viewer in the Google Play Store
\section1 Creating a network connection between \QDS and \QUV
\note Use the same network to connect both \QDS and your
Android device where you have installed \QUV.
\list 1
\li Open \QUV on your Android device. Find the IP address and note it down.
\li Open or create a project in \QDS.
\li Select \uicontrol Run dropdown from the top toolbar and select
\uicontrol {Device Manager}.
\image studio-run-dropdown.webp Device Manager in the Run dropdown
\li In \uicontrol {Set target device IP} write the IP address you have
noted from \QUV. Then, select \imageplus. Your device is now added
to the list of available devices.
\list
\li To update the device name, edit \uicontrol Alias.
\li To show your device in the \uicontrol Run dropdow,
always keep \uicontrol Enabled turned on.
\li If you are connected to the same network, and \QUV is running on your
Android device, the \uicontrol Status is Online.
\endlist
\image studio-devicemanager-add-device.webp {Add an device in the Device Manager}
\endlist
\note You can connect multiple Android devices to \QDS. Then, run a \QDS
project on any of the devices by selecting them from
\uicontrol Run dropdown, and selecting \imagerunproject.
\section1 Previewing a \QDS project in \QUV
Once you have created a network connection between \QDS and \QUV:
\list 1
\li Open or create a project in \QDS.
\li Open \QUV on your Android device.
\li Select your Android device from the \uicontrol Run dropdown.
\image studio-run-dropdown-with-added-device.webp {Android device listed in the Run dropdown}
\li Select \imagerunproject.
\endlist
Every time you close \QUV or \QDS, you need to follow the above process
to preview it again in \QUV.
To fit the preview on your Android device's screen, select \uicontrol Settings
in the \QUV and turn on \uicontrol Auto-scale. \QUV follows the orientation of your
Android device.
To keep your Android device awake, select \uicontrol Settings
in the \QUV and turn on \uicontrol {Keep screen on}.
\image qtuiviewer-settings.webp Settings of the Qt UI Viewer
\section1 Removing a connected Android device from \QDS
\list 1
\li Open or create a project in \QDS.
\li Select \uicontrol Run dropdown from the top toolbar and select
\uicontrol {Device Manager}.
\li Select the device you want to remove from the list of devices and
select \imageminus.
\image studio-devicemanager-remove-device.webp Remove a device from the Device Manager
\endlist
*/