Synergy .NET Requirements

This topic lists basic requirements for developing and deploying Synergy .NET assemblies. It includes the following sections:

Development system requirements

To develop with Synergy .NET, you’ll need a Windows development machine with the following:

SDI is the Synergy/DE product that enables you to develop Synergy programs in Visual Studio. See http://www.synergex.com/synergy_net.aspx for detailed system requirements, including additional requirements for Android, iOS, and Linux development:

Application requirements

A Visual Studio solution that includes one or more Synergy assemblies must have a reference to Synergy runtime libraries and must use Synergy licensing. These requirements are discussed in this section (Synergy runtime libraries below and Licensing .NET assemblies). For platform-specific application requirements, see

Synergy runtime libraries

Every Visual Studio solution that has a Synergy project must have a reference to Synergy runtime libraries. This reference must be in a project that is not for a portable class library.

Runtime libraries for desktop and server applications

For desktop and server applications (Windows and Linux), this reference must be to synrnt. Most Synergy project templates for desktop and server applications automatically add this reference. The exception is Synergy portable class library projects. These do not include this reference, so if all Synergy projects in a solution are for portable class libraries, you must manually add this reference to a non-Synergy project.

Synergy runtime libraries are included in the Synergy/DE Professional Series distributions for Windows and Linux. But on Linux systems, you must manually add the synrnt runtime library (located in dbl/bin) to the global assembly cache or make sure it is in the same folder as your application binaries. To add synrnt to the global assembly cache, use the following command:

sudo GACUTIL -i synrnt.dll

Runtime libraries for devices

For a device application (UWP, Android, or iOS), at least one Visual Studio project for the application must have a reference to the Synergex.SynergyDE.synrnt NuGet package. This contains the runtime libraries for devices. It is installed to a local NuGet repository when Synergy DBL Integration is installed, and it is available on the NuGet site: www.nuget.org/packages/Synergex.SynergyDE.synrnt. Note the following:

Install-Package Synergex.SynergyDE.synrnt -Pre

When you create a project from a Synergy UWP, Android, or iOS template, a reference is automatically added to the project. When this reference is added, the version of the NuGet package installed with Synergy DBL Integration is copied to a repository for the project. From that point on, the package installed with Synergy DBL Integration is completely separate from the package for the project. Note the following:

Licensing .NET assemblies

Synergy .NET assemblies (executables and class libraries) require either traditional Synergy licensing or Synergy device licensing.

Note that if your application uses traditional Synergy licensing and the target machine has not been configured for local Synergy licensing, you must specify a license server name in the App.config file. See Runtime Settings page, Project Designer (Synergy .NET) for information.

To use device licensing, your application must have a device licensing implementation. Projects created from the following Synergy project templates include basic device licensing implementations, but you may need to modify these or create your own implementations to meet your licensing requirements:

In the project that includes the device licensing attribute (SynergyDeviceLicenseAttribute), select the “Enable Device Licensing” option on the Compile page of Project Designer. (See Compile page, Project Designer (Synergy .NET) for information.) Do not use this option for any other project in a solution.

For more information on licensing, see Configuring License Manager and Device licensing (.NET).

Deployment requirements

To deploy a Windows desktop or server application (not UWP), the target Windows system must have .NET Framework and Synergy/DE Professional series, which includes the Synergy .NET runtime libraries. (With ClickOnce deployment, it is possible to deploy to Windows machines that do not have Synergy/DE, but this is not supported. See ClickOnce Deployment for Synergy .NET for more information.)

To deploy a UWP application, the target system must have a Windows 10 operating system (e.g., Windows 10 Mobile).

To deploy to an Android, iOS, or Linux application, the target system must have Mono. For Android, Xamarin includes a full or partial (linked) installation of Mono in deployment packages. Xamarin also includes Mono in iOS deployments. (See Xamarin documentation for information.) However, for Linux