Angular-CLI指南：构建并发布NPM第三方包

本文档详细介绍了如何使用Angular-CLI来构建一个可发布的NPM包。首先，你需要创建一个新的Angular项目： 1. 创建项目：使用Angular CLI的`ng new`命令，指定项目名称，例如`ng new PROJECT_NAME`。这将初始化一个新的Angular项目结构。 2. 创建第三方包：在项目根目录下，切换到项目文件夹`cd PROJECT_NAME`。接下来，使用`ng g library`生成一个库，如`ng g library LIBRARY_NAME --prefix PREFIX`。这里的`LIBRARY_NAME`是你想要的包名，比如`zorro`，`PREFIX`是组件前缀，如`nz-`。这将创建一个名为`projects/LIBRARY_NAME`的目录，其中包含了生成的库及其相关组件、模块等。 3. 构建模块：在新建的库中，开发必要的功能模块。例如，创建`directive.ts`用于提供内部使用的指令，同时确保导入到对应的`module.ts`中，并在模块的`@NgModule`装饰器中声明和导出组件。对于可能需要外部引用的模型（如`models.ts`），你需要将其导出到`public_api.ts`文件中，以便于外部项目能正确引用。 4. 准备发布：在打包NPM包之前，你需要更新`package.json`文件，确保包含正确的项目信息，如版本号。每次发布新版本时，记得更新版本号，这有助于跟踪包的更新历史。 5. 构建NPM包：使用Angular CLI的`ng build`命令构建你的库，选择`--prod`标志以生成生产环境优化的代码。这将生成一个包含所有库文件的dist目录。然后，你可以使用`npm pack`命令将dist文件压缩成`.tgz`格式，这样就可以通过`npm publish`命令发布到NPM仓库了。 6. 发布和使用：发布完成后，可以通过`npm install LIBRARY_NAME`在其他项目中安装和使用你的NPM包。确保在引入时正确使用前缀和导入路径。 总结来说，使用Angular-CLI构建NPM包涉及项目初始化、库结构创建、模块开发、配置文件管理和打包发布等多个步骤。遵循这些步骤，你就能高效地构建和管理自己的Angular库，方便其他开发者在其项目中复用和扩展。