guanchemos
Differences
This shows you the differences between two versions of the page.
| Next revision | Previous revision | ||
|
guanchemos [2019/09/06 09:06] bloguintosh created |
guanchemos [2019/09/06 11:59] (current) bloguintosh |
||
|---|---|---|---|
| Line 7: | Line 7: | ||
| 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. | 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. | ||
| + | |||
| + | ===== GuancheMOS in the Store ===== | ||
| + | |||
| + | You can buy your GuancheMOS license at the AprendeXojo Store [[https://www.aprendexojo.com/en/shop/guanchemos-serial-number-generation-and-validation-for-xojo-developers-2/|using this link]]. | ||
| ===== What is included with GuancheMOS? ===== | ===== What is included with GuancheMOS? ===== | ||
| Line 20: | Line 24: | ||
| 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. | 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. | ||
| - | ==== How to use the plug-in ==== | + | ===== How to use the plug-in ===== |
| 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: | 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: | ||
| Line 29: | Line 33: | ||
| * Register( mode, name, license) | * Register( mode, name, license) | ||
| - | ==== GuancheMOS Release Notes ==== | + | ==== Register ==== |
| + | |||
| + | 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 | ||
| + | |||
| + | |||
| + | ==== Create ==== | ||
| + | |||
| + | 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. | ||
| + | |||
| + | ==== Validate ==== | ||
| + | |||
| + | 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**. | ||
| + | |||
| + | ==== CheckWithLicense ==== | ||
| + | |||
| + | 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**. | ||
| + | |||
| + | ===== GuancheMOS Release Notes ===== | ||
| * GuancheMOS 1.8 Added compatibility with new Xojo Plug-in format and Xojo 2015r3. Added compatibility for 64 bits compiled applications under OS X, Windows and Linux. | * GuancheMOS 1.8 Added compatibility with new Xojo Plug-in format and Xojo 2015r3. Added compatibility for 64 bits compiled applications under OS X, Windows and Linux. | ||
guanchemos.1567753596.txt.gz · Last modified: 2019/09/06 09:06 by bloguintosh
Page Tools
