LiveCharts2 跨平台图表库安装与快速入门指南

LiveCharts2 跨平台图表库安装与快速入门指南

LiveCharts2 Simple, flexible, interactive & powerful charts, maps and gauges for .Net, LiveCharts2 can now practically run everywhere Maui, Uno Platform, Blazor-wasm, WPF, WinForms, Xamarin, Avalonia, WinUI, UWP. 项目地址: https://gitcode.com/gh_mirrors/li/LiveCharts2

前言

LiveCharts2 是一个基于 .NET 平台的现代化数据可视化库，支持多种 UI 框架，包括 WPF、WinForms、Avalonia、Uno Platform、WinUI、Blazor 和 MAUI。本文将详细介绍如何在不同平台上安装 LiveCharts2 并创建第一个图表。

环境准备

在开始之前，请确保：

1. 已安装 Visual Studio 2022（推荐版本）
2. 已安装对应平台的开发环境（如 MAUI 工作负载等）
3. 了解基本的 .NET 开发概念

各平台安装指南

WPF 平台

1. 创建项目

• 在 VS2022 中创建新的 WPF 应用项目
• 选择 .NET 8.0 作为目标框架（兼容性提示：LiveCharts2 也支持 .NET 4.6.2 及以上版本）

2. 安装 NuGet 包

• 搜索并安装 LiveChartsCore.SkiaSharpView.WPF 包
• 注意：需要勾选"包含预发行版"选项

3. 创建视图模型

public class ViewModel
{
    public ISeries[] Series { get; set; } = [
        new ColumnSeries<int>(3, 4, 2),
        new ColumnSeries<int>(4, 2, 6),
        new ColumnSeries<double, DiamondGeometry>(4, 3, 4)
    ];
}

4. 添加图表控件

在 MainWindow.xaml 中添加：

<Window ...
    xmlns:lvc="clr-namespace:LiveChartsCore.SkiaSharpView.WPF;assembly=LiveChartsCore.SkiaSharpView.WPF"
    xmlns:local="clr-namespace:WpfSample">
    
    <Window.DataContext>
        <local:ViewModel />
    </Window.DataContext>

    <lvc:CartesianChart Series="{Binding Series}"/>
</Window>

WinForms 平台

1. 创建项目

• 创建 Windows Forms 应用项目
• 选择 .NET 8.0 框架

2. 安装 NuGet 包

• 安装 LiveChartsCore.SkiaSharpView.WinForms 包
• 安装后，图表控件会自动出现在工具箱中

3. 添加图表

从工具箱拖拽 CartesianChart 到窗体，然后在代码中设置：

cartesianChart1.Series = new ISeries[]
{
    new LineSeries<double>
    {
        Values = new double[] { 2, 1, 3, 5, 3, 4, 6 },
        Fill = null
    }
};

MAUI 平台

1. 安装 NuGet 包

• 安装 LiveChartsCore.SkiaSharpView.Maui 包

2. 注册服务

在 MauiProgram.cs 中添加：

builder
    .UseSkiaSharp()
    .UseLiveCharts();

3. 创建视图模型

与 WPF 平台类似

4. 添加图表控件

在 XAML 中添加：

<ContentPage ...
    xmlns:lvc="clr-namespace:LiveChartsCore.SkiaSharpView.Maui;assembly=LiveChartsCore.SkiaSharpView.Maui">
    
    <lvc:CartesianChart Series="{Binding Series}"/>
</ContentPage>

核心概念解析

1. ISeries 接口：所有图表系列的基础接口，支持多种图表类型
2. SkiaSharp 渲染：LiveCharts2 使用 SkiaSharp 进行高性能渲染
3. 跨平台一致性：相同的 API 在不同平台上表现一致

常见问题

1. 为什么看不到预发行版包？

   • 需要在 NuGet 包管理器中勾选"包含预发行版"选项

2. 图表不显示怎么办？

   • 检查是否正确设置了 DataContext
   • 确认 Series 属性绑定的数据不为空
   • 验证是否正确安装了所有依赖项

3. 性能优化建议

   • 对于大数据集，考虑使用虚拟化
   • 合理使用图表动画配置

进阶学习

掌握了基础安装和使用后，可以进一步学习：

• 自定义图表样式
• 复杂数据绑定
• 交互功能实现
• 多图表联动

LiveCharts2 提供了丰富的文档和示例，是 .NET 生态中数据可视化的强大工具。通过本文的入门指南，您已经迈出了数据可视化的第一步。

LiveCharts2 Simple, flexible, interactive & powerful charts, maps and gauges for .Net, LiveCharts2 can now practically run everywhere Maui, Uno Platform, Blazor-wasm, WPF, WinForms, Xamarin, Avalonia, WinUI, UWP. 项目地址: https://gitcode.com/gh_mirrors/li/LiveCharts2