محفوظ کاروباری بلاکس کے ساتھ Ruby سافٹ ویئر لائسنسنگ

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 ڈاؤن لوڈ اور اَن زِپ کرنے یا مقامی سورس پاتھ مقرر کرنے کی ضرورت نہیں۔

gem install licentivo-sdk --version 0.11.6

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

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

# frozen_string_literal: true
require 'licentivo'

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

def setting(name, fallback)
  value = ENV[name]
  value.nil? || value.empty? ? fallback : value
end

def export_report(path)
  # Replace this write with your existing export operation.
  File.write(path, "A report generated by the licensed application.\n")
end

begin
  # A GUI supplies the activation input. Later starts use an empty key.
  Licentivo::Client.open_product(
    PRODUCT_ID, TRUSTED_KEYS,
    setting('LICENTIVO_LICENSE_KEY', '')
  ) do |client|
    feature = setting('LICENTIVO_FEATURE', 'export')
    path = setting('LICENTIVO_OUTPUT', 'licensed-report.txt')
    if setting('LICENTIVO_METERED', '0') == '1'
      client.run_metered_feature(feature, 1, setting('LICENTIVO_OPERATION_ID', '')) { export_report(path) }
    else
      client.run_feature(feature) { export_report(path) }
    end
    puts "License OK: #{feature} is available\nExport completed: #{path}"
  end # Real app: keep the owning block/client alive until shutdown.
rescue StandardError => error
  warn error.message
  exit 2
end

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

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

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

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

open_with_license بلاک کلائنٹ کا مالک ہے۔ ایپلیکیشن لوپ کو اس کی زندگی بھر میں رکھیں اور ہر ایک محفوظ کارروائی کے لیے run_feature پر کال کریں۔ کاروباری کال بیک کے اندر سے کلائنٹ کو بند نہ کریں۔ Ruby مستثنیات SDK ناکام آپریشن کو سنبھالنے کے بعد پھیلتی ہیں۔

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'
ruby main.rb

LICENTIVO_LICENSE_KEY=YOUR_LICENSE_KEY ruby main.rb

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

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

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

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

لائسنس کو لوڈ نہیں کیا جا سکتا: چیک کریں کہ جیم کی تنصیب اور پروگرام پر عمل درآمد ایک ہی Ruby ماحول کا استعمال کرتا ہے۔ ونڈوز پر سورس بنانے کے لیے، LICENTIVO_CURL_ROOT سیٹ کریں اور مماثل libcurl DLL کو PATH پر دستیاب کریں۔