[release] prepare v0.31.0 release

8a5263d package.json: update gopls settings for v0.7.5
e79a488 test: fix default go.delveConfig test
ffc9238 tools: fix gopls update tool generation
5bfc2aa build/all.bash: fix jq query to change hideSystemGoroutines default
0c7a9c4 CHANGELOG.md: Update CHANGELOG.md for release
4ef6379 src/goToolsInformation: update latest gopls prerelease version
aae8322 package.json: use defaults from package.json for delveConfig
4667012 package.json: change go template file language id to gotmpl
7cabf78 src/goBrowsePackage.ts: use async function syntax
5a7c4f7 build,docs: remove references to all.bash setup_env
9fce485 package.json: pin direct dependencies
a22f335 docs/contributing.md: encourage npm ci instead of npm install
3e64075 test: use @vscode/test-electron instead of vscode-test
c2fcb4e go.mod: update imports to latest versions
a0af37b test: increase sleep time to wait for dlv cleanup
b65133f goDebug.test.ts: stat for output file multiple times
62db19c goDebug.test.ts: update switch goroutine test
d2c9293 tools/generate.go: fix default value formatting for []string types
85f1be0 test: disable should cleanup when stopped
7abeb7a package.json: use 'console' enums consistent with other extensions
1fa51bc package.json: add description of 'console' and 'asRoot'
8d2a31f src/goDebugFactory,goDebugConfiguration: adjust env computation
a807c61 src/goDebugFactory: add support for `asRoot` property
c4f5c25 test: disable switch goroutine tests
c132833 src/goDebugConfiguration: use 'dlv' instead of 'dlv-dap' binary
094f345 debugging.md: note that 'go build', not 'go run'  must be used with dlv
943ff11 src/goDebugFactory: support integrated/external console
f4e5154 src/goDebugFactory: start dlv-dap lazily
cd0a462 src/goDebugFactory: use --client-addr when console=integrated/external
f4aa041 debugging.md: add a note about using --continue with remote server
f4f07b0 test: remove unused dlvDapSkipsEnabled variable
143b6d9 workflow: enable tests with go1.18beta1
691e15f src/goDebugFactory: improve start-up and session fail messages for remote dlv-dap
25af90d src/goTest: fix output for subtests
944fbf7 src/goTest: don't resolve tests in virtual files
1dc72ce test: enable substitutePath tests for remote dlv-dap
efdf4bf test: enable disconnect remote dlv-dap test
bccac79 test: enable remote set breakpoints tests
6de4255 test: enable basic remote tests
482381f test: enable unknown request test
1395952 README.md: update debugging video link
08dacee src/goStatus: assign id/name to each status bar item
8c3683f README: add link to GopherCon Debugging Treasure Hunt presentation
e81d440 package.json: start v0.31.0 dev
f5e6bec package.json: update gopls settings

Change-Id: Ic032bf88783beea865c24398a3582b1b133f02a0

Author: suzmue

.github/workflows/test-long-all.yml

@@ -17,7 +17,7 @@ jobs:
       matrix:
         os: [ubuntu-latest, windows-latest, macos-latest]
         version: ['stable', 'insiders']
-        go: ['1.15', '1.16', '1.17']
+        go: ['1.15', '1.16', '1.17', '1.18.0-beta1']
 
     steps:
       - name: Clone repository

.github/workflows/test-long.yml

@@ -16,7 +16,7 @@ jobs:
       matrix:
         os: [ubuntu-latest, windows-latest] # TODO: reenable macos-latest
         version: ['stable']
-        go: ['1.15', '1.16', '1.17']
+        go: ['1.15', '1.16', '1.17', '1.18.0-beta1']
 
     steps:
       - name: Clone repository

CHANGELOG.md

