EventHorizon.Blazor.TypeScript.Interop.Generator 使用手册

1. 项目目录结构及介绍

EventHorizon.Blazor.TypeScript.Interop.Generator 是一个用于生成 C# Blazor 互操作代理的工具，它利用TypeScript定义文件来简化C#中调用JavaScript库的过程。以下为核心目录结构及其简介：

• Sample: 此目录包含了示例工程，特别是针对BabylonJS库的集成样例，展示了如何在Blazor应用中使用通过此工具生成的互操作代码。

• Tool: 包含了命令行工具的源码，用于解析TypeScript定义并生成对应的C#代码。是本项目的执行核心。

• gitattributes, editorconfig, gitignore: 版本控制相关的配置文件，指导git如何处理文件和保持代码风格一致性。

• LICENSE, README.md: 分别是该项目的许可协议和主读我文件，提供了快速了解项目功能和使用方法的入口。

• EventHorizon.Blazor.TypeScript.Interop.Generator.sln: 解决方案文件，整合了项目中的所有相关组件，便于统一管理和构建。

• src: 理论上应包含主要的源代码，但根据提供的信息，实际源代码被组织在特定子目录下，如Tool内。

2. 项目的启动文件介绍

虽然这个项目主要是作为工具而非传统意义上的可“启动”的应用，其启动或运行的核心在于命令行工具 EventHorizon.Blazor.TypeScript.Interop.Tool 的执行。并没有特定的“启动文件”如.exe或者Web应用的入口点。用户通过命令行界面进行交互，使用该工具生成所需的C#代码。启动过程通常涉及以下步骤：

• 安装工具：通过命令dotnet tool install -g EventHorizon.Blazor.TypeScript.Interop.Tool全局安装工具。
• 执行生成命令，例如：eventhorizon-blazor-typescript-interop-tool -s path/to/typescript-definition.ts -c MyClass.

3. 项目的配置文件介绍

主要配置文件

• Project Configuration: 在具体使用过程中，项目的生成配置不直接体现在某个单一配置文件中，而是通过命令行参数指定（如前所述）。然而，对于开发环境，开发者可能调整.csproj文件或使用环境变量来定制构建过程。

• 工具配置: EventHorizon.Blazor.TypeScript.Interop.Tool/Tool.csproj 可以看作是工具本身的配置，决定了编译设置等，但用户直接编辑的需求不高。

• 其他常规配置: 诸如.editorconfig用于规定代码格式，.gitignore定义了哪些文件不应纳入版本控制系统，这些间接地影响着项目的开发流程，但并不是直接影响生成逻辑。

综上所述，本项目重视的是通过命令行接口的即时配置，而不是依赖于静态配置文件来决定行为，使得其更加灵活适应不同类型的TypeScript定义文件转换需求。