diff --git a/doc/qtdesignstudio/config/qtdesignstudio-icon-macros.qdocconf b/doc/qtdesignstudio/config/qtdesignstudio-icon-macros.qdocconf index 5524c61011f..75f164e992e 100644 --- a/doc/qtdesignstudio/config/qtdesignstudio-icon-macros.qdocconf +++ b/doc/qtdesignstudio/config/qtdesignstudio-icon-macros.qdocconf @@ -230,6 +230,7 @@ macro.imageselectgroup = "\\inlineimage ic macro.imageselectitem = "\\inlineimage icons/select_item.png {the Select Item button}" macro.imageselectlanguages = "\\inlineimage icons/select-languages.png {the Select languages button}" macro.imagesettings = "\\inlineimage icons/settings.png {the Settings button}" +macro.imageshareproject = "\\inlineimage icons/share-project.png {the Share Project button}" macro.imagesketchlogo = "\\inlineimage sketch-logo.png {the Sketch logo}" macro.imageslidericon16 = "\\inlineimage icons/slider-icon16.png {the Slider component}" macro.imagesnapping = "\\inlineimage icons/snapping.png {the Snapping button}" diff --git a/doc/qtdesignstudio/images/icons/share-project.png b/doc/qtdesignstudio/images/icons/share-project.png new file mode 100644 index 00000000000..7875cf1d181 Binary files /dev/null and b/doc/qtdesignstudio/images/icons/share-project.png differ diff --git a/doc/qtdesignstudio/images/qt-design-viewer-homepage.webp b/doc/qtdesignstudio/images/qt-design-viewer-homepage.webp new file mode 100644 index 00000000000..c2d87fd20a8 Binary files /dev/null and b/doc/qtdesignstudio/images/qt-design-viewer-homepage.webp differ diff --git a/doc/qtdesignstudio/images/qt-design-viewer-share-options.webp b/doc/qtdesignstudio/images/qt-design-viewer-share-options.webp new file mode 100644 index 00000000000..7a450839b7b Binary files /dev/null and b/doc/qtdesignstudio/images/qt-design-viewer-share-options.webp differ diff --git a/doc/qtdesignstudio/images/qt-design-viewer-share.webp b/doc/qtdesignstudio/images/qt-design-viewer-share.webp new file mode 100644 index 00000000000..9712c481bd4 Binary files /dev/null and b/doc/qtdesignstudio/images/qt-design-viewer-share.webp differ diff --git a/doc/qtdesignstudio/images/qt-design-viewer-shared-application-link.webp b/doc/qtdesignstudio/images/qt-design-viewer-shared-application-link.webp new file mode 100644 index 00000000000..c5bbf58c7c0 Binary files /dev/null and b/doc/qtdesignstudio/images/qt-design-viewer-shared-application-link.webp differ diff --git a/doc/qtdesignstudio/images/qt-design-viewer.webp b/doc/qtdesignstudio/images/qt-design-viewer.webp index 47c80e4d6ad..598561dfe24 100644 Binary files a/doc/qtdesignstudio/images/qt-design-viewer.webp and b/doc/qtdesignstudio/images/qt-design-viewer.webp differ diff --git a/doc/qtdesignstudio/images/share-online-manage.webp b/doc/qtdesignstudio/images/share-online-manage.webp deleted file mode 100644 index 3ddb938dfcb..00000000000 Binary files a/doc/qtdesignstudio/images/share-online-manage.webp and /dev/null differ diff --git a/doc/qtdesignstudio/images/share-online.webp b/doc/qtdesignstudio/images/share-online.webp deleted file mode 100644 index 7ba08aa4271..00000000000 Binary files a/doc/qtdesignstudio/images/share-online.webp and /dev/null differ diff --git a/doc/qtdesignstudio/images/studio-share-logged-in.webp b/doc/qtdesignstudio/images/studio-share-logged-in.webp new file mode 100644 index 00000000000..d840d3df1f8 Binary files /dev/null and b/doc/qtdesignstudio/images/studio-share-logged-in.webp differ diff --git a/doc/qtdesignstudio/images/studio-share-sign-in.webp b/doc/qtdesignstudio/images/studio-share-sign-in.webp new file mode 100644 index 00000000000..c3102d42a6d Binary files /dev/null and b/doc/qtdesignstudio/images/studio-share-sign-in.webp differ diff --git a/doc/qtdesignstudio/src/overviews/qt-design-viewer.qdoc b/doc/qtdesignstudio/src/overviews/qt-design-viewer.qdoc index e3f4c9f3926..8eed306d789 100644 --- a/doc/qtdesignstudio/src/overviews/qt-design-viewer.qdoc +++ b/doc/qtdesignstudio/src/overviews/qt-design-viewer.qdoc @@ -1,4 +1,4 @@ -// Copyright (C) 2024 The Qt Company Ltd. +// Copyright (C) 2025 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only /*! @@ -8,42 +8,81 @@ \title Sharing applications online - \image qt-design-viewer.webp + \image {qt-design-viewer.webp} {Qt Design Viewer example} In \QDS, you can share your applications in most widely-used web browsers, such as Apple Safari, Google Chrome, Microsoft Edge, and Mozilla Firefox, on the desktop and on mobile devices. - The application shared online runs in Qt Design Viewer, which is a QML + The application shared online runs in \QDV, which is a QML viewer that runs in your web browser. The startup and compilation time depend on your browser and configuration. However, the actual performance of the application once started is indistinguishable from the same application running on the desktop. - The loaded applications remain locally in your browser. No data is uploaded - into the cloud. + \section1 Connecting to the \QDV web service - \section1 Sharing your application online + \list 1 + \li Open a project in \QDS. + \li Select \imageshareproject in the top toolbar, then select \uicontrol {Sign in}. + \image {studio-share-sign-in.webp} {Sign in to the Design Viewer web service} + + \li Log in with your Qt account. After logging in, you receive 10 GB of + space on the \QDV server to upload your projects. + \image {studio-share-logged-in.webp} {After signing in to the Design Viewer} + \endlist + + To sign out of the \QDV web service, select \imageshareproject in the top toolbar, + then select \uicontrol {Sign out}. + + \section1 Sharing your application online from \QDS To share your \QDS application online: \list 1 \li Open the application in \QDS. - \li Select \uicontrol File > \uicontrol {Share Application Online}. - \li Optionally, select \uicontrol {Protect with password}, and enter a password to prevent - unauthorized viewing of the application. - \note If you share the same application again, you must set the password - again. Otherwise, the application is not password protected any longer. - \li Select \uicontrol Share. - \image share-online.webp + \li \l {Connecting to the \QDV web serivce} {Connect} \QDS to the \QDV web service. + \li Select \imageshareproject in the top toolbar, then select \uicontrol Share. \endlist - You can now open the application in a web - browser, copy the link to share with others, or manage your shared - applications. + \section1 Running the shared \QDS application in the \QDV web service - \image share-online-manage.webp + \list 1 + \li Go to the \l {https://designviewer.qt.io/} {\QDV web service}. + \image {qt-design-viewer-homepage.webp} {Qt Design Viewer homepage} + + \li Log in with your Qt account. + \li Select \uicontrol Projects, then select the project you want to run. + \endlist + + \note The changes you make after sharing the application from \QDS are not immediately + reflected in the \QDV web service. Share the application again + from \QDS to have the latest changes in the \QDV web service. + + \section1 Sharing an application from the \QDV web service + + \list 1 + \li Go to the \l {https://designviewer.qt.io/} {\QDV web service}. + \li Log in with your Qt account. + \li Select \uicontrol Projects, then find the project you want to share. + \li To open the extra options, select \imagemorebutton in the project thumbnail, + then select \uicontrol Share. + \image {qt-design-viewer-share.webp} {Share application from Qt Design Viewer} + + \li Select the corresponding options to add a description, set an expiration date, + or protect the project with a password. + \image {qt-design-viewer-share-options.webp} {Options for shared application in Qt Design Viewer} + + \li After selecting your preferred options, select \uicontrol {Create new link}. + \endlist + + Share the generated link with others to allow them direct access to the application. + \image {qt-design-viewer-shared-application-link.webp} {Generated link after sharing the application from Qt Design Viewer} + + \note You cannot update the description, expiration date, or password on an + existing shared link. Instead, create a new link by + following the above process. \section1 Best practices