Avalonia开发笔记（2024/5/20更新）
官网：
源码：
https://github.com/AvaloniaUI/Avalonia
目前最新版本：11.0.10
常用控件
CgdataBase.Avalonia
自己写的基础库控件，里面是自己平常经常用的基础函数。
Install-Package CgdataBase.Avalonia
OxyPlot.Avalonia
开源的曲线图控件
OxyPlot.Avalonia需要下面的版本：
Install-Package OxyPlot.Avalonia -Version 2.1.0-Avalonia11
LiveCharts2
开源的曲线图控件
Install-Package LiveChartsCore.SkiaSharpView.Avalonia
Avalonia.AvaloniaEdit
开源的文本和代码编辑器控件
Install-Package Avalonia.AvaloniaEdit
Dock.Avalonia
开源的dock控件
Install-Package Dock.Avalonia
Install-Package Dock.Model.Mvvm
ThemeEditor.Controls.ColorPicker
开源的颜色选择器控件
Install-Package ThemeEditor.Controls.ColorPicker
Material.Avalonia
Install-Package Material.Avalonia
https://github.com/AvaloniaCommunity/Material.Avalonia
Avalonia.Controls.DataGrid
Install-Package Avalonia.Controls.DataGrid
DialogHost.Avalonia
Install-Package DialogHost.Avalonia
ShowMeTheXaml.Avalonia
Install-Package ShowMeTheXaml.Avalonia
目前我们已经拿Avalonia做了好几个跨平台的项目。跟WPF非常相似，还是挺不错的。
并且这个平台一直在更新，从开始接触到现在，也是已经升级了好多个版本。
很多第三方的控件和开发库都基于Avalonia进行了移植。常规的开发基本上没啥问题。
类似曲线图等控件，可选用OxyPlot或LiveCharts2。
从0.10升级到11.0.x版本
版本升级的官方帮助文档，说明版本说明时需要修改的一些东西。
https://docs.avaloniaui.net/zh-Hans/docs/next/stay-up-to-date/upgrade-from-0.10
编辑器推荐
Visual Studio 2022 + Avalonia for Visual Studio 2022
需要安装一个插件，但是XAML界面下，代码提示功能比较弱，基本上算没有，写起来不是很方便。
JetBrains Rider
目前最新版本是2021版本，本身是商用，可以试用30天。JetBrains Rider的代码提示功能做得挺不错的，不过代码调试有时候没VS方便，可以两个IDE结合起来使用。
如果是在Linux系统下开发，因为没有VS编译器可用，感觉JetBrains Rider会是最好的选择，相比较VS Code，集成度会更高，代码提示等方面都会做得更好一点。
VS Code
VS Code开源免费，各个操作系统都支持，在Linux等操作系统下也是一个不错的选择。可以用VS Code编辑代码，然后用dotnet来编译执行。
不过我用的比较少，现在大部分时候还是在Windows上开发完，然后拿到Linux上执行和调试。
系统测试情况
目前试了一下，能够正常运行的系统，除了Windows系统外，流行的Ubuntu，Centos，Redhat这些系统应该都没啥问题。
目前因为国产化要求，经常需要运行在银河麒麟系统下，目前测试了没有啥问题。
在Linux系统可能会出现因为找不到字体运行失败的问题，需要指定一下字体。
Avalonia 11.0.0版本之后，处理的方式会有差异。
Avalonia的应用可以打包成deb安装包。也可以基于软件包设置桌面图标，操作方法参考：
Ubuntu系统下为Avalonia应用创建桌面图标 - wzwyc - 博客园
https://www.cnblogs.com/wzwyc/p/14820893.html
相关的开源项目
Avalonia资源
https://github.com/AvaloniaCommunity/awesome-avalonia?tab=readme-ov-file
Gotrays.Suspension
Gotrays Suspension 作为open666.cn的客户端生态，以开源给用户使用，使用avalonia实现跨平台，支持在Win，Linux,Mac下运行。
https://github.com/239573049/Suspension
Core2D
GitHub - wieslawsoltes/Core2D: A multi-platform data driven 2D diagram editor.
https://github.com/wieslawsoltes/Core2D
Avalonia内置控件的示例程序
https://github.com/AvaloniaUI/ControlCatalogStandalone.git
FAQ常见问题解决
1、“Default font family name can't be null or empty.”报错
Avalonia 11.0.0的处理方式：
public static AppBuilder BuildAvaloniaApp()
{
var Settings = AppSettings.Instance;
FontManagerOptions options = new();
if (OperatingSystem.IsLinux())
{
options.DefaultFamilyName = Settings.LinuxFamilyName;
}
else if (OperatingSystem.IsMacOS())
{
options.DefaultFamilyName = Settings.MacOSFamilyName;
}
else if (OperatingSystem.IsWindows())
{
options.DefaultFamilyName = Settings.WindowsFamilyName;
}
return AppBuilder.Configure<App>()
.UsePlatformDetect()
.LogToTrace()
.WithInterFont()
.UseReactiveUI()
.With(options);
}
2、打包成deb安装包
Avalonia的应用可以打包成deb安装包。也可以基于软件包设置桌面图标，操作方法参考：
Ubuntu系统下为Avalonia应用创建桌面图标 - wzwyc - 博客园
https://www.cnblogs.com/wzwyc/p/14820893.html
3、窗体的快捷键设置
<Button
Classes="select"
Command="{Binding AddCommand}"
Content="添加"
HotKeyManager.HotKey="Ctrl+N" />
<Button
Classes="select"
Command="{Binding EditCommand}"
Content="编辑"
HotKeyManager.HotKey="F2" />
<Button
Classes="select"
Command="{Binding DeleteCommand}"
Content="删除"
HotKeyManager.HotKey="Delete" />
<Button
Classes="select"
Command="{Binding RefreshCommand}"
Content="刷新"
HotKeyManager.HotKey="F5" />
在按钮上设置HotKeyManager.HotKey的值。
4、CalendarDatePicker
WPF里面的DatePicker控件，在Avalonia里面对应的应该是CalendarDatePicker。
<CalendarDatePicker SelectedDate="{Binding StartTime}" />
前面一直在用Avalonia的DatePicker，别扭。
获取控件的窗体
public static Window GetWindow(Visual visual)
{
return Avalonia.VisualTree.VisualExtensions.FindAncestorOfType<Window>(visual);
}
对话框关闭的时候提示线程不正确
Avalonia是从0.10.x版本开始用，所以习惯了用ReactiveUI模式。
新项目一开始需要使用Dock控件，找了Dock.Avalonia库。因为这个库示例只有CommunityToolkit.Mvvm的示例，所以工程用的是CommunityToolkit.Mvvm。
后面又用了Prism.Avalonia框架。
然后又用了PropertyChanged.Fody和ReactiveUI.Fody。
估计引入的东西太多了，有点冲突了。
后面重新建一下，改成了ReactiveUI，保留Prism.Avalonia和ReactiveUI.Fody，然后就正常了。
