Table of Contents

Licensing and Product Evaluation

The current document contains information about the product evaluation, license activation, and answers frequently asked questions regarding licensing.

Product Evaluation

The free 60-day trial version of the Eremex Controls Library allows you to evaluate the product in your projects and environment. If no active license is found, the Eremex Controls display trial messages.

eremex-controls-trial

Licensing

The licensing model of the Eremex Controls Library is outlined in the End User License Agreement (EULA).

During the license period you can create new projects using the Eremex Controls Library, and upgrade your existing projects with a new version of the Library. In the pre-build stage, the Eremex Controls' license manager generates the emxLicense.cs file that contains a unique license runtime key. The license runtime key contains information about the following settings:

  • Assembly name
  • Major version (XX.Y.z) of the Eremex Controls Library used in your project.

The `emxLicense.cs' file is created in the project's directory when the project is built. It is included in the project as a compile item.

emxLicense-cs-file

An example of the emxLicense.cs file that defines a license runtime key:

// This file is auto-generated. Please do not change it.
using System.Runtime.CompilerServices;
using Eremex.AvaloniaUI.Controls.License;

namespace DemoCenter;
public class LicenseProvider
{
#pragma warning disable CA2255 // The 'ModuleInitializer' attribute should not be used in libraries
	[ModuleInitializer]
#pragma warning restore CA2255 // The 'ModuleInitializer' attribute should not be used in libraries
    public static void RegisterLicense()
	{
        ControlsLicenseManager.SetRuntimeLicenseOwner(new LicenseProvider(),"", 
        "61 5C D0 DA 5E 85 40 27 D0 33 A1 27 5E A7 49 C0 55 B8 3F 84 29 15 30 E0 
        08 57 73 0B 33 D6 BF 34 51 3D AC 02 BD 11 BF C3");
	}
}

If the generated emxLicense.cs file is not automatically included to the project (for instance, because of an IDE setting), please include this file manually.

The license runtime key is used for license checking at runtime. If license information is invalid or not found, the Eremex Controls display a trial message.

License Expiration

After the license period expires, it is not possible to create new projects and update existing projects to a new major version of the Eremex Controls Library.

Projects that were created during the license period will continue to build and run. The only requirement is that you must not change the assembly name and major version of the Eremex Controls Library in your existing projects. Otherwise, the Eremex Controls will display a trial message at runtime. However, you are free to update the minor release number (XX.Y.z) of the Library in your projects, even after a license expires.

Manage Licenses

Developer licenses for Eremex Controls are managed by two utilities from Guardant:

  • 'Guardant Control Center' - A license management service. Installation file: grdcontrol-x.xx.msi for Windows, and grdcontrol-x.x_amd64.deb for Linux.
  • 'Guardant License Wizard' - A GUI and command-line tool that allows you to add, update and transfer licenses. Executable file: license_wizard.exe for Windows, and license_wizard for Linux.

You can download these tools using the following links:

Online Eremex Controls License Activation

  1. Install 'Guardant Control Center'

  2. Run 'Guardant License Wizard'

    guardant-license-wizard

  3. Click Settings, and ensure that the Server address property is set to https://getlicense.guardant.ru.

    guardant-license-wizard-settings-server-address

    Then click Back to return to the previous page.

  4. Click the License Activation button to add a new license key.

  5. Specify the computer on which you want to register a license.

    guardant-license-wizard-select-computer

  6. Enter your license key in the Serial Number field.

    guardant-license-wizard-specify-license-key

  7. Click Get license.

    If the license activation is successful, the Wizard will display information about the licensed products.

    guardant-license-wizard-list-of-licensed-products

Register a license from the command line

license_wizard --console --activate <LICENSE-KEY> --host https://getlicense.guardant.ru

Get information about all command-line options

license_wizard --help

Online Update of the Eremex Controls License

  1. Run 'Guardant License Wizard'

    guardant-license-wizard-linceses-list

  2. Click Settings, and ensure that the Server address property is set to https://getlicense.guardant.ru. Then click Back to return to the previous page.

  3. In the Licenses page, click the ellipsis ('...') button and click 'Check updates'.

    guardant-license-wizard-check-updates-button

  4. Click the Install Updates link that appears if a license update is found on the server.

  5. When the operation is successful, the Wizard will update the registered licenses.

Update a license from the command line

license_wizard --console --update <LICENSE-KEY> --host https://getlicense.guardant.ru

Offline Eremex Controls License Activation

  1. Run 'Guardant License Wizard'

    guardant-license-wizard

  2. Click 'License activation'.

  3. Select 'On this' to specify the computer on which you want to register a license.

    guardant-license-wizard-select-computer

  4. Click the 'Offline activation' button.

    guardant-license-wizard-offline-activation-button

  5. Click 'Save' to save a request for a new license to a file.

    guardant-license-wizard-offline-save-request-button

  6. On another computer with Internet access, run 'Guardant License Wizard'.

  7. Click Settings, and ensure that the Server address property is set to https://getlicense.guardant.ru. Then click Back to return to the previous page.

  8. In the Licenses page, click the License Activation button.

    guardant-license-wizard-offline-license-activation-button

  9. Select "On another" to specify the computer for which to activate a license. Then click 'Continue'.

    guardant-license-wizard-offline-another-comp

  10. Load the request for a license that was generated on a target computer.

    guardant-license-wizard-offline-load-request

  11. Enter your license number and click 'Activate a new license'.

    guardant-license-wizard-offline-enter-license

  12. Save the license file ('*.license').

    guardant-license-wizard-offline-save-license-file

  13. Go back to the target computer.

  14. Run 'Guardant License Wizard', and switch to the 'License activation' page.

  15. Select "On this" to the specify the computer for the license activation. Then click 'License file or rehost file', and load the generated license file ('*.license').

    guardant-license-wizard-offline-load-license-file

  16. Activate the license.

FAQ

– Can I build my project with the Eremex Controls in CI without an additional license?

– Yes, you can. You do not need an additional developer license to build projects in CI. To run projects without trial messages, do not change the assembly name and the major version of Eremex Controls in your project in the CI environment.


– Can I develop applications using a remote connection with RDP?

– When you use remote application development, the license manager does not create a license file in your project. As a result, a trial message appears in the project. Please contact us if you need a license type without these restrictions.


– Will my project continue to build and run without trial messages after my Eremex Controls License expires?

– Yes. The license gives you the right to create new projects, and upgrade existing projects during the license period. After a license expires, your project will continue to build and run without trial messages if you do not change the assembly name and the major version (XX.Y.z) of the referenced Eremex Controls Library. It is possible to update the minor release number (XX.Y.z) in your existing projects, as it does not take part in license validity checking.


– Why does my project display a trial message?

– The Eremex Controls display a trial message in the following cases:

  • The project does not contain the emxLicense.cs file with a valid license runtime key.
  • The major version of the Eremex Controls Library used by the application does not match the version of the Library encoded in the license runtime key.
  • The current assembly name does not match the assembly name encoded in the license runtime key.