miel.truyen/nx
1
0
Fork 0
Code Issues Pull Requests Actions 4 Packages Projects Releases Wiki Activity

docs(angular): document PNPM workaround for ngcc (#19041)

Browse Source 
Co-authored-by: Daniel Shuy <daniel_shuy@hotmail.com>
This commit is contained in:
Isaac Mann 2023-09-07 09:46:44 -04:00 committed by GitHub
parent c2c664a055
commit 2cc40a1f32
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
docs/shared/guides/setup-incremental-builds-angular.md
View File

@ -26,8 +26,25 @@ installation. You can check your `package.json` and make sure you have the follo
}
```
{% callout type="warning" title="ngcc limitations" %}
Please note that `ngcc` doesn’t support `pnpm` ([#32087](https://github.com/angular/angular/issues/32087#issuecomment-523225437) and [#38023](https://github.com/angular/angular/issues/38023#issuecomment-732423078)), so you need to use either `yarn` or `npm`.
{% callout type="warning" title="PNPM support" %}
To use `ngcc` with `pnpm`, set [`node-linker=hoisted` in `.npmrc`](https://pnpm.io/npmrc#node-linker) ([angular/angular#50735](https://github.com/angular/angular/issues/50735)) and explicitly declare `node-gyp-build` in `package.json` ([#16319](https://github.com/nrwl/nx/issues/16319) and [parcel-bundler/watcher#142](https://github.com/parcel-bundler/watcher/issues/142)), e.g.
```ini {% fileName=".npmrc" %}
node-linker=hoisted
```
```jsonc {% fileName="package.json" %}
{
...
"devDependencies": {
...
"node-gyp-build": "4.6.0",
...
}
...
}
```
{% /callout %}
## Use buildable libraries