Get Started With TotalCross

Install the tools, run Hello World, and deploy your first embedded interface.

What you need

  1. An IDE. We recommend Visual Studio Code, but any Java IDE works.
  2. A compatible Java installation.
  3. Apache Maven.
  4. The TotalCross SDK and a project to start coding.

Download the TotalCross SDK

For another IDE

Clone the Hello World repository and follow its README. IntelliJ and Eclipse guides remain available in the community archives.

Hello World with TotalCross

VS Code

  1. Open the Command Palette and select TotalCross: Create new Project.
  2. Name the project HelloWorld and select the current SDK and deployment platform.
  3. Run RunHelloWorldApplication.java. The simulator opens your application.

Other IDEs

  1. Import the Hello World repository.
  2. Run RunHelloWorldApplication.java from the IDE.

Packaging and deployment

VS Code

Use TotalCross: Package from the Command Palette. The packaged program is written under target/install/<platform>.

For Linux Arm targets, use TotalCross: Deploy or TotalCross: Deploy&Run, enter the SSH device details, and view the result on the attached display or through VNC.

Other IDEs

Follow the Maven packaging and deployment instructions in the project README or ask for help in Telegram or Discord.

First embedded project

Follow the community tutorial and connect the application to real hardware.