Running the MDL IDE on Mac OS Sierra and later
==============================================

Summary
-------
When running the application MDLIDE.app you may get a dialog with the following error:

'“MdlIde.app” is damaged and can’t be opened. You should move it to the Trash.'

Don't be alarmed.  The build is sound. Please run the workaround below.


Background
----------
Since introducing the AppStore on the Mac, Apple has introduced a number of security checks
to protect the user against malicious software. In the latest releases of MacOS this has 
become stricter and now all applications running on these operating systems must be signed
in an Apple accredited manner.  The MDL IDE is currently not signed and so the MDL-IDE products
distributed here will not run without using the workaround below.  Our aim is to ultimately sign
these applications, but in the meantime please apply this workaround.

Workaround
----------

These instructions need you to open the Terminal app and execute the following from the command line.

1) Check that the downloaded file has not been interfered with by verifying the checksum file

	1.1) Download the checksum file. For example: eu.ddmore.mdleditor.site-1.6.0-SNAPSHOT-macosx.cocoa.x86_64.zip.md5

	1.2) Calculate the checksum for the download file.
		md5 eu.ddmore.mdleditor.site-1.6.0-SNAPSHOT-macosx.cocoa.x86_64.zip

	1.3) Compare to the checksum in the file.  You can get it using the following command:
		cat eu.ddmore.mdleditor.site-1.6.0-SNAPSHOT-macosx.cocoa.x86_64.zip.md5

	1.4) If the checksum is identical then proceed to the next step.  If not then the file has been tampered with.
		Do not use the file if tampered with and delete it from you system.		


2) Tell MacOS that you file is OK to use. 

	1.1) Unzip the archive.  This is typically done by double clicking in Finder.  The archive
		 will extract a file called MdlIde.app

	1.2) Run the following command from the command line.
		xattr -cr MdlIde.app


3) Now try running the application by double clicking on it.  It should run without an error.