教學課程：使用 Visual Studio Code 發佈 .NET 主控台應用程式

  • 發行項

本教學課程會說明如何發佈主控台應用程式，以供其他使用者執行。 發佈會建立執行應用程式所需的檔案集。 如要部署這些檔案，請將其複製到目標機器上。

.NET CLI 可用來發佈應用程式，因此如果您想要，也可以使用 Visual Studio Code 以外的其他程式碼編輯器來按本教學課程操作。

必要條件

發行應用程式

  1. 啟動 Visual Studio Code。

  2. 開啟您在「使用 Visual Studio Code 建立 .NET 主控台應用程式」中所建立的 HelloWorld 專案資料夾。

  3. 從主功能表中選擇 [檢視]> [終端]。

    終端會在 HelloWorld 資料夾中開啟。

  4. 執行以下命令：

    dotnet publish --configuration Release

    預設的組建組態是 [偵錯]，故此命令會指定 [發行] 組建組態。 [發行] 組建組態的輸出會包含最少的符號偵錯資訊，且會完整進行最佳化。

    該命令輸出會類似如下範例：

    Microsoft (R) Build Engine version 17.8.0+b89cb5fde for .NET
Copyright (C) Microsoft Corporation. All rights reserved.
  Determining projects to restore...
  All projects are up-to-date for restore.
  HelloWorld -> C:\Projects\HelloWorld\bin\Release\net8.0\HelloWorld.dll
  HelloWorld -> C:\Projects\HelloWorld\bin\Release\net8.0\publish\

檢查檔案

發佈流程會預設建立架構相依部署。在這種部署類型中，發佈的應用程式會在安裝 .NET 執行階段的電腦上執行。 若要執行發佈的應用程式，您可以使用可執行檔，或透過命令提示字元執行 dotnet HelloWorld.dll 命令。

在下列步驟中，您會看到發佈流程中建立的多個檔案。

  1. 在左側導覽列中選取 [總管]。

  2. 展開 bin/Release/net7.0/publish。

    Explorer showing published files

    如圖所示，已發佈的輸出包含下列檔案：

    • HelloWorld.deps.json

      此為應用程式的執行階段相依性檔案， 會定義執行應用程式所需的 .NET 元件及程式庫 (涵蓋內含您應用程式的動態連結程式庫)。 如需詳細資訊，請參閱執行階段組態檔。

    • HelloWorld.dll

      此為應用程式的架構相依部署版本。 若要執行此動態連結程式庫，請在命令提示字元中輸入 dotnet HelloWorld.dll。 這項執行應用程式的方法適用於所有已安裝 .NET 執行階段的平台。

    • HelloWorld.exe (Linux 或 macOS 上的 HelloWorld。)

      此為應用程式的架構相依可執行檔版本。 此檔案為作業系統專用。

    • HelloWorld.pdb (對於部署為選用)

      此為偵錯符號檔案。 此檔案不需要隨您的應用程式部署，但當您需要對應用程式發行的版本進行偵錯，則應該儲存它。

    • HelloWorld.runtimeconfig.json

      此為應用程式的執行階段組態檔， 會識別要執行所建置之應用程式的 .NET 版本。 您也可以在其中新增組態選項。 如需詳細資訊，請參閱 .NET 執行階段組態設定 (部分機器翻譯)。

執行已發佈的應用程式

  1. 在 [總管] 中，以滑鼠右鍵按一下 [發佈] 資料夾 (在 macOS 中則按一下 Ctrl)，然後選取 [在整合式終端中開啟]。

    Context menu showing Open in Terminal

  2. 在 Windows 或 Linux 上，使用可執行檔執行應用程式。

    1. 在 Windows 上，輸入 .\HelloWorld.exe，然後按 Enter。

    2. 在 Linux 上，輸入 ./HelloWorld，然後按 Enter。

    3. 輸入名稱來回應提示，然後按任意鍵結束。

  3. 在任何平台上，使用 dotnet 命令執行應用程式：

    1. 輸入 dotnet HelloWorld.dll，然後按 Enter。

    2. 輸入名稱來回應提示，然後按任意鍵結束。

其他資源

下一步

在本教學課程中，您發佈了主控台應用程式。 在下一個教學課程中，您會建立類別庫。

