This document is no longer applicable to Starcounter.VisualStudio v3.0.0. To read more about the changes, please refer to the Announcement.

General

It's important to use a version of the Visual Studio extension that is compatible with the installed version of Starcounter. Here's the compatibility chart:

Starcounter 2.0.* => 2.3.*	Starcounter 2.4.*
Extension >= 1.0 < 2.*	Extension >= 2.*

Incompatible versions will result in errors building your project. Read further for more information.

Troubleshooting

Building my project fails

If building your project fails with a message pointing you here, indicating some incompatibility, and if ...

• ...you have Starcounter 2.3 (or lower) installed:

  • You probably created your project using 2.x of the extension - your project is incompatible with 2.4.
  • You can easily adapt. Compare section Create a Starcounter application using standard templates in 2.4 to 2.3 and adjust your project accordingly.

• ...you have Starcounter 2.4 (or higher) installed:

  • You probably created your project using 1.x of the extension, or
  • You created the project manually, and did not add the required <StarcounterVersionCompatibility> property.
  • You can easily adapt. Compare section Create a Starcounter application using standard templates in 2.4 to 2.3 and adjust your project accordingly.

I can't find version 2.x of the extension on the Visual Studio marketplace

That is because the Visual Studio marketplace only support a single version of any extension. The 1.x version the extension is targeting our stable releases, i.e. 2.2 and 2.3, hence that is the one we choose to expose.

When installing 2.4 (or higher), the extension package is part of the distribution. You can either get it from there, or fetch it from a NuGet package, here. To install it:

1. First make sure you have uninstalled version 1.x of the extension (in Visual Studio: Tools | Extensions and Updates).
2. Double-click Starcounter.VS.vsix in the Starcounter installation directory and the extension installer will guide you.

How do I migrate a project from 2.[1-3] => 2.4 (or vice versa)

Compare differences between how to create a project without the templates in 2.4 to 2.3 and adjust your project accordingly.

Relation to branches

The code base for each extension version lives in separate branches:

• master branch: Choose this for extension version 1.x
• develop branch: Choose this for extension version 2.x