Go to file
Yaohai Zheng ae5d58ec45
Fix gulp build_server location isue. (#138)
2017-11-08 13:44:51 +08:00
.vscode Intialize VSCode Java Debugger extension. (#1) 2017-09-08 12:19:34 +08:00
src support stopOnEntry (#133) 2017-11-07 17:22:47 +08:00
test Enable travis (#84) 2017-10-10 12:42:23 +08:00
.editorconfig Refine codebase. (#13) 2017-09-17 19:47:07 -07:00
.gitignore Enable travis (#84) 2017-10-10 12:42:23 +08:00
.travis.yml Fixing the versions in package.json and modify the tslint configuration to fix the issue in gulp tslint/ 2017-10-24 17:32:34 +08:00
.vscodeignore Add binary extension. (#3) 2017-09-11 16:49:45 +08:00
CHANGELOG.md Update changelog for 0.2.0 (#104) 2017-10-19 00:05:30 -05:00
LICENSE.txt Update license. (#42) 2017-09-22 13:16:06 +08:00
README.md support stopOnEntry (#133) 2017-11-07 17:22:47 +08:00
gulpfile.js Fix gulp build_server location isue. (#138) 2017-11-08 13:44:51 +08:00
logo.png Update product icon (#25) 2017-09-20 16:24:51 +08:00
package-lock.json Fix gulp build_server location isue. (#138) 2017-11-08 13:44:51 +08:00
package.json Fix gulp build_server location isue. (#138) 2017-11-08 13:44:51 +08:00
tsconfig.json Fixing the versions in package.json and modify the tslint configuration to fix the issue in gulp tslint/ 2017-10-24 17:32:34 +08:00
tslint.json Fixing the versions in package.json and modify the tslint configuration to fix the issue in gulp tslint/ 2017-10-24 17:32:34 +08:00

README.md

Debugger for Java

Gitter Travis CI

Overview

A lightweight Java Debugger based on Java Debug Server which extends the Language Support for Java by Red Hat. It allows users debugging Java code using Visual Studio Code (VS Code). Here's a list of features:

  • Launch/Attach
  • Breakpoints
  • Exceptions
  • Pause & Continue
  • Step In/Out/Over
  • Variables
  • Callstacks
  • Threads
  • Debug console

Requirements

Install

Open VS Code and press F1 or Ctrl + Shift + P to open command palette, select Install Extension and type vscode-java-debug.

Or launch VS Code Quick Open (Ctrl + P), paste the following command, and press enter.

ext install vscode-java-debug

Use

  • Launch VS Code
  • Open a Java project (Maven/Gradle/Eclipse)
  • Open a Java file to activate the extensions
  • Add debug configurations and edit launch.json
    • To launch: specify mainClass
    • To attach: specify hostName and port
  • Press F5

Please also check the documentation of Language Support for Java by Red Hat if you have trouble setting up your project.

Options

Launch

  • mainClass (required) - The main class of the program (fully qualified name, e.g. [mymodule/]com.xyz.MainClass).
  • args - The command line arguments passed to the program.
  • sourcePaths - The extra source directories of the program. The debugger looks for source code from project settings by default. This option allows the debugger to look for source code in extra directories.
  • modulePaths - The modulepaths for launching the JVM. If not specified, the debugger will automatically resolve from current project.
  • classPaths - The classpaths for launching the JVM. If not specified, the debugger will automatically resolve from current project.
  • encoding - The file.encoding setting for the JVM. If not specified, 'UTF-8' will be used. Possible values can be found in http://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html.
  • vmArgs - The extra options and system properties for the JVM (e.g. -Xms<size> -Xmx<size> -D<name>=<value>).
  • projectName - The preferred project in which the debugger searches for classes. There could be duplicated class names in different projects. This setting also works when the debugger looks for the specified main class when launching a program.
  • cwd - The working directory of the program.
  • env - The extra environment variables for the program.
  • stopOnEntry - Automatically stop program after launch.

Attach

  • hostName (required) - The host name or IP address of remote debuggee.
  • port (required) - The debug port of remote debuggee.
  • timeout - Timeout value before reconnecting, in milliseconds (default to 30000ms).
  • sourcePaths - The extra source directories of the program. The debugger looks for source code from project settings by default. This option allows the debugger to look for source code in extra directories.
  • projectName - The preferred project in which the debugger searches for classes. There could be duplicated class names in different projects. This setting also works when the debugger looks for the specified main class when launching a program.

User Settings

  • java.debug.logLevel: minimum level of debugger logs that are sent to VS Code, defaults to warn.

Feedback and Questions

You can find the full list of issues at Issue Tracker. You can submit a bug or feature suggestion, and participate community driven Gitter

License

This extension is licensed under MIT License.

Data/Telemetry

Debugger for Java collects usage data and sends it to Microsoft to help improve our products and services. Read our privacy statement to learn more.