Ejemplo básico

1. Abra un nuevo proyecto en su Delphi IDE.

2. Coloque un componente AVLockGold en la forma principal.

Para VCL Delphi

Para la plataforma .NET VS2005 / Delphi 2006

3. Inserte una linea de código

Para VCL Delphi

procedure TForm1.FormCreate(Sender: TObject);

begin

AvLockG51.execute; //<-- this is the only needed line

end;

Para la plataforma .NET VS2003 / Delphi 2005

//Sample in C# language

//into the Load event  

private void Form1_Load(object sender, System.EventArgs e)

{

avLockGold1.execute();

}

4. Compile el proyecto

Un fichero project1.exe se generará dentro de la carpeta de la aplicación, o dentro de la carpeta app\bin\Debug folder para la versión .NET.

5.  Si en este punto Ud. ya tiene terminado su proyecto y nada más va a ser agregado, entonces podría cerrar Delphi y realizar el resto de las tareas necesarias con el utilitar4io AVLockManager.

6. Abra el utilitario AVLockManager (ejecutando el fichero avmanager.exe).

7. Presione el botón [Add] a fin de agregar una nueva aplicación a la lista de aplicaciones. La forma "add application" surgirá en pantalla.

8. Rellene el campo "Application Name" con el nombre de su aplicación (por ej. Mi Programa).

9. Rellene el campo "Application Path" con el valor apropiado (por ej.. c:\avlockg5\myprogram).

10. Rellene el campo "Executable file" con el valor apropiado (por ej.. project1.exe).

11. Para este ejemplo deje en blanco el campo opcional "Encryption Key".

NOTA: El campo "Encryption Key" es sensible a mayúsculas/minúsculas. En la version 5.3 no definido (blanco) en todos los demos. En versiones previas para el Demo=blanco, para Demo2 = "myencryptionkey123", para  Demo3 = "Demo3" y para Demo4 = "Demo4".

12. Presione el botón [Ok] para guardar la nueva aplicación.

NOTA: En este punto un nuevo registro (sección) se agregará al fichero applications.ini (por ej. c:\avlocg5\avman\applications.ini) y el fichero avconfig.ini se creará dentro del directorio de la aplicacion (por ej. c:\avlockg5\myprogram\avconfig.ini) donde se guardarán todos los datos de configuración de las solapas "Settings" y "Modules".

Solapa "Settings".

Solapa "Modules".

13. Dele un vistazo a las solapas "Settings" y "Modules". Vea como el valor "AppID" ha sido copiado dentro de la columna "Moule-ID" para la primer fila (modulo 0) correspondiente a la aplicacion principal. Vea también el cuadro "Trial mode" donde es configurado el tipo de trial, en este caso el  modo es "Relative" (el trial se inicia cuando el usuario ejecuta por primera vez la aplicación) y por un período de 30 dias. Vea también el checkbox con eltexto "The program expires when the user turn back the system date", este debe estar checkeado.

NOTA: El valor "AppID" es generado aleatoriamente cuando se agrega una nueva aplicación, sin embargo este valor puede ser modificado ingresando cualquier valor que desee con la condición de que sea diferente para cada aplicación.

14. Presione el botón [Run]. Su aplicación se ejecutará por primera vez y el trial iniciado de acuerdo con la configuración. Se le pedirá que ingrese el nombre de usuario y la compañía, luego surgirá la froma de registración mostrando el mensaje "Days left to expire: 30" y abajo la barra de progreso comenzando en la fecha del sistema actual y terminando 30 dias mas tarde.

15. Presione el botón [Continue>>] sobre la forma de registración y se presentará la forma principal de su aplicación.

16. Cierre su aplicación.

17. Avance un día la fecha del sistema y después presione el botón [Run] otra vez.

18. Observe la forma de registración. Ahora el mensaje será "Days left  to expire: 29".

19. Cierre su aplicación.

20. Atrase un día la fecha del sistema volviendo al valor anterior, después presione el botón [Run] otra vez.

21. Ahora la forma de registración vendrá con el botón [Continue>>] desactivado. No le será posible acceder a la forma principal de su aplicación a menos que avance la fecha del sistema al mayor valor al que alguna vez haya alcanzado, en este caso avanzando un día. El mecanismo de seguridad está trabajando!!.

22. Presione elbotón [Unregister]. Esto borrará todos los datos de registración permitiendole probar otra vez cambiando la configuración.

NOTA: No es posible que cualquier persona utilice este método para reinicializar el periodo de prueba en una aplicación ya expirada ya que este no conoce la cadena "encryptionkey" ni el número "AppID". Este número es único para cada aplicación y permite que un usuario pueda tener instaladas varias aplicaciones manejadas con AVLock Gold en la misma máquina.

