Hexagon Geospatial
MENU

Developers Knowledge Base

GeoMedia Smart Client Workflow Manager provides tools for building and delivering highly-constrained, map-based workflows for the office or the field.
Showing results for 
Search instead for 
Do you mean 

Client Extension Deployment (until 2018 Update 3)

by Technical Evangelist on ‎10-18-2018 02:58 AM - edited 4 weeks ago by Technical Evangelist (68 Views)

To add your extension to an existing GeoMedia Smart Client installation please follow these steps:

  1. Create a jar file
  2. Sign the jar
  3. Create a jnlp
  4. Add the extension to the plugins folder on the server
  5. Users must download the GMSC Client again to get the extension

Create a jar file

GMSC Client Extensions are deployed as jar files. Jar files are used to bundle multiple files into one package.To learn more about jar files please visit the Java Tutorials: https://docs.oracle.com/javase/tutorial/deployment/jar/index.html 

General information about how to create a jar file may be found here: https://docs.oracle.com/javase/tutorial/deployment/jar/build.html

If you are using the Eclipse IDE you can create the jar file using the built in export as jar file option (File --> Export):

ExportToJar_Eclipse.jpgExportToJar_Eclipse2.jpg

And include the project that should be bundled into the jar file.

A detailed description how to create jar files using Eclipse may be found here: http://help.eclipse.org/mars/index.jsp?topic=%2Forg.eclipse.jdt.doc.user%2Ftasks%2Ftasks-37.htm 

Sign the jar

Once the jar file has been created, it must be signed due to security policies (see Understanding Signing and Verification). 

More information about how to sign jar files may be found here: https://docs.oracle.com/javase/tutorial/deployment/jar/signing.html

 

Optionally you can compress the signed jar file using the Jar Packing tool. This is recommended in production to improve the GMSC load time on startup but is not an absolute requirement and depends on the size of your extension. 

Create a jnlp

To add the extension as resource of the GMSC Client, a jnlp file must be created.

In the resources section reference the jar files that you would like to add to the Client and define the minimum Java version that is required to run the extension. In case that you have already compressed the signed jar you have to set the jnlp.packEnabled property but this is optional: 

<?xml version="1.0" encoding="UTF-8"?>
<jnlp spec="1.0+" >
	<information>
		<title>HGDN GMSC Shared Samples</title>
		<vendor>Hexgon Geospatial</vendor>
		<offline-allowed/>
	</information>
	<security>
		<all-permissions/>
	</security>
	<component-desc/>
	<resources>
		<j2se version="9+" />
		<property name="jnlp.packEnabled" value="true" />
		<jar href="HGDN_GMSC_SharedSamples.jar"/>
	</resources>
</jnlp>

This jnlp will automatically be referenced in the global GMSC Client jnlp . 

To learn more about jnlp files please look at this article: https://docs.oracle.com/javase/tutorial/deployment/deploymentInDepth/jnlpFileSyntax.html 

Add the extension to the plugins folder on the server

As a last step the jnlp file and the signed jar file must be copied to the plugins folder that may be found under the installation directory of GMSC on the sever (default path: C:\Program Files\Intergraph\GeoMedia SmartClient\Program\plugins). Only the signed and packed file (in case that you packed it) is needed not the original jar file that has been created in Step 1.

 

SamplePluginsFolder.JPG 

Users must download the GMSC Client again to get the extension

 In order to get the extension on the client side, the user must download the GMSC client again 

Overview
Contributors