feat(@angular/build): introduce outputMode option to the application builder
#28355
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
angular-robot
bot
added
detected: feature
alan-agius4
added
the
target: major
alan-agius4
force-pushed
the
wireup-ssr-output-mode
branch
2 times, most recently
from
f90791f to
7d2f132
Compare
alan-agius4
force-pushed
the
wireup-ssr-output-mode
branch
5 times, most recently
from
28a16ca to
a3f50d5
Compare
alan-agius4
force-pushed
the
wireup-ssr-output-mode
branch
from
a3f50d5 to
ac71ce1
Compare
alan-agius4
force-pushed
the
wireup-ssr-output-mode
branch
7 times, most recently
from
859f6b9 to
3814f19
Compare
alan-agius4
force-pushed
the
wireup-ssr-output-mode
branch
6 times, most recently
from
5c30f3d to
23c32aa
Compare
alan-agius4
added
the
action: review
alan-agius4
force-pushed
the
wireup-ssr-output-mode
branch
6 times, most recently
from
8e1a54c to
d33ec81
Compare
clydin
reviewed
Sep 18, 2024
alan-agius4
force-pushed
the
wireup-ssr-output-mode
branch
4 times, most recently
from
655b76a to
3974957
Compare
clydin
reviewed
Sep 19, 2024
Comment on lines
+209
to
+215
| if (options.prerender) { | ||
| context.logger.warn( | ||
| 'The "prerender" option is no longer needed when "outputMode" is specified.', | ||
| ); | ||
| } else { | ||
| options.prerender = !!options.server; | ||
| } |
There was a problem hiding this comment.
Looks like when prerender is false here, it will be ignored. Is that intentional?
There was a problem hiding this comment.
Yeah, both prerender and appshell options are unused with the new API. As prerendering and app-shell is controlled through the routes config.
alan-agius4
force-pushed
the
wireup-ssr-output-mode
branch
from
3974957 to
f01d2da
Compare
clydin
reviewed
Sep 19, 2024
packages/angular/build/src/builders/application/execute-build.ts
Outdated
Show resolved
Hide resolved
…n builder The `outputMode` option accepts two values: - **`static`:** Generates a static output (HTML, CSS, JavaScript) suitable for deployment on static hosting services or CDNs. This mode supports both client-side rendering (CSR) and static site generation (SSG). - **`server`:** Generates a server bundle in addition to static assets, enabling server-side rendering (SSR) and hybrid rendering strategies. This output is intended for deployment on a Node.js server or serverless environment. - **Replaces `appShell` and `prerender`:** The `outputMode` option simplifies the CLI by replacing the `appShell` and `prerender` options when server-side routing is configured. - **Controls Server API Usage:** `outputMode` determines whether the new server API is utilized. In `server` mode, `server.ts` is bundled as a separate entry point, preventing direct references to `main.server.ts` and excluding it from localization. Closes angular#27356, closes angular#27403, closes angular#25726, closes angular#25718 and closes angular#27196
alan-agius4
force-pushed
the
wireup-ssr-output-mode
branch
from
f01d2da to
5de4d93
Compare
clydin
approved these changes
Sep 19, 2024
alan-agius4
added
action: merge
|
Are there any example on how to use this? |
|
@alan-agius4 So glad this is finally solved, thank you! When will it be released? And could you please provide an example how to setup an ssr app with i18n enabled, so we can get rid of the workaround mentioned here: #25726 |
|
@patricsteiner, this is part of Angular version 19 which is currently in pre-release. The schematics will be updated to use the new API. In the meantime you can check this test for an example. |
|
This issue has been automatically locked due to inactivity. Read more about our automatic conversation locking policy. This action has been performed automatically by a bot. |
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
The
outputModeoption defines the build output target, offering two modes:'static': Generates a static site suitable for deployment on any static hosting service. This mode can produce a fully client-side rendered (CSR) or static site generated (SSG) site. When SSG is enabled, redirects are handled using the<meta>tag.'server': Produces an application designed for deployment on a server that supports server-side rendering (SSR) or a hybrid approach.Additionally, the
outputModeoption determines whether the new API is used. If enabled, it bundles theserver.tsas a separate entry point, preventing it from directly referencingmain.server.tsand excluding it from localization.This option will replace
appShellandprerenderingwhen server routing configuration is present.closes #27356
closes #27403
closes #25726
closes #25718
closes #27196