@@ -1,3 +1,36 @@
+## v0.31.0 - 20 Jan, 2022
+
+### Fixes
+
+- src/goStatus: assign id/name to each status bar item ([Issue 1571](https://github.com/golang/vscode-go/issues/1571)) <!-- CL 370354 -->
+- Change go template file language id to `gotmpl` ([Issue 1957](https://github.com/golang/vscode-go/issues/1957)) <!-- CL 376037 -->
+
+### Debugging
+
+- Use 'dlv' instead of 'dlv-dap' binary ([Issue 1977](https://github.com/golang/vscode-go/issues/1977)) <!-- CL 374594 -->
+- Experimental support of 'console' mode debugging ([Issue 124](https://github.com/golang/vscode-go/issues/124)) <!-- CL 358618 -->
+- Support debugging with root privileges ([Issue 558](https://github.com/golang/vscode-go/issues/558))
+- Updated [debugging documentation]() ([Issue 1861](https://github.com/golang/vscode-go/issues/1861),[1719](https://github.com/golang/vscode-go/issues/1719),([1676](https://github.com/golang/vscode-go/issues/1676), [123](https://github.com/golang/vscode-go/issues/123), [855](https://github.com/golang/vscode-go/issues/855), [1840](https://github.com/golang/vscode-go/issues/1840)))
+- Enabled remaining tests for dlv dap and fixed flaky tests ([Issue 1958](https://github.com/golang/vscode-go/issues/1958),[Issue 1993](https://github.com/golang/vscode-go/issues/1993))
+- Improvement of debug session start-up and session fail messages ([Issue 1861](https://github.com/golang/vscode-go/issues/1861)) <!-- CL 371974 -->
+
+### Test Explorer
+
+- src/goTest: don't resolve tests in virtual files <!-- CL 373234 -->
+- src/goTest: fix output for subtests ([Issue 1837](https://github.com/golang/vscode-go/issues/1837)) <!-- CL 373274 -->
+
+### Development Process Updates
+
+- Recommend that contributers use npm ci instead of npm install when developing vscode-go ([Issue 2010](https://github.com/golang/vscode-go/issues/2010)) <!-- CL 379154 -->
+- test: use @vscode/test-electron instead of vscode-test <!-- CL 377336 -->
+- go.mod: update imports to latest versions <!-- CL 374280 -->
+- package.json: pin direct dependencies ([Issue 2010](https://github.com/golang/vscode-go/issues/2010)) <!-- CL 379155 -->
+- Enable tests with go1.18beta1 ([Issue 1950](https://github.com/golang/vscode-go/issues/1950)) <!-- CL 374055 -->
+
+### Thanks
+
+Thank you for your contribution, @firelizzard18, @hyangah, @jamalc, @polinasok, @TheNagaPraneeth, @suzmue!
+
 ## v0.30.0 - 16 Dec, 2021
 
 A list of all issues and changes can be found in the [v0.30.0 milestone](https://github.com/golang/vscode-go/milestone/40) and [commit history](https://github.com/golang/vscode-go/compare/v0.29.0...v0.30.0).

README.md

@@ -16,6 +16,8 @@ We recommend switching your remote attach configurations in `launch.json` to use
 `"debugAdapter":"dlv-dap"` now to verify that this works for you.
 Please [file a new issue](https://github.com/golang/vscode-go/issues/new/choose) if you encounter any problems.
 
+📣📣 Watch [Debugging Treasure Hunt](https://youtu.be/ZPIPPRjwg7Q) from [GopherCon 2021](https://www.gophercon.com/) for a fun take on a debugging demo with VS Code Go and Delve DAP.
+
 ## Quick Start
 
 Welcome! 👋🏻<br/>

build/all.bash

@@ -11,7 +11,6 @@ Available subcommands:
   help      - display this help message.
   test      - build and test locally. Some tests may fail if vscode is already in use.
   testlocal - build and test in a locally built container.
-  setup_env - setup environment for test. This installs tools under GOPATH/bin.
   ci        - build and test with headless vscode. Requires Xvfb.
 EOUSAGE
 }
@@ -81,7 +80,7 @@ prepare_nightly() {
 .displayName="Go Nightly" |
 .publisher="golang" |
 .description="Rich Go language support for Visual Studio Code (Nightly)" |
-.contributes.configuration.properties."go.delveConfig.hideSystemGoroutines".default=true
+.contributes.configuration.properties."go.delveConfig".properties.hideSystemGoroutines.default=true
 ') > /tmp/package.json && mv /tmp/package.json package.json
 
   # Replace CHANGELOG.md with CHANGELOG.md + Release commit info.

docs/contributing.md

@@ -35,12 +35,12 @@ Please note that extra configuration is required to build and run the [Debug Ada
 ### Setup
 
 1) Install [node](https://nodejs.org/en/). Note: make sure that you are using `npm v7` or higher. The file format for `package-lock.json` (changed significantly)[https://docs.npmjs.com/cli/v7/configuring-npm/package-lock-json#file-format] in `npm v7`.
-2) Clone the repository, run `npm install`, and open VS Code:
+2) Clone the repository, run `npm ci`, and open VS Code:
 
     ```bash
     git clone https://go.googlesource.com/vscode-go
     cd vscode-go
-    npm install
+    npm ci
     code .
     ```
 
@@ -64,11 +64,11 @@ If you make subsequent edits in the codebase, you can reload (`Ctrl+R`) the `[Ex
 
 Simple unit tests that do not require interaction with VS Code are located in `test/unit`. 
 Tests in `test/integration` and `test/gopls` directories are integration tests. They involve invocation of the VS Code API and 
-require external Go tools installed in `GOPATH`. The command `setup_env` in [`build/all.bash`](https://github.com/golang/vscode-go/blob/master/build/all.bash)
+require external Go tools installed in `GOPATH`. The command `installtools` in [`tools/installtools/main.go`](https://github.com/golang/vscode-go/blob/master/tools/installtools/main.go)
 installs all the tool dependencies in `GOPATH`. 
 
 1. `export GOPATH=/path/to/gopath/for/test`
-1. `build/all.bash setup_env`
+1. `go run tools/installtools/main.go`
 1. Unfortunately, VS Code test framework inherits your user settings when running tests [Issue 43](https://github.com/golang/vscode-go/issues/43). Make sure VS Code user settings do not contain any go related configuration, except `go.gopath` or `go.toolsGopath` in case you installed the tools for testing in a different `GOPATH`.
 
 There are currently three test launch configurations: (1) `Launch Extension Tests`, (2) `Launch Extension Tests with Gopls`, and (3) `Launch Unit Tests`. To run the tests locally, open the Run view (`Ctrl+Shift+D`), select the relevant launch configuration, and hit the Play button (`F5`).
@@ -79,13 +79,13 @@ After making changes to the extension, you may want to test it end-to-end instea
 
 1. Install the [vsce](https://code.visualstudio.com/api/working-with-extensions/publishing-extension#vsce) tool for packaging extensions (`npm install -g vsce`).
 2. `cd` into your `vscode-go` directory.
-3. Install all dependencies by running `npm install`.
+3. Install all dependencies by running `npm ci`.
 4. Run `vsce package`. This will generate a file with a `.vsix` extension in your current directory.
 
     ```bash
     npm install -g vsce
     cd vscode-go
-    npm install
+    npm ci
     vsce package
     ```