C# 开发环境搭建（Avalonia UI、Blazor Web UI、Web API 应用示例）

C# 文档

• https://learn.microsoft.com/zh-cn/dotnet/csharp/tour-of-csharp/

NuGet

• https://www.nuget.org/

.NET SDK 下载

• https://dotnet.microsoft.com/zh-cn/download

安装 .NET SDK

安装完验证

dotnet -h
# .NET SDK 版本
dotnet --version
# .NET SDK 的列表
dotnet --list-sdks
# .NET 运行时的列表
dotnet --list-runtimes
# .NET 安装和计算机环境详细信息
dotnet --info

• 安装时正常会自动添加 PATH

# /usr/local/share/dotnet:~/.dotnet/tools
echo $PATH

VS Code 配置

C# 开发插件

C#
C# Dev Kit
Avalonia for VSCode

settings.json

• 配置 Code Runner

{"code-runner.executorMap": {"csharp": "cd $dir && dotnet run $fileName"}
}

• 创建一个 控制台应用

# 安装模板包
dotnet new install Microsoft.NET.Runtime.WebAssembly.Templates
# 根据 console 模板创建项目
dotnet new console -o ./demo -n demo
# 根据 console 模板创建项目，未指定名称则使用输出目录的名
dotnet new console -o ./demo

• 运行 demo 项目

• 或者终端执行命令

dotnet run

WPF UI 框架

WPF（Windows Presentation Foundation）是微软推出的基于Windows 的用户界面框架。

• 文档： https://learn.microsoft.com/zh-cn/previous-versions/dotnet/netframework-4.0/ms742119(v=vs.100)

注： 本人是 Mac 电脑无法演示。

Avalonia UI 框架

Avalonia是一个强大的框架，使开发人员能够使用.NET创建跨平台应用程序。它使用自己的渲染引擎绘制UI控件，确保在Windows、macOS、Linux、Android、iOS和WebAssembly等不同平台上具有一致的外观和行为。这意味着开发人员可以共享他们的UI代码，并在不同的目标平台上保持统一的外观和感觉。

• Github： https://github.com/AvaloniaUI/Avalonia

• 官网： https://avaloniaui.net/

• 文档： https://docs.avaloniaui.net/zh-Hans/docs/welcome

创建 Avalonia 项目

# 安装 Avalonia 模板
dotnet new install Avalonia.Templates
# 列出已安装的模板
dotnet new list

# 创建 Avalonia 项目
dotnet new avalonia.app -o demo
cd demo
# 运行项目
dotnet run

Avalonia 官方示例

• https://github.com/AvaloniaUI/Avalonia.Samples

git clone https://github.com/AvaloniaUI/Avalonia.Samples.git
cd Avalonia.Samples
cd ./src/Avalonia.Samples/CompleteApps/SimpleToDoList

• SimpleToDoList.csproj 修改为当前环境 .NET SDK 版本

<TargetFramework>net8.0</TargetFramework>

• 运行项目

dotnet run

Avalonia 桌面 UI 库

• Github： https://github.com/kikipoulet/SukiUI

git clone https://github.com/kikipoulet/SukiUI.git
cd SukiUI/SukiUI.Demo
dotnet run

Blazor Web UI 框架

注： Blazor允许Web开发人员使用C#代替JavaScript创建Web应用程序。他们还可以重用.NET Silverlight代码。另外，Blazor应用程序由使用C＃，HTML和CSS实现的可重复使用的Web UI组件组成。由于客户端和服务器代码都是用C#编写的，因此开发人员可以共享代码和库。

• ASP.Net Core 文档： https://dotnet.microsoft.com/zh-cn/learn/aspnet/blazor-tutorial/intro

• Blazor 文档： https://learn.microsoft.com/zh-cn/aspnet/core/blazor/?view=aspnetcore-8.0&WT.mc_id=dotnet-35129-website

创建应用

dotnet new blazor -o BlazorApp

项目结构

• Program.cs 是启动服务器以及在其中配置应用服务和中间件的应用的入口点。
• 在 Components 目录中:
  • App.razor 为应用的根组件。
  • Routes.razor 配置 Blazor 路由器。
  • Pages 目录包含应用的一些示例网页。
• BlazorApp.csproj 定义应用项目及其依赖项。
• Properties 目录中的 launchSettings.json 文件为本地开发环境定义不同的配置文件设置。创建项目时会自动分配端口号并将其保存在此文件上。

• 运行应用

dotnet run

• http://localhost:5291/

ASP.NET Core 控制器创建 Web API

• 创建 Web API 文档： https://learn.microsoft.com/zh-cn/training/modules/build-web-api-aspnet-core/?WT.mc_id=dotnet-35129-website

dotnet --list-sdks
dotnet new webapi -controllers -f net8.0 -o demo

• 项目结构

名称	描述
Controllers/	包含公共方法公开为 HTTP 终结点的类。
Program.cs	配置服务和应用的 HTTP 请求管道，包含应用的托管入口点。
ContosoPizza.csproj	包含项目的配置元数据。
ContosoPizza.http	包含直接从 Visual Studio Code 测试 REST API 的配置。

• 运行应用

dotnet run

• http://localhost:5223/weatherforecast

dotnet 命令

• https://learn.microsoft.com/zh-cn/dotnet/core/tools/dotnet

dotnet new

dotnet new -h

• 列出要使用 dotnet new 运行的可用模板

dotnet new list

• 在 NuGet.org 上搜索 dotnet new 支持的模板

dotnet new search console

• 安装模板包

dotnet new install Microsoft.NET.Runtime.WebAssembly.Templates

• 卸载模板包

# 列出已安装的模板及其详细信息
dotnet new --uninstall
# 卸载 WebAssembly 模板包
dotnet new uninstall Microsoft.NET.Runtime.WebAssembly.Templates

• 更新已安装的模板包

dotnet new update -h
# 检查已安装模板包更新
dotnet new update --check-only
# 更新已安装模板包
dotnet new update

dotnet build

• 生成项目及其所有依赖项

dotnet build -h

dotnet run

• 无需任何显式编译或启动命令即可运行源代码

dotnet run -h
dotnet run --no-build

dotnet tool

dotnet tool -h
# 列出全局或本地安装的工具
dotnet tool list