• Introduction
  • Dev Environment Setup
  • Developing Apps
  • Data Handling
  • Device Capabilities
  • Testing & Debugging
  • Extending

Build for Windows 10 (UWP)

Setup

Follow the instructions for setting up the development environment for building Windows Phone 10 applications.

Application changes

  • Add a productid GUID to application build.yml . For example:

      uwp:
        productid: caa0300f-1021-40aa-bb98-27c5547616fa
    
When you use the `rhodes app` command to generate an application, a productid is generated automatically

Build and run using Rhodes gem

  • Install Rhodes gem

  • If it is the first time, you building uwp application, you may need to install all MSVS dependencies, needed by an application. To do that, from power shell go to the directory ‘\platform\uwp’ and run nuget_restore.sh

  • Run application simulator:

      $rake run:uwp
    
You may use your computer keyboard with Windows Phone 10 emulator. By default it is disabled, but you can enable it pressing **PgUp** key. While it is enabled a device rotation simulation is not supported. To rotate device you need to disable keyboard support pressing **PgDown** key. Look [MSDN page](https://docs.microsoft.com/en-us/windows/uwp/debug-test-perf/test-with-the-emulator) for much more details on this topic.
  • load application to device:

      $rake run:uwp:device
    
  • See log in application folder : rholog.txt

When running on device you may need to disconnect USB cable from device to see log
  • After Application code modifications, run rake commands. DO NOT close simulator!

Build from sources

  • Checkout rhodes source code from github

Build from IDE

Rhodes

  • Open rhodes\platform\uwp\rhodes.sln in VS 2015 or VS Express 2015 for Windows Phone with version 10.0.14393.
  • Select Debug or Release configuration, Windows Phone 10 Emulator target and build solution.
  • Run emulator by pressing Start Debugging or Start Without Debugging
  • After Application code modifications , build Rhodes solution and Start Debugging. DO NOT close emulator!
  • See log in VS output console (Debug mode only)

Building the application for the Windows Phone Store

Setting your application name, icon and loading screen

You will need to provide a name and icon for the application that the user will see on the device. You can also customize the loading screen that is shown while your application is launching. Refer to the Application Icon and Splash Screen guide for detailed information.

Turn off developer options

Update your application’s configuration files to make sure developer / debug / profile options are turned off.

The below values can be used as a guide for rhoconfig.txt, skip any setting which is not already present.

MinSeverity  = 3
LogToOutput = 0
net_trace = 0
log_skip_post = 0

The below values can be used as a guide for build.yml, skip any setting which is not already present.

profiler: 0 

Creating your application package

Once your build.yml is set up, you can run:

$ rake device:uwp:production

The compiled application .APPX file will be located in <your project folder>\bin\target\uwp and all dependencies you may need are in ‘\bin\target\uwp\Dependencies’

Deploying application to Windows Phone 10 device

To deploy application .APPX file to UWP device:

  1. Windows Phone 10 device should be registered for development.
  2. Connect WP10 device to your development Windows 10.x PC via USB
  3. On the PC go to Start screen and search for Application Deployment
  4. Run Application Deployment tool, specify Target=Device, select your APPX file and click Deploy.

Information about using certificate

Application key is placed here: ‘\platform\uwp\rhodes\rhodes_TemporaryKey.pfx’. If you got microsoft certification key - you can simply replace one to another (or change it in rhodes_dev.sln, if you want). In other cases you should use developer mode on your device. On Windows 10 for PC you should also add certificate from the preferences of *.appx. Here is few steps that could help: 1. Click Properties 2. Click Digital Signatures 3. Select Signature from the list 4. Click Details 5. Click View Certificate 7. Click Install Certificate 8. Install the Certificate

Quote from Installing developer packages on Windows RT

Click Next. Tap OK to confirm the UAC dialog.
In the next screen of the Certificate Import Wizard, change the selected option to Place all certificates in the following store.
Tap the Browse button. In the Select Certificate Store pop-up window, scroll down and select Trusted People, and then tap OK.
Tap the Next button; a new screen appears. Tap the Finish button.
A confirmation dialog should appear; if so, click OK. 

Publishing on Windows Phone Store

Uploading and Publishing your application

Publishing your application on Windows Phone Store is a simple two step process:

Refer to the official docs for all details about publishing to the Windows Phone Store.

Back to Top