build: add support for Visual Studio Code

.gitignore

@@ -4,8 +4,6 @@
 *~
 classes
 target
-.classpath
-.project
 .wtpmodules
 .settings
 .sonar
@@ -38,3 +36,4 @@ bin/
 maven.deps
 DEPENDENCIES
 .java-version
+.tycho-consumer-pom.xml

README.md

@@ -43,13 +43,8 @@ Development on Kura follows a [variant of the gitflow model](https://github.com/
 Getting Started
 -----------------
 
-Development for Kura can be done in Eclipse IDE using the Kura Development Environment, in a gateway or in a Docker container.
-
 ## Development Environment
 
-### Supported Development Platforms
-The Eclipse Installer based setup works for the main used platforms like Linux, Mac OS and Windows.
-
 ### Prerequisites
 Before installing Kura, you need to have the following programs installed in your system
 * JDK 1.8
@@ -155,28 +150,22 @@ mvn -f kura/distrib/pom.xml clean install -DbuildAllContainers
 
 After this command runs, images can be found in your preferred container engine image list.
 
-### Eclipse IDE
-The simplest way to start developing on Eclipse Kura is to use an [Eclipse Installer](https://www.eclipse.org/downloads/) based setup. A detailed installation and setup guide is available on the [official documentation](http://eclipse.github.io/kura/dev/kura-setup.html). Here you'll find a brief explaination of the required steps.
+### Visual Studio Code
+
+The simplest way to start developing on Eclipse Kura is to use a [Visual Studio Code](https://code.visualstudio.com/docs/languages/java) based setup.
 
 To correctly setup the environment, proceed as follows:
-- Install a jdk-8 distribution like [Eclipse Temurin](https://adoptium.net/temurin/releases/?version=8) for your specific CPU architecture and OS.
-- Start the Eclipse Installer
-- Switch to advanced mode (top right hamburger menu > Advanced Mode)
-- Select "Eclipse IDE for Eclipse Committers" and configure the "Product Version" to be the version **2022-06 or older**.
-- Set the Java 1.8+ VM to the installed local jdk-8 VM, and press the Next button
-- Select the Eclipse Kura installer from the list. If this is not available, add a new installer from https://raw.githubusercontent.com/eclipse/kura/develop/kura/setups/kura.setup, then check and press the Next button
-- Select the "Developer Type":
-  - "User": if you want to develop applications or bundles running on Kura, select this option. It will install only the APIs and the examples.
-  - "Developer" : if you are a framework developer, select this option. It will download and configure the Eclipse Kura framework.
-- Update Eclipse Kura Git repository username and customize further settings if you like (e.g. Root install folder, Installation folder name). To show these options, make sure that the "Show all variables" checkbox is enabled
-- Leave all Bootstrap Tasks selected and press the Finish button
-- Accept all the licenses and wait for the installation to finish
-At first startup Eclipse IDE will checkout the code, perform a full build and configure a few Working Sets. 
-- When the tasks are completed. In the IDE open (double click) Target Platform > Target-Definition > Kura Target Platform Equinox 3.16.0, and press "Set as Target Platform" located at the top right of the window
+- Open Visual Studio Code in the `kura` directory.
+- Install the recommended extensions.
+- Load the project in [Standard Mode](https://code.visualstudio.com/docs/java/java-project#_lightweight-mode).
+- After the build completes you'll see a lot of errors. This is normal. To fix this run the _"Developer: Reload Window"_ command in the [Command Palette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette)(this is needed only once, the first time you import the project).
+- ... and you're done!
 
 Now you are ready to develop on Eclipse Kura.
 
-To raise an issue, please report a bug on [GitHub issues](https://github.com/eclipse/kura/issues/new).
+### Eclipse IDE
+
+If you prefer a more advanced setup you can follow the setup instructions for [Eclipse IDE](https://eclipse.github.io/kura/latest/java-application-development/development-environment-setup/).
 
 ### Known Issues
 Currently, the emulator web ui is not properly working on Windows so, with your setup, you will be able to build and deploy you applications, but not be able to use the Eclipse IDE based Kura emulator.

kura/.project

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>kura</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.m2e.core.maven2Builder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.m2e.core.maven2Nature</nature>
+	</natures>
+	<filteredResources>
+		<filter>
+			<id>1681116377785</id>
+			<name></name>
+			<type>30</type>
+			<matcher>
+				<id>org.eclipse.core.resources.regexFilterMatcher</id>
+				<arguments>node_modules|\.git|__CREATED_BY_JAVA_LANGUAGE_SERVER__</arguments>
+			</matcher>
+		</filter>
+	</filteredResources>
+</projectDescription>

kura/.vscode/extensions.json

@@ -0,0 +1,17 @@
+{
+	// List of extensions which should be recommended for users of this workspace.
+	"recommendations": [
+		"redhat.java",
+		"vscjava.vscode-java-debug",
+		"vscjava.vscode-java-dependency",
+		"vscjava.vscode-java-pack",
+		"vscjava.vscode-java-test",
+		"vscjava.vscode-maven",
+		"sonarsource.sonarlint-vscode",
+		"yaozheng.vscode-pde"
+	],
+	// List of extensions recommended by VS Code that should not be recommended for users of this workspace.
+	"unwantedRecommendations": [
+
+	]
+}

kura/.vscode/launch.json

@@ -0,0 +1,125 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "java",
+            "name": "Remote Kura debug",
+            "request": "attach",
+            "hostName": "${input:ipAddress}",
+            "projectName": "${input:bundleProject}",
+            "port": 8000
+        }
+    ],
+    "inputs": [
+        {
+          "id": "ipAddress",
+          "type": "promptString",
+          "description": "IP Address of the device running Kura"
+        },
+        {
+          "id": "bundleProject",
+          "type": "pickString",
+          "description": "Select the bundle project to be debugged",
+          "options":[
+            "org.eclipse.kura.ai.triton.server",
+            "org.eclipse.kura.api",
+            "org.eclipse.kura.asset.cloudlet.provider",
+            "org.eclipse.kura.asset.helper.provider",
+            "org.eclipse.kura.asset.provider",
+            "org.eclipse.kura.ble.eddystone.provider",
+            "org.eclipse.kura.ble.ibeacon.provider",
+            "org.eclipse.kura.ble.provider",
+            "org.eclipse.kura.broker.artemis.core",
+            "org.eclipse.kura.broker.artemis.simple.mqtt",
+            "org.eclipse.kura.broker.artemis.xml",
+            "org.eclipse.kura.camel",
+            "org.eclipse.kura.camel.cloud.factory",
+            "org.eclipse.kura.camel.xml",
+            "org.eclipse.kura.cloudconnection.eclipseiot.mqtt.provider",
+            "org.eclipse.kura.cloudconnection.raw.mqtt.provider",
+            "org.eclipse.kura.configuration.change.manager",
+            "org.eclipse.kura.container.orchestration.provider",
+            "org.eclipse.kura.container.provider",
+            "org.eclipse.kura.core",
+            "org.eclipse.kura.core.certificates",
+            "org.eclipse.kura.core.cloud",
+            "org.eclipse.kura.core.cloud.factory",
+            "org.eclipse.kura.core.comm",
+            "org.eclipse.kura.core.configuration",
+            "org.eclipse.kura.core.crypto",
+            "org.eclipse.kura.core.deployment",
+            "org.eclipse.kura.core.inventory",
+            "org.eclipse.kura.core.keystore",
+            "org.eclipse.kura.core.net",
+            "org.eclipse.kura.core.status",
+            "org.eclipse.kura.core.system",
+            "org.eclipse.kura.core.tamper.detection",
+            "org.eclipse.kura.db.sqlite.provider",
+            "org.eclipse.kura.deployment.agent",
+            "org.eclipse.kura.docs",
+            "org.eclipse.kura.driver.ble.sensortag.provider",
+            "org.eclipse.kura.driver.ble.xdk",
+            "org.eclipse.kura.driver.block",
+            "org.eclipse.kura.driver.eddystone.provider",
+            "org.eclipse.kura.driver.gpio.provider",
+            "org.eclipse.kura.driver.helper.provider",
+            "org.eclipse.kura.driver.ibeacon.provider",
+            "org.eclipse.kura.driver.opcua.provider",
+            "org.eclipse.kura.driver.s7plc.provider",
+            "org.eclipse.kura.event.publisher",
+            "org.eclipse.kura.hook.file.move.provider",
+            "org.eclipse.kura.http.server.manager",
+            "org.eclipse.kura.json.marshaller.unmarshaller.provider",
+            "org.eclipse.kura.linux.bluetooth",
+            "org.eclipse.kura.linux.clock",
+            "org.eclipse.kura.linux.command",
+            "org.eclipse.kura.linux.debian.provider",
+            "org.eclipse.kura.linux.gpio",
+            "org.eclipse.kura.linux.net",
+            "org.eclipse.kura.linux.position",
+            "org.eclipse.kura.linux.redhat.provider",
+            "org.eclipse.kura.linux.systemd.provider",
+            "org.eclipse.kura.linux.sysv.provider",
+            "org.eclipse.kura.linux.usb",
+            "org.eclipse.kura.linux.usb.aarch64",
+            "org.eclipse.kura.linux.usb.armv6hf",
+            "org.eclipse.kura.linux.usb.x86_64",
+            "org.eclipse.kura.linux.watchdog",
+            "org.eclipse.kura.localization",
+            "org.eclipse.kura.localization.resources",
+            "org.eclipse.kura.log.filesystem.provider",
+            "org.eclipse.kura.misc.cloudcat",
+            "org.eclipse.kura.net.admin",
+            "org.eclipse.kura.net.admin.firewall",
+            "org.eclipse.kura.net.configuration",
+            "org.eclipse.kura.network.threat.manager",
+            "org.eclipse.kura.nm",
+            "org.eclipse.kura.protocol.can",
+            "org.eclipse.kura.protocol.modbus",
+            "org.eclipse.kura.request.handler.jaxrs",
+            "org.eclipse.kura.rest.asset.provider",
+            "org.eclipse.kura.rest.configuration.provider",
+            "org.eclipse.kura.rest.network.status.provider",
+            "org.eclipse.kura.rest.provider",
+            "org.eclipse.kura.rest.wire.provider",
+            "org.eclipse.kura.stress",
+            "org.eclipse.kura.useradmin.store",
+            "org.eclipse.kura.util",
+            "org.eclipse.kura.web2",
+            "org.eclipse.kura.web2.ext",
+            "org.eclipse.kura.wire.ai.component.provider",
+            "org.eclipse.kura.wire.camel",
+            "org.eclipse.kura.wire.component.conditional.provider",
+            "org.eclipse.kura.wire.component.join.provider",
+            "org.eclipse.kura.wire.component.provider",
+            "org.eclipse.kura.wire.db.component.provider",
+            "org.eclipse.kura.wire.h2db.component.provider",
+            "org.eclipse.kura.wire.helper.provider",
+            "org.eclipse.kura.wire.provider",
+            "org.eclipse.kura.wire.script.filter.provider",
+            "org.eclipse.kura.wire.script.tools",
+            "org.eclipse.kura.xml.marshaller.unmarshaller.provider"
+          ]
+        }
+    ]
+}

kura/.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "java.format.settings.url": "setups/formatting/KuraFormatter.xml",
+    "editor.defaultFormatter": "redhat.java",
+    "editor.formatOnSave": true
+}

kura/emulator/.project

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>emulator</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.m2e.core.maven2Builder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.m2e.core.maven2Nature</nature>
+	</natures>
+	<filteredResources>
+		<filter>
+			<id>1681116377782</id>
+			<name></name>
+			<type>30</type>
+			<matcher>
+				<id>org.eclipse.core.resources.regexFilterMatcher</id>
+				<arguments>node_modules|\.git|__CREATED_BY_JAVA_LANGUAGE_SERVER__</arguments>
+			</matcher>
+		</filter>
+	</filteredResources>
+</projectDescription>

kura/emulator/org.eclipse.kura.emulator.clock/.classpath

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
+	<classpathentry kind="con" path="org.eclipse.pde.core.requiredPlugins"/>
+	<classpathentry kind="src" path="src/main/java/"/>
+	<classpathentry kind="output" path="target/classes"/>
+</classpath>

kura/emulator/org.eclipse.kura.emulator.clock/.project

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>org.eclipse.kura.emulator.clock</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.pde.ManifestBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.pde.SchemaBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.m2e.core.maven2Builder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.m2e.core.maven2Nature</nature>
+		<nature>org.eclipse.pde.PluginNature</nature>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+	</natures>
+	<filteredResources>
+		<filter>
+			<id>1681116377988</id>
+			<name></name>
+			<type>30</type>
+			<matcher>
+				<id>org.eclipse.core.resources.regexFilterMatcher</id>
+				<arguments>node_modules|\.git|__CREATED_BY_JAVA_LANGUAGE_SERVER__</arguments>
+			</matcher>
+		</filter>
+	</filteredResources>
+</projectDescription>

kura/emulator/org.eclipse.kura.emulator.gpio/.classpath

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
+	<classpathentry kind="con" path="org.eclipse.pde.core.requiredPlugins"/>
+	<classpathentry kind="src" path="src/main/java/"/>
+	<classpathentry kind="output" path="target/classes"/>
+</classpath>

kura/emulator/org.eclipse.kura.emulator.gpio/.project

@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>org.eclipse.kura.emulator.gpio</name>
+	<comment></comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.pde.ManifestBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.pde.SchemaBuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.m2e.core.maven2Builder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.m2e.core.maven2Nature</nature>
+		<nature>org.eclipse.pde.PluginNature</nature>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+	</natures>
+	<filteredResources>
+		<filter>
+			<id>1681116377990</id>
+			<name></name>
+			<type>30</type>
+			<matcher>
+				<id>org.eclipse.core.resources.regexFilterMatcher</id>
+				<arguments>node_modules|\.git|__CREATED_BY_JAVA_LANGUAGE_SERVER__</arguments>
+			</matcher>
+		</filter>
+	</filteredResources>
+</projectDescription>

kura/emulator/org.eclipse.kura.emulator.net/.classpath

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<classpath>
+	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER"/>
+	<classpathentry kind="con" path="org.eclipse.pde.core.requiredPlugins"/>
+	<classpathentry kind="src" path="src/main/java/"/>
+	<classpathentry kind="output" path="target/classes"/>
+</classpath>