Development

Prerequisites

To build Arduino Cloud Agent from sources, you need the following tools to be available in your local environment:

• Go You must use the version specified by the go directive in the project's go.mod file:
  https://github.com/arduino/arduino-create-agent/blob/main/go.mod
  ⓘ gvm is recommended if you need to work with multiple versions of Go on your machine.
• Task to help you run the most common tasks from the command line

Local Development with auto-reload

task run

Build the project and run it with auto-reload (if any *.go files are changed the tool is relaunched automatically) and data-race enable (to spot DATA RACE warning).

Building the source code

From the project folder root, just run:

task go:build

The project uses Go modules, so dependencies will be downloaded automatically. At the end of the build, you should find an arduino-cloud-agent executable in the same folder.

Compile without systray support

In case you prefer to build without tray icon support, use the following command:

go:build-cli

In this case, the executable will be named arduino-cloud-agent_cli.