diff --git a/docs/changelog/17_0_0.md b/docs/changelog/17_0_0.md index 9246cb8dd0..e3cd96ca7e 100644 --- a/docs/changelog/17_0_0.md +++ b/docs/changelog/17_0_0.md @@ -20,6 +20,6 @@ Use [the `nx migrate` command](/core-features/automate-updating-dependencies) to {% card title="Removed workspace-lint command" type="external" url="https://github.com/nrwl/nx/pull/16212" /%} {% card title="Removed defaultCollection property" type="external" url="https://github.com/nrwl/nx/pull/19708" /%} {% card title="Removed npmScope property" type="external" url="https://github.com/nrwl/nx/pull/19708" /%} -{% card title="Removed ability for Angular CLI to use our generators and executors" type="external" url="https://github.com/nrwl/nx/pull/19557" /%} +{% card title="Removed ability for Angular CLI to use our generators and executors" type="external" url="/deprecated/angular-schematics-builders" /%} {% card title="Removed exported code from @nrwl/workspace that has been moved elsewhere" type="external" url="https://github.com/nrwl/nx/pull/19588" /%} {% /cards %} diff --git a/docs/generated/manifests/menus.json b/docs/generated/manifests/menus.json index a316e15566..74d89dfd7c 100644 --- a/docs/generated/manifests/menus.json +++ b/docs/generated/manifests/menus.json @@ -4996,6 +4996,14 @@ "children": [], "disableCollapsible": false }, + { + "name": "Angular Schematics and Builders", + "path": "/deprecated/angular-schematics-builders", + "id": "angular-schematics-builders", + "isExternal": false, + "children": [], + "disableCollapsible": false + }, { "name": "Storybook deprecated docs", "path": "/deprecated/storybook", @@ -5128,6 +5136,14 @@ "children": [], "disableCollapsible": false }, + { + "name": "Angular Schematics and Builders", + "path": "/deprecated/angular-schematics-builders", + "id": "angular-schematics-builders", + "isExternal": false, + "children": [], + "disableCollapsible": false + }, { "name": "Storybook deprecated docs", "path": "/deprecated/storybook", diff --git a/docs/generated/manifests/nx.json b/docs/generated/manifests/nx.json index eddbcb4a68..b53acd910c 100644 --- a/docs/generated/manifests/nx.json +++ b/docs/generated/manifests/nx.json @@ -6230,6 +6230,16 @@ "path": "/deprecated/global-implicit-dependencies", "tags": [] }, + { + "id": "angular-schematics-builders", + "name": "Angular Schematics and Builders", + "description": "", + "file": "shared/deprecated/angular-schematics-builders", + "itemList": [], + "isExternal": false, + "path": "/deprecated/angular-schematics-builders", + "tags": [] + }, { "id": "storybook", "name": "Storybook deprecated docs", @@ -6396,6 +6406,16 @@ "path": "/deprecated/global-implicit-dependencies", "tags": [] }, + "/deprecated/angular-schematics-builders": { + "id": "angular-schematics-builders", + "name": "Angular Schematics and Builders", + "description": "", + "file": "shared/deprecated/angular-schematics-builders", + "itemList": [], + "isExternal": false, + "path": "/deprecated/angular-schematics-builders", + "tags": [] + }, "/deprecated/storybook": { "id": "storybook", "name": "Storybook deprecated docs", diff --git a/docs/map.json b/docs/map.json index cdbf2715cb..1570fef911 100644 --- a/docs/map.json +++ b/docs/map.json @@ -1418,6 +1418,11 @@ "id": "global-implicit-dependencies", "file": "shared/deprecated/global-implicit-dependencies" }, + { + "name": "Angular Schematics and Builders", + "id": "angular-schematics-builders", + "file": "shared/deprecated/angular-schematics-builders" + }, { "name": "Storybook deprecated docs", "id": "storybook", diff --git a/docs/shared/deprecated/angular-schematics-builders.md b/docs/shared/deprecated/angular-schematics-builders.md new file mode 100644 index 0000000000..e077c098fa --- /dev/null +++ b/docs/shared/deprecated/angular-schematics-builders.md @@ -0,0 +1,11 @@ +# Angular Schematics and Builders + +As of Nx 17, official Nx plugins no longer export [schematics](https://angular.io/guide/schematics) and [builders](https://angular.io/guide/cli-builder) that can be directly consumed by the Angular CLI. Since Angular CLI users are not a large portion of Nx's user base, it made sense to stop maintaining that code. + +Currently, the Angular CLI can only run its own schematics and builders. The Nx CLI is still able to directly run any schematics or builders created for the Angular CLI as well as Nx's own generators and executors. The only thing that has changed is that Nx is no longer taking the extra step of converting our own code into a format that the Angular CLI recognizes. + +To switch from using the Angular CLI to using the Nx CLI follow the [migrating an Angular CLI project to Nx](/recipes/angular/migration/angular) recipe. + +## Converting Nx Generators to Schematics and Nx Executors to Builders + +If you need to still support the Angular CLI, you can wrap any Nx generator with the [convertNxGenerator](/nx-api/devkit/documents/convertNxGenerator) function and re-export it in your own plugin as a schematic. In the same way, you can wrap any Nx executor with the [convertNxExecutor](/nx-api/devkit/documents/convertNxExecutor) function and re-export it in your own plugin as a builder. diff --git a/docs/shared/reference/sitemap.md b/docs/shared/reference/sitemap.md index 36864f55c8..f08add4f2b 100644 --- a/docs/shared/reference/sitemap.md +++ b/docs/shared/reference/sitemap.md @@ -237,6 +237,7 @@ - [defaultCollection](/deprecated/default-collection) - [runtimeCacheInputs](/deprecated/runtime-cache-inputs) - [globalImplicitDependencies](/deprecated/global-implicit-dependencies) + - [Angular Schematics and Builders](/deprecated/angular-schematics-builders) - [Storybook deprecated docs](/deprecated/storybook) - [Angular: Information about the Storybook targets](/deprecated/storybook/angular-storybook-targets) - [Angular: The browserTarget](/deprecated/storybook/angular-browser-target)