Oktatóanyag: .NET konzolalkalmazás közzététele

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.

Előfeltételek

• Ez az oktatóanyag azzal a konzolalkalmazással működik, amelyet a .NET konzolalkalmazás létrehozása során készítesz el.

Az alkalmazás közzététele

1. Indítsa el Visual Studio.

2. Nyissa meg a HelloWorld Hozzon létre egy .NET konzolalkalmazást.

3. Győződjön meg arról, hogy Visual Studio a kiadás buildkonfigurációját használja. Szükség esetén módosítsa az eszköztáron lévő build-konfigurációs beállítást Hibakeresési-ről Kiadási.

   Visual Studio eszköztár kiadási build kiválasztva.

4. Kattintson a jobb gombbal a HelloWorld projektre (nem a HelloWorld-megoldásra), és válassza Közzététel lehetőséget a menüből.

   

5. A Közzététel lap Cél lapján válassza a Mappalehetőséget, majd válassza Továbblehetőséget.

   Válasszon egy közzétételi célt a Visual Studio-ban.

6. A Meghatározott cél lapján a Közzététel oldalon válassza a Mappalehetőséget, majd válassza a Továbblehetőséget.

   

7. A Hely fülön, a Közzététel oldalon válassza a Befejezésgombot.

   

8. A Közzétételi profillétrehozás folyamatának oldalán válassza a Bezáráslehetőséget.

9. A Közzététel ablak Közzététel fülén válassza a Közzététellehetőséget.

   

1. Indítsa el a Visual Studio Code.

2. Nyissa meg a HelloWorld Hozzon létre egy .NET konzolalkalmazást.

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 Hozzon létre egy .NET konzolalkalmazást.

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

A közzétételi folyamat alapértelmezés szerint egy keretrendszertől függő üzembe helyezést hoz létre, 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 felhasználók futtathatják a közzétett alkalmazást úgy, hogy duplán kattintanak a végrehajtható fájlra, vagy kiadják 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 Solution Explorer területen válassza a Show All Files lehetőséget.

   

2. A projektmappában bontsa ki a bin/Release/{net}/publish fájlt. (Ahol a(z) {net} a cél keretrendszermappa, például net10.0.)

   

   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 csatolási könyvtár végrehajtásához írja be a parancssorba a dotnet HelloWorld.dll-t. 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

     Ez az alkalmazás keretrendszerfüggő végrehajtható verziója. A futtatásához írja be HelloWorld.exe a parancssorba. 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 futtatásra készült. 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.

A közzétételi folyamat alapértelmezés szerint egy keretrendszertől függő üzembe helyezést hoz létre, 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 futtatásra készült. 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 futtatásra készült. 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. A Solution Explorer-ben kattintson a jobb gombbal a publish mappára, és válassza a Teljes elérési út másolása lehetőséget.

2. Nyisson meg egy parancssort, és lépjen a közzétételi mappába. Ehhez írja be a cd-t, majd illessze be a teljes elérési utat. Például:

   cd C:\Projects\HelloWorld\bin\Release\net10.0\publish\
   

3. Futtassa az alkalmazást a végrehajtható paranccsal:

   1. Írja be HelloWorld.exe és nyomja le az Enter billentyűt.

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

4. Futtassa az alkalmazást a dotnet paranccsal:

   1. Írja be dotnet HelloWorld.dll és nyomja le az Enter billentyűt.

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

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-ban írja be a .\HelloWorld.exe, majd nyomja meg az Enter billentyű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 és nyomja le az Enter billentyű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

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

Erőforrások törlése

GitHub 30 nap inaktivitás után automatikusan törli a Codespace-t. Ha további oktatóanyagokat tervez ebben a sorozatban, a Codespace üzembe helyezését elhagyhatja. Ha készen áll a .NET webhelyre a .NET SDK letöltéséhez, törölheti a Codespace-t. 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álytár létrehozása