This is an automated email from the ASF dual-hosted git repository. sdedic pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/netbeans.git
The following commit(s) were added to refs/heads/master by this push: new 9322cdc Readme prep for 12.5 and name shortening. new d1927a4 Merge pull request #3039 from MartinBalin/vscode_readme_12.5 9322cdc is described below commit 9322cdcc64fdfb5ab70a54f0a13e690bb1285dda Author: Martin Balin <martin.ba...@oracle.com> AuthorDate: Sat Jul 3 15:22:36 2021 +0200 Readme prep for 12.5 and name shortening. --- java/java.lsp.server/vscode/README.md | 49 +++++++++++++++-------- java/java.lsp.server/vscode/images/debuggers.png | Bin 0 -> 34385 bytes java/java.lsp.server/vscode/images/run.png | Bin 0 -> 3787 bytes java/java.lsp.server/vscode/package.json | 2 +- 4 files changed, 33 insertions(+), 18 deletions(-) diff --git a/java/java.lsp.server/vscode/README.md b/java/java.lsp.server/vscode/README.md index 753c58b..4867262 100644 --- a/java/java.lsp.server/vscode/README.md +++ b/java/java.lsp.server/vscode/README.md @@ -23,33 +23,48 @@ This is a technology preview of [Apache NetBeans](http://netbeans.org) based extension for VS Code. Use it to get all the _goodies of NetBeans_ -via the VS Code user interface! Run on __JDK8__[*], __JDK11__, __JDK15__, etc. - -[*]: <http://github.com/oracle/nb-javac> "Running on JDK8 requires additional download of GPLv2 with ClassPath Exception code" - -Invoke "Open Folder" action to open project directories with `pom.xml` or `build.gradle` -build scripts. Edit, compile and debug (with the __Java 8+__ debugger configuration) -the `.java` application and test files in such projects. Debug not only Java code, -but JavaScript, Python, Ruby polyglot programs at once. +via the VS Code user interface! Runs on __JDK8__[*] and all newer versions. +Apache NetBeans Language Server brings full featured Java development (edit-compile-debug & test cycle) for Maven and Gradle projects to VSCode. As well as other features. ## Getting Started +1. Set JDK in `VSCode | Preferences | Settings ...` __Netbeans: Jdkhome__ setting to point to JDK which Language Server will run on and projects will be compiled with. More below in section [Selecting the JDK](#selecting-the-jdk) -Follow the -[online instructions](https://cwiki.apache.org/confluence/display/NETBEANS/Apache+NetBeans+extension+for+Visual+Studio+Code) -to set your environment up to support -[typical development use-cases](https://cwiki.apache.org/confluence/display/NETBEANS/Apache+NetBeans+extension+for+Visual+Studio+Code). +2. Use __Java: New Project...__ " command to start creating new project, or +3. Open the folder with existing __pom.xml__ for Maven or ___Gradle___ project files (_build.gradle, gradle.properties_). + * Language Server opens the project, performs priming build and might ask for Resolving problems, usually related to opening + subprojects etc. +4. Or simply create a new Java class file with `public static void main(String[] args)` method in opened folder and start coding, compiling, debugging. Works on JDK 8 and newer. -## Supported Actions +## Supported Actions +* __Java: New Project...__ allows creation of new Maven or Gradle project +* __Java: New from Template...__ add various files to currently selected open project. Files are: + * Java - broad selection of various predefined Java classes + * Unit tests - JUnit and TestNB templates for test suites and test cases + * HTML5/JavaScript - Templates for JS, HTML, CSS,... files + * Other - various templates for JSON, YAML, properties, ... files * __Java: Compile Workspace__ - invoke Maven or Gradle build -* __GraalVM: Pause in Script__ - place a breakpoint into first executed polyglot script -* Debugger __Java 8+__ - start test or main class on JDK8+ in polyglot mode +* Debugger __Java 8+...__ - start main class or test on JDK8+. More in [Debugger section](#debugger-and-launch-configurations) * Progress shown for long running operations with cancel support for selected types * __Native Image Debugger__ is a new Run configuration added which allows Java style debugging of Ahead of Time compiled native-images, produced by GraalVM. It is experimental feature which works with GDB on Linux. GDB 7.11 or GDB 10.1+ is required due to known issue [#26139](https://sourceware.org/bugzilla/show_bug.cgi?id=26139) in GDB 8 and 9. * __Micronaut and Spring__ support especially for YAML configuration files with code completion and source code navigation to Java. * __Test Explorer__ for Java tests results visualization and execution including editor code Lenses. -* Improved Maven and Gradle support including multi-project projects, subprojects opening and Gradle priming builds. - +* Maven and Gradle support including multi-project projects, subprojects opening and Gradle priming builds. + +## Debugger and Launch Configurations +Language Server __Java 8+ ...__ launch configuration supports debugging and running Java applications using JDK8 or newer. +1. The launch configuration (debugger) is invoked when `Run main | Debug main` code lense is selected in the code. +2. Or __Java 8+...__ is selected in __Run and Debug__ activity panel. +![Debug configurations](images/debuggers.png) +### Launch Configurations +* __Launch Java 8+ App__ - Debug or Run current Java project +* __Launch Java: Continuous Mode__ - Runs Micronaut project and reloads it when source code has been changed. +* __Attach to Port__ & __Attach to Process__ - Attach debugger actions. Available when __Java 8+ ...__ at the bottom of drop down list is selected. + * Select this configuration, then click the ![Run](images/run.png) + * Select either from available process or enter the port to connect to JVM running with JDWP. + * __Attach to Shared Memory__ is available on Windows in addtion to above mentioned _Attach..._ + +Default launch configurations provided by Language Server can modified in `launch.json` file using intellisense for available options. ## Supported Refactorings Class level refactorings as well as variable refactorings are supported in VSCode via Apache NetBeans extension. See following screenshots: diff --git a/java/java.lsp.server/vscode/images/debuggers.png b/java/java.lsp.server/vscode/images/debuggers.png new file mode 100644 index 0000000..6f48668 Binary files /dev/null and b/java/java.lsp.server/vscode/images/debuggers.png differ diff --git a/java/java.lsp.server/vscode/images/run.png b/java/java.lsp.server/vscode/images/run.png new file mode 100644 index 0000000..5b4fe7c Binary files /dev/null and b/java/java.lsp.server/vscode/images/run.png differ diff --git a/java/java.lsp.server/vscode/package.json b/java/java.lsp.server/vscode/package.json index c0b0b3b..188b34c 100644 --- a/java/java.lsp.server/vscode/package.json +++ b/java/java.lsp.server/vscode/package.json @@ -1,6 +1,6 @@ { "name": "apache-netbeans-java", - "displayName": "Apache NetBeans Language Server", + "displayName": "Language Server", "description": "Apache NetBeans Language Server Extension for Visual Studio Code", "author": "Apache NetBeans", "license": "Apache 2.0", --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@netbeans.apache.org For additional commands, e-mail: commits-h...@netbeans.apache.org For further information about the NetBeans mailing lists, visit: https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists