Page tree
Skip to end of metadata
Go to start of metadata

مقدمه

در این مستند با نحوه‌ی پیاده‌سازی سرویس صدور مجوز مایکت برای برنامه‌های تحت Cordova و PhoneGap آشنا می‌شوید. تمام مراحلی که در این مستند ذکر می‌شوند در اپلیکیشن نمونه پیاده‌‌سازی شده‌ است. این برنامه را می‌توانید از اینجا دانلود نمایید.

دانلود و نصب Plugin

جهت پیاده‌سازی Licensing در اپلیکیشن‌های Cordova/PhoneGap کافیست پلاگین myket-licensing-cordova-plugin را از اینجا دانلود نمایید. حال کافی است پلاگین را در شاخه plugins برنامه‌ی خود قرار دهید. اگر پلتفورم Android را نصب نکرده‌اید کافیست با دستور زیر این پلتفورم و پلاگین مایکت را با هم نصب نمایید:

ولی اگر این پلتفورم را از قبل نصب کرده‌اید و قصد remove کردن آن‌ را ندارید کافیست دستور زیر را اجرا نمایید تا پلاگین Licensing مایکت بر روی اپلیکیشن شما نصب شود:

بعد از نصب این پلاگین شما می‌توانید از کلاس platforms/android/src/ir/myket/licensing/cordova/AndroidLicensePlugin.java برای ثبت BASE64_PUBLIC_KEY که از پنل توسعه‌دهندگان مایکت دریافت کرده‌اید استفاده نمایید.

 

نحوه استفاده

ابتدا در فایل index.html این خط را اضافه کنید:

همان‌طور که در برنامهٔ نمونه وجود دارد می‌توانید از کد زیر در تابع onDeviceReady در فایل index.js برای چک کردن Licensing استفاده نمایید

در این کد آبجکت data شامل فیلد‌های data.allow وdata.policyReason می‌باشد که allow متغییری boolean است که نشان می‌دهد آیا MyketServerManagedPolicy.java برای اجرا اپلیکیشن مجوز صادر کرده است یا خیر. همچنین فیلد data.policyReason جزئیات پردازش اطلاعات را نشان می‌دهد. حالت‌هایی که data.policyReason می‌تواند داشته باشد در فایل AndroidLicensePlugin.js و فایل Policy.java موجودند و به شرح زیر است:

 

- این وضعیت نشان دهنده‌ی تأیید سرور و Policy شما برای استفاده از اپلیکیشن است:

- این وضعیت نشان دهنده رد سرور یا Policy شما برای استفاده از اپلیکیشن است:

- این وضعیت نشان می‌دهد که جواب سرور به دلیلی نمی‌تواند مشخص شود:

- این وضعیت نشان می‌دهد که مایکت نصب نیست:

- این وضعیت نشان می‌دهد که ورژن مایکت قدیمی است و نمی‌تواند Licensing را پشتیبانی نماید:

بعد از پیاده‌سازی توابع کال‌بک AndroidLicensePlugin.check متناسب با این داده‌ها و یا کپی کردن این Callback، سرویس بررسی مجوز مایکت به طور کامل بر روی برنامه‌ٔ شما کار خواهد کرد.

  • No labels