Running Java in Acode

Relevant source files

The following files were used as context for generating this wiki page:

• tutorials/how-to-run-java.md
• user-guide/terminal.md
• user-guide/plugins.md
• user-guide/settings/terminal-settings.md
• user-guide/file-browser.md
• user-guide/settings/app-settings.md

Running Java within the Acode environment requires a terminal interface to handle compilation and execution. Acode provides two primary methods for Java development: using the built-in terminal environment (Alpine Linux) or integrating with external terminal emulators like Termux. Both methods rely on a Java Development Kit (JDK) to process source code.

Sources: tutorials/how-to-run-java.md:12-20, user-guide/terminal.md:5-10

Execution Environments

You can execute Java code using either the native internal terminal or an external integration.

Built-in Terminal (Recommended)

Acode includes a full Linux terminal environment based on Alpine Linux using proot. This environment supports package management via apk and allows you to install development tools directly within the editor. The Runner plugin facilitates this by adding a dedicated "Play" button to the interface, which automates the execution of Java files in the built-in terminal.

Sources: user-guide/terminal.md:5-15, tutorials/how-to-run-java.md:16-20

Termux Integration

Termux serves as a third-party Linux terminal emulator for Android. When using Termux, the AcodeX - Terminal plugin acts as a bridge, allowing Acode to communicate with a terminal server running in the Termux environment.

Sources: tutorials/how-to-run-java.md:46-52

Architecture and Workflow

The following diagram illustrates the flow from code writing to execution using the AcodeX and Termux integration.

This diagram shows how Acode interfaces with different terminal backends to compile and run Java.

Sources: tutorials/how-to-run-java.md:55-65, user-guide/terminal.md:18-25

Installation and Configuration

1. JDK Installation

You must install the OpenJDK to compile (javac) and run (java) applications.

Environment	Command	Notes
Termux	pkg install openjdk-17	Requires pkg update first.
Built-in	apk add openjdk17	Uses Alpine package manager.

Sources: tutorials/how-to-run-java.md:40-42, user-guide/terminal.md:28-35

2. Plugin Setup

Plugins extend the editor to support terminal communication and execution shortcuts.

• Runner Plugin: Adds a UI element to run files using the built-in terminal.
• AcodeX - Terminal: Requires an external server. Install the server in Termux using:
  curl -sL https://raw.githubusercontent.com/bajrangCoder/acode-plugin-acodex/main/installServer.sh | bash

Sources: tutorials/how-to-run-java.md:17-20, tutorials/how-to-run-java.md:55-60, user-guide/plugins.md:10-25

3. Storage and Path Linking

Terminal environments require specific permissions to access Java files stored on the device.

• Internal Storage: In Terminal Settings, enable All Files Access (Android 10+ only).
• Path Linking: Use the File Browser to add the Termux home directory or project folders to the Acode sidebar via the Add Path button.

Sources: user-guide/settings/terminal-settings.md:5-9, user-guide/file-browser.md:25-30, tutorials/how-to-run-java.md:75-85

Compiling and Running

The compilation process converts .java source files into bytecode, which the Java Virtual Machine then executes.

Manual Execution Sequence

1. Open Terminal: Use the shortcut Ctrl + K (or Ctrl + Shift + P and search for Terminal).
2. Navigate: Use cd or the terminal's folder icon to enter the project directory.
3. Compile: Run javac FileName.java.
4. Execute: Run java FileName.

The sequence diagram details the interaction between the user interface, the terminal backend, and the Java Development Kit.

Sources: tutorials/how-to-run-java.md:92-105, user-guide/terminal.md:40-45

Terminal Customization

Users can modify the terminal behavior to optimize the Java development workflow via Settings → Terminal Settings.

Category	Setting	Impact on Java Development
Permissions	All Files Access	Allows reading/writing source files in internal storage.
Behavior	Scrollback Lines	Retains stack trace history for debugging.
Appearance	Font Family	Enhances code readability for terminal output.

Sources: user-guide/settings/terminal-settings.md:10-35, user-guide/settings/app-settings.md:25-30

Conclusion

Running Java in Acode leverages Android's Linux capabilities through terminal emulation. By combining either the built-in Alpine Linux environment or Termux with OpenJDK 17, developers can compile and debug Java applications directly on mobile devices. Proper configuration of file paths and terminal permissions is essential for seamless access to project files.

Sources: tutorials/how-to-run-java.md:108-110, user-guide/terminal.md:130-135