8. Licencia y modo demo #

← FAQ y resolución de problemas · Índice

PBToolboxAI es una biblioteca comercial. El control de la licencia es totalmente sin conexión: ninguna conexión, ninguna activación, ninguna llamada a un servidor. Una clave firmada se asigna al arrancar y la DLL la verifica localmente.

8.1 Los tres tipos de claves #

Las claves son acumulables: llame a PBT_SetLicense tantas veces como sea necesario, la biblioteca conserva una clave por tipo.

Por lo tanto, un proyecto necesita las dos: un puesto dev por desarrollador y una clave runtime para la aplicación entregada a sus clientes.

• Una clave dev que acabara en un ejecutable no desbloquea nada.
• Una clave runtime no concede ningún puesto de desarrollo.
• Sus clientes finales no tienen nada que introducir ni nada que activar: la clave runtime está en su código.

La detección «IDE o ejecutable» la realiza la propia DLL (nombre del proceso, módulos design-time cargados), no código de PowerBuilder — no se puede eludir desde sus fuentes.

8.2 Asignar la clave #

Una sola cosa que hacer, antes de la apertura de la primera ventana:

// Declaracion - objeto aplicacion, "Local External Functions"
Function long PBT_SetLicense (string as_client, string as_key) Library "pbtoolboxai.dll"

// Evento open del objeto aplicacion
// Local variables
long ll_rc
string ls_dev_key

// La clave RUNTIME va en el codigo : DEBE ir dentro del ejecutable.
ll_rc = PBT_SetLicense(gs_licensee, gs_runtime_key)

// La clave DEV se lee del puesto : solo desbloquea el IDE, y en el codigo
// iria en cada copia entregada sin servir para nada.
ls_dev_key = ProfileString("pbtoolboxai.ini", "license", "dev", "")
if ls_dev_key <> "" then ll_rc = PBT_SetLicense(gs_licensee, ls_dev_key)

Open(w_main)

La clave se establece mediante la función de la DLL, nunca mediante un método de componente: se aplica a todo el proceso y debe establecerse antes de que exista ningún componente. Por esa misma razón PBT_LicenseStatus no pide ningún handle.

El titular se pasa en claro, como primer argumento: es el nombre (o la dirección de correo) a cuyo nombre se emitió la licencia, y debe coincidir con el que lleva la clave firmada. Así, una clave no puede circular sin el nombre de quien la compró.

💡 Qué clave va dónde. La clave runtime pertenece al código: debe acabar dentro del ejecutable que entrega. La clave dev no — solo desbloquea el IDE, así que dentro de un ejecutable no sirve de nada y sin embargo circula, con el nombre de su empresa. Su sitio es un archivo pbtoolboxai.ini junto al IDE, o un valor del registro.

Asignar la clave después de la creación de un componente también funciona: los componentes ya abiertos se desbloquean inmediatamente. Pero lo más sencillo sigue siendo el evento open de la aplicación.

💡 Conserve la clave en una constante o en un recurso de su aplicación. Está firmada: no contiene ningún secreto aprovechable y no se puede modificar sin invalidar su firma.

8.3 Comprobar el estado de la licencia #

// Declaracion
Function long PBT_LicenseStatus (ref string as_json, long al_len) Library "pbtoolboxai.dll"

// Local variables
string ls_status

// El estado de la licencia, en JSON
ls_status = Space(1024)
PBT_LicenseStatus(ls_status, 1024)
// -> {"licensed":true,"ide":false,"keys":{...},"reason":""}

Útil en fase de integración para comprobar que una clave se tiene realmente en cuenta, o para registrar un arranque en su registro de aplicación.

8.4 El modo demo #

Sin una clave válida — o con una clave que no se aplica al contexto (una clave dev en un exe, por ejemplo) — la biblioteca funciona en modo demo: todo es utilizable, todo es visible, pero con límites — salvo los cinco componentes de la edición comunidad, descritos justo debajo, que nunca están limitados.

Cinco componentes siguen siendo gratuitos #

La edición comunidad no requiere nada: sin ninguna clave, cinco componentes funcionan sin distintivo y sin límite, indefinidamente.

La elección es deliberada: los cuatro componentes visuales son los que se encuentran primero, no llevan ningún modelo de datos propio y bastan para demostrar en un puesto bloqueado que el runtime se despliega — el obstáculo real antes de cualquier compra. json se suma porque está escrito en PowerScript puro, sin la DLL: es una herramienta básica, no un componente.

La lista vive en la DLL. PBT_LicenseStatus la devuelve tal cual, en "free": su aplicación puede así anunciar a qué tiene derecho sin clave, en lugar de descubrirlo componente por componente.

Una clave válida siempre prevalece: en esos cinco componentes como en los demás, restablece su nombre y su edición.

El distintivo #

Cada componente muestra un distintivo «PBToolboxAI — DEMO», que no se puede ocultar.

Los límites funcionales #

Estos límites se aplican a la representación: nada falla, la visualización se trunca. Por lo tanto, usted puede evaluar realmente cada componente, con sus propios datos, antes de comprar.

Asignar una clave válida elimina al instante todos estos límites y retira el distintivo, sin reiniciar la aplicación.

8.5 Perpetua + mantenimiento #

La licencia es perpetua: las versiones cubiertas por su periodo de mantenimiento funcionan para siempre, incluso después de que este caduque.

En concreto, la clave lleva una fecha de fin de mantenimiento, comparada con la fecha de compilación de la DLL:

• una versión de la biblioteca publicada durante su mantenimiento queda desbloqueada definitivamente;
• una versión publicada después de la caducidad devuelve -3: renueve el mantenimiento para acceder a ella;
• sus aplicaciones ya entregadas nunca se ven afectadas: incorporan la versión que siempre han utilizado.

8.6 Preguntas frecuentes #

¿Mi clave se verifica en línea? No. Ninguna red, nunca. La verificación es una firma RSA validada localmente por Windows.

¿Mis clientes necesitan una clave? No. Su clave runtime está en su aplicación; ellos no ven nunca nada de la licencia.

¿Qué ocurre si olvido PBT_SetLicense en producción? La aplicación funciona, pero cada componente muestra el distintivo demo y se aplican los límites de la tabla anterior. Es el primer punto que hay que comprobar si aparece un distintivo en casa de un cliente.

¿Puedo asignar una clave dev y una clave runtime en el mismo código? Sí — es incluso el caso habitual: la dev sirve cuando ejecuta desde el IDE, la runtime cuando ejecuta el exe. Cada una se ignora en el otro contexto.

El distintivo aparece aunque la clave está asignada. Tres causas, por orden de frecuencia: (1) clave dev mientras ejecuta un exe compilado, o al revés; (2) valor devuelto por PBT_SetLicense sin comprobar — verifique que vale 0; (3) mantenimiento caducado para la versión de DLL instalada (retorno -3). PBT_LicenseStatus lo resuelve en una línea.

Una clave es nominativa. Una clave dev está vinculada a un desarrollador, una clave runtime a su empresa. No las comparta fuera de su equipo.

← FAQ y resolución de problemas · Índice