ADNC(.NET微服务/分布式开发框架)快速入门指南

1. 项目目录结构及介绍

ADNC框架基于.NET平台，其详细目录结构如下：

adnc
├── github               # CICD脚本目录(github-action)
├── doc                  # 技术文档目录
├── src                 # 源代码主目录
│   ├── ServerApi       # 后端服务代码
│   │   ├── Infrastructures     # 基础架构层
│   │   ├── ServiceShared      # 服务共享层
│   │   ├── Gateways           # API Gateway (Ocelot)
│   │   └── Demo              # 示例与应用场景
│   └── ClientApp          # 前端应用代码
├── test                # 测试代码目录
├── gitignore           # Git忽略文件
├── README.md           # 项目说明文档
└── LICENSE             # 许可证书

• github: 包含持续集成与交付(CI/CD)的脚本。
• doc: 提供技术文档和架构设计说明。
• src:
  • ServerApi: 含有服务后端代码，进一步划分为基础架构、服务共享、API Gateway实现和服务示例。
  • ClientApp: 前端应用相关的代码。
• test: 用于存放各类测试用例。
• gitignore: 规定哪些文件不被Git版本控制系统追踪。
• LICENSE: MIT许可证文件，说明软件使用的开放许可情况。

2. 项目的启动文件介绍

在src(ServerApi)目录下，每个子目录都可能含有一个或多个.sln（Solution）文件，例如src\ServerApi\Adnc.sln是主要的解决方案文件，包含了整个框架的所有工程项目。要启动项目，通常需先打开此.sln文件。对于特定的服务如Demo服务，会有独立的解决方案文件，如src\ServerApi\Demo\Adnc.Demo.sln，这是用来快速启动示例服务的。

项目通常通过Visual Studio或.NET CLI命令来启动。例如，使用.NET CLI，可以在命令行导航到相应的解决方案文件夹并运行以下命令：

dotnet build
dotnet run --project path/to/your/startup/project.csproj

请注意，具体的启动命令可能会根据项目实际的入口类（通常是Program.cs中的Main方法）和依赖环境有所不同。

3. 项目的配置文件介绍

ADNC框架的配置文件可能分布在不同的位置，常见的配置文件如下：

• appsettings.json 或 appsettings.Development.json: 应用程序的基础配置，包含了连接字符串、服务端口等默认设置。
• configurations 或特定命名的配置文件：这取决于项目实施的具体配置机制，ADNC支持Consul等配置中心，配置文件可能不局限于本地文件，更多依赖外部服务。
• .props 文件（如common.props, version_infra.props等）: 提供公共属性配置，例如版本号或通用编译选项。

为了适应微服务环境，ADNC鼓励使用环境变量、配置中心进行动态配置，确保环境间的隔离和配置的灵活性。具体配置项及其作用通常在文档的“配置管理”部分有详细的解释。

在实际应用中，开发者需要根据项目需求，在这些配置文件中设置正确的数据库连接信息、服务注册地址等关键信息，以确保项目的正确运行。

---

此指南提供了一个初步的框架介绍，实际使用还需参照项目的官方文档和示例，尤其是关于如何结合具体技术栈进行配置和启动的详细步骤。