development/vscode
development/vscode
1
0
Fork 0
mirror of https://github.com/Microsoft/vscode synced 2024-08-28 05:19:39 +00:00
Code Issues Packages Projects Releases Wiki Activity
vscode/.devcontainer/README.md

4.9 KiB
Raw Blame History

Code - OSS Development Container

Open in Dev Containers

This repository includes configuration for a development container for working with Code - OSS in a local container or using GitHub Codespaces.

Quick start - local

If you already have VS Code and Docker installed, you can click the badge above or here to get started. Clicking these links will cause VS Code to automatically install the Dev Containers extension if needed, clone the source code into a container volume, and spin up a dev container for use.

  1. Install Docker Desktop or Docker for Linux on your local machine. (See docs for additional details.)

  2. Important: Docker needs at least 4 Cores and 8 GB of RAM to run a full build with 9 GB of RAM being recommended. If you are on macOS, or are using the old Hyper-V engine for Windows, update these values for Docker Desktop by right-clicking on the Docker status bar item and going to Preferences/Settings > Resources > Advanced.

    Note: The Resource Monitor extension is included in the container so you can keep an eye on CPU/Memory in the status bar.

  3. Install Visual Studio Code Stable or Insiders and the Dev Containers extension.

    Image of Dev Containers extension

    Note: The Dev Containers extension requires the Visual Studio Code distribution of Code - OSS. See the FAQ for details.

  4. Due to the size of the repository we strongly recommend cloning it on a Linux filesystem for better bind mount performance. On macOS we recommend using a Docker volume (press F1 and select Dev Containers: Clone Repository in Container Volume...) and on Windows we recommend using a WSL folder:

  • Make sure you are running a recent WSL version to get X11 and Wayland support.
  • Use the WSL extension for VS Code to open the cloned folder in WSL.
  • Press F1 and select Dev Containers: Reopen in Container.

Note: For developing the desktop app locally, you will need X11's DISPLAY or Wayland's WAYLAND_DISPLAY environment variable set to allow for the Code - OSS window to display. See Running GUI app on WSL for Windows and Quartz for Mac.

Try it

To start working with Code - OSS, follow these steps:

  1. In your local VS Code client, open a terminal (Ctrl/Cmd + Shift + `) and type the following commands:

    yarn install
./scripts/code.sh

  2. You should now see Code - OSS!

Next, let's try debugging.

  1. Shut down Code - OSS by clicking the box in the upper right corner of the Code - OSS window.

  2. Go to your local VS Code client, and use the Run / Debug view to launch the VS Code configuration. (Typically the default, so you can likely just press F5).

    Note: If launching times out, you can increase the value of timeout in the "VS Code", "Attach Main Process", "Attach Extension Host", and "Attach to Shared Process" configurations in launch.json. However, running ./scripts/code.sh first will set up Electron which will usually solve timeout issues.

  3. After a bit, Code - OSS will appear with the debugger attached!

Enjoy!

Notes

The container comes with VS Code Insiders installed. To run it from an Integrated Terminal use VSCODE_IPC_HOOK_CLI= /usr/bin/code-insiders ..

Quick start - GitHub Codespaces

  1. From the microsoft/vscode GitHub repository, click on the Code dropdown, select Open with Codespaces, and then click on New codespace. If prompted, select the Standard machine size (which is also the default).

    Note: You will not see these options within GitHub if you are not in the Codespaces beta.

Try it

To start working with Code - OSS Web, follow these steps:

  1. Open a terminal (Ctrl/Cmd + Shift + `) and type the following commands:

    yarn install
yarn compile && yarn compile-web
./scripts/code-web.sh

  2. You should now see Code - OSS Web open in your browser!