angular-cn/docs
Alex Rickabaugh d4cee514f6 refactor(ivy): obviate the Bazel component of the ivy_switch (#26550)
Originally, the ivy_switch mechanism used Bazel genrules to conditionally
compile one TS file or another depending on whether ngc or ngtsc was the
selected compiler. This was done because we wanted to avoid importing
certain modules (and thus pulling them into the build) if Ivy was on or
off. This mechanism had a major drawback: ivy_switch became a bottleneck
in the import graph, as it both imports from many places in the codebase
and is imported by many modules in the codebase. This frequently resulted
in cyclic imports which caused issues both with TS and Closure compilation.

It turns out ngcc needs both code paths in the bundle to perform the switch
during its operation anyway, so import switching was later abandoned. This
means that there's no real reason why the ivy_switch mechanism needed to
operate at the Bazel level, and for the ivy_switch file to be a bottleneck.

This commit removes the Bazel-level ivy_switch mechanism, and introduces
an additional TypeScript transform in ngtsc (and the pass-through tsc
compiler used for testing JIT) to perform the same operation that ngcc
does, and flip the switch during ngtsc compilation. This allows the
ivy_switch file to be removed, and the individual switches to be located
directly next to their consumers in the codebase, greatly mitigating the
circular import issues and making the mechanism much easier to use.

As part of this commit, the tag for marking switched variables was changed
from __PRE_NGCC__ to __PRE_R3__, since it's no longer just ngcc which
flips these tags. Most variables were renamed from R3_* to SWITCH_* as well,
since they're referenced mostly in render2 code.

Test strategy: existing test coverage is more than sufficient - if this
didn't work correctly it would break the hello world and todo apps.

PR Close #26550
2018-10-19 09:23:05 -07:00
..
BAZEL.md refactor(ivy): obviate the Bazel component of the ivy_switch (#26550) 2018-10-19 09:23:05 -07:00
CARETAKER.md docs: fix script path reference (#25552) 2018-08-17 10:26:10 -07:00
COMMITTER.md build: Add GitHub scripts for rebasing PRs (#18359) 2017-08-28 18:44:39 -05:00
DEBUG.md test: support debugging unit tests in node (#18987) 2017-09-01 15:06:40 -05:00
DEVELOPER.md docs: adds information about the VSCode clang-format extension (#24351) 2018-06-08 16:35:05 -07:00
NAMING.md docs: fix spelling of case variants in naming.md 2017-06-26 13:43:37 -07:00
PR_REVIEW.md ci: scripts to review PRs locally (#24623) 2018-06-25 08:45:12 -07:00
PUBLIC_API.md docs: update PUBLIC_API.md with the latest list of packages and clarifications 2018-05-02 16:23:47 -07:00
RELEASE_SCHEDULE.md docs: change release_schedule.md to link to new angular release page in docs (#23808) 2018-05-10 15:45:28 -07:00
SAVED_REPLIES.md docs: replace plnkr with StackBlitz (#20365) 2018-02-16 15:12:10 -08:00
TOOLS.md docs: enable debug tools with current versions of Angular (#25361) 2018-08-14 16:38:26 -07:00
TRIAGE_AND_LABELS.md docs(elements): mention `comp: elements` as a valid label (#24443) 2018-06-25 07:56:14 -07:00