اگر شما هم مثل بنده در حال نگهداری از یک سیستم قدیمی میباشید، به احتمال زیاد همیشه با یک سری مسائل مثل آپدیت پکیجها، اضافه کردن یا حذف کردن فایلی از پروژه، مدیریت وابستگیها، خروجی گرفتن از یک پروژه کنسول و ... درگیر هستید؛ مسائلی که سالهاست با روی کار آمدن «دات نت کور» و پس از آن «دات نت ۵» حل شدهاست. این حجم از مشکلات به حدی بود که گاهاً کدنویسی را با مشکل مواجه میکرد و امروز تصمیم گرفتم این مشکل را برای پروژه شرکت حل کنم. ابتدا باید بگویم، یک نسخهی پشتیبان از کد خود تهیه کنید؛ چرا که زیاد به آن رجوع خواهید داشت.
اگر پیغامی دریافت میکنید مبتنی بر این که این نرمافزار قبلاً نصب شده، با دستور زیر از بهروز بودن آن اطمینان حاصل کنید:
در دستور بالا، کلمهی MyProject را با نام پروژهی خود جایگزین کنید. پس از اجرای این دستور، مراحل ۱ تا ۳ را که پیشتر در مورد آن توضیح داده شد، اجرا کنید. توجه داشته باشید که اگر solution شما از بیش از یک پروژه تشکیل شده، برای هر پروژه بهطور جداگانهای باید این عمل تکرار شود. حال اگر فایل csproj پروژه را ببینید، متوجه آن میشوید که پروژه به ساختار جدید درآمده است.
انجام این آپدیت از طریق دو نرمافزار upgrade-assistant و try-convert قابل انجام است. بنده به شخصه از upgrade-assistant استفاده کردم چرا که به نظر به بلوغ بیشتری رسیدهاست. ابتدا با دستور زیر این نرمافزار را نصب کنید:
dotnet tool install -g upgrade-assistant
dotnet tool update -g upgrade-assistant
توجه داشته باشید، نرمافزار upgrade-assistant برای ارتقاء پروژهها به دات نت 5 و 6 طراحی شدهاند. بنابراین ما فقط با سه مرحلهی اول سر و کار داریم:
- Back up project
- Convert project file to SDK style
- Clean up NuGet package references
حال یک terminal را باز کنید و به محل پروژه بروید و دستور زیر را اجرا کنید:
upgrade-assistant upgrade MyProject.csproj
- اگر پروژه از جنس Library باشد، فایل csproj را به شکل زیر درآورید:
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net472</TargetFramework> <OutputType>Library</OutputType> </PropertyGroup> . . . </Project>
- اگر پروژه از جنس Console باشد، فایل csproj را به شکل زیر درآورید:
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>net472</TargetFramework> <OutputType>Exe</OutputType> <ApplicationIcon>logo.ico</ApplicationIcon> <AppConfig>App.config</AppConfig> </PropertyGroup> . . . </Project>
- اگر پروژه از جنس Web باشد، فایل csproj را به شکل زیر درآورید. احتمالاً پیچیدهترین و سختترین فایلها، متعلق به پروژههای وب باشد. اگر دقت کنید نوع SDK از نوع MSBuild.SDK.SystemWeb میباشد. نسخه این SDK ممکن است در زمانیکه شما در حال خواندن این مطلب میباشد آپدیت شده باشد و بهتر است قبل از استفاده، آخرین نسخه را از نیوگت برداشت کنید. (باید ذکر کنم که این hack کوچک را از یک comment در issueهای گیتهاب پیدا کردم.)
<Project Sdk="MSBuild.SDK.SystemWeb/4.0.54"> <PropertyGroup> <OutputType>Library</OutputType> <TargetFramework>net472</TargetFramework> <AppConfig>Web.config</AppConfig> </PropertyGroup> . . . </Project>