Deploying Felgo Games & Apps to Windows Phone 8.1 and Windows Runtime

Introduction

Qt 5.4 added support for Windows Phone 8.1 and Windows Runtime, this means you can also run your Felgo apps or games on these new platforms. Since the new platform support, there are currently some bugs in the Qt framework that may affect your apps or games. Please have a look at the limitations for Felgo in the current Felgo version.

In addition to the official deployment guides by Qt below, you can find a summary of the steps needed to explore the world of Qt and Felgo on Windows Phone 8.1 and Windows Runtime in this document. If you encounter any problems while setting this up, please read the official guides in the next section closely.

Official Qt Deployment Guides for Windows Phone 8.1 and Windows Runtime

• Qt for UWP: Detailed guide for setting up Qt to run on Windows Phone 8.1 and Windows Runtime.
• Video guide by Qt: Video version of the guide which also covers all important steps. The most important commands for the command prompt from the video can also be found in the Felgo guide below. It's a little bit outdated though, so make sure you are also reading the Felgo guide.

Running Felgo Apps or Games on Windows Phone 8.1 and Windows Runtime - Important Deployment Steps

Requirements

• Windows 8.1
• Windows Phone SDK

Depending on your device target you will need the following tools provided by Microsoft to be installed:

If you are targeting a remote device, please follow all instructions by Visual Studio to set it up correctly.

Build Settings

Open your Felgo project in Qt Creator and switch to the Projects-Tab. Add the Windows Phone Kit (or Windows Runtime), select it and make sure you enabled shadow build.

Now hit "Build Project" (the hammer icon in the lower left of Qt Creator) to create the shadow build which we will then use to deploy the project to your Windows Phone (or Windows Runtime). Make sure you have selected the right kit.

Create a Visual Studio Project

Qt Creator does not support debugging your Windows Phone 8.1 or Windows Runtime Apps (yet). That's why we need to convert the Qt Creator project to a Visual Studio project. You can do so very easily with a single qmake command.

Open a command prompt and switch to the directory of your shadow build.

Now execute following command: <Path to your Qt installation>\5.4\winphone_arm\bin\qmake.exe -tp vc CONFIG+=windeployqt <Your *.pro file>

Use the explorer to navigate to the generated files and open the *.vcxproj file with Visual Studio.

Deploy the Application

All that is left for you to do now is to hit the RUN button in Visual Studio!

NOTE: If you change your source code in the QtCreator now, make sure to call the qmake.exe command again, to also update the Visual Studio project, before running it on the device again.

Windows Phone 8.1 and Windows Runtime Limitations

• GameSoundEffect and GameSoundEffect components are not working. Use Audio or MediaPlayer components instead.
• FelgoGameNetwork is not working.
• If you encounter any other problems, please drop us a mail at support@felgo.com. Then we can try to find a quick fix, or if it turns out to me a major issue, we will add it to this list.