Licensing Instructions
Standard (Royalty-Free) Licensing
These .NET components use Microsoft's .NET Licensing scheme.
In Microsoft's .NET Licensing scheme, Visual Studio automatically creates a file named "licenses.licx" whenever you drop a licensed component on the form. The "licenses.licx" file is automatically added to your project as an embedded resource. When you build the project, this licenses.licx file will be used to embed license information into the compiled assembly .
If you are not using a form or you are creating the components dynamically, the easiest way to generate the licx file is to use a separate project, drop a component on a form, and copy the licenses.licx file over to your formless project.
Important Notes:
- The licx file must be named "licenses.licx" and be included in the project as an embedded resource.
- If you are developing a class library, the referencing project must also include the .licx file as an embedded resource and be compiled on a machine with a valid license installed.
- Activation checks are made on the developer machine only, not at runtime.
.NET Standard/.NET Core
If a license for the .NET Standard library has not already been activated on the machine this must be done first.
License Activation
The install-license application is a .NET Core console application included in the toolkit.
If the library was installed from a NuGet package this is present in the tools folder in the package installation directory. Typically the package can be found here on Windows: %USERPROFILE%\.nuget\packages\callback.cbfsfuse
If the library was installed as part of the .NET Edition this is present in the lib/netstandard2.0 folders in the installation.
To use the install-license application run the command:
dotnet ./install-license.dll <key>
Where key is your product key. This will install a license to this particular system. Read on for deployment instructions.
Deployment
The RuntimeLicense property must be set before deploying your application. To obtain this value on a properly licensed development machine, output the current value of the property. For instance:
Console.WriteLine(component.RuntimeLicense);
This will output a long string. Save this value and use it in your real application like so:
component.RuntimeLicense = "value_from_above";
Note: The same RuntimeLicense property value works for all components included in the toolkit.
Trial Licensing - .NET Standard/.NET Core
To activate a trial license use the install-license application. The install-license application is a .NET Core console application included in the toolkit.
If the library was
installed from a NuGet package this is present in the tools folder in the package installation directory.
Typically the package can be found here on Windows: %USERPROFILE%\.nuget\packages\callback.cbfsfuse
If the library was installed as part of the .NET Edition installer this is present in the lib/netstandard2.0
folders in the installation.
To use the install-license application run the command:
dotnet ./install-license.dll
Xamarin Notes: When using a trial license in Xamarin.iOS and Xamarin.Android no special steps are required; simply create and use the component.
UWP Notes: Fall Creator's Update and later requires the trial license to be included as an embedded resource. From the solution
explorer in Visual Studio add an existing item to the project and add %USERPROFILE%\.callback\CUNFA.lic.
Set the Build Action property for the file to Embedded Resource.
If you have purchased a license, but are still getting a license exception, check the following:
If you would like to transfer your license to another system, please complete our
license transfer form. This will ensure your installations are not mistaken for license violations.
For additional information about our product activation process, please refer to our
product activation FAQ.
Troubleshooting
License Transfer