project system

Система проекта .NET для Visual Studio

Выпускать	Строить	Согласие	Публиковать	Локализация
основной

Этот репозиторий содержит систему проекта .NET для Visual Studio, которая записана поверх структуры общей системы проектов (CPS). В Visual Studio 2017, Visual Studio 2019 и Visual Studio 2022 эта система проекта используется для .NET Core [SDK-стиль] (C#, F# и Visual Basic) и общих проектов (C# и Visual Basic). В долгосрочной перспективе эта система проекта будет основой для всех типов проектов C#, F# и Visual Basic. Список различий в функциях между системами проекта см. Сравнение функций.

Legacy C# и Visual Basic Project Systems ( CSPROJ.DLL и MSVBPRJ.DLL ) впервые поставляется с Visual Studio .NET .NET в 2002 году. Они хорошо послужили нам, но являются: являются:

• Родной и на основе COM
• Одиночная резьба и связанная с потоком пользовательского интерфейса
• Трудно продлить за пределы агрегации с помощью <ProjectTypeGuids> и подтех типов (ароматы)
• Отдельные реализации для проектов C# и Visual Basic

Текущая система проекта .NET:

• На основе управляемого и управляемого интерфейса
• Многопоточный, масштабируемый и отзывчивый
• Легко расширить и сочинять с помощью рамки управляемой расширяемости (MEF). Многие стороны, в том числе 3 -й стороны, могут внести свой вклад в одну систему проекта.
• Единственная реализация для проектов C#, F# и Visual Basic

Что такое система проекта?

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

Есть много технологий, которые собираются вместе, чтобы составить систему проекта .NET:

• MSBUILD предоставляет двигатель и формат файла сборки.
• SDK предоставляет интерфейс командной строки для строительства, работы и взаимодействия с проектами .NET, а также необходимых задач и целей MSBUILD.
• Общая проектная система предоставляет базовые строительные блоки для системы проекта, включая (но не ограничиваясь) дерево проектов, координации сборки и отладчика и интеграции Visual Studio.
• Roslyn предоставляет C# и Visual Basic Language, включая компиляторы, Intellisense, Refactorings, анализаторы и исправления кода.
• Visual F# Tools обеспечивает поддержку языка F#.

Как построить репозиторий?

Этот репозиторий построен на .NET Framework и требует успешного создания .NET Framework версии MSBUILD. Кроме того, существует зависимость от Visual Studio SDK, поскольку система проекта .NET связана с расширением Visual Studio для развертывания в Visual Studio.

Вот как приобрести необходимые компоненты:

• Установите последнюю визуальную студию
  • Выберите эти рабочие нагрузки во время установки:
    • .NET Desktop Tools
    • Разработка расширения Visual Studio

После установки необходимых компонентов просто запустите пакетный файл build.cmd в корне репозитория. Это будет строить, проверить и подчинить хранилище соответствующим образом.

Build.cmd Flags

Все аргументы командной строки, предоставленные для Build.cmd, отправляются в MSBuild. Есть некоторые специальные свойства, которые мы создали для создания этого репо.

• Для проектов:
  • /p:SrcProjects=[true or false] : включает проекты в каталоге SRC . По умолчанию: true
  • /p:TestProjects=[true or false] : включает проекты в каталоге Tests . По умолчанию: true
  • /p:SetupProjects=[true or false] : включает проекты в каталоге настройки . По умолчанию: true
• Для целей:
  • /p:Restore=[true or false] : запускает цель восстановления для получения зависимостей проекта. По умолчанию: true
  • /p:Build=[true or false] : запускает цель сборки для составления проектов в сборки. По умолчанию: true
  • /p:Rebuild=[true or false] : запускает цель перестройки , которая очищает и строит проекты. По умолчанию: false
  • /p:Test=[true or false] : запускает целевую тестовую цель для выполнения тестовых проектов XUNIT. По умолчанию: true
  • /p:Pack=[true or false] : запускает цель пакета , чтобы объединить проекты в пакеты Nuget. По умолчанию: true

Как мне вовлечь и внести свой вклад?

Мы приветствуем вас, чтобы попробовать что -то, подать проблемы, выполнять запросы на функции и присоединиться к нам в дизайнерских разговорах. Если вы ищете что -то, над чем можно поработать, взгляните на нашу помощь, желающую, чтобы вы могли начать. Кроме того, проверьте наше руководство.

Этот проект принял кодекс поведения, адаптированный из Завета участника, чтобы прояснить ожидаемое поведение в нашем сообществе. Этот кодекс поведения был принят многими другими проектами. Для получения дополнительной информации см. Кодекс поведения участников.

Товарные знаки

Этот проект может содержать товарные знаки или логотипы для проектов, продуктов или услуг. Уполномоченное использование товарных знаков или логотипов Microsoft подлежит и должно следовать указаниям Microsoft по товарной марке и брендам. Использование товарных знаков Microsoft или логотипов в модифицированных версиях этого проекта не должно вызывать путаницу или подразумевать спонсорство Microsoft. Любое использование сторонних товарных знаков или логотипов подвержена политике сторонних сторон.

Сбор данных

Программное обеспечение может собирать информацию о вас и использование программного обеспечения и отправить ее в Microsoft. Microsoft может использовать эту информацию для предоставления услуг и улучшения наших продуктов и услуг. Вы можете отключить телеметрию, как описано в «Программе улучшения опыта работы с клиентами Visual Studio». В программном обеспечении также есть некоторые функции, которые могут позволить вам и Microsoft собирать данные от пользователей ваших приложений. Если вы используете эти функции, вы должны соблюдать применимый закон, включая предоставление соответствующих уведомлений пользователям ваших приложений вместе с копией выписки Microsoft по конфиденциальности. Наше заявление о конфиденциальности находится по адресу https://go.microsoft.com/fwlink/?linkid=824704. Вы можете узнать больше о сборе данных и использовании в справочной документации и нашем заявлении о конфиденциальности. Использование вашего программного обеспечения работает как ваше согласие на эту практику.