To add your extension to an existing GeoMedia Smart Client installation please follow these steps:
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):
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
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.
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
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.
In order to get the extension on the client side, the user must download the GMSC client again