Activation on a Mac
ComponentOne supports serial key activation on macOS using command-line licensing tools. This allows developers to activate licenses, build applications, and generate runtime license files on macOS systems.
When you first build a project that references ComponentOne NuGet packages, a 30-day evaluation license is applied automatically. To continue development and build licensed applications, you must activate a valid serial key.
Activating a Serial Key on MacOS
Open the Terminal in Visual Studio for Mac:
View → Pads → Terminal
Run the following command to list installed products and license status:
sa3client ( l | list )
Activate your serial key:
sa3client ( a | activate ) 0000-0000-0000-0000-000
If the activation is successful it will say that activation completed.
After activation, you can build and properly license your application. During the build, a unique runtime license file (.sa3licx) is generated (for example, in obj/Debug or obj/Release) and embedded as a resource in the application. This file is used at runtime to validate the license.
Offline Activation on a Mac OS
If the machine cannot connect to the MESCIUS License Server, you can activate the license offline.
1. Generate an offline activation request file:
sa3client ( a | activate ) 0000-0000-0000-0000-000 -o activation-request.txt
2. Go to the MESCIUS License Management website Home - SA3 License and select Activation.
3. Upload or paste the contents of activation-request.txt.
The website generates an offline license.
Save the license text to a file (for example,
license.txt) and import it:
sa3client ( i | import ) license.txt
Your Mac is now activated and ready to build licensed applications.
Deactivation on a Mac
A serial key can only be activated on a limited number of machines. To free an activation, deactivate the license on an existing machine.
1. Open the Terminal in Visual Studio for Mac.
2. List installed licenses and note the serial key prefix: sa3clientlist
3. Deactivate the license:
sa3client ( d | deactivate ) C1S-1234-5678
Offline Deactivation
If deactivation fails due to network issues:
1. Generate an offline deactivation request:
sa3client ( d | deactivate ) C1S-1234-5678 -o deactivation-request.txt
2. Go to the MESCIUS License Management website (https://sa3.mescius.com/) and select Deactivation.
3. Upload or paste the contents of deactivation-request.txt and click OK to free the usage of this serial key from the server.
Activating a Serial Key on a Mac (GCLM)
1. Open the Terminal in Visual Studio for Mac.
2. Run the following command to list installed products and indexes: glcm
GrapeCity License Manager v1.4
========================================================================================================
Index Product Name Status
--------------------------------------------------------------------------------------------------------
1 ComponentOne Studio Enterprise Trial License Activated (30 days left)
2 ComponentOne Studio for Xamarin No License
3 ComponentOne Xamarin.Android Edition No License
4 ComponentOne Xamarin.iOS Edition No License
========================================================================================================
gclm List all products.
gclm [index] Show details of the product license.
gclm [index] -a [SerialKey] Activate the product with a serial key.
gclm [index] -d Deactivate the product.3. Note the Index of the product you want to activate.
4. Activate the serial key:
gclm [Index] -a 0000-0000-0000-0000-000
If activation succeeds, the tool displays “Activation completed.”
After activation, building the application generates a runtime license file (.gclicx) in the build output (for example, obj/Debug or obj/Release). This file must be distributed with the application.
Offline Activation on a Mac (GCLM)
If the tool cannot connect to the MESCIUS License Server:
1. Generate an offline activation request:
gclm [Index] -g serialkey.txt
2. Go to the MESCIUS License Management website and select Activation:
https://sa2.mescius.com/
3. Enter the activation key from serialkey.txt.
The website generates a license.
4. Save the license text to a file and import it:
gclm [Index] -i license.txt
Deactivation on a Mac (GCLM)
A serial key can be activated on up to two development machines. To activate on another machine, you must first deactivate an existing activation.
1. Open the Terminal and list installed products:
gclm
2. Identify the product index.
3. Deactivate the license:
gclm [Index] -d
Offline Deactivation (GCLM)
If network issues prevent deactivation:
1. Generate a deactivation request:
gclm [Index] -d deactivation-key.txt
2. Go to the MESCIUS License Management website and select Deactivation.
3. Paste the deactivation key to free the activation.