Developers Knowledge Base

Learn how to manipulate, modify, and tune your GeoMedia WebMap, Geospatial Portal and Consumer portal instances.
Showing results for 
Search instead for 
Do you mean 

Updating SDK

by Technical Evangelist on ‎10-15-2015 06:46 AM - edited on ‎04-06-2017 05:35 AM by Technical Evangelist (1,814 Views)

How to start with mercurial


To maitain the code it is recommended to use some version controls system. In our case we will use Mercurial with HgTortoise client, for more information about Mercurial check this website:


Preparing your SDK


This article is about how to upgrade your SDK package to our newest update without losing your own code changes.

First, we need to create repository with our SDK. It will have only „default” branch so next step is creating named branch for the SDK sources from „portal-sdk-application-portal-sdk-package” zip file, in my case it's „sdk2015-orig” branch.

Next, what I show on screenshot, I performed merge from „sdk2015-orig” branch to „default” branch.


Początek 2.png


Branch „default” is the place where I commit my changes in code. Every change is commited in particular revisions. I can go back to any revision and update my SDK to particular one. In example: I want to get the state of SDK before Piotr added „toolbar button” and upgrade it to EP04 - all I need is update my revision to revision number 7 and do the next step.


How to upgrade your SDK to SDK 15.0 EP04


First step to upgrade your SDK is updating your current repository to „sdk2015-orig” branch.


Początek 3.png


Copy all files from extracted EP04 „portal-sdk-application-portal-sdk-package” zip to your repository, add the new ones and include upgraded, in my example, folder with repository is „Repo SDK”.




Now commit changes.


Commitowanie update.png


After commiting, switch to default branch and merge from upgraded „sdk-2015-orig” branch.

NOTICE If you have conflicts in merge, choose „local files” option.


Merge 1.png


Merge gotowy.png


REMEMBER: If you want to merge branches it is important to do this in „default” branch from „sdk2015-org” branch, in opposite way after merge you will get just pure upgraded SDK without your changes from „default” branch.


The solution has now been updated to EP04. The same approach may be repeated with the consecutive patches (EP05, EP06 etc.). The main advantage of version controls systems, is the possibility to retrieve any of changes done in repository. In this case, Piotr done some changes 3 months ago and I want to upgrade my SDK but in particular state. All I need to do is update to revision which interest me and do upgrade in the same way.

on ‎01-19-2016 01:27 AM


how can I get the SDK?

by Technical Evangelist
on ‎04-06-2017 05:34 AM

Hi Gamal,


Geospatial Portal SDK is now a part of HGDN Subscription.