Setting up your environment for development

Before you start creating your .NET application, check the list below to ensure your environment is set up properly. If you are working on the same machine as was used to create the assembly, some of these steps are already done. If not, you’ll need to copy files to your .NET development machine.

1.

Install Visual Studio and xfNetLink .NET.

2.

If you generated the assembly from Workbench or with the batch file, copy your Synergy .NET assembly to a location where your application can reference it and, if necessary, register it in the GAC. There are two instances in which your assembly must be registered in the GAC:

• The assembly will be public.
• Your application will use pooling and pass structures as parameters.

3.

If you generated the assembly from the MSBuild project, add a reference to that project in your Visual Studio project.

4.

(optional) Copy the files for the API documentation to the development machine. These files can go in any convenient location.

5.

Create or edit the configuration file (if your application will use one) using the xfNetLink .NET Configuration Utility, or set the necessary environment variables. See Specifying configuration settings for more information.

6.

If your application will use pooling, create, configure, and start the pool. See Understanding .NET pooling and Implementing COM+ pooling for .NET Framework or Implementing pooling for .NET Core and .NET 5.