Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(docs-infra): traduccion del archivo /content/guide/updating-to-v… #360

Open
wants to merge 5 commits into
base: master
Choose a base branch
from
Open

docs(docs-infra): traduccion del archivo /content/guide/updating-to-v… #360

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
618c8c7
docs(docs-infra): updating of upstream master
zago-code May 7, 2021
6de45d6
docs(docs-infra): merge branch 'master' of github.com:angular-hispano…
zago-code May 7, 2021
5a9f939
docs(docs-infra): traduccion del archivo /content/guide/updating-to-v…
zago-code Apr 29, 2021
ee1fd5a
docs(docs-infra): actualizacion de traduccion del archivo /content/gu…
zago-code May 3, 2021
108265a
docs(docs-infra): traduccion al archivo updating-to-version-11.md
zago-code May 7, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
73 changes: 73 additions & 0 deletions aio/content/guide/updating-to-version-11.en.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
# Updating Angular

This guide contains information related to updating to the latest version of Angular.

## Updating CLI Apps

For step-by-step instructions on how to update to the latest Angular release (and leverage our automated migration tools to do so), use the interactive update guide at [update.angular.io](https://update.angular.io).

## Changes and Deprecations in Version 11

<div class="alert is-helpful">

For information about Angular's deprecation and removal practices, see [Angular Release Practices](guide/releases#deprecation-practices "Angular Release Practices: Deprecation practices").

</div>

{@a breaking-changes}
### New Breaking Changes

* Remove deprecated support for IE 9, 10, and IE mobile. See [PR 38931](https://github.com/angular/angular/pull/38931).
* TypeScript 3.9 is no longer supported. Please update to TypeScript 4.0. See [PR 39313](https://github.com/angular/angular/pull/39313).
* `NavigationExtras#preserveQueryParams` has been removed from `@angular/router`. See [PR 38762](https://github.com/angular/angular/pull/38762)
* `CollectionChangeRecord` has been removed from `@angular/core`. See [PR 38668](https://github.com/angular/angular/pull/38668).
* We changed the default value for `relativeLinkResolution` from `'legacy'` to `'corrected'` so that new applications are automatically opted-in to the corrected behavior from [PR 22394](https://github.com/angular/angular/pull/22394). Applications which use the current default are updated by a migration to specify `'legacy'` to ensure the current behavior is maintained when the default is updated. See [PR 25609](https://github.com/angular/angular/pull/25609).
* Fixed a bug in the router where the arguments for `future` and `curr` snapshots were reversed in the call to `shouldReuseRoute` when processing child routes. Usually this ordering mistake doesn't matter because most implementations of [`shouldReuseRoute`](api/router/RouteReuseStrategy#shouldReuseRoute) just do
an equality comparison between `future` and `curr`. However, some implementations actually do rely on values specifically on
one of the two and will need to be updated. See [PR 26949](https://github.com/angular/angular/pull/26949).
* `ViewEncapsulation.Native` has been removed. Angular previously supported a view encapsulation mode `ViewEncapsulaion.Native` that was based on the v0 Shadow DOM Draft APIs. These APIs have been superceded by the final Shadow DOM APIs, which are enabled via `ViewEncapsulation.ShadowDom`. For background information about this change, see [Web Components update: more time to upgrade to v1 APIs](https://developers.google.com/web/updates/2019/07/web-components-time-to-upgrade).
* `@angular/platform-webworker` has been removed and will no longer be supported. See [PR 38846](https://github.com/angular/angular/pull/38846).
* `@angular/platform-webworker` is no longer supported. No further versions will be published. See [PR 38846](https://github.com/angular/angular/pull/38846).
* Updated the options for `initialNavigation`. For more information, see [initialNavigation](api/router/InitialNavigation) in the API documentation. See [PR 33128](https://github.com/angular/angular/pull/33128).
* `DatePipe` no longer rounds up fractional milliseconds. See [PR 38009](https://github.com/angular/angular/pull/38009).
* Locale data arrays are now read-only. See [PR 30397](https://github.com/angular/angular/pull/30397).
* The injected `ControlValueAccessor` for `NG_VALUE_ACCESSOR` is now readonly. See [PR 29273](https://github.com/angular/angular/pull/29723).
* The type of `AbstractControl#parent` now indicates that it may be null. See [PR 32671](https://github.com/angular/angular/pull/32671).
* Calling `overrideProvider` before initializing the TestBed will now throw an error. See [PR 38717](https://github.com/angular/angular/pull/38717).
* Types for many Angular built-in pipes have been either narrowed or expanded to be more accurate. For more information, see the corresponding [Pipes](https://angular.io/api?type=pipe) API documentation. See [PR 37447](https://github.com/angular/angular/pull/37447).
* Directives in the `@angular/forms` package used to have `any[]` as a type of validators and asyncValidators
arguments in constructors. Now these arguments are properly typed, so if your code relies on
directive constructor types it may require some updates to improve type safety. See [PR 38994](https://github.com/angular/angular/pull/38944).
* `routerLink` now accepts `undefined` inputs. See [PR 39151](https://github.com/angular/angular/pull/39151).
* The `async` function from `@angular/core/testing` has been renamed to `waitForAsync` in order to avoid confusion with the native JavaScript `async` syntax. The existing function is deprecated and will be removed in a future version. See [PR 37583](https://github.com/angular/angular/pull/37583).

{@a deprecations}
### New Deprecations

| Area | API or Feature | May be removed in |
| ----------------------------- | -------------------------------------------------- | ----------------- |
| `@angular/core/testing` | Rename `async` to `waitForAsync` | <!--v11--> v13 |


{@a removals}
### New Removals of Deprecated APIs

The following APIs have been removed starting with version 11.0.0*:

| Package | API | Replacement | Notes |
| ---------------- | -------------- | ----------- | ----- |
| `@angular/router`| `NavigationExtras#preserveQueryParams` | no action needed | NavigationExtras#preserveQueryParams has been removed from `@angular/router`.|
| `@angular/core` | `CollectionChangeRecord` | no action needed | CollectionChangeRecord has been removed from `@angular/core`.|
| `@angular/core` | `ViewEncapsulation.Native` | no action needed | Angular previously supported a view encapsulation mode `ViewEncapsulaion.Native` that was based on the v0 Shadow DOM Draft APIs. These APIs have been superceeded by the final Shadow DOM APIs, which are enabled via `ViewEncapsulation.ShadowDom`. For background information about this change, see [Web Components update: more time to upgrade to v1 APIs](https://developers.google.com/web/updates/2019/07/web-components-time-to-upgrade).|

{@a ivy}

## Ivy features and compatibility

Since version 9, Angular Ivy is the default rendering engine. If you haven't heard of Ivy, you can read more about it in the [Angular Ivy guide](guide/ivy).

* Among other features, Ivy introduces more comprehensive type-checking within templates. For details, see [Template Type-checking](guide/template-typecheck).

* For general guidance on debugging and a list of minor changes associated with Ivy, see the [Ivy compatibility guide](guide/ivy-compatibility).

* For help with opting out of Ivy, see the instructions [here](guide/ivy#opting-out-of-angular-ivy).
68 changes: 68 additions & 0 deletions aio/content/guide/updating-to-version-11.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
# Actualizando a la versión 11

Esta guía contiene información relacionada para actualizar tus aplicaciones a la versión más reciente de Angular.

## Actualización de aplicaciones usando la CLI

Las instrucciones paso a paso para actualizar tus aplicaciones a la versión más reciente de Angular(aprovechando nuestras herramientas de migración automatizadas), es usando nuestra guía interactiva: [update.angular.io](https://update.angular.io).

## Cambios y obsolescencias en la Versión 11

<div class="alert is-helpful">

Para más información sobre el proceso de remoción u obsolescencia en Angular, consulta [Prácticas de liberación de Angular](guide/releases#deprecation-practices "Angular Release Practices: Deprecation practices").

</div>

{@a breaking-changes}
### Nuevos cambios importantes

* Se deja de dar soporte a IE 9, 10, y a IE mobile. Para más detalle, consulta [PR 38931](https://github.com/angular/angular/pull/38931).
* Ya no hay soporte para TypeScript 3.9. Por favor actualiza a TypeScript 4.0. Para más detalle, consulta [PR 39313](https://github.com/angular/angular/pull/39313).
* `NavigationExtras#preserveQueryParams` ha sido eliminado de `@angular/router`. Para más detalle, consulta [PR 38762](https://github.com/angular/angular/pull/38762)
* `CollectionChangeRecord` ha sido eliminado de `@angular/core`. Para más detalle consulta [PR 38668](https://github.com/angular/angular/pull/38668).
* Cambiamos el valor predeterminado para `relativeLinkResolution` de `'legacy'` a `'corrected'` de tal modo que las nuevas aplicaciones eligan de forma automática el comportamiento correcto de la navegación de rutas vacías aninadas [PR 22394](https://github.com/angular/angular/pull/22394). Las aplicaciones que utilizan el valor predeterminado (deafult), se actualizan mediante una migración que especifique "legacy" y así garantice mantener el comportamiento adecuado. Para más detalle, consulta [PR 25609](https://github.com/angular/angular/pull/25609).
* Se corrigió un bug en el enrutador donde los argumentos para las snapshots `future` y `curr` se inviertieron en la llamada a `shouldReuseRoute` al procesar rutas secundarias. Por lo general este error de orden no importa porque la mayoría de las implementaciones de [`shouldReuseRoute`](api/router/RouteReuseStrategy#shouldReuseRoute), solo hacen una comparación de igualdad entre `future` y `curr`. Sin embargo, algunas implementaciones realmente se basan específicamente en el valor de uno de los dos y por tanto, deberá actualizarse. Para más detalle, consulta [PR 26949](https://github.com/angular/angular/pull/26949).
* `ViewEncapsulation.Native` ha sido eliminado. Anteriormente Angular admitía un modo encapsulado de vista `ViewEncapsulaion.Native` que se basaba en la v0 de APIs del Shadow DOM Draft. Estas APIs han sido reemplazadas por las APIs actualizadas del Shadow DOM, y que ahora están habilitadas en el `ViewEncapsulation.ShadowDom`. Para más información sobre este cambio, consulta [Actualización de Componentes Web: actualice las APIs a la v1 ](https://developers.google.com/web/updates/2019/07/web-components-time-to-upgrade).
* `@angular/platform-webworker` ha sido eliminado, ya no será compatible. Para más detalle, consulta [PR 38846](https://github.com/angular/angular/pull/38846).
* `@angular/platform-webworker` ya no es compatible. No habrá más versiones. Para más detalle, consulta [PR 38846](https://github.com/angular/angular/pull/38846).
* Actualizadas las opciones para `initialNavigation`. Para más información, consulta [initialNavigation](api/router/InitialNavigation) la documentación de la API. Consulta [PR 33128](https://github.com/angular/angular/pull/33128).
* `DatePipe` ya no redondea fracciones de milisegundos. Para más detalle, consulta [PR 38009](https://github.com/angular/angular/pull/38009).
* Los arrays locales, ahora son de solo lectuta. Para más detalle, consulta [PR 30397](https://github.com/angular/angular/pull/30397).
* El `ControlValueAccessor` inyectado para `NG_VALUE_ACCESSOR` ahora es de solo lectura. Para más detalle, consulta [PR 29273](https://github.com/angular/angular/pull/29723).
* El tipo de `AbstractControl#parent` ahora indica que puede ser nulo. Para más detalle, consulta [PR 32671](https://github.com/angular/angular/pull/32671).
* Llamar a `overrideProvider` antes de inicializar el TestBed, ahora arrojará error. Para más detalle, consulta [PR 38717](https://github.com/angular/angular/pull/38717).
* Muchos de los pipes integrados en Angular se han ampliado o reducido para ser más claros. Para más información, consulta [Pipes](https://angular.io/api?type=pipe) la documentación de la API. Ver [PR 37447](https://github.com/angular/angular/pull/37447).
* Las directivas del paquete `@angular/forms` solía tener `any[]` como argumentos a los validators y a los asyncValidators en los constructores. Ahora estos argumentos están mejor escritos, por lo que si su código se basa en estos tipos de argumentos en los constructores, ahora se actualizan los tipos para hacerlos coherentes a las directivas. Para más detalle, consulta [PR 38994](https://github.com/angular/angular/pull/38944).
* `routerLink` ahora acepta entradas `undefined`. Para más información, consulta [PR 39151](https://github.com/angular/angular/pull/39151).
* La función `async` de `@angular/core/testing` se renombró a `waitForAsync` para evitar confusiones con la sintaxis nativa `async` de JavaScript. Dicha función se ha vuelto obsoleta y se eliminará en una futura versión. Para más detalle, consulta [PR 37583](https://github.com/angular/angular/pull/37583).

{@a deprecations}
### Nuevas obsolescencias

| Area | API o Característica | Se elimina en |
| ----------------------------- | -------------------------------------------------- | ----------------- |
| `@angular/core/testing` | Renombrado `async` a `waitForAsync` | <!--v11--> v13 |


{@a removals}
### APIs eliminadas por desuso

Las siguientes APIs se eliminaron a partir de la versión 11.0.0*:

| Paquete | API | Reemplazo | Notas |
| ---------------- | -------------- | ----------- | ----- |
| `@angular/router`| `NavigationExtras#preserveQueryParams` | No es necesaria alguna acción | NavigationExtras#preserveQueryParams ha sido eliminado de `@angular/router`.|
| `@angular/core` | `CollectionChangeRecord` | No es necesaria alguna acción | CollectionChangeRecord ha sido eliminado de `@angular/core`.|
| `@angular/core` | `ViewEncapsulation.Native` | No es necesaria alguna acción | Anteriormente Angular admitía un modo encapsulado de vista `ViewEncapsulaion.Native` que se basaba en la v0 de APIs del Shadow DOM Draft. Estas APIs han sido reemplazadas por las APIs actualizadas del Shadow DOM, y que ahora están habilitadas en el `ViewEncapsulation.ShadowDom`. Para más información sobre este cambio, counsulta [Actualización de Componentes Web: actualice las APIs a la v1](https://developers.google.com/web/updates/2019/07/web-components-time-to-upgrade).|

{@a ivy}
## Características compatibles del Ivy

Desde la versíon 9, Ivy es el motor de renderizado por defecto de Angular. Si no has escuchado hablar de Ivy, puedes leer al respecto en [La guía de Ivy de Angular](guide/ivy).

* Entre otras características, Ivy introduce una verificación de tipo de plantilla más completa. Para más detalle, consulta [Verificación de tipo de plantilla](guide/template-typecheck).

* Para obtener una guía general sobre la depuración y la lista de cambios menores relacionados al Ivy, ver la [Guía de compatibilidad de Ivy](guide/ivy-compatibility).

* Si necesitas ayuda para deshabilitar Ivy, consulta las instrucciones [aquí](guide/ivy#opting-out-of-angular-ivy).