الحزم
حزم البدء & SDK عروض
نسخ الصفحة
أنشئ تطبيق Lia مع إعدادات وحدة التحكم الموجهة، وتسجيل الدخول المعتمد من المتصفح وتسجيل التطبيق الخاص تلقائيًا. اختر من بين تسع تكاملات إطارات.
#إنشاء مشروع
npm create @lia-labs/app@latestLia Developer Studio يرشدك عبر مشروعك، وإطارك، والقالب الأولي، والإعداد والحساب. استخدم مفاتيح السهم لاختيار إطارك و البدء أو مُلعب SDK. مُوصى به الإعدادات تُمكّن المحاكي المحلي للمتصفح وتثبيت الاعتماديات باستخدام مدير الحزم الذي تستخدمه. تخصيص يسمح لك بتغيير التطبيق العام ID، مدير الحزم، تجربة المحاكاة المحلية وتفضيلات التثبيت. يقوم الإعداد بفحص دليلك قبل إنشاء الملفات، ويعرض تقدم التثبيت ويُطبع أوامر الاستعادة إذا فشل التثبيت. اضغط على Ctrl+C لإلغاء. لا يتم تجاوز المجلدات الموجودة التي ليست فارغة.
استخدم إصدارًا مدعومًا من Node LTS: يُنصح بإصدار Node 22.12+ أو 24+. يختار النماذج الإطارات المتوافقة مع الروابط الحالية لـ Lia، بما في ذلك Preact 10 وSolid 1.
cd my-lia-app
npm install
npm run devتخطي npm install إذا كانت التبعيات مثبتة بالفعل. استخدم الأوامر المطابقة لمدير الحزم المحدد.
#قم بالاتصال بحسابك Lia
بعد إنشاء ملفاتك، اختر الاتصال & تسجيل لفتح Lia المطورين في متصفحك. سجّل الدخول بحسابك Lia، مقارنة الشفرة المعروضة في الطرفية، وافق على الطلب. يتم إنشاء تطبيقك كقائمة اختبار خاصة في لوحة التحكم الخاصة بك. اختر استمر في البناء محليًا، أو تجاهله --local، للتسجيل لاحقًا.
npx @lia-labs/create-app@latest login
npx @lia-labs/create-app@latest whoami
npx @lia-labs/create-app@latest appsهل لديك مشروع تم إنشاؤه مسبقًا؟ سجّله من مجلد المشروع:
npx @lia-labs/create-app@latest register --name "My game" --kind gameيمكنك أيضًا إنشاء وتسجيل الدخول في أمر واحد:
npm create @lia-labs/app@latest my-game -- --framework react --template demo --register --kind gameالتسجيل لا يتطلب استضافة حتى الآن. حتى تضيف HTTPS مُنشَّرة URL في لوحة التحكم، فإن فتح القائمة يعرض مكانًا افتراضيًا للإعداد. استخدم --url https://your-app.example عند التسجيل إذا كانت الخدمة جاهزة. تسجيل تطبيق ID تملكه بالفعل يربط المشروع بهذا القائمة دون تعديله؛ تطبيق ID يملكه شخص آخر يتم رفضه. إدارة تغييرات URL، الفن، المختبرين والمراجعة في لوحة التحكم.
التطبيق العام ID يتم حفظه في lia.config.json والتكوين المولد للإطار. تسجيل الدخول يضيف معلومات لوحة القيادة ومعرف المضيف إلى هذا الملف. بيانات اعتماد الحساب تُخزَّن منفصلة على جهازك; لا تُكتَب أبدًا في المشروع أو الشفرة المُولدة للمتصفح.
رمز موافقة المتصفح ينتهي بعد عشر دقائق. الوصول إلى واجهة السطر يستمر حتى ثلاثين يومًا ويمكنه عرض تطبيقاتك، وإنشاء إعلانات اختبار خاصة وإعداد معاينات محلية متصلة بتطبيقات الاختبار الخاصة بك. لا يمكنه نشر التطبيقات أو قراءة مفاتيح الخادم أو إجراء الدفعات. استخدم المحطات المتصلة على لوحة التحكم لإلغاء جهاز نهائي فورًا، أو تسجيل الخروج من سطر الأوامر:
npx @lia-labs/create-app@latest logoutالموافقة فقط على الكود الذي بدأت به نفسك. ما زال متطلبات الوصول للتطوير الحالي سارية؛ لا يتجاوز تسجيل الدخول من وحدة التحكم عملية الدعوة. إذا لم يمكن فتح المتصفح تلقائيًا، استخدم login --no-browser وافتح الرابط المطبوع بنفسك. يمكن إعادة محاولات الطلبات المرفوضة أو المنتهية الصلاحية باستخدام login.
#معاينة تطبيقك المحلي داخل Lia
من مشروعك المسجل، قم بتشغيل:
npx @lia-labs/create-app@latest devيبدأ CLI خادم الإطار التنموي، ويفتح قناة Cloudflare مؤقتة ويقوم بتوصيلها بموقع الاختبار الخاص بك. افتح التطبيق مرة أخرى في Lia تحت التطبيقات → الاختبارات. التعديلات اللاحقة تستخدم إعادة تحميل المخطط التفصيلي الخاص بالإطار الخاص بك، لذا يمكنك الاستمرار في اختبار التطبيق على هاتفك أثناء تعديل الملفات المحلية. لا تحتاج إلى حساب Cloudflare أو إعدادات DNS.
إذا لم يتم تثبيت Cloudflare Tunnel، يقوم Lia بتنزيل المساعد الرسمي إلى ذاكرة التخزين المؤقت للمستخدم ويتحقق من مجموع التحقق من الإصدار قبل تشغيله. لا يقوم بتثبيت خدمة في الخلفية. اختر منفذًا آخر مع --port 4201, أو مدير حزم مع --pm pnpm.
يعرض لوحة التشغيل المحلي خادمك، وقناة HTTPS وتطبيق Lia المتصل. اضغط على o لفتح رابط التطبيق، d للوحة القيادة الخاصة بها، أو q / Ctrl+C to stop. Existing terminal grants need one new browser approval for local preview access.
موقعك الثابت URL غير متغير. عند التوقف يتم إزالة اتصال المعاينة، وينتهي الاتصال عند فقدان终端 خلال دقيقتين. تعمل معاينات الموقع المحلي فقط مع تطبيقات الاختبار الخاصة، ولا يمكن أن تحل محل التطبيق المباشر. قم بDeployment استضافة HTTPS الثابتة قبل تقديمها للمراجعة.
تُعتبر قناة URL المؤقتة عامة لأي شخص يمتلكها، بينما يبقى موقع Lia محدودًا للمستخدمين الحاليين. احتفظ بأسرار الإنتاج وبيانات العملاء الخاصة بعيدًا عن معاينات المتصفح المحلية. قنوات Quick هي بنية تحتية تنموية لا تضمن توفرها دائمًا.
#تفضيلات المحطة
يتكيف واجهة المستخدم مع المحطات الأصغر. قم بتعيين NO_COLOR=1 للألوان البسيطة، LIA_NO_MOTION=1 لإيقاف تشغيل تدرج التقدم، أو ACCESSIBLE=1 للرسائل النصية القياسية. CI وال출력 المُعاد توجيهه تبقى ثابتة. تُقدِّم CLI خطوات التكوين الفعلية بدلًا من نسبة مئوية محاكاة.
#اختر إطار عمل
| الهيكل | ال الأوامر | Lia التكامل |
|---|---|---|
| عادي TypeScript | npm create @lia-labs/app@latest my-app -- --framework vanilla | مكالمات SDK المُحددة والنظام المرصود. |
| رياكت | npm create @lia-labs/app@latest my-app -- --framework react | useInit, usePlayer, useLanguage, useMainButton. |
| Preact | npm create @lia-labs/app@latest my-app -- --framework preact | الوصفات المسبقة والارتباطات المسبقة لـ Lia. |
| فوي | npm create @lia-labs/app@latest my-app -- --framework vue | الوحدات المركبة، المراجع وتنظيف المكونات. |
| سفلت | npm create @lia-labs/app@latest my-app -- --framework svelte | مكتبات Svelte والتحكمات المُحددة بالملف. |
| صلب | npm create @lia-labs/app@latest my-app -- --framework solid | الوصولات، createInit و createMainButton. |
| زاوي | npm create @lia-labs/app@latest my-app -- --framework angular | تطبيق Angular مستقل مع إشارات مُضافة. |
| عناصر الويب | npm create @lia-labs/app@latest my-app -- --framework elements | <lia-app>, <lia-main-button> والنوع المُحدد SDK. |
| الجسر منخفض المستوى | npm create @lia-labs/app@latest my-app -- --framework bridge | نوعية متقدمة request, send ومثال الحدث. |
تستخدم Angular مُنشئ تطبيقاتها. يستخدم بدائل أخرى Vite. جميع البدائل تستخدم TypeScript؛ يتم تضمين ملفات مكونات محددة للإطار بحيث يمكنك تعديل التكامل مباشرةً.
#ابدأ بنسخة تجريبية تعمل من SDK
أضف --template demo للوظيفة التفاعلية للكتالوج في إطار عملك:
npm create @lia-labs/app@latest my-react-demo -- --framework react --template demo
npm create @lia-labs/app@latest my-vue-demo -- --framework vue --template demo
npm create @lia-labs/app@latest my-angular-demo -- --framework angular --template demoتتضمن عروض الهيكل المحادثات والاهتزازات والهوية وتحديث الجلسة والشراء التجريبي والإعلانات المُكافأة أو الإعلانات الكاملة أو الشاشة أو الإعلانات المدمجة والمشاركة والتخزين وتصوير الوسائط والبصمة البيولوجية ومسح QR والتحكم في الشاشة والتحذيرات والنتائج. لكل إجراء يوجد كود ورد فعل التحميل وقراءة الاستجابة. يتم التعامل مع الميزات غير الداعمة ورفض الصلاحيات دون تعطيل النظام. يتم إزالة رموز الجلسة ومحتوى الملفات من قراءة الاستجابة.
يُركز العرض التوضيحي المتقدم على الرسائل المُحددة بالنوع. تستخدم عروض الإطارات التوضيحية روابطها الخاصة للهوية التفاعلية واللغة والتحكمات الأصلية؛ وهي تشارك أمثلة مُحددة بالنوع، وليس إطارًا مُحاطًا بعرض JavaScript الأصلي.
يمكنك أيضًا فتح نموذج SDK داخل Lia تحت التطبيقات → الاختبارات. يملك كل مطور مسجل الوصول دون الحاجة إلى منح مُختَبِر منفصل. يحتوي مقدمة البوابة ورابط لوحة القيادة على رابط إليه.
#محاكاة المتصفح والاختبار الحقيقي
تثبيتات التطوير المحلي mockLia() فقط خارج Lia. يتم محاكاة المدفوعات والإعلانات والمكافآت؛ لا يتم إنشاء جلسة حقيقية أو دفع. تُستبعد نسخ الإنتاج من المُحاكاة التنموية. تُستبدل Angular وحدة التطوير الخاصة بها؛ يستخدم بدائيات Vite علم البناء التنموي.
تعطيل المحاكاة باستخدام --no-mock. بالنسبة للمشاريع Vite، يمكنك أيضًا تعيين VITE_LIA_MOCK=false في ملف بيئة التطوير المحلية. لا تزال الأذونات والعتاد الأصلي تحتاج إلى اختبار داخل Lia.
- تشغيل
npm run buildوالحفاظ على المخرجات عبر HTTPS (dist/, أوdist/browser/لـ Angular). - سجل عبر CLI أو قم بإنشاء التطبيق في بوابة المطورين. قم بتعيين HTTPS المُسجَّلة URL قبل الاختبار. لا يُسجِّل تطبيق ID في الكود وحده قائمة أو يُصدِّق الطلبات.
- أنت وأربعة مختبرين إضافيين يجدونه تحت التطبيقات → الاختبارات، بغض النظر عن فئتها النشرية.
- لمثال الشراء، قم بإنشاء
demo-coinsاختبار المنتج في البوابة. - ضع تطبيق اختبار بعيدًا مع الإعدادات → أرشيف التطبيق. يختفي من قائمة تطبيقات الجميع الأصلية ويمكن استعادته دون حذف الإعدادات أو بيانات الاختبار.
يُلزم الإصدار العام المراجعة. سيتم فتح الوصول للمطورين بشكل مفتوح في الربع 1 2027؛ ولا يُعفي CLI من متطلبات الدعوة أو النشر الحالية.
#احتفظ بالقرارات القيّمة على خادمك
لا تثق بالاستدعاءات الجانبية للعميل، والنقاط، أو قيم التخزين المحلي أو أحداث إغلاق الإعلانات لمنح العملة، أو العناصر أو المكافآت. احتفظ بمفاتيح الخادم وسر webhook بعيدًا عن الشفرة المصدرية للمتصفح وكلها VITE_* المتغيرات.
النموذج الأول لا يُقلّد التحقق من الخادم ولا يحتوي على نقطة نهاية غير آمنة. يتم تقييد الشراء والتقديم المتعلق بالنتائج إلى وضع الاختبار. أضف خادمًا ي تحقق الجلسات، تحقق من تطبيق كل رسوم الدفع، اللاعب، المنتج، النمط والสถานية، وتُسَلِّم مرة واحدة وتُعَلِّم بتسليمها. احتفظ بالمحاسبة التجريبية والعملية منفصلة.
#مُدرِّجات الحزم والآليات
pnpm create @lia-labs/app my-app --framework vue --template demo
yarn create @lia-labs/app my-app --framework svelte
bun create @lia-labs/app my-app --framework solidللنصوص أو CI:
npm create @lia-labs/app@latest my-app -- --framework react --template starter --app-id my-app --yes --no-install --localالإعداد غير التفاعلي يبقى محليًا ما لم تمرر --register؛ تسجيل الدخول دون مطالبات يتطلب تسجيل دخول جلسة موجودة مسبقًا. استخدم --install لتنصيبها تلقائيًا. --help تُعرض الخيارات. إذا فشلت التثبيت، تبقى الملفات المُولدة متاحة، ويُطبع CLI الأمر لمحاولة إعادة المحاولة.
#أضف خادمًا آمنًا
تشغيل npx @lia-labs/create-app@latest backend لمشروع خادم منفصل في TypeScript/JavaScript، بايثون، PHP أو غو. اختر Node/Express، FastAPI/Django، PHP HTTP أو غو HTTP. تحتوي هذه البدائل على جلسات لاعبين مُصادق عليها، وتواريخ موقعة، وتحقق من الدفعات المدفوعة ومستودعات مستمرة ذات إيصالات فريدة. احتفظ بأسرار الخادم بعيدًا عن واجهة المستخدم. اطلع على حزم الخلفية والإرشادات لتكامل الإطار.
تم الترجمة تلقائيًا. الإنجليزية هي مصدر الحقيقة. اقرأ باللغة الإنجليزية