Skip to content

Commit

Permalink
The docs update, mostly related to how to package the extension and h… (
Browse files Browse the repository at this point in the history
  • Loading branch information
karolh2000 authored Feb 13, 2023
1 parent 579cf94 commit 3a96c03
Show file tree
Hide file tree
Showing 2 changed files with 28 additions and 6 deletions.
12 changes: 12 additions & 0 deletions .vscodeignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
.github
.idea
.vscode
.vscode-test
src
.eslintrc.cjs
.gitignore
.vscodeignore
package.json
package-lock.json
pre-commit.sh
tsconfig.json
22 changes: 16 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,20 +42,30 @@ To debug the tests, in the Activity Bar select "Run and Debug" and make sure the
## How to package, install and uninstall Pyrsia extension in the IDE
The Pyrsia extension is not available in the VS Code store yet, it's necessary to manually install the extension as described below.
The Pyrsia extension is not yet listed in the VS Code marketplace. For now it can still be installed manually following the instructions outlined below.
### Package and Install (side-load extension)
### Install extension (side-load extension)
- Download the latest version of the extension (vsix file) from the [project release page](https://github.com/pyrsia/pyrsia-vscode-extension/releases).
- Close the IDE and install the extension using the `vsix` file downloaded in the previous step.
```sh
code --install-extension <PYRSIA_VSIX_FILE_PATH>
```
### Build package and install extension from the local repository (side-load extension)
- Install [Visual Studio Code Extensions](https://code.visualstudio.com/api/working-with-extensions/publishing-extension#vsce) with the following command.
```sh
npm install -g @vscode/vsce
```
- In the extension repository folder package the extension as follows.
- Package the extension in the extension repository folder as follows.
```sh
vsce package
vsce package --allow-star-activation --ignoreFile .vscodeignore --pre-release
```
- If the packaging was successful the last line of the VSCE logs should contain the `vsix` file path, for example:
Expand All @@ -64,12 +74,12 @@ The Pyrsia extension is not available in the VS Code store yet, it's necessary t
DONE Packaged: /home/joed/repositories/pyrsia-vscode-extension/pyrsia-integration-0.0.1.vsix (960 files, 2.2MB)
```
- Copy the `vsix` file path and install the extension as follows.
- Close the IDE and install the extension using the `vsix` file path from the previous step.
```sh
code --install-extension <PYRSIA_VSIX_FILE_PATH>
```
### Uninstall (side-load)
- Find the extension in the list of the extensions (look for "pyrsia", for example `undefined_publisher.pyrsia-integration`).
Expand Down

0 comments on commit 3a96c03

Please sign in to comment.