Oktatóanyag: .NET-konzolalkalmazás közzététele a Visual Studio Code használatával

Ez az oktatóanyag bemutatja, hogyan tehet közzé egy konzolalkalmazást, hogy más felhasználók is futtathassák. A közzététel létrehozza az alkalmazások futtatásához szükséges fájlok készletét. A fájlok üzembe helyezéséhez másolja őket a célgépre.

A .NET CLI az alkalmazás közzétételére szolgál.

Előfeltételek

• Ez az oktatóanyag a .NET-konzolalkalmazás létrehozása a Visual Studio Codehasználatával létrehozott konzolalkalmazással működik.

Az alkalmazás közzététele

1. Indítsd el a Visual Studio Code-ot.

2. Nyissa meg a HelloWorld projektmappát, amelyet .NET-konzolalkalmazás létrehozása Visual Studio Code-használatával hozott létre.

3. Válassza >Terminál megtekintése lehetőséget a főmenüben.

   A terminál megnyílik a HelloWorld mappában.

4. Futtassa a következő parancsot:

   dotnet publish
   

   Az alapértelmezett build-konfiguráció a kiadási, amely az éles környezetben futó üzembe helyezett helyekhez megfelelő. A Release build konfiguráció kimenete minimális szimbolikus hibakeresési információkkal rendelkezik, és teljesen optimalizált.

   A parancs kimenete a következő példához hasonló:

   Restore complete (1.1s)
     HelloWorld net10.0 succeeded (7.8s) → bin\Release\net10.0\publish\
   
   Build succeeded in 10.3s
   

1. Nyissa meg a Visual Studio Code használatával létrehozott GitHub Codespace-et egy .NET-konzolalkalmazás létrehozása során.

2. Adja hozzá a következő kódsort a HelloWorld.cs tetejére:

   #:property PublishAot=false
   

   Ez az irányelv letiltja a natív ahead-of-time (AOT) fordítást, és az alkalmazás futásidőben a standard just-in-time (JIT) fordítót fogja használni. A közzétett kimenet keretrendszerfüggő lesz.

3. A terminálban győződjön meg arról, hogy az Oktatóanyagok mappában van.

4. Futtassa a következő parancsot:

   dotnet publish HelloWorld.cs
   

   A parancs létrehoz egy független végrehajtható fájlt.

   A parancs kimenete a következő példához hasonló:

   Restore complete (0.5s)
     HelloWorld net10.0 succeeded (4.0s) → artifacts\HelloWorld\
   
   Build succeeded in 5.1s
   

A fájlok vizsgálata

Alapértelmezés szerint a közzétételi folyamat létrehoz egy keretrendszertől függő üzembe helyezést, amely egy olyan üzembe helyezési típus, amelyben a közzétett alkalmazás egy olyan gépen fut, amelyen telepítve van a .NET-futtatókörnyezet. A közzétett alkalmazás futtatásához használhatja a végrehajtható fájlt, vagy futtathatja a dotnet HelloWorld.dll parancsot egy parancssorból.

A következő lépésekben a közzétételi folyamat által létrehozott fájlokat tekintheti meg.

1. A bal oldali navigációs sávon válassza a Explorer.

2. Nyissa meg a bin/Release/net10.0/publish könyvtárat.

   

   Ahogy a képen látható, a közzétett kimenet a következő fájlokat tartalmazza:

   • HelloWorld.deps.json

     Ez az alkalmazás futtatókörnyezeti függőségek fájlja. Meghatározza az alkalmazás futtatásához szükséges .NET-összetevőket és kódtárakat (beleértve az alkalmazást tartalmazó dinamikus hivatkozástárat is). További információ: Futtatókörnyezet konfigurációs fájljai.

   • HelloWorld.dll

     Ez az alkalmazás keretrendszerfüggő üzembe helyezési verziója. A dinamikus hivatkozástár futtatásához írja be dotnet HelloWorld.dll egy parancssorba. Az alkalmazás futtatásának ez a módszere minden olyan platformon működik, amelyen telepítve van a .NET-futtatókörnyezet.

   • HelloWorld.exe (HelloWorld Linux vagy macOS rendszeren.)

     Ez az alkalmazás keretrendszerfüggő végrehajtható verziója. A fájl operációs rendszerspecifikus.

   • HelloWorld.pdb (üzembe helyezéshez nem kötelező)

     Ez a hibakeresési szimbólumfájl. Ezt a fájlt nem kell az alkalmazással együtt üzembe helyeznie, bár mentenie kell abban az esetben, ha hibakeresést kell végeznie az alkalmazás közzétett verziójában.

   • HelloWorld.runtimeconfig.json

     Ez az alkalmazás futtatókörnyezetének konfigurációs fájlja. Azonosítja a .NET azon verzióját, amelyen az alkalmazás fut. Emellett konfigurációs beállításokat is hozzáadhat hozzá. További információ: .NET futtatókörnyezet konfigurációs beállításai.

