Wie fängt man mit Gradle an?

Wir verwenden das Build-Automatisierungstool Gradle in all unseren Projekten. Unsere Distributionen enthalten alle voll funktionsfähige Gradle-Build-Dateien (build.gradle). Wenn Sie also den Code geändert haben und eine Bibliothek neu erstellen möchten, können Sie dies einfach mit Gradle tun. Auch wenn Sie unsere Software in Eclipse importieren möchten, können Sie mit Gradle einfach Eclipse-Projektdateien erstellen. Unsere Projekte enthalten auch den Gradle-Wrapper. Sie können entweder den Gradle-Wrapper (gradlew) im Wurzelverzeichnis des Projekts verwenden oder Gradle auf Ihrem System installieren. Folgen Sie einfach diesen Anweisungen:

Gradle installieren (optional, falls der Gradle-Wrapper nicht verwendet wird):

• Laden Sie die neueste Version von Gradle von der Website herunter: https://gradle.org/

  • Fügen Sie das bin-Verzeichnis von Gradle zum user/system Pfad hinzu:

  • in Unix-Systemen: Fügen Sie export PATH=$PATH:/home////bin to ~/.bashrc hinzu

• in Windows folgen Sie diesen Anweisungen

• Gradle wird automatisch die Projekt-Abhängigkeiten von Maven Central herunterladen. Wenn Sie sich hinter einem Proxy befinden, sollten Sie die Proxy-Optionen in der gradle.properties Datei setzen, wie hier erklärt.

Installieren Sie ein Java JDK >= 8

• Wir verwenden mindestens OpenJDK 8 zum Kompilieren unserer Projekte. Wenn Sie mehrere JDKs installiert haben, möchten Sie möglicherweise die org.gradle.java.home-Eigenschaft in der gradle.properties-Datei festlegen.

Erstellen Sie Eclipse-Projektdateien mit Gradle:

• Mit dem Befehl gradle eclipse oder ./gradlew eclipse können Sie Eclipse-Projektdateien generieren

• Nachdem die Eclipse-Projektdateien generiert wurden, können Sie das Projekt in einen Eclipse-Arbeitsbereich importieren

• Es ist wichtig, die Variable GRADLE_USER_HOME in Eclipse hinzuzufügen: Window->Preferences->Java->Build Path->Classpath Variable. Setzen Sie es auf den Pfad des Ordners ~/.gradle in Ihrem Home-Verzeichnis (e.g. /home/<user_name>/.gradle/ (Unix) or C:\Users<user_name>.gradle\ (Windows))

Eine Bibliothek neu erstellen:

• Nachdem Sie den Code geändert haben, können Sie den Code vollständig neu aufbauen mit dem Befehl gradle build. Dies wird auch die JUnit-Tests ausführen oder die Javadoc- und Handbücher generieren.

• Führen Sie gradle tasks aus, um eine Liste aller Gradle-Aufgaben zu erhalten

• Sie können auch eine neue Distributionstar-Datei zusammenstellen: der Befehl gradle clean tar wird alles bauen und eine neue Distributionsdatei im Ordner <project_root>/build/distribution ablegen.

Wie bekomme ich die serielle Kommunikation mit jRxTx oder RXTX zum Laufen?

Viele unserer Softwarekomponenten sind von der Java-Bibliothek RXTX (Copyright 1997-2004 von Trent Jarvi) abhängig, um auf den seriellen Port (UART) zuzugreifen. Derzeit verlagern wir unsere Projekte auf jRxTx, das ein von uns geschriebener Wrapper von RXTX ist. jRxTx bietet viele Vorteile gegenüber RXTX, wie eine verbesserte API, OSGi-Fähigkeit, Hosting auf Maven Central usw.

Zusätzlich zur neuen API bietet jRxTx auch die Legacy-RXTX-API an. Selbst wenn Sie eine unserer Bibliotheken verwenden, die noch von RXTX abhängig sind, können Sie jRxTx mit ihnen verwenden. Schauen Sie sich die README auf Github an, um Anweisungen zur Einrichtung von jRxTx auf Ihrem System zu erhalten.