From c8cfbb58e525a07afc7d8ebabb089233be275ab3 Mon Sep 17 00:00:00 2001 From: Shivam Madan Date: Mon, 9 Dec 2024 18:00:46 +0530 Subject: [PATCH] Fix for single README file --- build.xml | 23 +++- vscode/.vscodeignore | 3 +- vscode/README.md | 207 ------------------------------ vscode/{images => icons}/logo.png | Bin vscode/package.json | 2 +- 5 files changed, 23 insertions(+), 212 deletions(-) delete mode 100644 vscode/README.md rename vscode/{images => icons}/logo.png (100%) diff --git a/build.xml b/build.xml index 4bd1ab5d..f62fd86b 100644 --- a/build.xml +++ b/build.xml @@ -246,19 +246,36 @@ - + + + + + + + + + + + + + - + - + + diff --git a/vscode/.vscodeignore b/vscode/.vscodeignore index 2762542c..0b84d049 100644 --- a/vscode/.vscodeignore +++ b/vscode/.vscodeignore @@ -11,4 +11,5 @@ vsc-extension-quickstart.md .nyc_output/** coverage/** **/.nycrc.json -esbuild.js \ No newline at end of file +esbuild.js +images/* \ No newline at end of file diff --git a/vscode/README.md b/vscode/README.md deleted file mode 100644 index 98cf5245..00000000 --- a/vscode/README.md +++ /dev/null @@ -1,207 +0,0 @@ - - - - -# Java Platform Extension for Visual Studio Code - -Java Platform extension from Oracle brings full featured development support (edit-compile-debug & test cycle) to VS Code. It also offers support for Maven and Gradle projects. Applications using JDK 8 and above are supported. -## Getting Started -1. Setting up the JDK - - If no JDK is present in your system then the extension can set things up for you. For more details refer to [JDK Downloader](#jdk-downloader) section. - - Set the JDK in the `View | Command Palette | Preferences: Open User Settings | Jdk: Jdkhome` setting to point to the JDK that the Language Server will run on and also by default use for running and compiling projects. - - The extension requires JDK 17 or newer to run. - - Optionally, set a different JDK to compile and run projects in the `View | Command Palette | Preferences: Open User Settings | Jdk › Project: Jdkhome` setting. - - By default, the __jdk.jdkhome__ setting is used. - - Projects can run on JDK 8 and above. - - For more information, see the section [Selecting the JDK](#selecting-the-jdk). -4. Use any one of the following ways to start coding, compiling and debugging in Java. - - Simply create a new Java class with `public static void main(String[] args)` method. - - Use the __Java: New File from Template...__ command to create a new Java file. - - Use the __Java: New Project...__ command to create a new project. - - Open the folder with existing __Maven__ or __Gradle__ project files (_pom.xml_ or _build.gradle, gradle.properties_). - -## Supported Actions -In the VS Code command palette : -* __Java: New Project...__ allows creation of new Maven or Gradle project -* __Java: New File from Template...__ add various files to currently selected open project. Files are: - * Java - broad selection of various predefined Java classes - * Unit tests - JUnit and TestNG templates for test suites and test cases - * Other - various templates for Javascript, JSON, YAML, properties, ... files -* __Java: Compile Workspace__ - invoke Maven or Gradle build -* __Java: Clean Workspace__ - clean Maven or Gradle build -* __Download, install and Use JDK__ - allows download and installation of JDK binaries -* Debugger __Java+...__ - start main class or test on selected JDK. More in [Debugger section](#debugger-and-launch-configurations) -* __Test Explorer__ for Java tests results visualization and execution including editor code Lenses. -* Maven and Gradle support including multi-project projects, subprojects opening and Gradle priming builds. -* __Java: Go To Test/Tested Class__ - Navigates to the corresponding test or source class file - -## Project Explorer -Project Explorer provides an overview of logical project structure, groups sources together and greatly simplifies Java package structure exploration. Project Explorer is an addition to the classical workspace explorer. Use it to build, test, execute and operate your Maven and Gradle Java projects. -![Project Explorer](images/project-explorer.png) - -### Localization support -Oracle Java Platform extension provides localization support for _Japanese_ and _Simplified Chinese_. -To switch language `Go to command Palette->Configure display language` select `ja` for _Japanese_ or `zh-cn` for _Simplified Chinese_ - - -![Localization.gif](images/Localization.gif) -## Debugger and Launch Configurations -Language Server __Java+ ...__ launch configuration supports debugging and running Java applications using JDK11 or newer. -1. The launch configuration (debugger) is invoked when `Run main | Debug main` code lense is selected in the code. -2. Or __Java+...__ is selected in __Run and Debug__ activity panel. -![Debug configurations](images/debuggers.png) -### Launch Configurations -* __Launch Java App__ - Debug or Run current Java project -* __Attach to Port__ & __Attach to Process__ - Attach debugger actions. Available when __Java+ ...__ 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. - -### Run Configurations panel -Program arguments, VM options, evironment variables,... can be set in Run Configuration panel a part of Explorer. The panel is sufficient for all typical use-cases Java programmer faces. Only advanced, expert scenarios may require touching of `launch.json` (which still takes precedence). -![Run Configuration](images/run_config.png) - -## JDK Downloader -If the system does not detect any JDK, the extension will offer a downloader and setup prompt to help you set up a JDK. This setup provides options for Oracle JDK, OpenJDK, and allows you to choose from any installed JDK on your system. -Alternatively, you can manually specify the path to JDK binaries by utilizing the JDK downloader. -You can also access the JDK downloader through the "Download, install, and Use JDK" option in the command palette. -![JDK Downloader](images/jdk_downloader.png) -## Enabling Java Preview Features -When using preview features use the quick fix action option to easily enable them. - -![Enable Preview](images/enable_preview.gif) -## Supported Refactorings - -Class level refactorings as well as variable refactorings are supported in VS Code via Oracle Java Platform extension. See following screenshots: - -### Source Action ... context menu -![Class Source Actions](images/Source_actions.png) - -### Introduce refactorings available via Show Code actions light bulb -![Introduce ... refactoring](images/Introduce_refactoring.png) - -### More Refactorings available also using Refactor... context menu -![More Refactorings](images/Refactor_menu.png) - -### Surround with refactorings -![Surrond with Refactorings](images/Surrond_With_refactorings.png) - -Some refactorings are two steps with like __Generate Override method__ ... where method to be overriden is selected in 2nd step: -![Override refactoring](images/Override_refactoring.png) - -### Change Method Parameters refactoring -Change method parameters refactoring is provided using dedicated form allowing to change, add, move, remove method parameters. -![Change method parameters refactoring](images/change_method_params.png) - -### Move Members Refactoring -Move members refactoring provides dedicated form as well. -![Move members refactoring](images/move_refactoring.png) - -### Some of supported refactorings: -* Convert to static import -* Pull member up & down -* Move class -* Extract interface/method -* Split into declaration and assignment -* Extract local variable -* Assign to variable -* Generate hashCode/equals -* Generate toString() -* Surround With refactoring -* For cycle refactoring -* try-catch refactoring -* switch() statement -* while() cycle -* Inline redundant variable -* Constructor and method argument refactoring - -## Formatter Preferences -Easily update default formatter preferences by adjusting a simple configuration option to tailor settings according to specific needs. - -Go to VSCode `View | Command Palette | Preferences:Open User Settings | Extensions | Java` and set `Jdk › Format: Settings Path:` option to the formatter preferences file. - -Please refer to [Java formatting preferences](https://github.com/oracle/javavscode/wiki/Java-formatting-preferences) wiki for more info. - -## Hints Preferences -Easily update default hint preferences by adjusting a simple configuration option to tailor hint preferences to specific needs. - -Go to VSCode `View | Command Palette | Preferences:Open User Settings | Extensions | Java` and set `Jdk › Hints: Preferences:` option to the xml hint preferences file. - -## Organize Imports -Out of the box support for organizing imports in Java sources is available. It removes unused imports, groups imports by packages and updates your imports whenever a file is saved. In addition to the defaults, there is a rich set of configuration options. - -Go to VSCode `View | Command Palette | Preferences:Open User Settings | Extensions | Java` and search for _Jdk_ to set `Jdk > Java > Imports:` options: -* `Count For Using Star Import` - Class count to use a star-import, 999 is the default value -* `Count For Using Static Star Import` - Members count to use a static star-import, 999 is the default value -* `Groups` - Groups of import statements (specified by their package prefixes) and their sorting order. Import statements within a group are ordered alphabetically - -And `View | Command Palette | Preferences:Open User Settings | Extensions > Java > On Save: Organize Imports` - Enable organize imports action on a document save - -## JavaDoc smart editing -When adding JavaDoc to code Oracle Java Platform extension assists by suggesting to insert preformatted and prepopulated JavaDoc comment. Type `/**` above method signature and IDE offers to complete the JavaDoc. The action creates JavaDoc comment with all arguments prepared. -![JavaDoc Completion](images/javadoc.png) - -## Test Explorer -Oracle Java Platform extension provides Test Explorer view which allows to run all tests in a project, examine the results, go to source code and run particular test. -![Test Explorer](images/Test_explorer.png) - -## Selecting the JDK -The JDK to build, run and debug projects is being searched in the following locations: - -- `jdk.project.jdkhome` setting (workspace then user settings) -- `jdk.jdkhome` setting (workspace then user settings) -- `JDK_HOME` environment variable -- `JAVA_HOME` environment variable -- current system path - -As soon as one of the settings is changed, the Language Server is restarted. - -## How to use JDK early access builds -This setup makes it easier to experiment with early access JDK builds. Follow these steps to enable the use of an early access JDK: -Step-1: Navigate to `View | Command Palette | Preferences:Open User Settings | Jdk > Advanced > Disable: Nbjavac` and enable the checkbox. - -Step-2: Set the JDK in `View | Command Palette | Preferences:Open User Settings (JSON) ...` by updating the __jdk.jdkhome__ setting to point to the early access JDK path. - -## Troubleshooting -If your extension is not starting and throwing some error like no JDK found even if you have a working JDK installed in your machine, then you can try deleting cache for the workspace using `View | Command Palette | Delete oracle java extension cache for this workspace`. - -## Workspace -The extension will analyze the content of the opened workspace, and relevant other files. If the workspace contains a lot of data, this may take a long time. It is therefore recommended to avoid adding unnecessarily big folders in a workspace. Specifically, it is not recommended to open user's home directory as a part of the workspace. - -## Contributing - -This project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](../CONTRIBUTING.md) - - -## Security - -Please consult the [security guide](../SECURITY.md) for our responsible security vulnerability disclosure process - -## License - -Copyright (c) 2024 Oracle and/or its affiliates. - -Oracle Java Platform Extension for Visual Studio Code is licensed under [Apache 2.0 License](../LICENSE.txt). -The [THIRD_PARTY_LICENSES](../THIRD_PARTY_LICENSES.txt) file contains third party notices and licenses. diff --git a/vscode/images/logo.png b/vscode/icons/logo.png similarity index 100% rename from vscode/images/logo.png rename to vscode/icons/logo.png diff --git a/vscode/package.json b/vscode/package.json index 5a018474..6ce71448 100644 --- a/vscode/package.json +++ b/vscode/package.json @@ -11,7 +11,7 @@ "url": "https://github.com/oracle/javavscode" }, "publisher": "Oracle", - "icon": "images/logo.png", + "icon": "icons/logo.png", "categories": [ "Programming Languages", "Debuggers",