使用 Visual Studio Code 建立 .NET 類別庫

本教學課程會說明如何發佈主控台應用程式，以供其他使用者執行。 發佈會建立執行應用程式所需的檔案集。 如要部署這些檔案，請將其複製到目標機器上。

.NET CLI 可用來發佈應用程式，因此如果您想要，也可以使用 Visual Studio Code 以外的其他程式碼編輯器來按本教學課程操作。

必要條件

發行應用程式

  1. 啟動 Visual Studio Code。

  2. 開啟您在「使用 Visual Studio Code 建立 .NET 主控台應用程式」中所建立的 HelloWorld 專案資料夾。

  3. 從主功能表中選擇 [檢視]> [終端]。

    終端會在 HelloWorld 資料夾中開啟。

  4. 執行以下命令：

    dotnet publish --configuration Release

    預設的組建組態是 [偵錯]，故此命令會指定 [發行] 組建組態。 [發行] 組建組態的輸出會包含最少的符號偵錯資訊，且會完整進行最佳化。

    該命令輸出會類似如下範例：

    Microsoft (R) Build Engine version 16.7.4+b89cb5fde for .NET
Copyright (C) Microsoft Corporation. All rights reserved.
  Determining projects to restore...
  All projects are up-to-date for restore.
  HelloWorld -> C:\Projects\HelloWorld\bin\Release\net7.0\HelloWorld.dll
  HelloWorld -> C:\Projects\HelloWorld\bin\Release\net7.0\publish\

檢查檔案

發佈流程會預設建立架構相依部署。在這種部署類型中，發佈的應用程式會在安裝 .NET 執行階段的電腦上執行。 若要執行發佈的應用程式，您可以使用可執行檔，或透過命令提示字元執行 dotnet HelloWorld.dll 命令。

在下列步驟中，您會看到發佈流程中建立的多個檔案。

  1. 在左側導覽列中選取 [總管]。

  2. 展開 bin/Release/net7.0/publish。

    Explorer showing published files

    如圖所示，已發佈的輸出包含下列檔案：

    • HelloWorld.deps.json

      此為應用程式的執行階段相依性檔案， 會定義執行應用程式所需的 .NET 元件及程式庫 (涵蓋內含您應用程式的動態連結程式庫)。 如需詳細資訊，請參閱執行階段組態檔。

    • HelloWorld.dll

      此為應用程式的架構相依部署版本。 若要執行此動態連結程式庫，請在命令提示字元中輸入 dotnet HelloWorld.dll。 這項執行應用程式的方法適用於所有已安裝 .NET 執行階段的平台。

    • HelloWorld.exe (在 Linux 上為 HelloWorld，不會在 macOS 上建立。)

      此為應用程式的架構相依可執行檔版本。 此檔案為作業系統專用。

    • HelloWorld.pdb (對於部署為選用)

      此為偵錯符號檔案。 此檔案不需要隨您的應用程式部署，但當您需要對應用程式發行的版本進行偵錯，則應該儲存它。

    • HelloWorld.runtimeconfig.json

      此為應用程式的執行階段組態檔， 會識別要執行所建置之應用程式的 .NET 版本。 您也可以在其中新增組態選項。 如需詳細資訊，請參閱 .NET 執行階段組態設定 (部分機器翻譯)。

執行已發佈的應用程式

  1. 在 [總管] 中，以滑鼠右鍵按一下 publish 資料夾 (在 macOS 中則 Ctrl + 按一下)，然後選取 [在終端中開啟]。

    Context menu showing Open in Terminal

  2. 在 Windows 或 Linux 上，使用可執行檔執行應用程式。

    1. 在 Windows 上，輸入 .\HelloWorld.exe，然後按 Enter。 在具有 Bash 終端的 Windows 上輸入 ./HelloWorld.exe。

    2. 在 Linux 上，輸入 ./HelloWorld，然後按 Enter。

    3. 輸入名稱來回應提示，然後按任意鍵結束。

  3. 在任何平台上，使用 dotnet 命令執行應用程式：

    1. 輸入 dotnet HelloWorld.dll，然後按 Enter。

    2. 輸入名稱來回應提示，然後按任意鍵結束。

其他資源

下一步

在本教學課程中，您發佈了主控台應用程式。 在下一個教學課程中，您會建立類別庫。

