Angular库生产构建@types/html2canvas需经allowedNonPeerDependencies显式允许的解决方法
Angular库项目生产构建
@types/html2canvas相关报错解决方案 报错触发逻辑
Angular 12及以上版本集成的ng-packagr构建工具,在执行生产编译时会做依赖校验:所有不属于库peerDependencies范畴的第三方依赖,必须通过显式配置允许参与构建,否则会直接终止流程并抛出must be explicitly allowed using the "allowedNonPeerDependencies" option提示。
解决步骤
- 找到库项目根目录下的
ng-package.json文件,该文件和项目的package.json处于同一层级。 - 在配置的顶层节点新增
allowedNonPeerDependencies数组配置,将@types/html2canvas加入数组,参考配置结构:配置参考示例
{ "$schema": "./node_modules/ng-packagr/ng-package.schema.json", "dest": "./dist/你的库名", "lib": { "entryFile": "src/public-api.ts" }, "allowedNonPeerDependencies": [ "@types/html2canvas" ] } - 补充校验:如果库代码中直接引入调用了html2canvas的运行时方法,而非仅靠类型定义做开发,需要把
html2canvas本体也加入上述数组,否则类型依赖放行后,构建会继续抛出关于html2canvas本体的同类拦截报错。
配置注意点
- 不要把
allowedNonPeerDependencies错放到lib子配置节点下,该配置属于顶层规则,层级错误会导致配置失效。 - 不要把
@types/html2canvas这类纯类型声明包放到peerDependencies中,这类包无运行时代码,放入peerDependencies会让库的使用者收到不必要的安装提示,增大项目冗余。 - 修改完成后重新执行
ng build --prod即可正常完成生产编译。
内容的提问来源于stack exchange,提问作者Ricardo Rocha
相关产品推荐
相关产品推荐

