// Copyright (C) 2024 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \previouspage studio-features-on-mcu-projects.html
    \page studio-projects-for-mcus.html
    \nextpage studio-creating-uis-for-mcus.html

    \title Creating projects for MCUs

    Use the \uicontrol {\QMCU} preset in the \QDS wizard to set up a new \QMCU
    project. When you create a project with the wizard, all the necessary files
    are created, you can adjust the project settings, and save custom presets.

    \image studio-preset-for-mcus.png {The Qt for MCU preset on the Qt Design Studio Welcome page.}

    Using the \uicontrol {\QMCU} preset creates an application that uses a subset
    of the default components that you can deploy, run, and debug on MCU boards.

    \note For more information on the default components available for MCU
    projects, see \l {\QDS features on MCU projects}.

    \section1 Creating an MCU project

    To create an MCU project:

    \list 1
        \li Select \uicontrol {File} > \uicontrol {New Project}.
        \li In the \uicontrol {Presets} tab, select the \uicontrol {\QMCU} preset.
        \li In the \uicontrol {Details} tab:
        \list
            \li Select the path for the project files. You can move the project
            folders later.
            \li Set the screen size to match the device screen, which also enables
            previewing on the desktop. You can change the screen size later in
            \l {Properties}.
        \endlist
        \li Select \uicontrol {Create} to create the project.
    \endlist

        \QDS creates the following files and folders:

    \list
        \li \c{.qmlproject} project file defines that all component and image files
            in the project folder belong to the project. All files are added
            automatically to their respective Files node based on their
            type.
            \note \QMCU does not recommend using the directory property to
            individually list the files in the project.
        \li \c {.qml} files define the functionality and appearance of application
            components.
        \li \c Screen01.ui.qml defines a custom component that you can edit in
            the \l {2D} view. For more information, see \l {UI files}.

            While the custom component is a good starting point for new users,
            you don't have to use it. Specifically, if you export and import
            designs using \QB, your file is most likely called something
            else. For more information, see \l {Exporting from Design Tools}.

            \note For MCU projects you can only import 2D assets.
        \li \c CMakeLists.txt project configuration file allowing you to
            share your project as a fully working C++ application with
            developers.
        \li \c {qtquickcontrols2.conf} file specifies the preferred style and some
            style-specific arguments.
        \li \c fonts folder contains font files that you have added in
            \uicontrol Assets.
        \li \c imports folder contains a \c {Constants.qml} file that specifies
            a font loader for the Arial font and the screen resolution. The size
            of the default \c {Screen.ui.qml} \l{basic-rectangle}{Rectangle} should
            be set as \c {width: Constants.width} & \c {height: Constants.height}
            so that it inherits the global resolution saved here.
        \li \c MCUDefaultStyle folder contains the default UI images and
            components available for the MCU project.
    \endlist

    To use image files in the UI, select \uicontrol Assets > \imageplus
    .

    \sa {Using Custom Presets}

    \section1 Adding files to MCU projects

    You can use wizard templates to add individual files to projects.

    The wizard templates in the \uicontrol {Qt Quick Controls} category create
    stylable versions of the components in the \uicontrol {Qt Quick Controls}
    module. For more information, see \l{Creating Custom Controls}.

    You can create the following types of files:

    \table
    \header
        \li Category
        \li Wizard template
        \li Purpose
    \row
        \li {1,5} Qt Quick Files
    \row
        \li Qt Quick File
        \li Generates a component with one of the following default components
            or \l{Using positioners}{positioners} as the root component:
            \l {basic-item}{Item}, \l {basic-rectangle}{Rectangle}, \l {Images}
            {Image}, \l {Border Image}, \l Flickable, Row, Column, Flow, or
            Grid.
    \row
        \li Qt Quick UI File
        \li Generates a UI file with one of the above components as the root
            component.
    \row
        \li Qt Quick Views
        \li Generates a List View. For more information, see
            \l{List Views and Grid Views}.
    \row
        \li Qt Quick UI Form
        \li Creates a UI file along with a matching QML file for
            implementation purposes.
    \row
        \li {1,8} Qt Quick Controls
        \li Custom Button
        \li Creates a \l {Button}{push button} with a text label.
    \row
        \li Custom \CheckBox
        \li Creates a \l {Check Box}{checkbox}.
    \row
        \li Custom Dial
        \li Creates a \l {Slider and Dial}{dial}.
    \row
        \li Custom Slider
        \li Creates a \l {Slider and Dial}{slider}.
    \row
        \li Custom \SpinBox
        \li Creates a \l {Spin Box}{spin box}.
    \row
        \li Custom Switch
        \li Creates a \l {Switch}{switch} with on and off states.
    \row
        \li \l Pane
        \li Provides a background that matches the UI style and theme.
    \row
        \li SwipeView
        \li Enables users to navigate pages by swiping sideways.
    \row
        \li QML Files
        \li ListModel
        \li Adds a \l{Editing List Models}{list model} to the project.
    \endtable
*/
