Developing for Universal Windows Platform

The following steps outline the basic procedure for creating a Universal Windows Platform (UWP) application from Synergy templates. Most of these steps outline Visual Studio procedures, so see Visual Studio documentation for full information.


You can use the “Synergy Blank App (Universal Windows)” project template to quickly get a simple application up and running on a mobile emulator in Visual Studio. See UWP quick start (Hello World).

Developing for UWP is similar to developing Windows desktop and server applications (see Developing Windows Desktop and Server Applications), but there are different restrictions, special defines, templates, and so forth. Many of these are discussed below, but see Feature Support for more information.

Additionally, any UWP solution with a Synergy project must implement Synergy device licensing. See Licensing .NET assemblies. And note that Windows updates can prevent developer-deployed UWP apps from working. If this happens, redeploy affected apps.

1. Start by reviewing Synergy .NET Requirements. Your Windows development machine and the Visual Studio projects you develop must meet requirements listed in that section.
2. Set options for your Visual Studio environment. For example, you can control the behavior of the Visual Studio code editor and the way IntelliSense works for Synergy DBL files. See Options for Synergy/DE projects.
3. In Visual Studio, create a project for each assembly in the UWP application. The following Synergy templates can be used for UWP projects:

For example, to create an executable assembly, select File > New Project, select Synergy/DE > Universal from the Installed Templates area of the New Project dialog, and then select “Blank App (Universal Windows)” from the list of project types. You’ll then need to set a few options for the project (name, location, and so forth) in the New Project dialog. Note the following:

4. Add DBL code, resource, controls, etc., to the Visual Studio projects, and make sure each project references needed assemblies. (For information on item templates, see Synergy/DE item templates.) Note the following:
5. Set project properties. (See Synergy/DE project properties.)
6. Build and debug the project in Visual Studio. See Visual Studio documentation for information on building and debugging, and see Debugging Synergy .NET Code. At build time, Visual Studio creates an .appxupload package, which is what you will deploy. When you are ready to release the application, you will submit this package to the Windows Store. Note that these steps are common to all UWP applications, so see Microsoft documentation for information.

UWP quick start (Hello World)

If your system meets the requirements for UWP development (see Synergy .NET Requirements) and you have a GUID and a public key from Synergex (see Device licensing (.NET)), you can have a simple UWP app running on a mobile emulator in Visual Studio in a matter of minutes.

1. Open Visual Studio and select File > New > Project. Then in the new Project Window, select “Blank App (Universal Windows)” in Installed > Synergy/DE > Universal:
2. Set the options for the project (name, location, and so forth) in the New Project dialog, and then click OK.

The new project opens in Visual Studio:

3. Open LicenseClass.dbl in the editor, find the assembly:SynergyDeviceLicense... line, and enter your public key and GUID values for device licensing. In other words, insert the public key and GUID values between the quotes that follow PublicKey= and AppGUID=.
4. In the toolbar drop-down list for emulation, select Local Machine:
5. Select Build > Build Solution. The Output window should show that the build succeeded.
6. When the project has finished building, select Debug > Start Debugging.
7. Wait while Visual Studio deploys your application to the emulator, which may take a few minutes. When it’s finished, your application should be running on the mobile emulator, and the application will display a License Login screen:

Congratulations! You have just created a Synergy UWP application.