In this repository you can find some application that can be installed on an Eclipse Kura™ instance.
- Kura™ Examples: provides examples of component that can be developed for the Eclipse Kura™ framework.
- Kura™ Prototypes: provides prototypes of components that can be developed for the Eclipse Kura™ framework.
For the complete guide to setup the development environment, please refer to the Eclipse Kura™ documentation.
In order to be able to build the applications for Eclipse Kura™ on your development machine, you need to have the following programs installed in your system:
- JDK 17
- Maven 3.9.x
To install Java 17, download the JDK tar archive from the Adoptium Project Repository.
Once downloaded, copy the tar archive in /Library/Java/JavaVirtualMachines/ and cd into it. Unpack the archive with the following command:
sudo tar -xzf <archive-name>.tar.gzThe tar archive can be deleted afterwards.
Depending on which terminal you are using, edit the profiles (.zshrc, .profile, .bash_profile) to contain:
export JAVA_HOME=/Library/Java/JavaVirtualMachines/<archive-name>/Contents/HomeReload the terminal and run java -version to make sure it is installed correctly.
Using Brew you can easily install Maven from the command line:
brew install [email protected]Run mvn -version to ensure that Maven has been added to the PATH. If Maven cannot be found, try running brew link [email protected] --force or manually add it to your path with:
export PATH="/usr/local/opt/[email protected]/bin:$PATH"For Java
sudo apt install openjdk-17-jdkFor Maven
You can follow the tutorial from the official Maven site. Remember that you need to install the 3.9.x version.
Change to the new directory and clone the Applications Eclipse Kura™ repo:
git clone https://github.com/eclipse-kura/kura-apps.gitBuild the project:
mvn clean installTip
You can skip tests by adding -Dmaven.test.skip=true in the commands above.
The Debian installers for the examples and prototypes will be generated in the kura-apps-distrib directory, under kura-examples/target/deb and kura-addon-prototypes/target/deb respectively.
Contributing to the Applications for Eclipse Kura™ is fun and easy! To start contributing you can follow our guide here.