diff --git a/.configurations/configuration.dsc.yaml b/.configurations/configuration.dsc.yaml new file mode 100644 index 0000000000..eb1da01f4e --- /dev/null +++ b/.configurations/configuration.dsc.yaml @@ -0,0 +1,29 @@ +# yaml-language-server: $schema=https://aka.ms/configuration-dsc-schema/0.2 +# Reference: https://github.com/microsoft/winget-cli-restsource#building-the-client +properties: + resources: + - resource: Microsoft.Windows.Developer/DeveloperMode + directives: + description: Enable Developer Mode + allowPrerelease: true + settings: + Ensure: Present + - resource: Microsoft.WinGet.DSC/WinGetPackage + id: vsPackage + directives: + description: Install Visual Studio 2022 (any edition is OK) + allowPrerelease: true + settings: + id: Microsoft.VisualStudio.2022.Community + source: winget + - resource: Microsoft.VisualStudio.DSC/VSComponents + dependsOn: + - vsPackage + directives: + description: Install required VS workloads from project .vsconfig file + allowPrerelease: true + settings: + productId: Microsoft.VisualStudio.Product.Community + channelId: VisualStudio.17.Release + vsConfigFile: '${WinGetConfigRoot}\..\.vsconfig' + configurationVersion: 0.2.0 \ No newline at end of file diff --git a/.github/actions/spelling/expect.txt b/.github/actions/spelling/expect.txt index 0a7d79857c..c6f6ba6fd9 100644 --- a/.github/actions/spelling/expect.txt +++ b/.github/actions/spelling/expect.txt @@ -91,6 +91,7 @@ debian deigh deleteifnotneeded desktopappinstaller +devhome dic diskfull dismapi diff --git a/README.md b/README.md index 86331bc7d6..07fba52ca7 100644 --- a/README.md +++ b/README.md @@ -79,6 +79,11 @@ The client is built around the concept of sources; a set of packages effectively ## Building the client +1. Clone the repository +2. Configure your system, please use the [configuration file](.configurations/configuration.dsc.yaml). This can be applied by either: + * [Dev Home](https://github.com/microsoft/devhome)'s machine configuration tool + * WinGet configuration. If you have the experimental feature enabled, run `winget configure .configurations/configuration.dsc.yaml` from the project root so relative paths resolve correctly + ### Prerequisites * Windows 10 1809 (17763) or later