angular/vscode-ng-language-service/DEVELOPER.md

Monorepo setup

This repository is a monorepo. All build outputs are created in the bazel-bin directory.

The dependencies in root package.json must include all production dependencies of the client and and the server.

The dependencies of the server need to be duplicated in the root package.json. Therefore, if a new prod dependency is added to the server, it needs to be added to both package.json and server/package.json.

Building the extension .vsix

If you'd like build the extension .vsix, run

pnpm --filter=ng-template run package`

The built vsix can be found in ./dist/bin/vscode-ng-language-service/ng-template.vsix

Test Local Changes in VSCode

Any changes made to the code in this repository tested out in a development version of VSCode. The instructions below explain how to bring up a local instance and then install a local version of @angular/language-service.

Launch VSCode in Extension Development Host

The scripts in .vscode directory are setup to automatically compile the code, then launch a new instance of VSCode with the Angular extension installed. To do so, either

1. Press F5, or
2. Go to Run on the sidebar, select VSCE: Launch Dev Client from the task list

After the client is launched, you can optionally choose to attach a debugger to the local instance. To do so,

1. Go to Run on the sidebar, select VSCE: Attach to Server from the task list

As a shortcut, there's also a task setup to automatically launch the client and attach the debugger in a single step. To do so,

1. Go to Run on the sidebar, select VSCE: Dev Client + Attach to Server from the task list