رابط خط فرمان command-line (NET Core (CLI. یک ابزار جدید سازگار با پلت فرم های مختلف برای ایجاد، بازیابی پکیج ها، ساخت، اجرا و انتشار اپلیکیشن های .NET است.
خب تا اینجای کار اولین برنامه ASP.NET Core خود را با استفاده از ویژوال استودیو در بخش های قبلی ساختیم. ویژوال استودیو به صورت داخلی خودش از این CLI برای بازیابی، ساخت و انتشار اپلیکیشن استفاده می کند. IDE ها و محیط توسعه ها، ویرایشگرها و ابزارهای سطح بالای دیگر می توانند برای پشتیبانی اپلیکیشن های .NET Core از CLI استفاده کنند.
NET Core CLI. به همراه NET Core SDK. برای پلت فرم های انتخاب شده نصب می شود. بنابراین لازم نیست که آن را به صورت جداگانه روی سیستم نصب کنیم. برای اینکه مطمئن شویم که CLI به درستی نصب شده، با باز کردن command prompt (همون cmd صفحه مشکی خودمون) در ویندوز و نوشتن dotnet و زدن Enter می توانیم نتیجه را ببینیم.
اگر اطلاعات usage و help را به صورت زیر نمایش دهد، یعنی به درستی نصب شده است.
رابط خط فرمان command-line
ساختار دستور:
ساختار دستور به شکل زیر است:
<dotnet <command> <argument><option
همه دستورات با درایور به نام dotnet شروع می شود. این درایور اجرای دستور مشخص شده را شروع می کند. بعد از dotnet، می توانیم دستور (معمولا به صورت فعل های انگلیسی هستند) را به آن بدهیم تا یک کار خاص را انجام دهد. هر دستوری می تواند با آرگومان ها و گزینه هایی بیایند. جدول زیر دستورات .NET Core 2.x CLI هستند.
دستورات اصلی | توضیح |
New | یک پروژه، فایل پیکربندی یا solution جدید براساس یک الگوی خاص می سازد |
Restore | وابستگی ها و ابزارهای یک پروژه را بازیابی می کند. |
Build | یک پروژه و تمام وابستگی های آن را build می کند. |
Run | سورس کد را بدون هیچ کامپایل مستقیم و دستورات راه اندازی اجرا می کند. |
Publish | اپلیکیشن و وابستگی های آن را برای استقرار روی یک سیستم میزبانی بسته بندی می کند. |
test | واحدهای تست (unit tests) را اجرا می کند. |
vtest | تست ها را از فایل های مشخص اجرا می کند. |
Pack | کدها را در یک پکیج NuGet بسته بندی می کند. |
clean | خروجی یک پروژه را پاک می کند. |
sln | فایل .NET Core solution را تغییر می دهد. |
help | راهنمایی دباره یک دستور خاص را نشان می دهد. |
store | فایل های اسمبلی خاصی را در مخزن پکیج زمان اجرا ذخیره می کند |
دستورات تغییر پروژه | توضیح |
add package | رفرنس یک پکیج را به پروژه اضافه می کند. |
add reference | رفرنس های پروژه – به – پروژه (P2P) را اضافه می کند. |
remove package | رفرنس پکیج را از پروژه پاک می کند. |
remove reference | رفرنس پروژه را پاک می کند. |
List reference | تمام رفرنس های پروژه – به – پروژه را لیست می کند. |
دستورات پیشرفته | توضیح |
nuget delete | یک پکیج را از سرور حذف کرده یا از لیست خارج می کند. |
nuget locals | منابع NuGet محلی را پاک کرده یا لیست می کند. |
nuget push | یک پکیج را به سرور پوش می کند و آن را منتشر می کند. |
msbuild | یک پروژه و وابستگی های آن را build می کند. |
dotnet install script | اسکریپت استفاده شده برای نصب ابزارهای .NET Core CLI و زمان اجرای به اشتراک گذاشته شده |
حالا که با دستورات خط فرمان command-line آشنا شدید. وقت آن رسیده که با استفاده از رابط خط فرمان command-line و بدون استفاده از ویژوال استودیو اپلیکیشن کنسول .NET Core ایجاد، بازیابی، build و اجرا کنیم.
ایجاد یک پروژه جدید:
برای ایجاد یک پروژه .NET Core، باید از دستور new و به دنبال آن آرگومان نام الگو (template) استفاده کنیم. ما می توانیم با استفاده از CLI پروژه های console، class library، web، mvc، webapi، razor، angular، react و غیره بسازیم.
دستور زیر یک پروژه کنسول جدید در دایرکتوری جاری به نام همان دایرکتوری جاری ایجاد می کند.
Dotnet new console
دستور زیر یک پروژه کنسول جدید با نام MyConsoleApp ایجاد می کند. گزینه –n یا –name نام پروژه را مشخص می کند.
dotnet new console –n MyConsoleApp
دستور زیر یک اپلیکیشن کنسول به نام MyConsoleApp در دایرکتوری MyProjects می سازد. گزینه –o یا –output برای مشخص کردن دایرکتوری خروجی یعنی جایی که باید پروژه تولید شود استفاده می شود.
dotnet new console –n MyConsoleApp –o c:\MyProjects
اضافه کردن رفرنس پکیج:
ما اغلب نیاز داریم تا رفرنس پکیج NuGet را به دلایل مختلف اضافه کنیم. به عنوان مثال، دستور زیر را برای اضافه کردن پکیج Newtonsot.json به پروژه کنسول خود اعمال می کنیم.
C:\MyConsoleApp>dotnet add package Newtonsoft.json
این دستور پکیج Newtonsoft.json را به پروژه ما اضافه خواهد کرد. با بازکردن فایل .csproj می توانیم آن را ببینیم.
بازیابی پکیج ها:
برای بازیابی پکیج ها یا به روزرسانی پکیج های موجود، می توانیم از دستور بازیابی زیر استفاده کنیم:
C:\MyConsoleApp;dotnet restore
Build پروژه:
برای build کردن یک پروژه جدید یا موجود، دستور c:\MyConsoleApp>dotnet build را اعمال کنید.
اجرای پروژه:
برای اجرای پروژه کنسول، دستور dotnet run را به صورت زیر اجرا می کنیم.
همانطور که مشاهده می کنید، یک خروجی “Hello World” را نمایش می دهد.
[offershortcode url=”https://www.mspsoft.com/web-design/asp-netcore/” ]آموزش ASP.NET Core[/offershortcode]
گرفتن راهنمایی:
با تایپ –h یا –help در آخر هر دستوری که می خواهیم درباره آن کمک بگیریم، می توانیم درباره هریک از دستورات NET Core CLI. راهنمایی بگیریم. به عنوان مثال، dotnet new –h راهنمایی هایی درباره دستور new، آرگومان ها و گزینه هایی که می توانیم با آن استفاده کنیم، به صورت زیر نمایش می دهد.
به این ترتیب، می توانیم از رابط خط فرمان (command-line ( .NET Core برای ایجاد، بازیابی پکیج ها، build، اجرا و انتشار انواع مختلف اپلیکیشن های NET Core. استفاده کنیم.
منتظر انتشار هرچه بیشتر مطالب عالی شما هستم.
۸