This is a fork containing Microsoft's vscode
software with manually expunged telemetry, experimentation, surveys and update service.
Unlike the VSCodium project, it does not use scripts to automatically build vscode
into freely-licensed binaries with a community-driven default configuration.
This source code is available to everyone under the standard MIT license.
In order to build VSCodius, you'll need the necessary tools:
- Git
- Node.js
- Yarn
- Python (required for
node-gyp
) - A C/C++ compiler tool chain for your platform:
- Windows
- Install the Visual C++ Build Environment by either installing the Visual Studio Build Tools or the Visual Studio Community Edition. The minimum workload to install is 'Desktop Development with C++'.
- Open a command prompt and run
npm config set msvs_version [version]
. - If the Visual C++ Build Tools are installed in a non-default directory, set the following environment variable
set vs[version]_install=[path]
.
- Mac OS
- XCode and the Command Line Tools, which will install
gcc
and the related toolchain containingmake
. - Run
xcode-select --install
to install the Command Line Tools.
- XCode and the Command Line Tools, which will install
- Linux
- On Debian-based Linux:
sudo apt-get install build-essential libx11-dev libxkbfile-dev libsecret-1-dev libkrb5-dev python-is-python3
. - On Red Hat-based Linux:
sudo yum groupinstall "Development Tools" && sudo yum install libX11-devel.x86_64 libxkbfile-devel.x86_64 libsecret-devel krb5-devel # or .i686
. - Others:
make
pkg-config
gcc
(or another compile toolchain)
- On Debian-based Linux:
- Windows
Install and build all of the dependencies using yarn
:
yarn
Then to build from a terminal:
yarn compile
The incremental builder will do an initial full build and will display a message that includes the phrase 'Finished compilation' once the initial build is complete.
Running on Electron with extensions run in Node.js:
./scripts/code.sh
./scripts/code-cli.sh # for running CLI commands (eg --version)
Where extensions and UI run in the browser:
./scripts/code-web.sh
Where UI run in the browser but extensions run in code server (Node.js):
./scripts/code-server.sh --launch
VSCodius can be packaged for the following platforms: win32-ia32 | win32-x64 | darwin-x64 | darwin-arm64 | linux-ia32 | linux-x64 | linux-arm
.
These gulp
tasks are available:
vscode-[platform]
: Builds a packaged version for[platform]
.vscode-[platform]-min
: Builds a packaged and minified version for[platform]
.
Run gulp
via yarn
to avoid potential out of memory issues, for example: yarn gulp vscode-linux-x64
Note on Windows: sometimes the default ElectronJS
resources will remain on the packaged executable. In order to fix this, run the following command:
node build\win32-resources-patch.js [exe path]
This project still remain under the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
Copyright (c) Microsoft Corporation. All rights reserved.
Licensed under the MIT license.