Skip to content

Latest commit

 

History

History
103 lines (65 loc) · 4.92 KB

dev.md

File metadata and controls

103 lines (65 loc) · 4.92 KB
Raw

CodeStream for Visual Studio

Getting the code

git clone https://github.com/TeamCodeStream/codestream.git

Prerequisites

  • Windows 10
  • Visual Studio 2017
  • Git
  • NodeJS, >= 8.9.1, < 9.0.0
  • npm, >= 6.2.0
  • License for https://www.teamdev.com/dotnetbrowser (it must put into the git-ignored folder \licenses\{Configuration} where {Configuration} is Debug (dev license) or Release (runtime license)). It will be picked up by msbuild and put into the correct location. These licenses should not be commited to source control

Build (local)

  1. From a terminal, where you have cloned the codestream repository, cd to shared/agent and execute the following command to re-build the agent from scratch:

    npm run rebuild

    Or to just run a quick build, use:

    npm run build

Watch (Agent only)

During development you can use a watcher to make builds on changes quick and easy. From a terminal, where you have cloned the codestream repository, cd to shared/agent execute the following command:

npm run watch

It will do an initial full build and then watch for file changes, compiling those changes incrementally, enabling a fast, iterative coding experience.

Debugging

Using Visual Studio

  1. Ensure that the agent has been build or that the watcher is running (see the Watch section above)
  2. Open the solution (vs/src/CodeStream.VisualStudio.sln),
  3. Press F5 to build and run the solution. This will open a new "experimental" version of Visual Studio.

NOTE: you cannot have the CodeStream for VS extension installed from the marketplace AND run an experimental debugging instance of VS (you have to uninstall the version from the store first)

Build (CI)

cd build
.\Pre-Build.ps1
.\Bump-Version.ps1 -BuildNumber $env:build_number  -BumpBuild
.\Build.ps1

The build portion of the artifact version can be updated using .\Bump-Version.ps1 -BuildNumber 666 -BumpBuild. this will convert 0.1.0 to 0.1.0.666

Releasing

To create a local release artifact. From PowerShell, run

cd vs\build
.\Release.ps1

Under the hood this calls Bump-Version.ps1 and Build.ps1. These can be run separately if necessary

By default Release.ps1 will bump the Minor version of the package (the version lives in three spots: manifest, AssemblyInfo, SolutionInfo).

Build.ps1 will restore, build, unit test, and generate all output in \build\artifacts\{Platform}\{Configuration}. The resulting extension artifact in that directory is called codestream-vs.vsix

Notes

Language Server

CodeStream.VisualStudio uses an LSP client library from Microsoft. There are some caveats to using it -- as it is only allowed to be instantiated after a certain file (content) type is opened in the editor.

This sample creates a mock language server using the common language server protocol and a mock language client extension in Visual Studio. For more information on how to create language server extensions in Visual Studio, please see here.

Related topics

Menu and Commands

Menus are attached to the VisualStudio shell with a .vsct file. Here, they are contained in the CodeStreamPackage.vsct file. It is a very fragile file: there is no intellisense, and any issues won't be known until runtime -- there will be no errors, just that the menus won't show up! It's highly recommend to install Mads Kristensen's ExtensibilityTools (see Tools). It will give intellisense, as well as a way to synchronize all the names/guids with a .cs file (ours is CodeStreamPackageVSCT.cs)

Issues

  • Occassionaly, VisualStudio will alert an error message with a path to a log file ending with ActivityLog.xml. This is usually a result of a MEF component not importing correctly. The path to the log file will be something like C:\Users\{user}\AppData\Roaming\Microsoft\VisualStudio\{VisualStudioVersion}\ActivityLog.xml. Be sure to open that file with Internet Explorer, as it will format it nicely as html.
  • Related, MEF can get into a bad state and clearing the MEF cache can sometimes resolve issues where Exported/Imported components are failing. See Tools.

Tools

Highly recommend installing: https://marketplace.visualstudio.com/items?itemName=MadsKristensen.ExtensibilityTools (Clearing MEF cache, VSCT support)