Permalink
c3d6111 Feb 26, 2018
@ralarcon @sibille @mrlacey @mbcrump @cliff-simpkins @crutkas
60 lines (36 sloc) 4.07 KB

Installing / Using the extension

Installing the Visual Studio Extension

Prerequisites

Windows Template Studio installs into your existing Windows 10 app development environment. If you're missing any of the below, you can get everything from the Windows Dev Center Download page.

  • Visual Studio 2017 Update 3 or higher (any edition) - Although VS 2017.3 is the minimum version, we recommend using WTS with the latest Visual Studio Update.
  • Windows 10 Creators Update SDK (version 10.0.15063.0 or later)
  • .Net Framework 4.7
  • Windows Template Studio extension. You have two ways of aquiring the extension.
    • Inside Visual Studio. Select Tools→ Extensions & Updates. Select the 'Online' node and search for Windows Template Studio then click Download
    • Direct link and manually install. Visual Studio Gallery

Public Release instructions

  1. Install the Visual Studio Extension for Windows Template Studio by downloading the VSIX from the Visual Studio Gallery.
  2. Once installed, open Visual Studio 2017 and select File→ New Project→ C# → Windows Universal and you should see Windows Template Studio as an option.
  3. To add pages and features to an existing Windows Template Studio project, select the project and choose Windows Template Studio → New page or New feature from the context menu. For more info on adding new items see here. Add new Page/Feature

Nightly / Pre-release feeds for Windows Template Studio

Nightly / Pre-release instructions

The Pre-release build version allows you to get updates with stable features not officially released yet (so, they are not definitive and may change). This build starts at 3AM GMT every night.

This feed will have stable extension versions so it is not thought to have breaking changes (and can be installed side by side with the official one), anyway, installing this extension is at your own risk.

Open Visual Studio 2017 and go to Tools→ Extensions & Updates, then click on Change your Extensions and Updates settings (bottom left of the 'Extensions and Updates' window) and create an Additional Extension Gallery.

Configure Additional Extension Gallery

Then, go again to Tools→ Extensions & Updates and using the recently added online gallery (added under the 'Online' node), download and install the Windows Template Studio extension. Note that you will likely need to restart Visual Studio for the install to complete.

Install UWP Community Templates extension

Once installed, you will see a new Project Template which allows you to access to the available templates: Pre-Release version uses the VNext Template Repository.

File New Project

You can start working with Windows Template Studio by cloning our repo and working locally with the code and the available templates. If you plan to contribute, please follow the contribution guidelines

Nightly Dev-release

If you want to have updates from in-progress changes. This feed will have the result of the daily dev-branch integration so expect some instability. This extension can be installed side by side with the official and pre-release, anyway, installing this extension is at your own risk.

Table of Contents