A .NET CLI áttekintése
Ez a cikk a ✔️ .NET Core 2.1 SDK és újabb verziókra vonatkozik
A .NET parancssori felület (CLI) egy platformfüggetlen eszközlánc .NET-alkalmazások fejlesztéséhez, létrehozásához, futtatásához és közzétételéhez.
A .NET CLI a .NET SDK részét képezi. A .NET SDK telepítéséről a .NET Core telepítése című témakörben olvashat.
Parancssori felületi parancsok
Alapértelmezés szerint a következő parancsok vannak telepítve:
Alapszintű parancsok
Project módosítási parancsok
Speciális parancsok
Eszközfelügyeleti parancsok
tool install
tool list
tool update
tool restore
A .NET Core SDK 3.0 óta érhető el.tool run
A .NET Core SDK 3.0 óta érhető el.tool uninstall
Az eszközök a NuGet-csomagokból telepített és a parancssorból meghívott konzolalkalmazások. Az eszközöket saját maga is megírhatja, vagy harmadik felek által írt eszközöket telepíthet. Az eszközöket globális eszközöknek, eszközútvonal-eszközöknek és helyi eszközöknek is nevezik. További információt a .NET-eszközök áttekintésében talál.
Parancsstruktúra
A parancssori felület parancsstruktúrája az illesztőprogramból ("dotnet"), a parancsból és esetleg a parancsargumentumokból és -beállításokból áll. Ezt a mintát a legtöbb parancssori felületi műveletben láthatja, például új konzolalkalmazás létrehozása és futtatása a parancssorból, ahogy az alábbi parancsok mutatják, amikor egy my_app nevű könyvtárból hajtják végre:
dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll
Illesztő
Az illesztőprogram neve dotnet , és két felelősségi körrel rendelkezik: egy keretrendszertől függő alkalmazás futtatásával vagy egy parancs végrehajtásával.
A keretrendszertől függő alkalmazás futtatásához adja meg az alkalmazást az illesztőprogram után, például dotnet /path/to/my_app.dll
. Amikor az alkalmazás DLL-jét tartalmazó mappából hajtja végre a parancsot, egyszerűen hajtsa végre dotnet my_app.dll
. Ha a .NET-futtatókörnyezet egy adott verzióját szeretné használni, használja a --fx-version <VERSION>
beállítást (lásd a dotnet parancsreferenciáját ).
Amikor parancsot ad meg az illesztőprogramnak, dotnet.exe
elindítja a parancssori felület parancsvégrehajtási folyamatát. Például:
dotnet build
Először az illesztőprogram határozza meg a használni kívánt SDK-verziót. Ha nincs global.json fájl, a rendszer az elérhető SDK legújabb verzióját használja. Ez lehet egy előzetes verzió vagy egy stabil verzió, attól függően, hogy mi a legújabb a gépen. Az SDK-verzió meghatározása után végrehajtja a parancsot.
Parancs
A parancs végrehajt egy műveletet. Például buildeli a dotnet build
kódot. dotnet publish
kódot tesz közzé. A parancsok konzolalkalmazásként, konvenció használatával vannak implementálva dotnet {command}
.
Argumentumok
A parancssorban átadott argumentumok a meghívott parancs argumentumai. Például a végrehajtáskor dotnet publish my_app.csproj
az my_app.csproj
argumentum jelzi a közzéteendő projektet, és átadja a publish
parancsnak.
Beállítások
A parancssorban megadott beállítások a meghívott parancs beállításai. Például a végrehajtáskor dotnet publish --output /build_output
a parancs átadja publish
a --output
lehetőséget és annak értékét.