ng-packagr项目中子入口配置的注意事项

在Angular库开发过程中，ng-packagr是一个常用的打包工具。近期在使用ng-packagr 17.2.1版本时，开发者可能会遇到一个关于子入口配置的验证问题，这值得引起我们的注意。

问题背景

当开发者创建包含子入口(secondary entry points)的Angular库时，通常会在子目录中放置额外的ng-package.json文件。在这些嵌套配置文件中，如果包含了"dest"属性，从ng-packagr 17.0.3版本开始，构建过程会报错，提示"Data path must NOT have additional properties (dest)"。

技术解析

实际上，这是ng-packagr有意为之的行为变更。在子入口配置文件中，"dest"属性并不是一个有效的配置选项。之前的版本没有严格执行这个验证，导致开发者可能会误以为这个属性是可用的。

ng-packagr为子入口配置文件定义了专门的JSON Schema，明确规定了哪些属性是允许的。这个Schema确保了配置的一致性和正确性。

解决方案

对于遇到此问题的开发者，解决方案很简单：

1. 检查项目中所有的子入口ng-package.json文件
2. 移除其中所有的"dest"属性配置
3. 重新构建项目

最佳实践

在配置子入口时，开发者应该：

• 只使用ng-packagr官方文档中明确支持的配置选项
• 避免将主入口的配置直接复制到子入口中
• 定期检查ng-packagr的更新日志，了解行为变更

总结

这个变更反映了ng-packagr团队对配置验证的加强，虽然短期内可能会造成一些构建失败，但从长远来看，这有助于开发者编写更规范的配置，避免潜在的问题。理解并遵循这些规则，将有助于构建更健壮的Angular库。