che-server/samples/sample-plugin-nativeaccess
Dmitry Kuleshov 2559ec009b Exec agent IDE client adaptation (#3383)
exec-agent command manager replacement, several improvements to JSOR RPC
2016-12-16 12:23:19 +02:00
..
che-sample-plugin-nativeaccess-ide Exec agent IDE client adaptation (#3383) 2016-12-16 12:23:19 +02:00
README.md Follow up fixes after configuration property renaming (#2955) 2016-11-02 10:12:58 +02:00
pom.xml [maven-release-plugin] prepare for next development iteration 2016-12-07 12:34:30 +00:00

README.md

Description

This sample extension illustrate how to access workspaces to retrieve configured commands and execute it with a simple action.

Read the tutorial at: https://eclipse-che.readme.io/v5.0/docs/native-access-to-the-workspace

The following sample will create a new file called "che-was-here" in the project by using the native "touch" command.

How to test sample-plugin-nativeaccess plugin

The plugin-nativeaccess extension is only a client-side (IDE) extension. You have to introduce the extension as a dependency in /che/assembly/assembly-ide-war/pom.xml.

Add:

...
<dependency>
  <groupId>org.eclipse.che.sample</groupId>
  <artifactId>che-sample-plugin-nativeaccess-ide</artifactId>
</dependency>
...

You can insert the dependency anywhere in the list. After you have inserted it, run mvn sortpom:sort and maven will order the pom.xml for you.

2- Register dependency to the GWT application

Link the GUI extension into the GWT app. You will add an <inherits> tag to the module definition. The name of the GWT extension is derived from the direction + package structure given to the GWT module defined in our extension.

In: assembly-ide-war/src/main/resources/org/eclipse/che/ide/IDE.gwt.xml

Add:

...
<inherits name='org.eclipse.che.plugin.nativeaccessexample.NativeAccessExample'/>
...

3- Rebuild Eclipse Che

# Build a new IDE.war
# This IDE web app will be bundled into the assembly
cd che/assembly/assembly-ide-war
mvn clean install

# Create a new Che assembly that includes all new server- and client-side extensions
cd assembly/assembly-main
mvn clean install

4- Run Eclipse Che

# Start Che using the CLI with your new assembly
# Replace <version> with the actual directory name
export CHE_ASSEMBLY=path_to_che_sources/assembly/assembly-main/target/eclipse-che-<version>/eclipse-che-<version>
che start

Documentation resources