Creating Qt Quick Projects

When you create a new Qt Quick project from scratch, you have the following options:

• Qt Quick UI creates a Qt Quick UI project with a single QML file that contains the main view. You can review Qt Quick UI projects in the QML Viewer and you need not build them. You do not need to have the development environment installed on your computer to create and run this type of projects.
• Qt Quick Application creates a Qt Quick application project that can contain both QML and C++ code. The project includes a QDeclarativeView. You can build the application and deploy it on desktop and mobile target platforms. For example, you can create signed Symbian Installation System (SIS) packages for this type of projects.
• Custom QML Extension Plugin creates a C++ plugin that makes it possible to offer extensions that can be loaded dynamically into applications by using the QDeclarativeEngine class.

If you have existing QML applications that you want to run in Qt Creator or deploy to mobile devices, use the Qt Quick Application wizard to convert them to Qt Quick applications.

Creating Qt Quick UI Projects

1. Select File > New File or Project > Qt Quick Project > Qt Quick UI > Choose....

   The Introduction and Project Location dialog opens.

   

2. In the Name field, give a name to the project.

   Do not use spaces and special characters in the project name and path.

3. In the Create in field, enter the path for the project files. For example, C:\Qt\examples. To select the path from a directory tree, click Browse.
4. Click Next.

   

5. Review the project settings, and click Finish to create the project.

Qt Creator creates the following files:

• .qmlproject project file defines that all QML, JavaScript, and image files in the project folder belong to the project. Therefore, you do not need to individually list all the files in the project.
• .qml file defines an element, such as a component, screen, or the whole application UI.

The import statement in the beginning of the .qml file specifies the Qt modules to import. Each Qt module contains a set of default elements. Specify a version to get the features you want.

To use JavaScript and image files in the application, copy them to the project folder.

Creating Qt Quick Applications

1. Select File > New File or Project > Qt Quick Project > Qt Quick Application > Choose....

   The Introduction and Project Location dialog opens.

   

2. In the Name field, give a name to the project.

   Do not use spaces and special characters in the project name and path.

3. In the Create in field, enter the path for the project files. For example, C:\Qt\examples. To select the path from a directory tree, click Browse.
4. Click Next.

   The Qt Versions dialog opens.

   

5. Select the Qt versions to use as build targets for your project, and then click Next.

   Note: Qt Quick is supported since Qt 4.7, and therefore, only Qt 4.7 and later versions are displayed. Further, if you have only one supported Qt version installed, this dialog is skipped.

   The Application Options dialog opens.

   

6. In the Orientation behavior field, determine how the application behaves when the orientation of the device display rotates between portrait and landscape.
7. In the Application icon field, select an application icon.
8. In the Target UID3 field, specify the Application UID.

   Note: Qt Creator generates a UID for testing the application on a device. You need to change the UID when you deliver the application for public use.

9. If the application needs network connectivity, select the Enable network access check box, and then click Next.

   The QML Sources dialog opens.

   

10. In the QML Main File group, select Generate a .qml file, and then click Next.

    The Project Management dialog opens.

    

11. In the Add to project field, you can add this project to another project as a subproject.
12. In the Add to version control field, you can add the project to a version control system.
13. Click Finish to create the project.

Qt Creator creates the necessary boilerplate files. Some of the files are specific to the Symbian or Maemo platform.

Importing QML Applications

If you have existing QML applications that you want to run in Qt Creator or deploy to mobile devices, use the Qt Quick Application wizard and select the main .qml file in your project. All the other files in the project are automatically added to the application project.

For example, you can open and run the QML examples and demos to learn how to use various aspects of QML. To run the examples in the QML Viewer on the desktop, open them in the Welcome mode. To view the examples on mobile devices, use the Qt Quick Application wizard to convert them into Qt Quick Applications.

To import QML applications:

1. Select File > New File or Project > Qt Quick Project > Qt Quick Application > Choose....
2. Name the project and set its path, and then click Next.
3. Select the Qt versions to use as build targets for your project, and click Next.
4. Specify options for deploying the application to mobile device targets, and click Next.
5. In the QML Sources dialog, select the Import an existing .qml file option and specify the main .qml file of the project you want to import.

   

6. Click Next.
7. Review the project settings, and click Finish to create the project.

Qt Creator adds references to the QML files to a project and creates the additional files necessary for deploying applications to mobile devices.