创建Avalonia 模板项目-基础

Avalonia是一个跨平台的.NET框架,用于构建漂亮、现代的图形用户界面(GUI)。使用Avalonia,您可以从单个代码库创建适用于Windows、macOS、 Linux、iOS、Android和Web Assembly的原生应用程序。

官方文档地址:官方文档

1.环境配置要求

💻 支持的 .NET 版本

Avalonia兼容所有支持.NET Standard 2.0的平台。您可以点击这里找到有关.NET标准版本的详细信息。

📱 支持的平台

Avalonia官方支持下列平台:

  • Windows 8 及更高版本(虽然它也能在Windows 7上正常工作)
  • macOS High Sierra 10.13 及更高版本

在Linux上,下列发行版支持Avalonia:

  • Debian 9 (Stretch) 及更高版本
  • Ubuntu 16.04 及更高版本
  • Fedora 30 及更高版本

🛠 支持的开发环境

下列环境中使用IntelliSense,极好地支持Avalonia XAML开发:

  • Visual Studio 2017及更高版本,包含Avalonia Visual Designer
  • JetBrains Rider 2020.3及更高版本

2.创建Avalonia 模板项目

1.安装Avalonia模板

运行下列命令安装模板Avalonia模板:

dotnet new install Avalonia.Templates

image-20230626104656604

注意:.NET 6.0及更早版本,请改用--install选项。

打开VS创建项目

搜索:avalonia,现在可以看到有各种类型模板可以选择了

image-20230626105647944

2.创建新的应用程序

1.命令创建(也可以在vs中可视化创建)

安装模板后,可以通过运行以下命令创建新的Avalonia应用程序:

dotnet new avalonia.app -o MyAvalonia

image-20230626104758346

这将在您的应用程序目录下创建一个名为MyAvalonia的新文件夹。

image-20230626104848412

要运行应用程序,请导航到MyApp目录并运行:

cd MyAvalonia

dotnet run

2.运行结果:

image-20230626105145434

Avalonia应用程序现在已经启动并运行。您可以打开MyApp文件夹,开始改进和构建应用程序。

3.开发工具配置

1.错误异常诊断

avalonia提供verbose级别日志:

  • Viual Studio 的菜单中选择 “工具” → “选项”
  • 在列表中选择 Avalonia XAML Editor
  • Minimum Log Verbosity 下选择 Verbose

选择“显示输出来源:Avalonia Diagnostics”,日志将显示在 Visual Studio 输出窗口中。

image-20230626134032192

2.故障排除和常见问题解答

Visual Studio 不展示 Avalonia 预览器

有时 Visual Studio 会使用 WPF 编辑器而不是 Avalonia 打开 XAML 文件。一般关闭显示错误的文件并重新打开它,问题就能解决。

如果这样做没有效果,可以右键单击该文件并选择[打开方式…]。在打开的对话框中,选择[Avalonia XAML Editor]

我没有预览界面

如果未正确显示预览界面,请尝试(重新)构建项目或解决方案。预览器需要有效的构建才能正常工作。

此外,如果解决方案中有多个项目,则可能需要选择渲染预览的项目。