Install Equo

Prerequisites

To develop applications with Equo there are some requirements that need to be met:

  • JDK >= 8

  • An IDE or code editor

  • A build system (Maven or Gradle)

Git

The version control system Git is highly recommended. This will allow you to connect your Equo application with Equo App Manager and take advantage of all the capabilities that it offers. Capabilities such as CI/CD, auto-updates, auto-generated installers, and more.

CLI Installation

The easiest way to create an Equo application is by using the Equo command-line tool. The Equo CLI is the preferred starting point, as it offers a wide range of development tools and help options along the way. It is also the main way to connect it to other services, such as App Manager.

Download the Equo CLI

There is no need to download any external library or tool to use the Equo CLI. To download the Equo CLI execute the following commands in your terminal:

Windows (PowerShell)
Start-BitsTransfer -Source https://www.dl.equo.dev/cli/rls/windows64/equo.exe -Destination C:\Users\$env:UserName\AppData\Local\Microsoft\WindowsApps\equo.exe
macOS
curl -L dl.equo.dev/cli/rls/macos64/equo.tar.gz | tar -xz && sudo mkdir -p /usr/local/bin && sudo install equo /usr/local/bin
Linux
curl -L dl.equo.dev/cli/rls/linux64/equo.tar.gz | tar -xz  && sudo install equo /usr/local/bin

Make sure that the Equo CLI executable file is added to your operating system path so that it can be used globally.

Create your First Application

To start an Equo application from scratch execute the following command:

equo create app_name

The above command generates a basic empty application skeleton that boost the development of your Equo application. Please refer to the Create an Application section for a detailed explanation on how to create an application.

Run the Application

The generated Equo application can be easily ran by using the following command:

equo run ./path_to_the_app_root_folder