Release

This repository contains two releasable items:

1. @angular/language-server NPM package
   This is the LSP server integrated into other clients like vim, emacs, Eclipse, etc.
2. Angular.ng-template vscode extension
   This is published to the Visual Studio Marketplace.

Release Steps

1. Determine the next version (X.Y.Z) and the appropriate git branch.
   If publishing a patch version, checkout the patch branch, otherwise checkout the master branch.
2. Set a releaseVersion variable so you can more easily copy-paste commands:

   releaseVersion=X.Y.Z

3. Update version in package.json to releaseVersion.
4. Update version server/package.json to releaseVersion.
5. Manually update the version of @angular/language-service in package.json and server/package.json to the latest. The version in both files must be the same.
6. Look at the CHANGELOG in @angular/angular for commits related to language service, and copy them to this repo's CHANGELOG.
   Append notable commits in this repository, particularly fixes and features.
7. Update yarn.lock and node_modules to use the version of @angular/language-service specified in previous step.

   rm -rf node_modules server/node_modules
   yarn install

   • If you see the error Error installing vscode.d.ts: TypeError: Cannot set property 'Authorization' of null try running unset GITHUB_TOKEN, then installing again. The GITHUB_TOKEN will conflict with the installation of vscode.
8. Build the NPM package and vscode extension

   ./scripts/build.sh

9. Do a quick check to make sure everything works as expected.
   • Install the .vsix through either vscode or run

     code --install-extension dist/npm/ng-template-${releaseVersion}.vsix

   • Open the test project in vscode
   • Execute a few operations such as go to definition, hover, check semantics, and auto-complete.
   • Remember to try both View Engine and Ivy mode
10. Commit the changes, tag the release, and push to upstream:

    git commit -am "release: v${releaseVersion}"
    git tag v${releaseVersion}
    git push upstream && git push upstream --tags

11. Make sure you're logged into Angular NPM account. If not, run the following command:

    npm login --registry https://wombat-dressing-room.appspot.com

12. Release @angular/language-server

    npm publish dist/npm/server --access public

13. Make sure you're logged into Azure DevOps account. If not, follow the instructions below.
14. Release vscode extension from the root of the repository.

    yarn vsce publish --packagePath dist/npm/ng-template-${releaseVersion}.vsix

15. Update release notes in github.
    • Go to the Releases section
    • Navigate to the release that was published in the previous step.
    • Click edit release
    • Copy the text added to the CHANGELOG
    • Upload the .vsix file.
    • Click Update Release

Login to Azure DevOps

1. [optional] Read the overall instructions in vscode's documentation
2. To obtain the security token, go to go/valentine.
3. Search for Angular vscode marketplace
4. Copy the Personal Access Token (PAT)
5. Run yarn vsce login Angular
6. Paste the PAT