微软自动图布局（Microsoft Automatic Graph Layout）项目使用手册

微软自动图布局（Microsoft Automatic Graph Layout）项目使用手册

【免费下载链接】automatic-graph-layout A set of tools for graph layout and viewing 项目地址: https://gitcode.com/gh_mirrors/au/automatic-graph-layout

项目概述

微软自动图布局（MSAGL）是一个用于图布局与查看的.NET库及工具。该项目由微软内部开发，适用于需要对图形进行高效布局和展示的场景。本教程将指导您了解其目录结构、关键的启动文件以及配置文件，以便您能够快速上手并应用到您的开发中。

1. 项目目录结构及介绍

MSAGL的仓库遵循了标准的GitHub仓库结构，主要组成部分包括源代码、解决方案文件以及示例等。以下是关键目录及其作用概览：

• 根目录：

  • LICENSE 和 README.md: 分别包含了软件许可协议和项目简介。
  • SECURITY.md: 提供有关项目安全性的信息。
  • src: 包含核心的源代码文件夹。
    • AutomaticGraphLayout: 核心布局引擎的实现。
    • AutomaticGraphLayout.Drawing: 用于定义绘图属性和图类的模块。
    • Microsoft.Msagl.WpfGraphControl: 支持WPF的图可视化控件。
    • Microsoft.Msagl.GraphViewerGDI: 提供Windows Forms下的图查看器控件。
  • samples: 示例代码和工程，帮助快速理解和使用MSAGL。
  • build: 构建相关的脚本和配置。
  • github/workflows: GitHub Actions的配置，自动化构建和发布流程。

• 关键文件：

  • GraphLayout.sln: 主要的Visual Studio解决方案文件，包含了所有的项目和依赖。
  • AutomaticGraphLayout.csproj, AutomaticGraphLayout.Drawing.csproj, ...: 各个模块的项目文件。

2. 项目的启动文件介绍

在MSAGL项目中，没有一个单一的“启动文件”如传统意义上的可执行文件。然而，开发者通常从打开GraphLayout.sln这个Visual Studio解决方案文件开始。此解决方案整合了所有必要的组件，并允许开发者立即浏览到samples目录下的各种示例工程，通过这些示例来理解如何使用MSAGL进行图的布局和显示。

对于实际的应用开发，根据不同的集成需求，可能需要关注特定的入口点，例如在创建一个新的应用程序时引入相应的DLL或者使用提供的WPF/WinForms控制作为启动界面的一部分。

3. 项目的配置文件介绍

• 解决方案和项目文件: 在Visual Studio解决方案(GraphLayout.sln)及各个子项目(*.csproj)中，包含了基本的项目配置，比如编译目标、引用的NuGet包等。
• 配置文件:
  • 对于构建和自动化过程，重点在于github/workflows/agl.yaml。这是一个GitHub Action的配置文件，用于自动化地创建版本发布。
  • 另外，若涉及到应用程序的自定义配置，开发者通常会在自己的应用中添加配置文件（如App.config或使用环境变量），而不是直接在MSAGL项目中查找配置文件。

在实际操作前，请确保您的开发环境中已安装有支持UWP（Universal Windows Platform）的Visual Studio和Windows 10 SDK，这将是成功搭建和运行项目的基础。通过上述介绍，希望您可以顺利上手并利用MSAGL在您的项目中展现复杂的图形布局。

【免费下载链接】automatic-graph-layout A set of tools for graph layout and viewing 项目地址: https://gitcode.com/gh_mirrors/au/automatic-graph-layout