Node.js اور Electron کے لیے JavaScript سافٹ ویئر لائسنسنگ

1. پروڈکٹ اور لائسنس تیار کریں۔

نوڈ لاکڈ لائسنس اور ایک عام ایکسپورٹ فیچر کے ساتھ شروع کریں۔ بنیادی اجازت کے بہاؤ کے کام کرنے کے بعد ہی میٹرڈ استعمال شامل کریں۔

آلات کا کوٹا موجودہ فعال رجسٹریشن کے مطابق گنا جاتا ہے اور آزاد کرنے پر واپس ملتا ہے۔ عام لائسنس آف لائن بھی شمار ہوتے ہیں؛ فلوٹنگ لائسنس کی لیز ختم ہونے پر بھی کوٹا خود واپس ملتا ہے۔

1. کنسول > مصنوعات سے پروڈکٹ ID کاپی کریں۔ اسی پروڈکٹ کی دستخطی عوامی کلیدیں کھولیں اور ہر کلید ID/عوامی کلید کا جوڑا ابتدائی کوڈ میں درج کریں؛ YOUR_PRODUCT_ID، YOUR_KEY_ID اور YOUR_PUBLIC_KEY تبدیل کریں۔ فوری انضمام یہ کوڈ بھی بنا سکتا ہے۔ پروڈکٹ کی کنفیگریشن فائل درکار نہیں؛ SDK بطورِ طے شدہ https://www.licentivo.com استعمال کرتا ہے۔
2. فوری انضمام میں، ایک پروڈکٹ بنائیں یا منتخب کریں۔ اس کی پالیسی میں برآمد نام کی خصوصیت کو فعال کریں اور ٹیسٹ لائسنس تیار کریں۔

2. SDK انسٹال کریں۔

اپنے ایپ پروجیکٹ میں درج ذیل کمانڈ چلا کر یا بلڈ ڈیپنڈنسی شامل کر کے SDK 0.11.6 انسٹال کریں۔ پیکیج مینیجر SDK حاصل کرتا ہے؛ سورس ZIP ڈاؤن لوڈ اور اَن زِپ کرنے یا مقامی سورس پاتھ مقرر کرنے کی ضرورت نہیں۔

npm install @licentivo/sdk@0.11.6

3. حقیقی برآمد کی حفاظت کریں۔

اپنی ایپ کے آغاز یا فعالیت پر SDK شروع کریں۔ فعالیت فارم سے صارف کی کلید پڑھیں اور پروڈکٹ ID اور قابلِ اعتماد کلیدیں دیں۔ ایپ بند ہونے تک کلائنٹ قائم رکھیں۔ اصل کاروباری عمل کے دروازے پر RunFeature رکھیں اور نمونے کی برآمد کی جگہ اپنا فنکشن دیں۔

import {writeFile} from 'node:fs/promises';
import {Client} from '@licentivo/sdk'; // Installed package: import from '@licentivo/sdk'.

// BEGIN LICENTIVO PRODUCT
// Copy Product ID and all key ID/public key pairs from Console > Products > Signing public keys.
const PRODUCT_ID = 'YOUR_PRODUCT_ID';
const TRUSTED_KEYS = {'YOUR_KEY_ID': 'YOUR_PUBLIC_KEY'};
// END LICENTIVO PRODUCT

export async function exportReport(path) {
  // Replace this write with your existing, non-metered export operation.
  await writeFile(path, 'A report generated by the licensed application.\n', {mode: 0o600});
}

async function main() {
  // In Electron, create this in the main process, using customer activation input.
  const client = await Client.openProduct(
    PRODUCT_ID, TRUSTED_KEYS,
    process.env.LICENTIVO_LICENSE_KEY ?? '',
    error => console.error('Background verification:', error.message),
  );
  try {
    const feature = process.env.LICENTIVO_FEATURE ?? 'export';
    const path = process.env.LICENTIVO_OUTPUT ?? 'licensed-report.txt';
    const action = () => exportReport(path);
    if (process.env.LICENTIVO_METERED === '1') {
      await client.runMeteredFeature(feature, 1, process.env.LICENTIVO_OPERATION_ID ?? '', action);
    } else {
      await client.runFeature(feature, action);
    }
    console.log(`License OK: ${feature} is available\nExport completed: ${path}`);
  } finally {
    await client.close(); // In your application, close only when the app exits.
  }
}

main().catch(error => {console.error(error.message); process.exitCode = 2;});

4. بند ہونے تک کلائنٹ کو زندہ رکھیں

یہ کمانڈ لائن مثال ایک آپریشن کرتی ہے اور باہر نکلتی ہے۔ ایک ڈیسک ٹاپ ایپلی کیشن میں، ایک کلائنٹ کو اسٹارٹ اپ پر کھولیں، ایکسپورٹ ایکشن سے فیچر کال بیک کی درخواست کریں، اور کلائنٹ کو صرف اس وقت بند کریں جب ایپلی کیشن ختم ہو۔

