artpay_lib 0.0.4

Flutter library for handling Art-Pay license verification using .lic files and backend validation.

ArtPay Lib

Librería oficial desarrollada en Flutter para gestionar licencias de pago de la plataforma Art-Pay a través de la importación y validación estricta de archivos .lic cifrados de forma robusta e interactiva con el Backend.

A partir de la versión 0.0.2, la librería extrae automáticamente la información intrínseca de hardware y de ejecución de la aplicación anfitriona para ser genérica sin configuración previa por el desarrollador.

🚀 Características Principales

• Validación Robusta: Verificación cruzada y automatizada con el backend de Art-Pay de archivos .lic generados a medida.
• Validación de Hardware / Tarjeta SIM: Lectura automática del número de teléfono del usuario y las tarjetas SIM Card instaladas (mobile_number) para realizar un anclaje lógico estricto de licencias por número telefónico y no dependiente únicamente por el dispositivo, favoreciendo transiciones fáciles en caso del que usuario cambie de móvil.
• Totalmente Agnóstica y Reutilizable: Descubre dinámicamente el packageName (app ID) de la App en ejecución nativa en Flutter usando package_info_plus.
• UI Integrada y Sencilla: Selector visual de archivos interactivo (FilePicker), Snackbars retroactivos configurables nativamente y manejador de excepciones de red integrado.

📦 Instalación

1. Agrega esto bajo dependencies en el pubspec.yaml de tu app en Flutter:

dependencies:
  artpay_lib: ^0.0.3

2. Requisitos Adicionales Prequeridos (Android): La librería necesita leer de forma intrusiva los datos telefónicos nativos para garantizar la seguridad de su plataforma. Por ello, es mandatorio que el desarrollador de la app anfitriona incluya los siguientes permisos dentro del archivo /android/app/src/main/AndroidManifest.xml de su propio código:

<manifest xmlns:android="...">
    <!-- Agregar obligatoriamente antes de la etiqueta application -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <uses-permission android:name="android.permission.READ_PHONE_NUMBERS"/>
    <!-- ... Resto del manifest ... -->
</manifest>

🛠 Modo de Implementación y Uso

La librería se encarga enteramente de la validación:

1. Extraer el nombre de paquete nativo de la aplicación.
2. Pedir y validar en tiempo de ejecución los permisos para lectura telefónica del usuario en caso de no haber sido cedidos previamente por el anfitrión de OS.
3. Mostrar interfaz y ejecutar internamente las llamadas API.

Para llamarla e instanciar un procesador de licencias en la app final (suele integrarse invocando una rutina asíncrona tras presionar algún botón de compra o activación base):

import 'package:artpay_lib/artpay_lib.dart';

// Un entorno de ejecución donde interactua una clase o vista Widget (Stateful/Stateless):
void handleLicenseVerification() async {
  
  // Utilizar las herramientas del API principal exportado por la librería:
  // Mediante el ArtPayService o los componentes nativos de interfaz proporcionados como el ArtPayPayment UI Flow.

}

Nota: La automatización exenta al desarrollador de tener que ingresar a pulso las variables de entorno de seguridad.