@phoenix-plugin-registry/adelwehbi.bracketsjdk

1.0.1 • Public • Published

brackets-jdk

Integration for Java Development Kit. Compiles and Runs. Includes its own Java Console.

Dependencies

  • Shelljs (will be phased out in the future)
  • Java Development Kit (java and javac commands should run correctly from the Command Prompt or Terminal)

Usage

The Extension adds 4 commands to the Edit Menu in the Menu Bar:

  • Build Java Project (Shortcut: Shift-F6)
  • Run Java Project (Shortcut: None)
  • Build and Run Java Project (Shortcut: Ctrl-Shift-F6)
  • Toggle Java Console (Shortcut: Ctrl-Alt-J)

Java Project are considered to be the folders present on Bracket's Project Root. So for example, say you want to create two Java projects, you create two new folders on the Bracket's Project Root called "JavaProject1" and "JavaProject2". In the future, this will be a preference option.

Which java project to compile is determined by the currently viewed file. In our example, if you're currently viewing a file main.java" located immediately in the "JavaProject1" directory and you use the Compile command, then "JavaProject1" will be compiled.

Compiled files are placed in the directory bin/ inside the project. If that directory does not exist, it will be created. This directory is emptied before each compilation. In the future, the location of this directory will be a preference choice.

When using th Run command, the extension itself finds the class that contains the main method using the Regex public\s+static\s+void\s+main and runs that class.

Currently, this extension only supports one point of entry to any Java project. If you have several main methods in your project, the first class found to have that method will be run.

TODO

I intend to work on these features later on. However, if you would like to contribute, go ahead! Do make me aware that you've adopted a feature from the TODO list so I don't start from scratch on it. If you'd like a specific feature added to this list, file an issue! Here's the TODO list (There's no order of priority):

  • Remove the Shelljs dependency as it turned out it isn't very necessary. (Phasing its use out should be easy)
  • Support setting preferences such as whether to have the entire workspace be one Java project, the location of the build directory...
  • Support multiple project entry points (multiple main methods).
  • Autocomplete support for Java.
  • Java linting and error detection.
  • Support displaying Java documentation (including for user created functions).

Contribute

Contributing to this project should be fairly easy. There are a few things to keep in mind though. If you want to modify anything that normally occurs on the command line (compiling, or running, etc...), you need to effect your modifications on the Nodejs end of Brackets. An example of that is the file bracketsjdk.js. You can modify that file or imitate it. If you want to call any function on the Nodejs side from the node-webkit side, you'll have to use the Node Domain variable (that would be the variable bracketsjdk in the main.js file). If you want to send something from the Nodejs side to the node-webkit side, however, you'll have to use the DomainManager.emitEvent function (see bracketsjdk.js for an example).

For a clearer explanation on how that works, consult the Brackets Node Process: Overview for Developers.

Package Sidebar

Install

npm i @phoenix-plugin-registry/adelwehbi.bracketsjdk

Weekly Downloads

6

Version

1.0.1

License

none

Unpacked Size

496 kB

Total Files

195

Last publish

Collaborators

  • ushmajit
  • core.ai