使用 Visual Studio Code 建立 .NET 類別庫

本教學課程會說明如何發佈主控台應用程式，以供其他使用者執行。 發佈會建立執行應用程式所需的檔案集。 如要部署這些檔案，請將其複製到目標機器上。

.NET CLI 可用來發佈應用程式，因此如果您想要，也可以使用 Visual Studio Code 以外的其他程式碼編輯器來按本教學課程操作。

必要條件

發行應用程式

  1. 啟動 Visual Studio Code。

  2. 開啟您在「使用 Visual Studio Code 建立 .NET 主控台應用程式」中所建立的 HelloWorld 專案資料夾。

  3. 從主功能表中選擇 [檢視]> [終端]。

    終端會在 HelloWorld 資料夾中開啟。

  4. 執行以下命令：

    dotnet publish --configuration Release

    預設的組建組態是 [偵錯]，故此命令會指定 [發行] 組建組態。 [發行] 組建組態的輸出會包含最少的符號偵錯資訊，且會完整進行最佳化。

    該命令輸出會類似如下範例：

    Microsoft (R) Build Engine version 16.7.0+b89cb5fde for .NET
Copyright (C) Microsoft Corporation. All rights reserved.
  Determining projects to restore...
  All projects are up-to-date for restore.
  HelloWorld -> C:\Projects\HelloWorld\bin\Release\net6.0\HelloWorld.dll
  HelloWorld -> C:\Projects\HelloWorld\bin\Release\net6.0\publish\

檢查檔案

發佈流程會預設建立架構相依部署。在這種部署類型中，發佈的應用程式會在安裝 .NET 執行階段的電腦上執行。 若要執行發佈的應用程式，您可以使用可執行檔，或透過命令提示字元執行 dotnet HelloWorld.dll 命令。

在下列步驟中，您會看到發佈流程中建立的多個檔案。

  1. 在左側導覽列中選取 [總管]。

  2. 展開 bin/Release/net6.0/publish。

    Explorer showing published files

    如圖所示，已發佈的輸出包含下列檔案：

    • HelloWorld.deps.json

      此為應用程式的執行階段相依性檔案， 會定義執行應用程式所需的 .NET 元件及程式庫 (涵蓋內含您應用程式的動態連結程式庫)。 如需詳細資訊，請參閱執行階段組態檔。

    • HelloWorld.dll

      此為應用程式的架構相依部署版本。 若要執行此動態連結程式庫，請在命令提示字元中輸入 dotnet HelloWorld.dll。 這項執行應用程式的方法適用於所有已安裝 .NET 執行階段的平台。

    • HelloWorld.exe (在 Linux 上為 HelloWorld，不會在 macOS 上建立。)

      此為應用程式的架構相依可執行檔版本。 此檔案為作業系統專用。

    • HelloWorld.pdb (對於部署為選用)

      此為偵錯符號檔案。 此檔案不需要隨您的應用程式部署，但當您需要對應用程式發行的版本進行偵錯，則應該儲存它。

    • HelloWorld.runtimeconfig.json

      此為應用程式的執行階段組態檔， 會識別要執行所建置之應用程式的 .NET 版本。 您也可以在其中新增組態選項。 如需詳細資訊，請參閱 .NET 執行階段組態設定 (部分機器翻譯)。

執行已發佈的應用程式

  1. 在 [總管] 中，以滑鼠右鍵按一下 publish 資料夾 (在 macOS 中則 Ctrl + 按一下)，然後選取 [在終端中開啟]。

    Context menu showing Open in Terminal

  2. 使用可執行檔執行應用程式。

    1. 在 Windows 上，輸入 .\HelloWorld.exe，然後按 Enter。

    2. 在 Linux 或 macOS 上，輸入 ./HelloWorld 並按 Enter。

    3. 輸入名稱來回應提示，然後按任意鍵結束。

  3. 在任何平台上，使用 dotnet 命令執行應用程式：

    1. 輸入 dotnet HelloWorld.dll，然後按 Enter。

    2. 輸入名稱來回應提示，然後按任意鍵結束。

其他資源

下一步

在本教學課程中，您發佈了主控台應用程式。 在下一個教學課程中，您會建立類別庫。

使用 Visual Studio Code 建立 .NET 類別庫