GetSpectNetIde.md

Get the ZX Spectrum IDE

← Contents

This project contains several Visual Studio 2017 packages. To be able to compile and run the project, you need to install the Visual Studio extension development workload:

1. Start the Visual Studio 2017 IDE
2. With the Tools|Get Tools and Features command, launch the Visual Studio Installer.
3. Make sure to select the Visual Studio extension development workload, and the .NET Framework 4.7 development tools component.

4. Click the Modify button. (Note: You need to close the VS 2017 IDE while the installer runs.)

Obtain and Run the Source Code

1. Get the source code from this Github repository:

git clone https://github.com/Dotneteer/spectnetide.git

2. Open the Spect.Net.sln solution file in Visual Studio 2017.
3. Create the artifacts with the Build|Rebuild Solution command. (Note: The first time it might take time while VS loads the required NuGet packages.)
4. In Solution Explorer, use the context menu to set the Spect.Net.VsPackage project in the VsIntegration folder as the startup project.
5. Go to the Properties page of the Spect.Net.VsPackage project, and in the Debug tab set the VS 2017 devenv.exe file to run with the /rootsuffix Exp command line. This setting takes care starting the Visual Studio Experimental Instance with the ZX Spectrum IDE loaded.
6. Use the Debug|Start Without Debugging command (Ctrl+F5) to run the project. (Note: Do not use the Start Debugging command unless you need it. Without debugging VS 2017 will start much faster.)

Create Your First ZX Spectrum Project

After the VS IDE (Experimental Instance) starts, you cannot see any new menu telling you that the ZX Spectrum IDE is loaded. However, in the Help|About dialog, you can see that the package is now active:

To display the ZX Spectrum related menus, first create a ZX Spectrum project.

← Contents | → Create Your First ZX Spectrum Project