Method migrate

src/cdk/schematics/update-tool/index.ts:57–166

* Migrates the project to the specified target version. * @param migrationTypes Migrations that should be run. * @param target Version the project should be updated to. Can be `null` if the set of * specified migrations runs regardless of a target version. * @param data Upgrade data th

(
    migrationTypes: MigrationCtor<Data, Context>[],
    target: TargetVersion | null,
    data: Data,
    additionalStylesheetPaths?: string[],
    limitToDirectory?: string,
  )

   * @param limitToDirectory If specified, changes will be limited to the given directory.
   */
  migrate<Data>(
    migrationTypes: MigrationCtor<Data, Context>[],
    target: TargetVersion | null,
    data: Data,
    additionalStylesheetPaths?: string[],
    limitToDirectory?: string,
  ): {hasFailures: boolean} {
    limitToDirectory &&= this._fileSystem.resolve(limitToDirectory);

    // Create instances of the specified migrations.
    const migrations = this._createMigrations(migrationTypes, target, data);
    // Creates the component resource collector. The collector can visit arbitrary
    // TypeScript nodes and will find Angular component resources. Resources include
    // templates and stylesheets. It also captures inline stylesheets and templates.
    const resourceCollector = new ComponentResourceCollector(this._typeChecker, this._fileSystem);
    // Collect all of the TypeScript source files we want to migrate. We don't
    // migrate type definition files, or source files from external libraries.
    const sourceFiles = this._program.getSourceFiles().filter(f => {
      return (
        !f.isDeclarationFile &&
        (limitToDirectory == null ||
          this._fileSystem.resolve(f.fileName).startsWith(limitToDirectory)) &&
        !this._program.isSourceFileFromExternalLibrary(f)
      );
    });

    // Helper function that visits a given TypeScript node and collects all referenced
    // component resources (i.e. stylesheets or templates). Additionally, the helper
    // visits the node in each instantiated migration.
    const visitNodeAndCollectResources = (node: ts.Node) => {
      migrations.forEach(r => r.visitNode(node));
      ts.forEachChild(node, visitNodeAndCollectResources);
      resourceCollector.visitNode(node);
    };

    // Walk through all source file, if it has not been visited before, and
    // visit found nodes while collecting potential resources.
    sourceFiles.forEach(sourceFile => {
      const resolvedPath = this._fileSystem.resolve(sourceFile.fileName);
      // Do not visit source files which have been checked as part of a
      // previously migrated TypeScript project.
      if (!this._analyzedFiles.has(resolvedPath)) {
        visitNodeAndCollectResources(sourceFile);
        this._analyzedFiles.add(resolvedPath);
      }
    });

    // Walk through all resolved templates and visit them in each instantiated
    // migration. Note that this can only happen after source files have been
    // visited because we find templates through the TypeScript source files.
    resourceCollector.resolvedTemplates.forEach(template => {
      // Do not visit the template if it has been checked before. Inline
      // templates cannot be referenced multiple times.
      if (template.inline || !this._analyzedFiles.has(template.filePath)) {
        migrations.forEach(m => m.visitTemplate(template));
        this._analyzedFiles.add(template.filePath);
      }
    });