ruffle

موقع الكتروني | تجريبي | يبني ليلا | ويكي

كشكش

Ruffle هو محاكي Adobe Flash Player مكتوب بلغة البرمجة Rust. يستهدف Ruffle كلاً من سطح المكتب والويب باستخدام WebAssembly.

جدول المحتويات

• حالة المشروع
• باستخدام كشكش
• البناء من المصدر
  • المتطلبات الأساسية
  • متطلبات Linux الأساسية
  • سطح المكتب
    • يبني
    • ماك
  • الويب أو الامتداد
  • أندرويد
  • الماسح الضوئي
  • مصدر
• بناء
• الرعاة
• رخصة
• المساهمة

حالة المشروع

يدعم Ruffle ActionScript 1 و2 و3 بشكل جيد، لكنه لم ينته بعد بأي حال من الأحوال. يرجى الإبلاغ عن أي مشكلة في أداة تعقب المشكلات.

باستخدام كشكش

أسهل طريقة لتجربة Ruffle هي زيارة صفحة العرض التوضيحي على الويب، ثم النقر فوق الزر "تحديد ملف" لتحميل ملف SWF من اختيارك.

تتوفر إصدارات Ruffle الليلية لمنصات سطح المكتب والويب.

لمزيد من التعليمات التفصيلية، راجع صفحة الويكي الخاصة بنا.

البناء من المصدر

المتطلبات الأساسية

• أحدث قناة مستقرة من الصدأ
• Java، متاحة على PATH الخاص بك java (مطلوبة لبناء المكتبة التي تحتوي على فئات Flash المضمنة لـ ActionScript 3)

متطلبات Linux الأساسية

فيما يلي تبعيات نموذجية لنظام التشغيل Linux:

• libasound2-dev
• libxcb-shape0-dev
• libxcb-xfixes0-dev
• libgtk-3-dev
• libudev-dev
• libxcb-xinput-dev
• libxcb-xkb-dev
• libxcb-cursor-dev
• الافتراضي-jre-headless
• com.cmake
• ز++

سطح المكتب

يبني

استخدم الأمر التالي لإنشاء تطبيق سطح المكتب وتشغيله:

cargo run --release --package=ruffle_desktop

لتشغيل ملف SWF محدد، قم بتمرير مسار SWF كوسيطة:

cargo run --release --package=ruffle_desktop -- test.swf

للإنشاء في وضع التصحيح، ما عليك سوى حذف --release من الأمر.

ماك

يمكن إنشاء سطح المكتب المكشكش من Homebrew Tap الخاص بنا:

brew install --HEAD ruffle-rs/ruffle/ruffle

ملحوظة: نظرًا لأنه مخصص للرأس فقط، فستحتاج إلى تشغيل brew upgrade --fetch-HEAD ruffle في كل مرة تريد فيها التحديث.

الويب أو الامتداد

اتبع الإرشادات الموجودة في دليل الويب لإنشاء إصدار ملحق الويب أو المتصفح من Ruffle.

تم اختبار هذا المشروع باستخدام BrowserStack.

أندرويد

اتبع الإرشادات الموجودة في مشروع ruffle-android لإنشاء تطبيق Android لـ Ruffle.

الماسح الضوئي

إذا كان لديك مجموعة من صناديق SWF "العالمية الحقيقية" لاختبارها، فقد يتم استخدام الماسح الضوئي لقياس قدرات التحليل الخاصة بـ ruffle. مزودًا بمجلد واسم ملف الإخراج، وسيحاول قراءة جميع ملفات Flash وتقديم تقرير عن نجاح مثل هذه المهمة.

cargo run --release --package=ruffle_scanner -- scan folder/with/swfs/ results.csv

مصدر

إذا كان لديك ملف SWF وترغب في التقاط صورة له، فيمكنك استخدام أداة التصدير. يتطلب هذا حاليًا تسريع الأجهزة، ولكن يمكن تشغيله بدون رأس (بدون نافذة).

• cargo run --release --package=exporter -- path/to/file.swf
• cargo run --release --package=exporter -- path/to/file.swf path/to/screenshots --frames 5

بناء

• core - المحاكي الأساسي والرمز المشترك
• swf - محلل SWF وActionScript
• desktop - عميل سطح المكتب (يستخدم wgpu-rs )
• web - عميل الويب وامتداد المتصفح (يستخدم wasm-bindgen )
• render - واجهات عرض مختلفة لكل من سطح المكتب والويب
• video - الواجهات الخلفية لفك تشفير الفيديو
• flv - برنامج فك ترميز فيديو فلاش
• wstr - تطبيق متوافق مع فلاش للسلاسل
• scanner - أداة مساعدة لتحليل ملفات SWF بشكل مجمّع
• exporter - أداة مساعدة لإنشاء لقطات شاشة PNG لملف SWF

الرعاة

يمكنك دعم تطوير Ruffle عبر رعاة GitHub. ستساعد رعايتك على ضمان إمكانية الوصول إلى محتوى Flash في المستقبل. شكرًا لك!

خالص الشكر لرعاة المستوى الماسي لـRuffle:

رخصة

الكشكشة مرخصة بموجب أي منهما

• ترخيص أباتشي، الإصدار 2.0 (http://www.apache.org/licenses/LICENSE-2.0)
• ترخيص معهد ماساتشوستس للتكنولوجيا (http://opensource.org/licenses/MIT)

في خيارك.

يعتمد Ruffle على مكتبات الطرف الثالث بموجب تراخيص متوافقة. راجع LICENSE.md للحصول على المعلومات الكاملة.

المساهمة

كشكش ترحب بمساهمة الجميع. راجع CONTRIBUTING.md للحصول على المساعدة للبدء.

ما لم تنص صراحةً على خلاف ذلك، فإن أي مساهمة يتم تقديمها عمدًا لتضمينها في العمل بواسطتك يجب أن تكون مرخصة كما هو مذكور أعلاه، دون أي شروط أو أحكام إضافية.

من المتوقع أن يلتزم مجتمع Ruffle بأكمله، بما في ذلك غرفة الدردشة ومشروع GitHub، بقواعد السلوك التي يتبعها مشروع Rust نفسه.