Get Started With TotalCross
Download the TotalCross SDK
Hello World with TotalCross
Step 1 - Create a new TotalCross project called Hello World.
How? From the VSCode Command Palette (CTRL + Shift + P on Windows, ⇧⌘P on Mac), type TotalCross and select TotalCross: Create new Project.
Step 2 - A new window will open with your project.
Right click the RunHelloWorldApplication.java file inside src/main/com/totalcross and choose Run. The TotalCross simulator will open with your brand new application.
Tip - To fill in the prompted questions:
- GroupId is the domain of your company backward as in org.wikipedia for wikipedia.org. Feel free to leave it as com.totalcross for now.
- ArtifactId is the name of your application, for this example type HelloWorld.
- Select the latest version of TotalCross SDK and choose whatever platform you intend to deploy your application.
For other IDEs
Step 1 - Open your IDE and import the Hello World repository you downloaded.
Step 2 - Inside src/main/java/com.totalcross, right-click the RunHelloWordApplication.java and choose Run. The TotalCross simulator will open with your brand new application.
Packaging and Deployment
Step 1: Open VSCode Command Palette (CTRL+Shift+P on Windows, ⇧⌘P on Mac) and search for TotalCross: Package.
Step 2: When the packaging process is finished the target program will take place inside the folder target/install/~platform~.
Deployment is currently working only for linux arm programs. This feature performs the implementation and execution of the platform via ssh.
Step 1: Open VSCode Command Palette (CTRL + Shift + P on Windows, ⇧⌘P on Mac) and search for TotalCross: Deploy&Run. If you just want to deploy, choose the option TotalCross: Deploy.
Step 2: Fill in the device information.
Step 3: See the result on a display connected to your device or with a VNC client.
For other IDEs
First embedded project with TotalCross
Follow this step by step tutorial on how to build your first embedded application using TotalCross.