Build Instructions

To build Visual Studio Extension for Lua on your own PC, for example to pick up the latest bug fixes, make modifications, or contribute back to the project, please use the following instructions.

Cloning

First, you will require a local copy of our Git repository.

If you do not want to use Git, you can download the latest commit as a ZIP file from the GitHub page.

Prerequisites

You'll need VS 2015 to build Visual Studio Extension for Lua for VS 2015.

Software	Download
Microsoft Visual Studio Community	Download here. Include the optional feature, Visual Studio Extensibility Tools, during installation. You can find them under Features / Common Tools / Visual Studio Extensibility Tools.

Building with Visual Studio

Lua.sln* can be opened and built in Visual Studio using the Build Solution command.

The project has a dependency on Visual Studio Project System Nuget. You can get it from https://www.nuget.org/packages/Microsoft.VisualStudio.ProjectSystem/14.0.50729-pre.

In order to show the "lua debugger", you need to copy ImportBefore and ImportAfter folder into [msbuild]\Microsoft.Cpp\v4.0\V140\Platforms[Platform].

To debug, ensure that ProjectLauncher is selected as the startup project. In Project->Properties->Debug page, select Start external program and choose devenv.exe. In the Start Options panel, set Command line arguments to -rootSuffix exp and use F5.

If an error appears rather than a new instance of VS, ensure the Project|Debug settings are correct.

Building in Visual Studio may produce a number of warnings related to potentially incompatible assemblies and missing references. As long as all projects build successfully, these warnings are benign and can be ignored.