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.
+
+### 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 
+ * 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
