The New .slnx Solution Format (migration guide)

الـ Solution files دايماً كانت هي الملف اللي مفيش حد عايز يلمسه وقت الـ merge conflict. أنا لسه فاكر المعاناة بتاعة حل الـ conflicts في الـ monorepos الكبيرة اللي فيها مئات المشاريع، وبصراحة الموضوع مكنش فيه أي نوع من أنواع المتعة.

شركة Microsoft أخيراً بدأت تحل الأزمة دي بتقديم الـ .slnx: وده عبارة عن XML-based format، بسيط، ومصمم عشان يكون أسهل في القراية، التعديل، والـ merge. وده الدليل العملي بتاعك لمستقبل الـ .NET solutions.

The Problem with .sln

ملفات الـ .sln التقليدية “رغاية” جداً (verbose): مليانة GUIDs لكل مشروع، وكمان فيها Blocks للـ configuration بتكبر بشكل مرعب كل ما الـ solution يكبر. وده بيخليها مصدر دايم للـ merge conflicts.

عشان نقدر قيمة الـ format الجديد، لازم نبص بصة على الشكل القديم. ده ملف .sln تقليدي لـ solution حجمه متوسط:

Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 17
VisualStudioVersion = 17.7.34031.279
MinimumVisualStudioVersion = 10.0.40219.1
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{8FC526EA-218B-4615-8410-4E1850611F38}"
	ProjectSection(SolutionItems) = preProject
		.editorconfig = .editorconfig
		Directory.Build.props = Directory.Build.props
		Directory.Packages.props = Directory.Packages.props
	EndProjectSection
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{64A28C1B-09AF-426E-8721-D002BE554B48}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SharedKernel", "src\SharedKernel\SharedKernel.csproj", "{166778A2-518F-47F0-BBC7-DB49C76A963C}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Domain", "src\Domain\Domain.csproj", "{6448ADE8-34BC-4F2F-A68C-5B2D6BF4FB0B}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Application", "src\Application\Application.csproj", "{0F576D4A-156D-4626-A4D5-83DD0F6FAFE7}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Infrastructure", "src\Infrastructure\Infrastructure.csproj", "{C699FD09-4D82-4C4B-8744-4FD3B0D60EFC}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Web.Api", "src\Web.Api\Web.Api.csproj", "{86506D03-3746-41E7-A645-97D3633981DB}"
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "tests", "tests", "{1EB88D85-BE1E-46DE-99A2-2F02363060AF}"
EndProject
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ArchitectureTests", "tests\ArchitectureTests\ArchitectureTests.csproj", "{8D8E2A8A-D3FE-4230-BEF7-C427D6BD87DA}"
EndProject
Project("{E53339B2-1760-4266-BCC7-CA923CBCF16C}") = "docker-compose", "docker-compose.dcproj", "{34BB3069-D5D0-4046-ACAD-A2025ED7678F}"
EndProject
Global
	GlobalSection(SolutionConfigurationPlatforms) = preSolution
		Debug|Any CPU = Debug|Any CPU
		Release|Any CPU = Release|Any CPU
	EndGlobalSection
	GlobalSection(ProjectConfigurationPlatforms) = postSolution
		{166778A2-518F-47F0-BBC7-DB49C76A963C}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
		{166778A2-518F-47F0-BBC7-DB49C76A963C}.Debug|Any CPU.Build.0 = Debug|Any CPU
		{166778A2-518F-47F0-BBC7-DB49C76A963C}.Release|Any CPU.ActiveCfg = Release|Any CPU
		{166778A2-518F-47F0-BBC7-DB49C76A963C}.Release|Any CPU.Build.0 = Release|Any CPU
		{6448ADE8-34BC-4F2F-A68C-5B2D6BF4FB0B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
		{6448ADE8-34BC-4F2F-A68C-5B2D6BF4FB0B}.Debug|Any CPU.Build.0 = Debug|Any CPU
		{6448ADE8-34BC-4F2F-A68C-5B2D6BF4FB0B}.Release|Any CPU.ActiveCfg = Release|Any CPU
		{6448ADE8-34BC-4F2F-A68C-5B2D6BF4FB0B}.Release|Any CPU.Build.0 = Release|Any CPU
		{0F576D4A-156D-4626-A4D5-83DD0F6FAFE7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
		{0F576D4A-156D-4626-A4D5-83DD0F6FAFE7}.Debug|Any CPU.Build.0 = Debug|Any CPU
		{0F576D4A-156D-4626-A4D5-83DD0F6FAFE7}.Release|Any CPU.ActiveCfg = Release|Any CPU
		{0F576D4A-156D-4626-A4D5-83DD0F6FAFE7}.Release|Any CPU.Build.0 = Release|Any CPU
		{C699FD09-4D82-4C4B-8744-4FD3B0D60EFC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
		{C699FD09-4D82-4C4B-8744-4FD3B0D60EFC}.Debug|Any CPU.Build.0 = Debug|Any CPU
		{C699FD09-4D82-4C4B-8744-4FD3B0D60EFC}.Release|Any CPU.ActiveCfg = Release|Any CPU
		{C699FD09-4D82-4C4B-8744-4FD3B0D60EFC}.Release|Any CPU.Build.0 = Release|Any CPU
		{86506D03-3746-41E7-A645-97D3633981DB}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
		{86506D03-3746-41E7-A645-97D3633981DB}.Debug|Any CPU.Build.0 = Debug|Any CPU
		{86506D03-3746-41E7-A645-97D3633981DB}.Release|Any CPU.ActiveCfg = Release|Any CPU
		{86506D03-3746-41E7-A645-97D3633981DB}.Release|Any CPU.Build.0 = Release|Any CPU
		{8D8E2A8A-D3FE-4230-BEF7-C427D6BD87DA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
		{8D8E2A8A-D3FE-4230-BEF7-C427D6BD87DA}.Debug|Any CPU.Build.0 = Debug|Any CPU
		{8D8E2A8A-D3FE-4230-BEF7-C427D6BD87DA}.Release|Any CPU.ActiveCfg = Release|Any CPU
		{8D8E2A8A-D3FE-4230-BEF7-C427D6BD87DA}.Release|Any CPU.Build.0 = Release|Any CPU
		{34BB3069-D5D0-4046-ACAD-A2025ED7678F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
		{34BB3069-D5D0-4046-ACAD-A2025ED7678F}.Debug|Any CPU.Build.0 = Debug|Any CPU
		{34BB3069-D5D0-4046-ACAD-A2025ED7678F}.Release|Any CPU.ActiveCfg = Release|Any CPU
		{34BB3069-D5D0-4046-ACAD-A2025ED7678F}.Release|Any CPU.Build.0 = Release|Any CPU
	EndGlobalSection
	GlobalSection(SolutionProperties) = preSolution
		HideSolutionNode = FALSE
	EndGlobalSection
	GlobalSection(NestedProjects) = preSolution
		{166778A2-518F-47F0-BBC7-DB49C76A963C} = {64A28C1B-09AF-426E-8721-D002BE554B48}
		{6448ADE8-34BC-4F2F-A68C-5B2D6BF4FB0B} = {64A28C1B-09AF-426E-8721-D002BE554B48}
		{0F576D4A-156D-4626-A4D5-83DD0F6FAFE7} = {64A28C1B-09AF-426E-8721-D002BE554B48}
		{C699FD09-4D82-4C4B-8744-4FD3B0D60EFC} = {64A28C1B-09AF-426E-8721-D002BE554B48}
		{86506D03-3746-41E7-A645-97D3633981DB} = {64A28C1B-09AF-426E-8721-D002BE554B48}
		{8D8E2A8A-D3FE-4230-BEF7-C427D6BD87DA} = {1EB88D85-BE1E-46DE-99A2-2F02363060AF}
	EndGlobalSection
	GlobalSection(ExtensibilityGlobals) = postSolution
		SolutionGuid = {B948A3CC-9872-4612-ABD2-BB3D49671542}
	EndGlobalSection
EndGlobal

حظ سعيد بقى وأنت بتحاول تفهم أي حاجة من الكلام ده وأنت بتحل merge conflict!

What .slnx looks like

الـ .slnx البسيط هو أساساً عبارة عن لستة مشاريع مكتوبة بـ XML.

ده نفس الـ solution اللي فوق بالظبط، بس بـ format الـ .slnx. هتلاحظ إننا لسه عندنا الـ solution items، الـ folders، وحتى الـ docker-compose project:

<Solution>
  <Folder Name="/Solution Items/">
    <File Path=".editorconfig" />
    <File Path="Directory.Build.props" />
    <File Path="Directory.Packages.props" />
  </Folder>
  <Folder Name="/src/">
    <Project Path="src/Application/Application.csproj" />
    <Project Path="src/Domain/Domain.csproj" />
    <Project Path="src/Infrastructure/Infrastructure.csproj" />
    <Project Path="src/SharedKernel/SharedKernel.csproj" />
    <Project Path="src/Web.Api/Web.Api.csproj" />
  </Folder>
  <Folder Name="/tests/">
    <Project Path="tests/ArchitectureTests/ArchitectureTests.csproj" />
  </Folder>
  <Project Path="docker-compose.dcproj">
    <Build />
  </Project>
</Solution>

الشكل ده شبه الـ .csproj file جداً.

How to Migrate Today

الـ format الجديد .slnx متاح حالياً في الإصدارات الأخيرة من الـ Visual Studio 2022 (v17.13+) والـ .NET 9 SDK. ودي الطريقة اللي تقدر تحول بيها:

Option 1: The Command Line

لو عندك الـ .NET 9 SDK متسطب (تحديداً إصدار 9.0.200 أو أحدث)، تقدر تحول فوراً عن طريق الـ CLI:

افتح الـ terminal في الفولدر بتاع الـ solution.
شغل أمر التحويل:

dotnet sln migrate

ده هيعمل ملف .slnx جديد جنب ملف الـ .sln القديم بتاعك. في المرحلة دي، أنصحك تمسح ملف الـ .sln القديم عشان متتلخبطش، مفيش فايدة إنك تسيب الاتنين في نفس الـ repo.

Option 2: Visual Studio “Save As”

لو بتفضل تستخدم الـ GUI، تقدر تعمل ده من جوه Visual Studio 2022 (أو 2026):

اختار الـ Solution من الـ Solution Explorer.
روح لـ File > Save Solution As…
غير الـ dropdown بتاع “Save as type” لـ Xml Solution File (*.slnx).

Why You Should Care

الـ Fewer Merge Conflicts: دي الميزة رقم 1. عشان الملف عبارة عن XML بسيط ومن غير GUIDs عشوائية بتتغير كل شوية، الـ git merges بتبقى تافهة.
الـ Human Readable: تقدر تفتح الملف ده في Notepad وتفهمه وتعدل فيه من غير ما تبوظ الـ build بتاعك كله.
الـ Consistency: أخيراً بقى شكل الـ solution متماشي مع شكل الـ project (.csproj)، اللي اتحول لـ XML مبسط من سنين.
الـ Performance: حجم ملفات أصغر و parsing أسهل، وده معناه سرعة تحميل (load times) أحسن شوية في الـ solutions العملاقة.

Visual Comparison

graph TD
    subgraph "Old Format (.sln)"
    A[GUID-based Header] --> B[Complex Project Sections]
    B --> C[Manual GUID Mapping]
    C --> D[Massive Configuration Blocks]
    end

    subgraph "New Format (.slnx)"
    E[Simple XML Tag] --> F[Folder Elements]
    F --> G[Project Paths]
    G --> H[Human Readable Structure]
    end

Is it Ready?

في أواخر 2025 وبداية 2026، الـ .slnx لسه يعتبر Preview feature تقنياً.

هل آمن للاستخدام؟ أيوه، الـ format نفسه مستقر.
دعم الأدوات؟ الـ Visual Studio 2022 و Visual Studio 2026 و Rider بيدعموه كويس جداً، وكذلك الـ .NET CLI. ممكن بعض الـ pipelines القديمة (CI/CD) أو أدوات الـ 3rd party متتعرفش على الامتداد ده لسه.

نصيحتي: جربه الأول على side project أو branch لوحده. لو الـ CI pipeline بتاعتك تمام، يبقى أنت جاهز للتحديث. أنا شخصياً بستخدم الـ format ده في كل مشاريعي الجديدة وحولت كذا مشروع موجود فعلاً ومواجهتش أي مشاكل.

Notes

نقطة الـ GUIDs في الـ .sln القديم كانت ضرورية لـ Visual Studio عشان يربط المشاريع ببعضها، لكن في الـ .slnx الـ IDE بيقدر يتعامل مع الـ paths بشكل أذكى ويولد الـ IDs دي في الـ memory وقت الـ runtime بدل ما يخزنها في الملف.
شركة Microsoft بتخطط إن الـ .slnx يكون هو الـ default format لما تيجي تعمل dotnet new sln في المستقبل القريب، وده هيخلي الاعتماد عليه مش مجرد اختيار بل هو الـ standard الجديد. كمان الـ .NET 10 SDK بيقدم تحسينات في سرعة الـ discovery للمشاريع جوه الـ .slnx.

🍿 CornPop

Explorer