ILSpy

ILSpy هو متصفح ومفكك تجميعات .NET مفتوح المصدر ومتعدد المنصات. تعمل واجهة المستخدم لسطح المكتب على Windows وLinux وmacOS (مبنية على Avalonia).

تنزيل: أحدث إصدار | أحدث بناء CI (master) | Microsoft Store (إصدارات RTM فقط)

واجهات المفكك الأمامية

بالإضافة إلى واجهة المستخدم لسطح المكتب متعددة المنصات ILSpy (القابلة للتنزيل عبر Releases، انظر أيضًا الإضافات)، تتوفر الواجهات الأمامية الأخرى التالية:

• يأتي Visual Studio 2022/2026 مع دعم فك التجميع لمفتاح F12 مفعّلًا افتراضيًا (باستخدام محركاتنا v8.2 وv9.1 على التوالي).
• إضافة Visual Studio 2022/2026 الخاصة بنا marketplace
• إضافة Visual Studio Code الخاصة بنا repository | marketplace | open-vsx
• أداة dotnet الخاصة بنا لـ Linux/Mac/Windows - راجع ILSpyCmd في هذا المستودع | dotnet tool install
• يأتي C# for Visual Studio Code مع دعم فك التجميع أيضًا. للتفعيل، قم بتشغيل الإعداد "Enable Decompilation Support".
• حزم NuGet الخاصة بنا ICSharpCode.Decompiler وILSpyX لمشاريعك الخاصة
• أوامر PowerShell cmdlets الخاصة بنا لـ Linux/Mac/Windows في هذا المستودع

الميزات

• فك التجميع إلى C# (راجع حالة دعم اللغة)
• فك تجميع المشروع بأكمله
• الفتح من موجز NuGet، والفتح من عملية قيد التشغيل بالإضافة إلى القرص وGAC (على Windows فقط)
• البحث عن الأنواع/الطرق/الخصائص (تعرّف على الخيارات)
• التنقل بين الأنواع/الطرق/الخصائص عبر الارتباطات التشعبية، والإشارات المرجعية
• التنقل بين الأنواع الأساسية/المشتقة، والسجل
• مستكشف بيانات تعريف التجميع (جولة في الميزة)
• مفكك BAML إلى XAML، ودعم !AvaloniaResources
• دعم ثنائيات ReadyToRun لـ .NET Core (راجع البرنامج التعليمي)
• قابل للتوسيع عبر الإضافات
• ميزات إضافية في بناءات DEBUG (للمطورين)

الترخيص

يُوزَّع ILSpy بموجب ترخيص MIT. يُرجى الاطلاع على مستند About للحصول على التفاصيل، بالإضافة إلى إشعارات الأطراف الثالثة للمكتبات مفتوحة المصدر المضمّنة.

كيفية البناء

Windows:

• تأكد من تثبيت PowerShell 7+ (يعمل أيضًا Windows PowerShell بإصدار 5.0 على الأقل)
• استنسخ مستودع ILSpy باستخدام git.
• نفّذ git submodule update --init --recursive لتنزيل الوحدة الفرعية ILSpy-Tests (التي تستخدمها بعض حالات الاختبار).
• ثبّت Visual Studio (الإصدار الموثق: 18.0/2026). تحتاج إلى مكونات عبء العمل التالية:
  • عبء العمل ".NET Desktop Development". يتضمن عبء العمل هذا .NET Framework 4.8 SDK وحزمة استهداف .NET Framework 4.7.2، بالإضافة إلى .NET 10.0 SDK (يستهدف ILSpy.csproj الإصدار .NET 10.0، لكن لدينا مشاريع net472 أيضًا). تتطلب اختبارات الوحدة لدينا .NET 11.0 SDK.
  • عبء العمل "Visual Studio extension development" (ملاحظة: ILSpy.VSExtensions.slnx منفصل عن ILSpy.slnx، وبالتالي فإن عبء العمل هذا اختياري)
  • المكوّن الفردي "MSVC v143 - VS 2022 C++ x64/x86 build tools" (أو ما شابه)
    • مجموعة أدوات VC++ اختيارية؛ إذا كانت موجودة فسيتم استخدامها مع editbin.exe لتعديل حجم المكدس (stack size) الذي يستخدمه ILSpy.exe من 1MB إلى 16MB، لأن المفكك (decompiler) يستخدم الاستدعاء الذاتي (recursion) بكثافة، حيث تؤدي أحجام المكدس الصغيرة إلى مشكلات في الطرق المعقدة جدًا.
