Skip to content

Commit

Permalink
KXI-30038: Revert from testing
Browse files Browse the repository at this point in the history
  • Loading branch information
cterry45 committed Sep 15, 2023
1 parent be7b95a commit b81258c
Show file tree
Hide file tree
Showing 3 changed files with 12 additions and 35 deletions.
4 changes: 2 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,11 @@

All notable changes to the kdb extension will be documented in this file.

# v9.9.0
# v0.1.17

### Internal Improvements

- This is a test
- KX Language Server Improvements

# v0.1.18

Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"displayName": "kdb",
"description": "IDE support for kdb product suite",
"publisher": "KX",
"version": "v9.9.0",
"version": "1.0.0-rc1",
"engines": {
"vscode": "^1.66.0"
},
Expand Down
41 changes: 9 additions & 32 deletions release_process.md
Original file line number Diff line number Diff line change
@@ -1,40 +1,17 @@
# Release process for KX VSCode extension

The release process for the extension requires multiple steps. Some of these are automated with scripts and can be called from future CI/CD platforms, such as Azure DevOps or GitHub workflows. Currently this process is quite manual as the extension is not published to the marketplace yet.
On each push to Main or Dev there is a vsix built and uploaded to [Downloads Portal](https://portal.dl.kx.com/assets/raw/kdb-vscode/)

## Steps for creating a new release

1. Build the extension and run all tests.
1. Update the [package.json](package.json) to bump the version for the extension. This is important because when installing the package (VSIX), it's important to have the updated version to ensure VSCode does not install another version. This applies after the extension is published to the marketplace. This uses semantic version of build.release.patch (e.g., 0.1.8)

```
yarn install
yarn run build
yarn run test
```
2. Update the [CHANGELOG.md](CHANGELOG.md) to include the release version the the appropriate comments on updates.

2. Run the extension in developer mode to test that the functionality of the change is valid.
3. Merge the changes

```
Press <F5>, wait for extension host to launch, tests functionality
```

3. Update the [package.json](package.json) to bump the version for the extension. This is important because when installing the package (VSIX), it's important to have the updated version to ensure VSCode does not install another version. This applies after the extension is published to the marketplace. This uses semantic version of build.release.patch (e.g., 0.1.8)

4. Update the [CHANGELOG.md](CHANGELOG.md) to include the release version the the appropriate comments on updates.

5. Package the extension. This will create the bundled extension (essentially compressing and minifing all code to a single js file) and then creating the manifest and assets for what will be published to the marketplace. This will output a VSIX file, which is a compressed file of these assets.

```
yarn run package
```

6. Start a new VS Code instance and install the extension by sideloading. This is done by navigating to the extensions tab and from the ellipse menu click on 'Install from VSIX'. Again, run the same tests as in step above. This is used to validate that the bundling/miniflying and compression didn't result in any breakage.

7. Share the VSIX with team members, get feedback.

8. After this is completed, a release can be created in GitHub. This _can_ be automated but currently is manual.

- First, create a new draft release in the GitHub repo
- Name the release v0.1.x to ensure the version matches the new version.
- Copy the section for the version from the [CHANGELOG.md](CHANGELOG.md) to the notes.
- Add the VSIX as a binary for the release.
4. Create a tag on main locally, then push it to remote.
```bash
git tag v1.0.0
git push origin v1.0.0
```

0 comments on commit b81258c

Please sign in to comment.