You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@netbeans.apache.org by sd...@apache.org on 2021/07/08 06:36:18 UTC

[netbeans] branch master updated: Readme prep for 12.5 and name shortening.

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 <ma...@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-unsubscribe@netbeans.apache.org
For additional commands, e-mail: commits-help@netbeans.apache.org

For further information about the NetBeans mailing lists, visit:
https://cwiki.apache.org/confluence/display/NETBEANS/Mailing+lists