Distribution

When creating an Equo application using the CLI, the Equo Framework libraries are downloaded and used from a Maven repository, because that’s the usual way to consume libs when developing a Java app. There are some scenarios where user applications have a different layout and, as a result, need to consume their dependencies in a different way. These use cases include OSGI and Eclipse applications.

In order to meet the different application needs to consume libs, Equo Framework is distributed in different ways:

  • as a Maven repository,

  • as an Eclipse P2 repository,

  • and as an OSGI repository.

Each of the following repositories contains Equo Framework Community Edition, which is licensed under GPLv3. You can only used these repositories in open source projects that meet the GPLv3 conditions. If you want to use Equo Framework in a commercial application please contact us.

Using Equo Framework in a Java Application with Maven

This is the default way, and the one that is used by our CLI when it creates Equo apps. To consume Framework libs in your Maven based project, you need to place the following lines in your pom.xml file:

<properties>
  <equo.version>1.1.1</equo.version>
  <maven.compiler.source>11</maven.compiler.source>
  <maven.compiler.target>11</maven.compiler.target>
</properties>

<dependencies>
  <dependency>
    <groupId>com.equo</groupId>
    <artifactId>com.equo.framework.bom</artifactId>
    <version>${equo.version}</version>
  </dependency>
  <dependency>
    <groupId>commons-io</groupId>
    <artifactId>commons-io</artifactId>
    <version>2.6</version>
  </dependency>
</dependencies>

<repositories>
  <repository>
    <id>equo-release</id>
    <name>Equo Public Release Repository</name>
    <url>https://dl.equoplatform.com/framework/mvn/release</url>
  </repository>
</repositories>

Using Equo Framework in an Eclipse Application

The Equo Framework P2 repository can be used to build Java and Eclipse based applications. It can be installed in Eclipse IDEs with the standard mechanism, viewed with viewers like Oomph Repository Explorer in Eclipse, and consumed in tycho/pde/bnd builds as any other P2 Repository. Note that the repositories are not searchable in a browser.

The P2 repository URL of the Equo Framework is:

https://dl.equoplatform.com/framework/1.1/repo/

Using Equo Framework in an OSGI Application

To use Equo Framework in a pure OSGI application, you just need to make reference to the following OSGI repository:

https://dl.equoplatform.com/framework/1.1/repo/index.xml.gz

To start developing OSGI applications you should consider bndtools, which is a great starting point. It basically provides tooling for OSGI apps.