Open eCard

h1. Making a Release

* Finish all your work and merge it to the master branch of "GitHub":https://github.com/ecsec/open-ecard/

* Determine the version number the release should have

* Use the "maven release plugin":http://maven.apache.org/maven-release/maven-release-plugin/ to create a new release (you will be asked for a version number):

<pre><code class="shell">

mvn release:prepare

mvn release:perform

</code></pre>

* Now the code is prepared for the release!

* Log into the "Jenkins CI system":https://ci.openecard.org/

* Open the Job "oec_build_release":https://ci.openecard.org/job/oec_build_release/

* Start a build with parameters, the version number of the release should go for the parameter "TAG"

* Now the builds are done for the release, a 'notarization' for OSX must for now done by hand:

** Download the '.dmg' and '.pkg' build artifacts to a OSX machine with Xcode and a logged in Apple-ID as part of the ecsec team available (look "here":https://developer.apple.com/account/#/membership/72RMQ6K75Z for details)

** Look up the 'APP-SPECIFIC-PASSWORD' for the OeC App at the "APPLE-ID homepage":https://appleid.apple.com/account/home

** If no 'APP-SPECIFIC-PASSWORD' is available you can create one, please have a look "here":https://support.apple.com/en-us/HT204397

** Run the 'notarization' of an installer, this will give you a 'REQUEST_UUID':

<pre><code class="shell">

xcrun altool --notarize-app --primary-bundle-id 

"org.openecard.versioncheck.MainLoader" --username "{APPLE_ID_EMAIL}" --

password "{APPLE_APP_SPECIFIC_PASSWORD}" --asc--provider "72RMQ6K75Z" --file 

{PKG_OR_DMG_FILE}

</code></pre>

** Check the result, you should recive an email:

<pre><code class="shell">

xcrun altool --notarization-info "{REQUEST_UUID}" --username 

"{APPLE_ID_EMAIL}" --password "{APPLE_APP_SPECIFIC_PASSWORD}"

</code></pre>

* Draft a new release on "GitHub":https://github.com/ecsec/open-ecard/releases/new

* Add a description, upload the build artifacts for all platforms and finish the release

* Update the version lists on vserver002 (as user typo3-admin):

<pre><code class="shell">

vim /opt/typo3-test/site/update-list.json

vim /opt/typo3-prod/site/update-list.json

</code></pre>

* Tell Stefan about the release until the website pulls update info from the server