strolch-website/docs/development/index.xml

13 lines
5.0 KiB
XML

<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Development on Strolch</title><link>https://strolch.li/development/</link><description>Recent content in Development on Strolch</description><generator>Hugo -- gohugo.io</generator><language>en-us</language><atom:link href="https://strolch.li/development/index.xml" rel="self" type="application/rss+xml"/><item><title>Prerequisites</title><link>https://strolch.li/development/prerequisites/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://strolch.li/development/prerequisites/</guid><description>Prerequisites To start developing Strolch you need an installed:
Java JDK 17 Apache Maven 3.x You can install these using the awesome SDKMAN!:
$ curl -s &amp;#34;https://get.sdkman.io&amp;#34; | bash source &amp;#34;$HOME/.sdkman/bin/sdkman-init.sh&amp;#34; sdk version sdk install java sdk install maven sdk install mvnd Test your Java installation:
$ java -version openjdk version &amp;#34;17.0.4&amp;#34; 2022-07-19 OpenJDK Runtime Environment Temurin-17.0.4+8 (build 17.0.4+8) OpenJDK 64-Bit Server VM Temurin-17.0.4+8 (build 17.0.4+8, mixed mode, sharing) Test your Maven installation:</description></item><item><title>Building Strolch</title><link>https://strolch.li/development/building/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://strolch.li/development/building/</guid><description>Building Strolch Note: You don&amp;rsquo;t have to build Strolch if you want to use the version on Maven central. If you need a snapshot version, the release you want isn&amp;rsquo;t on Maven central or you want to use the Strolch Maven archetypes, then go ahead and build Strolch.
Building Strolch is just a few lines:
git clone https://github.com/strolch-li/strolch.git cd strolch mvn clean install -DskipTests Note: To run the tests you will need to configure the PostgreSQL Databases.</description></item><item><title>Maven Archetypes</title><link>https://strolch.li/development/maven-archetypes/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://strolch.li/development/maven-archetypes/</guid><description>Maven Archetypes Maven offers archetypes to generate new projects. Strolch offers the following archetypes, to create new projects:
li.strolch.mvn.archetype.main for Java main class applications li.strolch.mvn.archetype.webapp for Java Web based applications using REST and Polymer 1.x as the frontend. li.strolch.mvn.archetype.plc for Strolch PLC projects. To use the archetypes, clone the archetypes repository and install it locally:
git clone https://github.com/strolch-li/strolch-maven-archetypes.git cd strolch-maven-archetypes git checkout 0.1.0 mvn clean install Then follow one of the next steps to create the type of application you want.</description></item><item><title>Web App</title><link>https://strolch.li/development/web-app/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://strolch.li/development/web-app/</guid><description>Prerequisites To start developing web-based Strolch apps you need the following:
Apache Tomcat 9.x (10.x isn&amp;rsquo;t supported yet). Just unpack it somewhere, to be used later, when running the application. NodeJS v11.x (other versions don&amp;rsquo;t work with Bower, the installation is described below. Note: Strolch&amp;rsquo;s Web UI is still using Polymer 1.x. This isn&amp;rsquo;t a big concern, as thanks to the polyfills, it works on all browsers, including Internet Explorer 11.</description></item><item><title>Main Class App</title><link>https://strolch.li/development/main-class-app/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://strolch.li/development/main-class-app/</guid><description>Creating a Strolch App The following shows the maven command to create the new maven project using Strolch&amp;rsquo;s main maven archetype. Note that you should replace the placeholders in the brackets:
Note: you need to have the Strolch Maven archetypes installed to your local maven repo, otherwise the following command will fail.
mvn archetype:generate \ -DarchetypeGroupId=li.strolch \ -DarchetypeArtifactId=li.strolch.mvn.archetype.main \ -DarchetypeVersion=0.1.0-SNAPSHOT \ -DgroupId=&amp;lt;my.groupid&amp;gt; \ -DartifactId=&amp;lt;my-artifactId&amp;gt; \ -Dversion=&amp;lt;my.</description></item><item><title>Converting Existing App</title><link>https://strolch.li/development/converting-existing/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://strolch.li/development/converting-existing/</guid><description>Converting an existing application You can convert an existing application to a Strolch agent, but this might be a bit daunting in the beginning. If you are planning on doing this, first create a test application using the maven archetypes, so that you can get a feel for the configuration.
Once that works, use the archetypes configuration to reconfigure your project to start as a Strolch agent.
Note: Beware to select the archetype pertaining to your use case:</description></item></channel></rss>