{"id":15361,"date":"2019-04-03T08:00:14","date_gmt":"2019-04-03T16:00:14","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/setup\/?p=15361"},"modified":"2020-03-02T05:18:51","modified_gmt":"2020-03-02T13:18:51","slug":"configure-visual-studio-across-your-organization-with-vsconfig","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/setup\/configure-visual-studio-across-your-organization-with-vsconfig\/","title":{"rendered":"Configure Visual Studio across your organization with .vsconfig"},"content":{"rendered":"

As application requirements grow more complex, so do our solutions. Keeping developers’ environments configured across our organizations grows equally complex. Developers need to install specific workloads and components in order to build a solution. Some organizations add these requirements to their README or CONTRIBUTING documents in their repositories. Some organizations might publish these requirements in documents for new hires or even just forward emails. Configuring your development environment often becomes a day-long chore. What’s really needed is a declarative authoring model that just configures Visual Studio like you need it.<\/p>\n

In Visual Studio 2017 Update 15.9 we added the ability to export and import workload and component selection to a Visual Studio installation configuration file. Developers can import these files into new or existing installations. Checking these files into your source repos makes them easy to share. However, developers still need to import these to get the features they need.<\/p>\n

Automatically install missing components<\/h2>\n

New in Visual Studio 2019<\/a>: you can save these files as .vsconfig files in your solution root directory and when the solution (or solution directory) is opened, Visual Studio will automatically detect which components are missing and prompt you to install them.<\/p>\n

\"Installing<\/p>\n

You can find an example<\/a> of this in the vswhere<\/a> repo on GitHub. When you click the\u00a0Install<\/strong> link, you’re prompted to install any missing components. You can click the\u00a0View full installation details<\/strong> link if you’d like to select additional components.<\/p>\n

\"Install \"Installing<\/p>\n

Exporting your configuration<\/h2>\n

In Visual Studio 2019, you can create a .vsconfig file right from Solution Explorer:<\/p>\n

    \n
  1. Right-click on your solution.<\/li>\n
  2. Click\u00a0Add > Installation Configuration File<\/strong><\/li>\n
  3. Confirm the location where you want to save the .vsconfig file (defaults to your solution root directory).<\/li>\n
  4. Click\u00a0Review details<\/strong><\/li>\n
  5. Select or deselect any changes you want to make and click\u00a0Export<\/strong><\/li>\n<\/ol>\n

    To help keep the installation footprint minimal, only export those components you know you need to build, test, and possibly publish your solution. One way you can do this is to install a second instance of Visual Studio or install into a virtual machine, add those workloads and optional components you know are necessary, and build and test your solution. Add components as needed until the solution builds successfully, then export your configuration.<\/p>\n

    For more details, see our documentation<\/a>.<\/p>\n

    Feedback<\/h2>\n

    We love to hear your feedback! You can report a problem<\/a> or make suggestions<\/a> for this or any other feature in Visual Studio on our Developer Community<\/a> site.<\/p>\n

     <\/p>\n","protected":false},"excerpt":{"rendered":"

    Add a .vsconfig file to your solution root directory to configure Visual Studio consistently across your organization.<\/p>\n","protected":false},"author":389,"featured_media":15362,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[14,20,45,57,119],"class_list":["post-15361","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized","tag-development","tag-installation","tag-visual-studio","tag-vs2017","tag-vs2019"],"acf":[],"blog_post_summary":"

    Add a .vsconfig file to your solution root directory to configure Visual Studio consistently across your organization.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/posts\/15361","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/users\/389"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/comments?post=15361"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/posts\/15361\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/media\/15362"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/media?parent=15361"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/categories?post=15361"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/setup\/wp-json\/wp\/v2\/tags?post=15361"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}