23. Cambie en algo la configuración del cuadro "Trial mode" dentro de la solapa "Settings" y presione [Run] otra vez para ver que pasa.

24. Repita los pasos 23 y 24 hasta que entienda como funciona esto.

25. Presione [Unregister] y reestablezca la configuración a su estado original (Trial "Relative" de 30 días, estrategia de bloqueo "InstallCode based").

26. Presione el botón [Run]. Cuando surja la forma de registración seleccione el InstallCode y cópielo al clipboard (Ctrl-C) o copielo en el lugar que quiera. Este será utilizado en el paso 31.

27. Abra la solapa "Users & Keys".

28. Presione el botón [Add] del cuadro "Users" para agregar un nuevo usuario a la lista de usuarios. Surgirá la forma "add user".

29. Rellene el campo "User name", "Company" y "Email address" con sus propios datos o cualquier otro.

30. Rellene el campo "InstallCode" con el valor almacenado en el clipboard con (Ctrl-V) o ingréselo manualmente.

31. Rellene el campo "Max users" con el valor que quiera utilizar.

32. Presione el botón [Ok] para guardar el nuevo usuario..

33. Observe la tabla de Módulos. Solo existe una linea correspondiente al módulo 0, este es el módulo principal, a saber, la aplicación.

34. En la columna "Key Type" se puede seleccionar el tipo de clave entre (Permanent, Temporary o Unregister), Seleccione Temporary.

35. Entre 90 en la columna "Days" y la fecha actual del sistema en la columna "Start Date" y checkee el cuadro de checkeo de la columna "Gen". Ahora podrá ver la clave generada en la columna "Generated key".

36. Presione el botón [Copy current key] para copiar al clipboard la clave generada.

37. Vaya a la forma de registración abierta en el paso 27 o vuélvala a abrir con el botón [Run].

38. Ingrese la clave en la forma de registración, manualmente o con Ctrl-V copiándola desde el clipboard.

39. Presione el botón [Register]. Ingrese el nombre de usuario y compañia si se le pide, luego verá el mensaje "1 Keys Registered".

40. Ahora la aplicación ha pasado del estado Trial al estado Autorizado. Podrá ver en pantalla la forma principal de su aplicación.

NOTA: Una aplicación puede estar en cualquiera de los siguientes cuatro estados: Trial, Autorizado, Registrado y Expirado.

Trial es el primer periodo previo al proceso de registración. Autorizado cuando la aplicación está registrada temporalmente, utilizado cuando se desea extender el periodo trial o para alquilar su programa. Registrado cuando la aplicación está registrada de forma definitiva, usado cuando se vende la aplicación, y Expirado cuando el programa termina un periodo trial o autorizado, o cuando por razones de seguridad el programa es forzado a este estado.

41. Cierre la aplicación y presione el botón [Run] otra vez.

42. Qué cambió? Ahora la forma de registración es pasada por alto y la forma principal de la aplicación es alcanzada directamente. Esto es bueno para usuarios registrados pero en algunos casos el usuario puede necesitar acceder a este por ejemplo para registrar un nuevo periodo. Cómo resolver este problema? Vea los siguientes pasos.

43. Cierre su aplicación y vaya al Delphi IDE y coloque un botón en la forma principal, ingrese el texto "Registration" en su  caption.  

44. Agregue el siguiente codigo en el evento OnClick:

Para VCL Delphi:

    procedure TForm1.Button1Click(Sender: TObject);

    begin

       AVLockG51.doexecute;

    end;

Para la plataforma .NET  VS2003 / Delphi 2005

//Sample in C# language

private void button1_Click(object sender, System.EventArgs e)

{

  avLockGold1.doexecute();

}

45. Compile y pruebe otra vez con el botón [Run]. Ahora tendrá acceso a la forma de registración mediante este nuevo botón.

46. El ejemplo Demo1 incluido en el paquete es muy similar al creado en este ejemplo, puede ubicarlo para Delphi en  c:\AV-Soft\avlockg5\samples\demo1, y para .NET  en c:\AV_Soft\avlockg5\samples\c#\demo1. Abralo en el IDE y compilelo. Cree una nueva aplicación en el AVLockManager con el nombre "Demo1" y vincúlelo con la ubicación de Demo1.

Si hay algo que no quedó claro o tiene preguntas no respondidas por esta ayuda, por favor no dude en contactarnos en nuestro sitio http://valega.com/contacto.php.