GuancheMOS is compatible with applications developed with Xojo and compiled for macOS X (32 bits/64 bits), Windows (32 bits/64 bits), Linux (32 bits/64 bits) and Web executables, both Desktop and Console deployments. (Contact with me if you need a plug-in version able to compile with previous REAL Studio versions of modifications/customized licensing schemes for your products.)
GuancheMOS allows Xojo Macintosh, Windows, Linux and Web developers to include in their applications the ability to generate and validate unique serial numbers or license keys with a minimum effort and a minimum footprint in their final executables.
By using this plug-in, Xojo developers can create their own apps for the automated assignment and control of serial numbers in a per-application basis. Of course the main purpose of GuancheMOS is the integration of the serial validation process in the final apps with the simple call to a function.
Please, note that GuancheMOS is a commercial product. Registered users of GuancheMOS will be able to use this plug-in in all their applications without pay additional fees.
You can buy your GuancheMOS license at the AprendeXojo Store using this link.
This is the plug-in that you must drop into your Xojo > Plug-ins folder in order to use its features in your own developments.
This is the source code project of a bare-bones Xojo application that tests the installation, generation and validation of serial number features. Please, note that this application is a test plug-in one, and that was not designed for production use. Probably you will want to create your own creation/validation application with additional features.
In demo mode GuancheMOS only allows 3 serial number/licenses generation per session, and the validation feature is disabled. This demo should give you a good taste about how easy it is to use and implement the solution into your own Xojo projects.
GuancheMOS is integrated in the Xojo development IDE as an additional Module (GuancheMOS) offering a total of four methods. That’s all, very easy and fast to use and implement in your own developments:
This is the method responsible of registering GuancheMOS with the license key provided by AprendeXojo. Otherwise the plug-in will work in Demo Mode.
Note: Be sure to register the plug-in as soon as possible during the execution of your code or before using the Create or Validate methods. For example, the Open Event of the App class is a good place. Otherwise the GuancheMOS code will run in Demo Mode.
Please, to avoid that other people could extract your personal license data, and abuse it witch may take you in trouble, try to hide the “name” and “license” strings inside your application.
| Parameter name | Type | Description |
|---|---|---|
| mode | integer | You can select from four different modes, ranging from 1 to 4. The number used changes the algorithm in charge of the Serial Number generation. |
| name | string | Enter here the name data send to you by AprendeXojo as part of the GuancheMOS license key process. |
| license | string | Enter here the license key provided by AprendeXojo. |
Returned Value: Nothing
This is the GuancheMOS method responsible of the creation of a unique serial number based on the provided data. Please, note that all of the parameters are mandatory. This is the method that you will use in your own “serial number assignment application” for your products.
Note: Use different seed1 and seed2 values for each one of your applications.
| Parameter name | Type | Description |
|---|---|---|
| platform | boolean | In the current version you must set always True. |
| name | string | Use this argument to provide the main data to be scrambled. Generally this is used to enter the user’s name or e-mail address for which you want to generate a serial number. |
| seed1 | string | Use this argument to enter the first data seed that will be used for GuancheMOS to scramble the main data. You can enter alphanumeric or only numeric value inside. |
| seed2 | string | Use this argument to enter the second data seed that will be used for GuancheMOS to scramble the main data. You must enter a numeric value inside (dot separation allowed; for example 1.0.2.1. |
Returned Data: A string with the serial number/license key for the provided data.
This is the GuancheMOS method responsible of the validation of a supposed valid serial number against the GuancheMOS engine. This is the method that you must use in your released applications, so your users can introduce the data (serial number) provided by you. You're responsible of creating the logic in your apps so the user doesn't need to input the serial number once it is validated. If you need help with this, I can help you to implement robust schemes in your apps as I already have done with several Xojo based products.
| Parameter name | Type | Description |
|---|---|---|
| platform | boolean | In the current version you must enter always True. |
| name | string | The main data to be scrambled. The usual is to enter the name or the e-mail address of the user for which you want to generate a serial number. |
| seed1 | string | Use this argument to enter the first seed data that will be used to check the scrambled data.You must enter here the alphanumeric or numeric value used previously in the creation of the serial number to validate. |
| seed2 | string | Use this argument to enter the second seed data that will be used for GuancheMOS to check the scrambled data. You must enter here the alphanumeric or exclusive numeric value used previously in the creation of the serial number to validate. |
| license | string | Enter here the license or serial number data to validate against the seed1, seed2 and name values. |
Returned Data: True if the engine validates the provided serial number against the data; otherwise it will return False.
This one is the GuancheMOS method responsible of the validation of a supposed valid serial number generated with a previous version of GuancheMOS against the actual GuancheMOS engine. Please, remember that you need to Register again your GuancheMOS plug-in before use again the Verify method.
| Parameter name | Type | Description |
|---|---|---|
| platform | boolean | In the current version you must enter always True. |
| name | string | The main data to be scrambled. The usual is to enter the name or the e-mail address of the user for which you want to generate a serial number. |
| seed1 | string | Use this argument to enter the first seed data that will be used to check the scrambled data.You must enter here the alphanumeric or numeric value used previously in the creation of the serial number to validate. |
| seed2 | string | Use this argument to enter the second seed data that will be used for GuancheMOS to check the scrambled data. You must enter here the alphanumeric or exclusive numeric value used previously in the creation of the serial number to validate. |
| license | string | Enter here the license or serial number data to validate against the seed1, seed2 and name values. |
| previousnamelicense | string | Use this argument to enter the name for registering a previous version of GuancheMOS |
| previousguanchemoslicense | string | Use this argument to enter your previous GuancheMOS license. |
| mode | integer | Use this argument to enter the mode used with the previous GuancehMOS version in the generation of the serial number that you want to check. |
Returned Data: True for a valid serial number; otherwise the result returned will be False.