AmmyUI 项目教程

1. 项目目录结构及介绍

AmmyUI 项目的目录结构如下：

AmmyUI/
├── build/
├── docs/
├── lib/
├── src/
├── test/
├── tools/
├── .gitignore
├── .gitmodules
├── Ammy.Samples.sln
├── Ammy.Tests.sln
├── Ammy.sln
├── LICENCE
├── README.md
├── build-all.cmd
├── build-ammy.cmd
├── build-nuget-host.cmd
├── build-nuget.cmd
├── release-notes.md
├── run-tests.cmd
├── run-unittests.cmd
├── upload-myget.cmd
└── upload-nuget.cmd

目录介绍

• build/: 包含项目的构建脚本和配置文件。
• docs/: 包含项目的文档文件。
• lib/: 包含项目依赖的库文件。
• src/: 包含项目的源代码文件。
• test/: 包含项目的测试代码文件。
• tools/: 包含项目使用的工具和脚本。
• .gitignore: Git 忽略文件配置。
• .gitmodules: Git 子模块配置。
• Ammy.Samples.sln: 示例项目的解决方案文件。
• Ammy.Tests.sln: 测试项目的解决方案文件。
• Ammy.sln: 主项目的解决方案文件。
• LICENCE: 项目的许可证文件。
• README.md: 项目的介绍和使用说明。
• build-all.cmd: 构建所有内容的脚本。
• build-ammy.cmd: 构建 Ammy 语言的脚本。
• build-nuget-host.cmd: 构建 NuGet 主机的脚本。
• build-nuget.cmd: 构建 NuGet 包的脚本。
• release-notes.md: 发布说明文件。
• run-tests.cmd: 运行测试的脚本。
• run-unittests.cmd: 运行单元测试的脚本。
• upload-myget.cmd: 上传到 MyGet 的脚本。
• upload-nuget.cmd: 上传到 NuGet 的脚本。

2. 项目启动文件介绍

项目的启动文件是 Ammy.sln，这是一个 Visual Studio 解决方案文件。通过打开这个文件，可以在 Visual Studio 中加载整个项目，并进行编译、调试和运行。

启动步骤

1. 安装 Visual Studio 2017（如果尚未安装）。
2. 安装 Nemerle（点击“Download Now”按钮）。
3. 克隆项目仓库。
4. 在 Visual Studio 2017 中打开 Ammy.sln 解决方案文件。
5. 将 Ammy.VisualStudio 项目设置为启动项目。
6. 开始调试会话。

3. 项目配置文件介绍

项目的配置文件主要包括以下几个部分：

.gitignore

这个文件用于配置 Git 忽略的文件和目录，避免将不必要的文件提交到版本控制系统中。

.gitmodules

这个文件用于配置 Git 子模块，管理项目依赖的其他 Git 仓库。

LICENCE

这个文件包含了项目的许可证信息，通常是 MIT 许可证。

README.md

这个文件是项目的介绍和使用说明，包含了项目的概述、安装步骤、使用方法等信息。

build-all.cmd 等脚本文件

这些脚本文件用于项目的构建、测试和发布，具体功能如下：

• build-all.cmd: 构建所有内容。
• build-ammy.cmd: 构建 Ammy 语言。
• build-nuget-host.cmd: 构建 NuGet 主机。
• build-nuget.cmd: 构建 NuGet 包。
• run-tests.cmd: 运行测试。
• run-unittests.cmd: 运行单元测试。
• upload-myget.cmd: 上传到 MyGet。
• upload-nuget.cmd: 上传到 NuGet。

这些配置文件和脚本文件共同构成了项目的构建和发布流程，确保项目能够顺利地进行开发、测试和部署。