Запуск построения из интегрированной среды разработки

Пользовательские системы проектов должны использовать IVsBuildManagerAccessor для запуска сборок.В этом разделе объясняется необходимость соблюдения этого требования, а также общие принципы для этого действия.

Параллельные построения и потоки

Visual Studio допускает наличие параллельных сборок, которым для доступа к общим ресурсам требуется посредник.Системы проектов могут асинхронным образом запускать построения, но не должны вызывать функции построения из обратных вызовов, предоставленных в диспетчере построений.

Если система проектов изменяет переменные среды, то свойство построения NodeAffinity должно иметь значение OutOfProc.Из-за этого использование объектов узла невозможно, так как они требуют наличия внутрипроцессного узла.

Использование IVSBuildManagerAccessor

Следующий код представляет метод, который используется системой проектов для запуска построения:

public bool Build(Project project, bool isDesignTimeBuild)
{
    // Get the accessor from the IServiceProvider interface for the 
    // project system
    IVsBuildManagerAccessor accessor =
        serviceProvider.GetService(typeof(SVsBuildManagerAccessor)) as   
        IVsBuildManagerAccessor;
    bool releaseUIThread = false;
    try
    {
        if(accessor != null)
        {
            // Claim the UI thread under the following conditions:
            // 1. The build must use a resource that uses the UI thread
            // or,
            // 2. The build requires the in-proc node AND waits on the 
            // UI thread for the build to complete
            if(NeedsUIThread)
            {
                int result = accessor.ClaimUIThreadForBuild();
                if(result != S_OK)
                {
                     // Not allowed to claim the UI thread right now
                     return false;
                }
                releaseUIThread = true;
             }
             if(isDesignTimeBuild)
             {
// Start the design time build
                  int result = accessor.BeginDesignTimeBuild();
                  if(result != S_OK)
                  {
                      // Not allowed to begin a design-time build at
                      // this time. Try again later.
                      return false;
                  }
             }
         }
         bool buildSucceeded = false;
         // perform project-system specific build set up tasks
         // Create your BuildRequestData
         // This assumes a IHostServices variable (hostServices) set 
   // to your host services. If you don't use a project instance 
         // (you build from a file for example) then use another 
         // constructor.
         BuildRequestData requestData = new 
             BuildRequestData(project.CreateProjectInstance(), 
             "myTarget", hostServices, 
             BuildRequestData.BuildRequestDataFlags.None);
         // Mark your your submission as Pending
         BuildSubmission submission =
              BuildManager.DefaultBuildManager.
              PendBuildRequest(requestData);
         // Register the loggers in BuildLoggers
         if (accessor != null)
         {
               foreach (ILogger logger in BuildLoggers)
               {
                    accessor.RegisterLogger(submission.SubmissionId, 
                        logger);
               }
         }
         BuildResult buildResult = submission.Execute();
         return buildResult;
     }
     // Clean up resources
     finally
     {
         if(accessor != null)
         {
             // Unregister the loggers, if necessary.
             accessor.UnregisterLoggers(submission.SubmissionId);
             // Release the UI thread, if used
             if(releaseUIThread)
             {
                  accessor.ReleaseUIThreadForBuild();
             }
             // End the design time build, if used
             if(isDesignTimeBuild)
             {
                  accessor.EndDesignTimeBuild();
             }
         }
     }
}

См. также

Другие ресурсы

IVsBuildManagerAccessor