// Copyright (c) .NET Foundation and contributors. All rights reserved. // Licensed under the MIT license. See LICENSE file in the project root for full license information. using System; using System.Collections.Generic; using Microsoft.Build.Construction; using Microsoft.DotNet.ProjectModel; using Microsoft.DotNet.ProjectModel.Graph; using Microsoft.DotNet.Cli; using System.Linq; using System.IO; using Microsoft.DotNet.ProjectJsonMigration.Rules; using Microsoft.DotNet.Tools.Common; namespace Microsoft.DotNet.ProjectJsonMigration { public class ProjectMigrator { // TODO: Migrate PackOptions // TODO: Migrate Multi-TFM projects // TODO: Tests // TODO: Out of Scope // - Globs that resolve to directories: /some/path/**/somedir // - Migrating Deprecated project.jsons private readonly IMigrationRule _ruleSet; private readonly ProjectDependencyFinder _projectDependencyFinder = new ProjectDependencyFinder(); public ProjectMigrator() : this(new DefaultMigrationRuleSet()) { } public ProjectMigrator(IMigrationRule ruleSet) { _ruleSet = ruleSet; } public void Migrate(MigrationSettings rootSettings, bool skipProjectReferences = false) { if (rootSettings == null) { throw new ArgumentNullException(); } MigrateHelper(rootSettings); if (skipProjectReferences) { return; } var projectDependencies = ResolveTransitiveClosureProjectDependencies(rootSettings.ProjectDirectory); foreach(var project in projectDependencies) { var projectDir = Path.GetDirectoryName(project.ProjectFilePath); var settings = new MigrationSettings(projectDir, projectDir, rootSettings.SdkPackageVersion, rootSettings.MSBuildProjectTemplate); MigrateHelper(settings); } } private IEnumerable ResolveTransitiveClosureProjectDependencies(string rootProject) { HashSet projectsMap = new HashSet(new ProjectDependencyComparer()); var projectContexts = ProjectContext.CreateContextForEachFramework(rootProject); var projectDependencies = _projectDependencyFinder.ResolveProjectDependencies(projectContexts); Queue projectsQueue = new Queue(projectDependencies); while(projectsQueue.Count() != 0) { var projectDependency = projectsQueue.Dequeue(); if (projectsMap.Contains(projectDependency)) { continue; } projectsMap.Add(projectDependency); projectContexts = ProjectContext.CreateContextForEachFramework(projectDependency.ProjectFilePath); projectDependencies = _projectDependencyFinder.ResolveProjectDependencies(projectContexts); foreach(var project in projectDependencies) { projectsQueue.Enqueue(project); } } return projectsMap; } private void MigrateHelper(MigrationSettings migrationSettings) { var migrationRuleInputs = ComputeMigrationRuleInputs(migrationSettings); if (IsMigrated(migrationSettings, migrationRuleInputs)) { // TODO : Adding user-visible logging return; } VerifyInputs(migrationRuleInputs, migrationSettings); SetupOutputDirectory(migrationSettings.ProjectDirectory, migrationSettings.OutputDirectory); _ruleSet.Apply(migrationSettings, migrationRuleInputs); } private MigrationRuleInputs ComputeMigrationRuleInputs(MigrationSettings migrationSettings) { var projectContexts = ProjectContext.CreateContextForEachFramework(migrationSettings.ProjectDirectory); var xprojFile = migrationSettings.ProjectXProjFilePath ?? FindXprojFile(migrationSettings.ProjectDirectory); ProjectRootElement xproj = null; if (xprojFile != null) { xproj = ProjectRootElement.Open(xprojFile); } var templateMSBuildProject = migrationSettings.MSBuildProjectTemplate; if (templateMSBuildProject == null) { throw new Exception("Expected non-null MSBuildProjectTemplate in MigrationSettings"); } var propertyGroup = templateMSBuildProject.AddPropertyGroup(); var itemGroup = templateMSBuildProject.AddItemGroup(); return new MigrationRuleInputs(projectContexts, templateMSBuildProject, itemGroup, propertyGroup, xproj); } private string FindXprojFile(string projectDirectory) { var allXprojFiles = Directory.EnumerateFiles(projectDirectory, "*.xproj", SearchOption.TopDirectoryOnly); if (allXprojFiles.Count() > 1) { MigrationErrorCodes .MIGRATE1017($"Multiple xproj files found in {projectDirectory}, please specify which to use") .Throw(); } return allXprojFiles.FirstOrDefault(); } private void VerifyInputs(MigrationRuleInputs migrationRuleInputs, MigrationSettings migrationSettings) { VerifyProject(migrationRuleInputs.ProjectContexts, migrationSettings.ProjectDirectory); } private void VerifyProject(IEnumerable projectContexts, string projectDirectory) { if (!projectContexts.Any()) { MigrationErrorCodes.MIGRATE1013($"No projects found in {projectDirectory}").Throw(); } var defaultProjectContext = projectContexts.First(); var diagnostics = defaultProjectContext.ProjectFile.Diagnostics; if (diagnostics.Any()) { MigrationErrorCodes.MIGRATE1011( $"{projectDirectory}{Environment.NewLine}{string.Join(Environment.NewLine, diagnostics.Select(d => FormatDiagnosticMessage(d)))}") .Throw(); } var compilerName = defaultProjectContext.ProjectFile.GetCompilerOptions(defaultProjectContext.TargetFramework, "_") .CompilerName; if (!compilerName.Equals("csc", StringComparison.OrdinalIgnoreCase)) { MigrationErrorCodes.MIGRATE20013( $"Cannot migrate project {defaultProjectContext.ProjectFile.ProjectFilePath} using compiler {compilerName}").Throw(); } } private string FormatDiagnosticMessage(DiagnosticMessage d) { return $"{d.Message} (line: {d.StartLine}, file: {d.SourceFilePath})"; } private void SetupOutputDirectory(string projectDirectory, string outputDirectory) { if (!Directory.Exists(outputDirectory)) { Directory.CreateDirectory(outputDirectory); } if (projectDirectory != outputDirectory) { CopyProjectToOutputDirectory(projectDirectory, outputDirectory); } } private void CopyProjectToOutputDirectory(string projectDirectory, string outputDirectory) { var sourceFilePaths = Directory.EnumerateFiles(projectDirectory, "*", SearchOption.AllDirectories); foreach (var sourceFilePath in sourceFilePaths) { var relativeFilePath = PathUtility.GetRelativePath(projectDirectory, sourceFilePath); var destinationFilePath = Path.Combine(outputDirectory, relativeFilePath); var destinationDirectory = Path.GetDirectoryName(destinationFilePath); if (!Directory.Exists(destinationDirectory)) { Directory.CreateDirectory(destinationDirectory); } File.Copy(sourceFilePath, destinationFilePath); } } public bool IsMigrated(MigrationSettings migrationSettings, MigrationRuleInputs migrationRuleInputs) { var outputName = Path.GetFileNameWithoutExtension( migrationRuleInputs.DefaultProjectContext.GetOutputPaths("_").CompilationFiles.Assembly); var outputProject = Path.Combine(migrationSettings.OutputDirectory, outputName + ".csproj"); return File.Exists(outputProject); } } }