Installation

Download JARU IDE

Download the latest version of JARU IDE from the official website:

• Download JARU IDE for Windows

Windows installation

1. Unzip the downloaded file (JARU_IDE_0.9.7_Setup.zip)
2. Run the installer inside it (JARU_IDE_0.9.7_Setup.exe)

Windows security notice

The installer is digitally signed with a code signing certificate issued to Juan Otero Fernández. Even so, Windows may display a warning for as long as the certificate takes to build up reputation with SmartScreen.

To proceed with the installation:

1. Click on "More info"
2. Select "Run anyway"

You can check the signature at any time: right-click the .exe, open Properties, and go to the "Digital Signatures" tab.

3. The installer asks for administrator permission, because it installs into C:\Program Files, and lets you choose its language: English or Spanish
4. Accept the license agreement
5. Select the destination folder (by default, C:\Program Files\JARU IDE)
6. Choose whether to create a desktop shortcut
7. Click "Install"
8. On the last page you can choose to open the README and to start JARU IDE. When you click "Finish", if the computer is online, the JARU website's welcome page opens in your browser: the first steps on a new install, or what is new in this version if you are upgrading from an earlier one

First launch

When opening JARU IDE for the first time:

1. It creates the Documents\JARUProjects folder, where new projects go by default
2. It copies the installation's board profiles and I2C drivers into your user folder (AppData\Local\JaruIDE)
3. It opens the project wizard (Project Wizard), as it does every time it starts: from it you create a project (New Project), open one (Load Project or Recent Projects) or start from an example (Example Projects), which is copied into JARUProjects under the name you give it. If you close it without choosing anything, the IDE closes
4. If the Check for updates on startup box in Settings is ticked, as it is by default, it checks in the background whether there is a new version

Verify installation

To verify everything is working correctly:

1. Open JARU IDE: it starts with the project wizard
2. Click New Project, type a name in Project Name (for example, Test) and click Finish. The IDE creates the project in Documents\JARUProjects, and its main file already has a test line:

println('Hello World from Test');

3. On the Build tab, click Run. The IDE builds the project and runs it on the Windows VM
4. A console opens with the message Hello World from Test. What the program prints goes there, not to the Output panel. Press any key to close it

Upgrading from 0.9.6

Install 0.9.7 over 0.9.6 like a normal install: there is no need to uninstall first. Then:

• Flash the VM firmware on each board before uploading programs compiled with 0.9.7 to it: Flash Firmware, in ESP32 Tools (Config › Platform › ESP32). A 0.9.6 firmware does not reject them: it stops at the first new instruction with the error "Unknown Opcode encountered".
• Rebuild your projects (Build › Compile) so that the IDE regenerates their resources: the sprites, which now come as a single image, the scene editor rooms, and the actors.
• Board profiles: in 0.9.7 they are named after the board's brand and model. When the new IDE starts, the old-named ones you have not edited go away and the new ones appear; one you edited keeps its old name. Your projects do not change: the name of the profile each board came from is only a reference.
• The installation's Examples folder is emptied and filled again with the 0.9.7 examples, so do not keep anything in it. The projects you created from an example are in JARUProjects and are not touched.

The changes that may require touching code are in the 0.9.7 release notes.

Troubleshooting

IDE won't start

• Verify you have 64-bit Windows 10 or 11
• Run the installer as administrator
• Check that your antivirus is not blocking the application

VM error

• Reinstall JARU IDE
• Verify you have enough disk space

Support

If you have installation problems, contact info@jarulang.com