https://github.com/microsoft/vscode-vsce

VS Code Extension Manager
https://github.com/microsoft/vscode-vsce

Last synced: about 1 month ago
JSON representation

VS Code Extension Manager

• Host: GitHub
• URL: https://github.com/microsoft/vscode-vsce
• Owner: microsoft
• License: other
• Created: 2015-09-22T10:04:25.000Z (about 9 years ago)
• Default Branch: main
• Last Pushed: 2024-09-30T10:01:03.000Z (about 2 months ago)
• Last Synced: 2024-10-02T10:48:43.761Z (about 2 months ago)
• Language: TypeScript
• Homepage: https://code.visualstudio.com/
• Size: 2.96 MB
• Stars: 800
• Watchers: 39
• Forks: 205
• Open Issues: 28
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# @vscode/vsce

> _The Visual Studio Code Extension Manager_

[![Build Status](https://dev.azure.com/monacotools/Monaco/_apis/build/status/npm/microsoft.vscode-vsce?repoName=microsoft%2Fvscode-vsce&branchName=main)](https://dev.azure.com/monacotools/Monaco/_build/latest?definitionId=446&repoName=microsoft%2Fvscode-vsce&branchName=main)

[![Version](https://img.shields.io/npm/v/@vscode/vsce.svg)](https://npmjs.org/package/@vscode/vsce)

This tool assists in packaging and publishing Visual Studio Code extensions.

Read the [**Documentation**](https://code.visualstudio.com/api/working-with-extensions/publishing-extension) on the VS Code website.

## Requirements

[Node.js](https://nodejs.org/en/) at least `20.x.x`.

### Linux

In order to save credentials safely, this project uses [`keytar`](https://www.npmjs.com/package/keytar) which uses `libsecret`, which you may need to install before publishing extensions. Setting the `VSCE_STORE=file` environment variable will revert back to the file credential store. Using the `VSCE_PAT` environment variable will also avoid using `keytar`.

Depending on your distribution, you will need to run the following command:

- Debian/Ubuntu: `sudo apt-get install libsecret-1-dev`

- Alpine: `apk add libsecret`

- Red Hat-based: `sudo yum install libsecret-devel`

- Arch Linux: `sudo pacman -S libsecret`

## Usage

```console

$ npx @vscode/vsce --version

```

`@vscode/vsce` is meant to be mainly used as a command-line tool. It can also be used as a library since it exposes a small [API](https://github.com/microsoft/vscode-vsce/blob/main/src/api.ts). When using `@vscode/vsce` as a library, be sure to sanitize any user input used in API calls to prevent security issues.

Supported package managers:

- `npm >=6`

- `yarn >=1 <2`

## Configuration

You can configure the behavior of `vsce` by using CLI flags (run `vsce --help` to list them all). Example:

```console

$ npx @vscode/vsce publish --baseImagesUrl https://my.custom/base/images/url

```

Or you can also set them in the `package.json`, so that you avoid having to retype the common options again. Example:

```jsonc

// package.json

{

  "vsce": {

    "baseImagesUrl": "https://my.custom/base/images/url",

    "dependencies": true,

    "yarn": false

  }

}

```

## Development

First clone this repository, then:

```console

$ npm install

$ npm run watch:build # or `watch:test` to also build tests

```

Once the watcher is up and running, you can run out of sources with:

```console

$ node vsce

```

Tests can be executed with:

```console

$ npm test

```

> **Note:** [Yarn](https://www.npmjs.com/package/yarn) is required to run the tests.