pspdfkit web example pwa

PSPDFKIT لمثال الويب - PWA

يوضح هذا المثال كيفية دمج PSPDFKIT للويب وإنشاء PWA (تطبيق الويب التدريجي).

يمكنك التحقق من معاينة مباشرة هنا: pspdfkit.com/pwa.

يتميز تطبيق العينة هذا بإعداد أساسي لـ PWA بما في ذلك بيان بيان وعامل خدمة ، للسماح لتطبيقك بالعمل في وضع عدم الاتصال بالإضافة إلى تخزين INSTEDDB لـ PDFs. وبهذه الطريقة ، تستمر ملفاتك حتى بعد إغلاق المتصفح.

في هذا المثال ، نستخدم Workbox ، وهو إطار PWA شهير من Google.

المتطلبات الأساسية

• node.js
• PSPDFKIT لترخيص الويب. إذا لم يكن لديك بالفعل واحدة ، فيمكنك طلب تجربة مجانية هنا.

الدعم والقضايا وأسئلة الترخيص

يقدم PSPDFKIT الدعم للعملاء مع ترخيص SDK نشط عبر https://pspdfkit.com/support/request/

هل تقوم بتقييم SDK لدينا؟ هذا رائع ، يسعدنا المساعدة! للتأكد من أن هذا سريعًا ، يرجى استخدام بريد إلكتروني للعمل وطلب شخص من شركتك ملء نموذج المبيعات لدينا: https://pspdfkit.com/sales/

ابدء

استنساخ الريبو:

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

تثبيت تبعيات المشروع مع npm :

npm install

الآن بعد أن تم تثبيت كل شيء ، نحتاج إلى تكوين التطبيق لاستخدام PSPDFKIT لمفتاح ترخيص الويب.

تحرير ./config/license-key واستبدل السلسلة YOUR_LICENSE_KEY_GOES_HERE بمفتاح الترخيص الذي تلقيته عبر البريد الإلكتروني.

تشغيل المثال

نحن على استعداد لإطلاق التطبيق! ؟

لتشغيل التطبيق في وضع التطوير:

npm run start

بناء القطع الأثرية الإنتاج

لبناء إصدار إنتاج ، ما عليك سوى اتباع الدليل أعلاه ولكن بدلاً من start :

npm run build

سيقوم برنامج Build Script بعد ذلك بإنشاء ملف يسمى ./dist والذي يمكنك نسخه إلى خادم الويب الخاص بك.

كيف تعمل

تحت ./src يمكنك العثور على قذيفة تطبيق بسيطة تقوم بتحميل PSPDFKIT للويب.

يستخدم التطبيق عامل خدمة لتوفير الدعم غير المتصلة بالإنترنت والخلع المسبق لغالبية الأصول.

لتقليل كمية Boilerplate ، نستخدم Workbox - مكتبة من Google التي تخلص من بعض الأفعال المرتبطة بإنشاء وتكوين عامل الخدمة.

نستخدم أيضًا Workbox-Cli ، مكتبة أخرى من Google ، لإنشاء ملف واضح للخدمة المسبقة للخدمة الخاصة بنا عند تشغيل npm start . يمكنك العثور على ملف التكوين هذا في ./src/workbox-config.js .

للسماح باستمرار PDFs محليًا حتى لا تحتاج إلى تنزيلها مرة أخرى ، قمنا بإنشاء مكتبة PSPDFKitFileStore . يستخدم غلافًا خفيف الوزن Promise حول واجهة برمجة تطبيقات INSTERDDB يسمى idb تحت الغطاء. تم تصميم الرمز للعمل بشكل مستقل عن مثال PWA ويمكن أيضًا استخدامه في Internet Explorer 11.

دعم الهاتف المحمول

إذا حاولت الاتصال بخادم التطوير المحلي عن بُعد ، فسترى بسرعة أن PWA لا يعمل كما هو متوقع. ويرجع ذلك إلى حقيقة أن واجهات برمجة التطبيقات PWA تتطلب شهادة SSL/TLS صالحة للعمل بشكل صحيح وربما لن يكون لديك هذا الإعداد محليًا.

لتجربة أفضل ، نقترح عليك التحقق من مثال PWA المستضافة أو نشر بناء إنتاج على الخادم الخاص بك.

رخصة

تم ترخيص هذا البرنامج بموجب ترخيص BSD معدّل.

المساهمة

يرجى التأكد من أنك وقعت CLA حتى نتمكن من قبول مساهماتك.