• افتح ILSpy.slnx في Visual Studio.
  • ستقوم استعادة حزمة NuGet بتنزيل التبعيات الإضافية تلقائيًا
  • شغّل المشروع "ILSpy" لواجهة مستخدم ILSpy
  • استخدم "Test Explorer" في Visual Studio لعرض/تشغيل الاختبارات
  • إذا كنت مهتمًا بمجموعة فرعية محددة فقط من ILSpy، يمكنك أيضًا استخدام
    • ILSpy.Desktop.slnf: لواجهة مستخدم Avalonia متعددة المنصات واختباراتها
    • ILSpy.XPlat.slnf: لأداة سطر الأوامر (CLI) متعددة المنصات (ilspycmd) أو أوامر PowerShell النمطية (cmdlets)
    • ILSpy.VSExtensions.slnx: لملحقات Visual Studio

ملاحظة: يتضمن Visual Studio إصدارًا من .NET SDK تتم إدارته بواسطة مثبّت Visual Studio - بمجرد التحديث، قد تتم ترقيته أيضًا. يرجى ملاحظة أن ILSpy متوافق فقط مع .NET 11.0 SDK، وسيرفض Visual Studio تحميل بعض المشاريع في الحل (وستفشل اختبارات الوحدة). إذا حدثت هذه المشكلة، يرجى تثبيت .NET 11.0 SDK يدويًا من هنا.

Unix / Mac:

• تأكد من تثبيت .NET 10.0 SDK (للتشغيل) و.NET 11.0 SDK (للاختبارات). والأفضل من ذلك، استخدم dotnetup مع قناة SDK preview.
• تأكد من تثبيت PowerShell (المعروف سابقًا باسم PowerShell Core)
• استنسخ المستودع باستخدام git.
• نفّذ git submodule update --init --recursive لتنزيل الوحدة الفرعية ILSpy-Tests (التي تستخدمها بعض حالات الاختبار).
• استخدم dotnet build ILSpy.Desktop.slnf لبناء واجهة مستخدم Avalonia المكتبية متعددة المنصات؛ شغّلها باستخدام dotnet run --project ILSpy.
• استخدم dotnet build ILSpy.XPlat.slnf لبناء أداة سطر الأوامر (CLI) فقط (ilspycmd) وأوامر PowerShell النمطية (cmdlets).

نوصي باستخدام Visual Studio Code أو مشتقاته مع DotRush، وهو متاح أيضًا لمشتقات VS Code.

كيفية المساهمة

• أبلغ عن الأخطاء
• إذا كنت ترغب في تقديم طلب سحب (pull request)، يرجى إضافة https://github.com/icsharpcode/ILSpy/blob/master/BuildTools/pre-commit إلى .git/hooks الخاص بك لمنع إيداع كود بتنسيق خاطئ. نستخدم علامات الجدولة (tabs) وليس المسافات. يشغّل خادم البناء نفس السكربت، لذا ستفشل أي طلبات سحب تستخدم تنسيقًا خاطئًا.

المساهمون الحاليون والسابقون.

سياسة الخصوصية لـ ILSpy

لا يجمع ILSpy أي معلومات تعريف شخصية، ولا يرسل ملفات المستخدم إلى خدمات طرف ثالث. لا يستخدم ILSpy أي خدمة APM (إدارة أداء التطبيقات) لجمع القياسات عن بُعد أو المقاييس.