AsmResolver

AsmResolver هي مكتبة لقراءة وتعديل وإعادة بناء ملفات Portable Executable (PE). وهي تدعم صور PE التي تعمل أصلاً على Windows، بالإضافة إلى الصور التي تحتوي على بيانات وصفية مُدارة (.NET).

صدر AsmResolver بموجب رخصة MIT.

الميزات الرئيسية

يحتوي AsmResolver على الكثير من الميزات. فيما يلي قائمة غير شاملة بأبرزها:

• إنشاء وقراءة وتعديل وكتابة وتصحيح ملفات PE.
  • وصول كامل إلى الأقسام وأدلة البيانات وتفسيراتها.
  • إعادة بناء Import Address Table (IAT) وإنشاء جسور القفز (trampolining).
  • تحكم كامل في تخطيط مخرَج ملف PE النهائي.
• دعم غني لأنواع موارد Win32 المختلفة (الأيقونات، VersionInfo، وما إلى ذلك).
• دعم غني للبيانات الوصفية لـ .NET مع واجهة برمجة تطبيقات بديهية مشابهة لـ System.Reflection.
  • دعم أجسام الطرق المُدارة والأصلية والديناميكية.
  • استيراد واستنساخ سهل للبيانات الوصفية.
  • مُسلسِلات ومزيلات تسلسل ملفات الموارد المُدارة.
  • دعم حِزم AppHost / SingleFileHost.
  • دعم ثنائيات ReadyToRun (R2R).
• مُصمَّم ليكون متيناً ضد الثنائيات التالفة/المُعمّاة.
• دعم قراءة غني لرموز PDB و PortablePdb.
  • واجهة برمجة تطبيقات مُدارة بالكامل عبر المنصات (بدون الحاجة إلى DIA أو تبعيات مشابهة).
• متعدد المنصات (Windows و *nix، و.NET Framework 3.5+، و.NET standard 2.0، و.NET Core، وMono، ومتوافق مع حزمة NixOS).
• موثّق.
• مُغطى باختبارات الوحدة.

التوثيق

• أدلة
  • الانتقال من v5.x إلى v6.0
• مرجع API

الدعم

• متعقب المشكلات
• لوحة النقاش
• Discord

الملفات الثنائية

البنى المستقرة:

• مصدر NuGet
• إصدارات GitHub

البنى الليلية:

• مصدر NuGet الليلي (https://nuget.washi.dev/v3/index.json)

الفرع	حالة البناء
master
development

التجميع

يمكن بناء الحل باستخدام .NET SDK أو بيئة تطوير متكاملة (IDE) تعمل معه (مثل Visual Studio و JetBrains Rider). تستهدف الحزم الرئيسية إصدارات LTS من مختلف بيئات تشغيل .NET (.NET Framework 3.5، .NET Standard 2.0، .NET Standard 2.1، .NET Core 3.1، .NET 6.0، .NET 8.0، .NET 9.0، .NET 10.0).

لبناء المشروع من سطر الأوامر، استخدم:

$ dotnet build

لتشغيل جميع الاختبارات، استخدم:

$ dotnet test

لتشغيل الاختبارات بنجاح، ستحتاج إلى تثبيت إصدارات إضافية من بيئة تشغيل .NET (بما في ذلك إصدارات STS أو الإصدارات المُعلَن أنها وصلت إلى نهاية الدعم (EOL))، حيث تتحقق اختبارات الوحدة من قراءة ثنائيات تستهدف بيئات تشغيل .NET مختلفة. لتشغيل الاختبارات بنجاح على MacOS و Linux، يُتوقع أيضاً تثبيت mono و wine.

المساهمة

• انظر CONTRIBUTING.md.

شكر وتقدير

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

• شكر خاص لجميع الأشخاص الذين ساهموا مباشرة بترميزات برمجية أو مالياً عبر رعاة GitHub.

• شكر خاص للأشخاص في @MonoMod لمساعدتهم في تحقيق التوافق مع .NET Framework 3.5.

• وشكر كبير آخر لجميع الأشخاص الذين اقترحوا ميزات جديدة، وقدموا ملاحظات حول تصميم API، وأجروا اختبارات مكثفة، و/أو أبلغوا عن أخطاء على لوحة المشكلات، عبر البريد الإلكتروني، أو من خلال الرسائل الخاصة.

إذا شعرت أنك لم تحصل على التقدير الكافي في هذه الإشادات، فلا تتردد في التواصل معنا.