Egy fájlból álló alkalmazás esetén a közzétételi folyamat létrehoz egy összetevőkönyvtárat egy lefordított szerelvényfájllal. A közzétett alkalmazás a dotnet paranccsal futtatható.

A következő lépésekben a közzétételi folyamat által létrehozott fájlokat tekintheti meg.

1. A bal oldali navigációs sávon válassza a Explorer.

2. Artefaktumok kibontása/HelloWorld.

   

   Ahogy a képen látható, a közzétett kimenet a következő fájlokat tartalmazza:

   • HelloWorld

     Ez az alkalmazás keretrendszerfüggő végrehajtható verziója. A fájl operációs rendszerspecifikus. A Codespaces Linuxon fut, így ez egy Linux-futtatható fájl.

   • HelloWorld.deps.json

     Ez az alkalmazás futtatókörnyezeti függőségek fájlja. Meghatározza az alkalmazás futtatásához szükséges .NET-összetevőket és kódtárakat (beleértve az alkalmazást tartalmazó dinamikus hivatkozástárat is). További információ: Futtatókörnyezet konfigurációs fájljai.

   • HelloWorld.dll

     Ez az alkalmazás keretrendszerfüggő üzembe helyezési verziója. A dinamikus hivatkozástár futtatásához írja be dotnet HelloWorld.dll egy parancssorba. Az alkalmazás futtatásának ez a módszere minden olyan platformon működik, amelyen telepítve van a .NET-futtatókörnyezet.

   • HelloWorld.pdb (üzembe helyezéshez nem kötelező)

     Ez a hibakeresési szimbólumfájl. Ezt a fájlt nem kell az alkalmazással együtt üzembe helyeznie, bár mentenie kell abban az esetben, ha hibakeresést kell végeznie az alkalmazás közzétett verziójában.

   • HelloWorld.runtimeconfig.json

     Ez az alkalmazás futtatókörnyezetének konfigurációs fájlja. Azonosítja a .NET azon verzióját, amelyen az alkalmazás fut. Emellett konfigurációs beállításokat is hozzáadhat hozzá. További információ: .NET futtatókörnyezet konfigurációs beállításai.

   Kattintson a jobb gombbal, és válassza a Letöltés... lehetőséget, ha fájlokat szeretne letölteni a Codespacesből a helyi számítógépre.

A közzétett alkalmazás futtatása

1. Az Exploreralkalmazásban kattintson jobb gombbal a publikálási mappára, (vagyCtrl-kattintson macOS-on), majd válassza a Megnyitás az integrált terminálbanlehetőséget.

   

2. Windows vagy Linux rendszeren futtassa az alkalmazást a végrehajtható fájl használatával.

   1. Windows rendszeren adja meg a .\HelloWorld.exe, majd nyomja le Enterbillentyűt.

   2. Linuxon adja meg a ./HelloWorld, majd nyomja le Enterbillentyűt.

   3. Adjon meg egy nevet a kérdésre válaszul, majd a kilépéshez nyomja le Enter billentyűt.

3. Bármely platformon futtassa az alkalmazást a dotnet paranccsal:

   1. Írja be dotnet HelloWorld.dll, majd nyomja le Enterbillentyűt.

   2. Adjon meg egy nevet a kérdésre válaszul, majd a kilépéshez nyomja le Enter billentyűt.

1. Az Explorerben kattintson a jobb gombbal az összetevők/HelloWorld mappára, és válassza a Megnyitás az integrált terminálban lehetőséget.

2. Futtassa az alkalmazást a végrehajtható paranccsal. Írja be ./HelloWorld , majd nyomja le az Enter billentyűt.

3. Adjon meg egy nevet a kérdésre válaszul, majd a kilépéshez nyomja le Enter billentyűt.

További erőforrások

• A .NET-alkalmazások közzétételi áttekintése
• dotnet publish
• A .NET SDK használata folyamatos integrációs (CI) környezetekben

Erőforrások törlése

A GitHub 30 napos inaktivitás után automatikusan törli a Kódteret. Ha további oktatóanyagokat tervez ebben a sorozatban, a Codespace üzembe helyezését elhagyhatja. Ha készen áll a .NET webhely felkeresésére a .NET SDK letöltéséhez, törölheti a Codespace-et. A Codespace törléséhez nyisson meg egy böngészőablakot, és menjen a a Codespaces felületére. Az ablakban megjelenik a kódterek listája. Válassza ki a három elemet (...) a learn oktatóanyag kódterének bejegyzésében. Ezután válassza a "törlés" lehetőséget.

Következő lépések

Ebben az oktatóanyagban közzétett egy konzolalkalmazást. A következő oktatóanyagban létrehoz egy osztálytárat.

.NET osztálykönyvtár létrehozása a Visual Studio Code segítségével