ایکٹیویشن کے بعد، بعد میں شروع ہونے والے LICENTIVO_LICENSE_KEY کو خالی چھوڑ سکتے ہیں اور اسی صارف اور کیش لوکیشن کے تحت نجی اسناد کو بحال کر سکتے ہیں۔ اس سند کو صارف ایپلیکیشن ڈیٹا ڈائرکٹری میں رکھیں۔ بند ہونے سے دل کی دھڑکنیں رک جاتی ہیں اور تیرتی نشستیں واپس آتی ہیں۔ نارمل ایگزٹ نوڈ لاکڈ ڈیوائس کو غیر فعال نہیں کرنا چاہیے۔

آف لائن رسائی صرف اس صورت میں دستیاب ہے جب پالیسی اس کی اجازت دیتی ہے اور دستخط شدہ گرانٹ درست رہتی ہے۔ ایک میعاد ختم یا مسترد شدہ خصوصیت کو مسدود رہنا چاہیے۔ میٹرڈ آپریشنز کے لیے نیٹ ورک کنکشن کی ضرورت ہوتی ہے۔

Electron میں، مرکزی عمل میں کلائنٹ کے مالک ہوں اور ایک تنگ IPC انٹرفیس کے ذریعے صرف مطلوبہ محفوظ کارروائیوں کو ظاہر کریں۔ رن فیچر کا انتظار کریں اور بند کریں؛ درخواست کی زندگی بھر کے لیے کلائنٹ کو زندہ رکھیں۔ ایک async کال بیک کامیابی کی اطلاع دینے سے پہلے ختم ہونا چاہیے۔

5. چلائیں اور نتیجہ کی تصدیق کریں۔

کنسول > مصنوعات سے پروڈکٹ ID کاپی کریں۔ اسی پروڈکٹ کی دستخطی عوامی کلیدیں کھولیں اور ہر کلید ID/عوامی کلید کا جوڑا ابتدائی کوڈ میں درج کریں؛ YOUR_PRODUCT_ID، YOUR_KEY_ID اور YOUR_PUBLIC_KEY تبدیل کریں۔ فوری انضمام یہ کوڈ بھی بنا سکتا ہے۔ پروڈکٹ کی کنفیگریشن فائل درکار نہیں؛ SDK بطورِ طے شدہ https://www.licentivo.com استعمال کرتا ہے۔

1. تصدیق کریں کہ برآمدی رسائی کے ساتھ ایک درست لائسنس licensed-report.txt بناتا ہے۔
2. LICENTIVO_LICENSE_KEY کو صاف کریں اور اسی صارف اکاؤنٹ کا استعمال کرتے ہوئے دوبارہ چلائیں: محفوظ کردہ اسناد کو بحال ہونا چاہئے۔
3. LICENTIVO_FEATURE کو لائسنس سے غائب ایک خصوصیت اور LICENTIVO_OUTPUT کو ایک تازہ فائل نام پر سیٹ کریں۔ پروگرام کو اس فائل کو بنائے بغیر انکار کی اطلاع دینی چاہیے۔
4. صرف اجازت یافتہ، غیر ختم شدہ دستخط شدہ گرانٹ کے ساتھ آف لائن دوبارہ شروع کرنے کی جانچ کریں۔ بیک گراؤنڈ ریفریش کی خرابی کے بعد ناکام فیچر چیک کو نظرانداز نہ کریں۔

$env:LICENTIVO_LICENSE_KEY = 'YOUR_LICENSE_KEY'
node main.mjs

LICENTIVO_LICENSE_KEY=YOUR_LICENSE_KEY node main.mjs

عام انضمام کے مسائل

پروڈکٹ ID، ہر کلید ID/عوامی کلید کا جوڑا اور صارف کا لائسنس جانچیں۔ عوامی کلیدیں پروڈکٹ کی ہیں؛ لائسنس اور آلے کی اسناد الگ ہیں۔ آزمائشی کلیدیں یا انتظامی API Key تقسیم نہ کریں۔

خصوصیت سے انکار، ڈیوائس کی حد تک پہنچ گئی یا لائسنس کی میعاد ختم: کنسول میں لائسنس اور پالیسی کا معائنہ کریں، پھر گاہک کو SDK کی خرابی دکھائیں۔ ایک ناکام اجازت کو ایکسپورٹ فنکشن کو کال نہیں کرنا چاہیے۔

رن فیچر فیچر تک رسائی کی جانچ کرتا ہے۔ میٹرڈ ویرینٹ ریزرو کرتا ہے اور ترتیب شدہ استعمال کو حل کرتا ہے۔ حقیقی کاروباری جاب کے لیے ایک مستحکم آپریشن آئی ڈی استعمال کریں اور کسی رکاوٹ والی نوکری کو بحال کرنے سے پہلے اس کے پائیدار نتیجہ کا معائنہ کریں۔

ماڈیول نہیں ملا: اسی پروجیکٹ میں @licentivo/sdk انسٹال کریں جس میں main.mjs ہے۔ ایک ترتیب شدہ proxy_url کو اضافی طور پر آپ کے Node.js ورژن کے ساتھ ہم آہنگ اختیاری undici پیکیج کی ضرورت ہے۔