pspdfkit web example pwa

Pspdfkit para ejemplo web - PWA

Este ejemplo muestra cómo integrar PSPDFKIT para Web y crear un PWA (aplicación web progresiva).

Puede consultar una vista previa en vivo aquí: pspdfkit.com/pwa.

Esta aplicación de muestra presenta una configuración básica de PWA que incluye un manifiesto y un trabajador de servicio, para permitir que su aplicación funcione fuera de línea, así como un almacenamiento indexado para PDFS. De esta manera, sus archivos persisten incluso después de cerrar el navegador.

En este ejemplo, usamos Workbox, un marco PWA popular de Google.

Requisitos previos

• Nodo.js
• Un pspdfkit para licencia web. Si aún no tiene uno, puede solicitar una prueba gratuita aquí.

Apoyo, problemas y preguntas de licencia

PSPDFKIT ofrece soporte para clientes con una licencia SDK activa a través de https://pspdfkit.com/support/request/

¿Estás evaluando nuestro SDK? Eso es genial, ¡estamos felices de ayudar! Para asegurarse de que esto sea rápido, utilice un correo electrónico de trabajo y haga que alguien de su empresa complete nuestro formulario de ventas: https://pspdfkit.com/sales/

Empezando

Clon el repositorio:

git clone https://github.com/PSPDFKit/pspdfkit-web-example-pwa.git
cd pspdfkit-web-example-pwa

Instale las dependencias del proyecto con npm :

npm install

Ahora que todo está instalado, necesitamos configurar la aplicación para usar nuestro PSPDFKIT para la clave de licencia web.

Editar ./config/license-key y reemplazar la cadena YOUR_LICENSE_KEY_GOES_HERE con la clave de licencia que recibió por correo electrónico.

Ejecutando el ejemplo

¡Estamos listos para lanzar la aplicación! ?

Para ejecutar la aplicación en modo de desarrollo:

npm run start

Construir artefactos de producción

Para construir una versión de producción, simplemente siga la guía anterior pero en lugar de ejecutar start :

npm run build

El script de compilación luego creará un archivo llamado ./dist que puede copiar a su servidor web as-es.

Cómo funciona

Debajo ./src Puede encontrar un shell de aplicación simple que cargue pspdfkit para la web.

La aplicación utiliza un trabajador de servicios para proporcionar soporte fuera de línea y preclamación previa para la mayoría de los activos.

Para reducir la cantidad de Boilerplate, utilizamos la caja de trabajo, una biblioteca de Google que abstrae parte de la verbosidad asociada a la creación y configuración del trabajador de servicios.

También usamos Workbox-Cli, otra biblioteca de Google, para generar automáticamente un archivo de manifiesto para nuestro servicio previo al trabajo previo cuando ejecutamos npm start . Puede encontrar este archivo de configuración en ./src/workbox-config.js .

Para permitir que los PDF se persistan localmente para que no necesiten ser descargados nuevamente, hemos creado la Biblioteca PSPDFKitFileStore . Utiliza un envoltorio liviano y Promise alrededor de la API indexedDB llamada idb debajo del capó. El código está diseñado para funcionar independientemente del ejemplo de PWA y también se puede usar en Internet Explorer 11.

Soporte móvil

Si intenta conectarse al servidor de desarrollo local de forma remota, verá rápidamente que el PWA no funciona como se esperaba. Esto se debe al hecho de que las API PWA requieren un certificado SSL/TLS válido para funcionar correctamente y probablemente no tendrá esta configuración localmente.

Para una mejor experiencia, le sugerimos que consulte el ejemplo de PWA alojado o implementa una compilación de producción en su propio servidor.

Licencia

Este software tiene licencia bajo una licencia BSD modificada.

Que contribuye

Asegúrese de haber firmado nuestra CLA para que podamos aceptar sus contribuciones.