什么是 Angular 项目中的 tsconfig.api-extractor.json 文件

在 Angular 项目中，“tsconfig.api-extractor.json” 是一个用于配置 API Extractor 工具的配置文件。API Extractor 是一个用于生成和管理 TypeScript 库的 API 文档的工具。它能够从 TypeScript 代码中提取公共 API 并生成清晰的文档，以便开发者能够更好地了解库的使用方式、函数、类、接口等。

“tsconfig.api-extractor.json” 文件是用于指导 API Extractor 的工作流程和行为的配置文件。它定义了用于生成 API 文档的源代码位置、输出目录、文件筛选规则、包含和排除的文件列表，以及其他相关的选项。

该配置文件通常位于项目的根目录下，并且以"tsconfig.api-extractor.json"的名称保存。在 Angular 项目中，它通常是与其他 TypeScript 配置文件（例如 “tsconfig.json”）并存的。

下面是一个示例的 “tsconfig.api-extractor.json” 配置文件内容：

{
  "$schema": "https://developer.microsoft.com/json-schemas/api-extractor/v7/api-extractor.schema.json",
  "mainEntryPointFilePath": "<path_to_entry_point_file>",
  "dtsRollup": {
    "enabled": true,
    "publicTrimmedFilePath": "<path_to_public_trimmed_file>",
    "betaTrimmedFilePath": "<path_to_beta_trimmed_file>",
    "alphaTrimmedFilePath": "<path_to_alpha_trimmed_file>"
  },
  "apiReport": {
    "enabled": true,
    "reportFileName": "<api_report_filename>"
  },
  "docModel": {
    "enabled": true
  },
  "docModelJson": {
    "enabled": true,
    "outputFolder": "<output_folder_path>"
  },
  "compiler": {
    "configType": "tsconfig",
    "rootFolder": ".",
    "overrideTsconfig": {
      "extends": "./tsconfig.json",
      "compilerOptions": {
        "outDir": "./dist"
      }
    }
  }
}

在上述配置文件中，可以看到以下重要的配置选项：

• “mainEntryPointFilePath”：指定库的入口文件路径，API Extractor 将从该文件开始提取 API。
• “dtsRollup”：配置生成的 API 文件的路径和选项。
• “apiReport”：配置是否生成 API 报告以及报告文件的名称。
• “docModel” 和 “docModelJson”：配置是否启用生成 API 文档模型和相应的输出文件夹路径。
• “compiler”：与 TypeScript 编译器相关的配置，指定了编译器选项和路径。

通过配置 “tsconfig.api-extractor.json” 文件，开发者可以根据项目需求自定义 API Extractor 工具的行为，并生成清晰的 API 文档以供开发者使用和参考。

需要注意的是，“tsconfig.api-extractor.json” 是 Angular 项目中特定于 API Extractor 的配置文件，用于生成 API 文档。与此同时，还存在其他 TypeScript 配置文件（例如 “tsconfig.json”）用于控制 TypeScript 编译器的行为。