project system

Le système de projet .NET pour Visual Studio

Libérer	Construire	Conformité	Publier	Localisation
principal

Ce référentiel contient le système de projet .NET pour Visual Studio qui est écrit au-dessus du cadre du système de projet commun (CPS). Dans Visual Studio 2017, Visual Studio 2019 et Visual Studio 2022, ce système de projet est utilisé pour les types de projets .NET Core [SDK-style] (C #, F # et Visual Basic) et les projets partagés (C # et Visual Basic). À long terme, ce système de projet sera la base de tous les types de projets C #, F # et Visual Basic. Pour une liste des différences de fonctionnalités entre les systèmes de projet, voir la comparaison des fonctionnalités.

L'héritage C # et Visual Basic Project Systems ( CSPROJ.DLL et MSVBPRJ.DLL ) a d'abord expédié avec Visual Studio .NET en 2002. Ils nous ont bien servi mais sont:

• Natif et basé
• Simple fileté et lié au fil d'interface utilisateur
• Difficile à s'étendre en dehors de l'agrégation via l'utilisation de <ProjectTypeGuids> et des sous-types (saveurs)
• Implémentations séparées pour les projets de base C # et Visual

Le système de projet .NET actuel est:

• Basé sur une interface gérée et gérée
• Multithread, évolutif et réactif
• Facile à étendre et à composer via le cadre d'extensibilité géré (MEF). De nombreuses parties, y compris les tiers, peuvent contribuer à un seul système de projet.
• Une seule implémentation pour les projets de base C #, F # et Visual

Qu'est-ce qu'un système de projet?

Un système de projet se situe entre un fichier de projet sur le disque (par exemple, .csproj et .vbproj ) et diverses fonctionnalités de Visual Studio, y compris, mais sans s'y limiter, l'explorateur de solutions, les concepteurs, le débogueur, les services linguistiques, la construction et le déploiement. Presque toutes les interactions qui se produisent avec les fichiers contenus dans un fichier de projet se produit via le système de projet.

Il existe de nombreuses technologies qui se réunissent pour composer le système de projet .NET:

• MSBuild fournit le moteur de construction et le format de fichier.
• SDK fournit l'interface de ligne de commande pour la construction, l'exécution et l'interaction avec les projets .NET, ainsi que les tâches et cibles MSBuild nécessaires.
• Common Project System fournit les éléments de base du système de projet, y compris (mais sans s'y limiter) l'arbre de projet, la coordination de la construction et le débogueur et l'intégration Visual Studio.
• Roslyn fournit un support de langue de base C # et visuel, y compris les compilateurs, l'intelligence, les refactorings, les analyseurs et les correctifs de code.
• Visual F # Tools fournit une prise en charge du langage F #.

Comment construire le référentiel?

Ce référentiel est construit sur .NET Framework et nécessite la version .NET Framework de MSBuild pour construire avec succès. De plus, il y a une dépendance à l'égard du SDK Visual Studio car le système de projet .NET est regroupé en tant qu'extension Visual Studio pour le déploiement dans Visual Studio.

Voici comment acquérir les composants nécessaires:

• Installez le dernier studio visuel
  • Sélectionnez ces charges de travail lors de l'installation:
    • Outils de construction de bureau .NET.
    • Développement d'extension Visual Studio

Une fois les composants nécessaires installés, exécutez simplement le fichier batch build.cmd à la racine du référentiel. Cela créera, testera et regroupera le référentiel de manière appropriée.

Build.cmd Flags

Tous les arguments de ligne de commande fournis à Build.cmd sont transmis à msbuild. Il y a des propriétés spéciales que nous avons créées pour construire ce dépôt.

• Pour les projets:
  • /p:SrcProjects=[true or false] : inclut les projets dans le répertoire SRC . Par défaut: true
  • /p:TestProjects=[true or false] : inclut les projets dans le répertoire des tests . Par défaut: true
  • /p:SetupProjects=[true or false] : inclut les projets dans le répertoire de configuration . Par défaut: true
• Pour les cibles:
  • /p:Restore=[true or false] : exécute la cible de restauration pour acquérir des dépendances du projet. Par défaut: true
  • /p:Build=[true or false] : exécute la cible de build pour compiler les projets en assemblages. Par défaut: true
  • /p:Rebuild=[true or false] : exécute la cible de reconstruction qui nettoie et construit les projets. Par défaut: false
  • /p:Test=[true or false] : exécute la cible de test pour exécuter les projets de test Xunit. Par défaut: true
  • /p:Pack=[true or false] : exécute la cible du pack pour regrouper les projets en packages NuGet. Par défaut: true

Comment m'engager et contribuer?

Nous vous invitons à essayer les choses, à déposer des problèmes, à faire des demandes de fonctionnalités et à nous joindre à nous dans des conversations de conception. Si vous cherchez quelque chose sur lequel travailler, jetez un œil à nos problèmes de recherche d'aide pour un endroit idéal pour commencer. Consultez également notre guide de contribution.

Ce projet a adopté un code de conduite adapté de l'alliance contributive pour clarifier le comportement attendu dans notre communauté. Ce code de conduite a été adopté par de nombreux autres projets. Pour plus d'informations, voir le code de conduite des contributeurs.

Marques

Ce projet peut contenir des marques ou des logos pour des projets, des produits ou des services. L'utilisation autorisée de marques ou de logos Microsoft est soumise et doit suivre les directives de marque et de marque de Microsoft. L'utilisation de marques ou de logos de Microsoft dans des versions modifiées de ce projet ne doit pas provoquer de confusion ou impliquer le parrainage de Microsoft. Toute utilisation de marques ou de logos tiers est soumis aux politiques de ces tiers.

Collecte de données

Le logiciel peut collecter des informations sur vous et votre utilisation du logiciel et les envoyer à Microsoft. Microsoft peut utiliser ces informations pour fournir des services et améliorer nos produits et services. Vous pouvez désactiver la télémétrie comme décrit dans "Visual Studio Customer Experience Improvement Program". Il existe également certaines fonctionnalités du logiciel qui peuvent permettre à vous et à Microsoft de collecter des données auprès des utilisateurs de vos applications. Si vous utilisez ces fonctionnalités, vous devez vous conformer à la loi applicable, y compris en fournissant des avis appropriés aux utilisateurs de vos applications ainsi qu'une copie de la déclaration de confidentialité de Microsoft. Notre déclaration de confidentialité est située sur https://go.microsoft.com/fwlink/?linkid=824704. Vous pouvez en savoir plus sur la collecte de données et l'utilisation dans la documentation d'aide et notre déclaration de confidentialité. Votre utilisation du logiciel fonctionne comme votre consentement à ces pratiques.