CMinor-Verifier 项目使用教程

1. 项目的目录结构及介绍

CMinor-Verifier 项目的目录结构如下：

CMinor-Verifier/
├── backend/
├── exception/
├── frontend/
├── ir/
├── testcases/
├── github/workflows/
├── .gitignore
├── .gitlab-ci.yml
├── .gitmodules
├── CMinorLexer.g4
├── CMinorParser.g4
├── COPYING
├── Doxyfile
├── Program.cs
├── cminor.csproj
├── cminor.sln
├── logo.jpeg
├── README.md
├── task-doc.md

目录介绍

• backend/: 包含项目后端相关的文件。
• exception/: 包含项目异常处理相关的文件。
• frontend/: 包含项目前端相关的文件。
• ir/: 包含中间表示相关的文件。
• testcases/: 包含测试用例文件。
• github/workflows/: 包含 GitHub Actions 的工作流配置文件。
• .gitignore: Git 忽略文件配置。
• .gitlab-ci.yml: GitLab CI 配置文件。
• .gitmodules: Git 子模块配置文件。
• CMinorLexer.g4: CMinor 语言的词法分析器定义文件。
• CMinorParser.g4: CMinor 语言的语法分析器定义文件。
• COPYING: 许可证文件。
• Doxyfile: Doxygen 配置文件。
• Program.cs: 主程序文件。
• cminor.csproj: C# 项目文件。
• cminor.sln: Visual Studio 解决方案文件。
• logo.jpeg: 项目 logo 图片。
• README.md: 项目说明文档。
• task-doc.md: 任务文档。

2. 项目的启动文件介绍

项目的启动文件是 Program.cs。这个文件包含了主程序的入口点，负责初始化和启动整个应用程序。

// Program.cs 文件内容示例
using System;

namespace CMinorVerifier
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("CMinor Verifier 启动...");
            // 初始化代码
        }
    }
}

3. 项目的配置文件介绍

项目的配置文件包括以下几个：

• .gitignore: 用于指定 Git 版本控制系统忽略的文件和目录。
• .gitlab-ci.yml: 用于配置 GitLab CI/CD 流水线。
• Doxyfile: 用于配置 Doxygen 文档生成工具。
• cminor.csproj: 包含项目的构建和依赖信息。
• cminor.sln: 包含 Visual Studio 解决方案的配置信息。

.gitignore 文件示例

# .gitignore 文件内容示例
bin/
obj/
*.log

.gitlab-ci.yml 文件示例

# .gitlab-ci.yml 文件内容示例
stages:
  - build
  - test

build:
  stage: build
  script:
    - echo "构建项目..."

Doxyfile 文件示例

# Doxyfile 文件内容示例
PROJECT_NAME           = "CMinor-Verifier"
OUTPUT_DIRECTORY       = docs

cminor.csproj 文件示例

<!-- cminor.csproj 文件内容示例 -->
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net5.0</TargetFramework>
  </PropertyGroup>
</Project>

cminor.sln 文件示例

Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio 15
VisualStudioVersion = 15.0.26730.15
MinimumVisualStudioVersion = 10.0.40219.1
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "cminor", "cminor.csproj", "{