تنزيل Markdownالوثيقة الأصلية على GitHub
حزم تكامل تطبيق Launch
يتضمن Launch 0.1.6 حزمة Licentivo SDK الرسمية 0.11.6 لجميع اللغات التسع. ثبّت حزمة Launch للغتك فقط. تتضمن التنفيذ والمحول الافتراضي وإشعارات الترخيص وإعداد ربط SDK. تنتمي تصريحات TypeScript إلى JavaScript؛ وتعد خلفية Go Web الموثوقة مثالًا إضافيًا. تُحفظ المصادر العامة وأوامر السجل والتوفر لكل لغة في مستودع Launch SDK وحالة نشره.
يحمل تحديث 0.1.6 إصلاح CMake لـ C/C++ من المصدر الأصلي لمستخدمي حزمة إعداد curl وFindCURL. لم تتغير بروتوكولات الترخيص وواجهات التطبيق ودورة حياة الحساب. يمكن للتطبيقات الحالية ترقية حزمة Launch وإعادة البناء دون تغيير رمز التكامل. يتتبع سجل نشر 0.1.6 التوفر العام والتحقق من التثبيت النظيف بصورة منفصلة عن البناء المحلي.
| اللغة | منتج Launch واحد | مصدر الحزمة / دليل API |
|---|---|---|
| Go | ملف ZIP لوحدة مكتفية ذاتيًا | pkg/launchclient |
| Python | licentivo_launch-0.1.6-py3-none-any.whl | sdk/python |
| C# / .NET 8 | Licentivo.Launch.0.1.6.nupkg | sdk/csharp |
| Java 17 | launch-client-0.1.6.jar وPOM | sdk/java |
| JavaScript / Node.js | licentivo-launch-0.1.6.tgz | sdk/javascript |
| Rust | licentivo-launch-0.1.6.crate أو ملف ZIP للمصدر | sdk/rust |
| Ruby | حزمة gem لمنصة Launch أو gem للمصدر | sdk/ruby |
| C | ملف ZIP لتثبيت Launch الأصلي باستخدام CMake | sdk/native |
| C++ | الأرشيف الأصلي نفسه، واجهة C++17 | sdk/native |
التثبيت من سجل عام
اجتازت فحوص التثبيت العام للإصدار 0.1.6 جميع اللغات التسع: Go وPython وC# وJava وNode.js/TypeScript وRust وRuby وC وC++. تتوفر أوامر السجل والتنزيلات الأصلية أدناه للعامة وقد تحققت لدى مستهلكين مستقلين. تسجل حالة النشر مجاميع التحقق الدقيقة للحزم ونتائج التثبيت وحدود المنصات.
go get github.com/spf86/licentivo-launch-sdk/pkg/launchclient@v0.1.6
python -m pip install licentivo-launch==0.1.6
npm install @licentivo/launch@0.1.6
dotnet add package Licentivo.Launch --version 0.1.6
cargo add licentivo-launch@=0.1.6
gem install licentivo-launch --version 0.1.6
تستخدم Java إحداثيات Maven/Gradle com.licentivo.launch:launch-client:0.1.6.
تستخدم C/C++ الأرشيف الأصلي المتوافق مع ABI من إصدار GitHub المحدد.
راجع حالة النشر لمعرفة انتشار السجل ونتائج التحقق.
تثبيت توزيع تم تنزيله
استخدم المنتجات المحددة في integration-packages.json. تسجل كل لغة sdk_managed: true وrequires_separate_official_sdk: false. تحقق من SHA256SUMS قبل التثبيت.
python -m pip install ./licentivo_launch-0.1.6-py3-none-any.whl
npm install ./licentivo-launch-0.1.6.tgz
dotnet add YOUR_PROJECT package Licentivo.Launch --version 0.1.6 --source YOUR_LOCAL_FEED
gem install --local ./licentivo-launch-0.1.6-x64-mingw-ucrt.gem
تستخدم Java ملف JAR الخاص بـ Launch فقط في classpath؛ ولا يحتوي POM على اعتماد على SDK الرسمي. يمكن لمستهلكي Go دون اتصال استخراج ZIP الوحدة واستخدام require/replace محلي لـ github.com/spf86/licentivo-launch-sdk. ويمكن لمستهلكي Rust دون اتصال استخراج crate أو ZIP المصدر وإضافة اعتماد مسار licentivo-launch محلي. لا يلزم حزمة SDK رسمية أو نسخة عمل لها.
بالنسبة إلى C/C++، استخرج ZIP التثبيت الأصلي وأضف بادئته إلى CMake واستخدم:
find_package(LicentivoLaunch CONFIG REQUIRED)
add_executable(myapp main.c)
licentivo_launch_link(myapp)
# C++17 target: licentivo_launch_link(myapp CXX)
يحل Launch اعتماديات SDK الخاص به والمكتبات المتعدية وملفات DLL المضمنة لـ Windows. يترجم build.rs في Rust نواة C المضمنة وينسخ ملفات DLL المضمنة بجوار ملفات Cargo التنفيذية. تتضمن gem منصة Ruby نواتها الأصلية الخاصة ومكتبات التشغيل؛ وتترجم gem المصدر النواة تلقائيًا.
تظل سلاسل أدوات اللغة العادية والاعتماديات المعتادة مطلوبة: يحل pip اعتماد cryptography، ويحل NuGet اعتماد BouncyCastle.Cryptography، ويحل Cargo حزم Rust العادية. تغطي الأرشيفات الأصلية Windows amd64 GNU وLinux amd64. تتضمن توزيعات Windows مكتبة curl. تستخدم أنظمة التشغيل الأخرى المصدر الكامل مع مترجم C11 ومكتبات تطوير curl/OpenSSL العادية للنظام. تتطلب نواة Windows الأصلية لـ SDK 0.11.6 بيئة GNU/MinGW.
تهيئة التطبيق
اختر البرنامج الموجود في Launch. يقرأ تلقائيًا عنوان URL الحالي للتاجر وتعيين الخطة/المنتج الموجود ومفاتيح التوقيع العامة الرسمية، ويوفر دالة اتصال معبأة. انسخ الدالة إلى التطبيق؛ ولا يلزم إدخال معرّف داخلي يدويًا أو إنشاء ملف إعداد. لا يزال بدء تشغيل الخادم يستخدم config.yaml الخاص الذي لا يُوزع مع التطبيق مطلقًا.
استخدم مدخل الحزمة، مثل launchclient.Connect أو Python Application.connect أو C# Application.Connect أو Node Application.connect. ينشئ المصنع المضمن SDK ويديره. المصانع المخصصة خطافات اختبار/تكامل اختيارية وليست خطوات تثبيت. الواجهات الدقيقة في README ومثال كل حزمة.
يتولى Launch دخول الحساب وبيانات الاعتماد محددة النطاق وإعادة المحاولات المعلقة المحدودة والاستعادة. يتحقق SDK المضمن من التواقيع ويصرح بكل عملية محمية. تبقى عمليات الإغلاق العادي والخروج وتحرير الجهاز مختلفة. تفحص تطبيقات Web الأذونات في خلفية موثوقة؛ ويوضع رمز Node/Electron في العملية الرئيسية أو الخادم.
تظل تعليمات التطوير اليدوي في manual-integration.md وREADME كل لغة. تنشئ صفحة تكامل AI الإدارية تعليمات إنجليزية لتدفق التهيئة المباشرة نفسه. تستبعد كلمات المرور ومفاتيح الإدارة وبيانات تشغيل العميل/الجهاز ولا تستدعي خدمة AI. راجع تكامل AI.
بناء التوزيعات بصفتك مشرفًا
لا يحتاج إلى مصادر الأصل المراجعة إلا المشرفون الذين يحدثون SDK المضمن. يتخطى المستهلكون هذا القسم.
./scripts/prepare-examples.ps1 -Source 'C:\path\to\reviewed-sdk\sdk'
./scripts/build-integration-packages.ps1 -Output artifacts/NEW_DIRECTORY -BuildRustCrate -BuildNative -CurlRoot PATH_TO_CURL -CCompiler PATH_TO_GCC
قدّم مسارات الأدوات باستخدام -Python و-DotNet و-JavaHome و-Ruby و-Cargo و-CMake حسب الحاجة. يتحقق منشئ الحزمة من بيان المصدر الأصلي، ثم يضمن prepare-managed-sdk.mjs المصادر ويسجل قيم SHA-256 للمصدر/الوجهة في sdk/managed-sdk-manifest.json. تتغير مواقع/واردات الوحدات عند الحاجة؛ ويبقى التحقق التشفيري في التنفيذ المراجع. ترافق تراخيص MIT وإشعاراتها كل نسخة مضمنة.
ينشئ كل بناء دليلًا جديدًا بمنتجات لكل لغة وأرشيفات مصدر وحزمة مصدر مجمعة وجرد ومجاميع تحقق. يصدر -SourceOnly منتجات مصدر صراحة؛ والأهداف المتخطاة ليست إصدارات ثنائية مختبرة. تحافظ الحزمة المجمعة على مسارات الحزم والأمثلة والمستندات والاختبارات دون الحاجة إلى examples/vendor.
التحقق من التثبيت والسلوك
يثبت scripts/test-managed-installations.ps1 التوزيع في مشاريع مستهلك جديدة. يتحقق من الأهداف التسعة دون حزمة SDK رسمية منفصلة أو مسار مصدر SDK أو محول منسوخ أو إعداد ربط SDK يدوي. يترجم وينفذ مقاطع الاتصال المباشر الناتجة بدقة، بما فيها البيانات العامة المهربة، ويبلغ عن configuration_files_required: false. تقريره منفصل عن مجموعة اختبارات التشغيل.
يشغّل scripts/test-integration-packages.ps1 اختبارات انحدار دورة الحياة وتجهيزات SDK حقيقية موقعة محليًا. قدّم مسارات الأدوات وبناء اختبار أصليًا مهيأ:
./scripts/test-integration-packages.ps1 -Python python -DotNet dotnet -JavaHome $env:JAVA_HOME -Ruby ruby -Cargo cargo -NativeBuildDirectory .cache/launch-native-build
تستخدم عمليات بناء مصدر المستودع اعتماديات النظام الأصلية المعتادة؛ ويمكن لمشرفي Windows توفير LICENTIVO_CURL_ROOT. هذا إعداد أداة لبناء المصدر وليس تثبيت SDK منفصلًا. مع تثبيتات MinGW مختلفة لـ Rust/C++، يقيّد -NativeRuntimeDirectories أدلة DLL الخاصة بـ C++ بالفحوص الأصلية. يؤدي غياب المتطلبات إلى فشل الهدف المتأثر. يتطلب all_nine_passed نجاح الفحوص التسعة جميعها.
التخزين والقبول
تُحفظ الجلسات في الذاكرة افتراضيًا. يتطلب تذكر الدخول مخزنًا محميًا. تتطلب مخازن AES-GCM مفتاحًا من 32 بايت يؤخذ من خزنة نظام التشغيل ولا يُحفظ بجوار النص المشفر مطلقًا. لا تُحفظ كلمات المرور بصورة دائمة. توفر Go وPython وC# وC/C++ الأصلية Windows DPAPI للمستخدم الحالي؛ وتوفر Java وNode وRust وRuby مخازن مشفرة بمفاتيح يديرها المستدعي.
تحتفظ ملفات أجهزة SDK بتنسيق المصدر الأصلي. لا يشفّر تشفير الجلسة كل ملف SDK. قيّد أدلة الذاكرة المؤقتة المحددة بالحساب/المنتج/البيئة واستبعدها من المثبتات والسجلات والتحكم بالإصدار. لا يمكن لتغييرات الهوية/الإعداد إعادة استخدام ذاكرة حساب آخر المؤقتة.
لا يمكن للرفض الصريح للجلسة/الاستحقاق الرجوع إلى العمل دون اتصال. لا يجوز إلا لفشل النقل أو HTTP 5xx استخدام منحة موجودة ومتحقق منها تشفيريًا ضمن سياستها الموقعة. يحتفظ التفعيل الأول والمقاعد العائمة والسياسات التي تمنع العمل دون اتصال بمتطلبات الاتصال.
لا تثبت التقارير المحلية الدفع الحقيقي أو الإصدار أو التفعيل الخارجي مطلقًا. أُجّلت تلك البيئة؛ راجع acceptance.md. يتطلب نشر السجل وتأهيل الإصدارات غير Windows عملًا وأدلة منفصلة.