Skip to content
This repository has been archived by the owner on Jan 3, 2019. It is now read-only.

Release process

Jump to bottom
Jakub Suder edited this page Nov 5, 2013 · 4 revisions

How to make a new Hive release:

(TODO: some of this could be automated further)

1. Prepare the .app bundle

  • make sure you have the right revision checked out in git
  • create the build with Product > Archive
  • in the Organizer window that should open at the end, select the first release at the top, and choose "Show in Finder" in the context menu
  • show the context menu on the selected bundle and choose "Show Package Contents"
  • go inside Products and Applications, take the Hive.app bundle that you see there, and move it to some safe place

2. Creating the .zip archive

  • just do a right-click on the .app, select "Compress", and rename the file to Hive-<version>.zip

3. Creating a release on GitHub

  • go to https://github.com/hivewallet/hive-osx/releases and click "Draft a new release"
  • enter the long version number in the tag field and again in the name field
  • make a list describing what things have been changed in this release
  • select "this is a pre-release"
  • drag the zip file to the designated area
  • click "publish release"

4. Adding the release to Sparkle appcast

  • use the generate_appcast_code.rb script to generate XML code for the appcast
  • open the hive-osx-appcast.xml file in grabhive.com project and paste the code inside the <channel> block, below <language>
  • deploy it to the server with bundle exec middleman deploy

5. Validating the zip release

  • download the previous dmg from http://grabhive.com, extract Hive and run it
  • select "Check for updates" from the menu, check if the release notes window appeared
  • confirm the update, wait until it downloads and check if it extracts and restarts properly (it wouldn't if e.g. you've messed up the DSA signature somehow)

6. Creating the .dmg archive

  • take the Hive-editable.dmg and make a new copy
  • open the dmg, switch to icon view, and copy the Hive.app in the right place
  • hide the sidebar and toolbar using the View menu, resize the window to the right size, and unmount the dmg
  • open the dmg in Disk Utility, choose Convert and save it as Hive-<version>.dmg

7. Publishing the .dmg

  • open the GitHub release page, choose "Edit", drag the new .dmg to the file upload area, and save the release
  • copy the .dmg download link and paste it to index.haml in the grabhive.com project
  • deploy the project again to the site and push the changes to the repo

8. Validating the dmg release

  • open http://grabhive.com, download the dmg
  • open the dmg, run the app inside it, and check if it's the right version

9. Create a post about the release

Clone this wiki locally