Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
    • Switch to GitLab Next
  • Sign in / Register
wiki
wiki
  • Project overview
    • Project overview
    • Details
    • Activity
  • Issues 19
    • Issues 19
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
    • Iterations
  • Requirements
    • Requirements
    • List
  • Operations
    • Operations
    • Incidents
  • Analytics
    • Analytics
    • Insights
    • Issue
    • Repository
    • Value Stream
  • Wiki
    • Wiki
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Create a new issue
  • Issue Boards
  • openlp
  • wikiwiki
  • Wiki
    • Packaging
  • Release

Last edited by Raoul Snyman Oct 14, 2019
Page history

Release

These are the steps to create a release of OpenLP.

Prepare the Release

Tag The Release

Make sure you have the latest version of the code:

user@linux:~/Projects/OpenLP/trunk$ bzr up

Then edit the .version file and set the version in there:

user@linux:~/Projects/OpenLP/trunk$ echo "2.X.X" > openlp/.version

Then get the current revision from bzr and increase it one:

user@linux:~/Projects/OpenLP/trunk$ bzr revno
2512

Then edit the tests file to create the correct tag version. Current Revision + 1

user@linux:~/Project/OpenLP/trunk$ vim tests/utils/test_bzr_tags.py 

The commit that change:

user@linux:~/Projects/OpenLP/trunk$ bzr commit -m "Release 2.X.X"

And then tag it:

user@linux:~/Projects/OpenLP/trunk$ bzr tag "2.X.X"

Create the Release Source Tarball

Export the code without any version control information into a tarball:

user@linux:~/Projects/OpenLP/trunk$ bzr export -r "2.X.X" ../OpenLP-2.X.X.tar.gz

Upload the Release Source Tarball

Create a new release directory on OpenLP.io:

$ ssh openlp@openlp.io "mkdir -p ~/sites/get.openlp.org/www/2.X.X/"

Then upload the zipped file:

$ scp OpenLP-2.X.X.tar.gz openlp@openlp.io:sites/get.openlp.org/www/2.X.X

Start the Packaging Process

Notify Packagers

Once you've created the source tarball, notify all the packagers that is available. The Windows and OS X packagers will upload their packages to the OpenLP.io server.

Platform Packager (IRC nick)
Windows ElderP or tgc
macOS superfly
Debian/Ubuntu superfly
Fedora TRB143
Arch thelinuxguy
Gentoo dsr1204

Announce the Release

Once everything is packaged (usually on Saturday), it is time to update the website and formally announce the new release. This part is done on the Sunday of the release, usually after church.

Update the Download Page

On the web site, edit the download page and update the links to all point to the new release. Often this is easiest done by just editing the HTML itself.

Blog the Announcement

Most releases we have collaboratively worked on a release announcement. After the download page has been updated, the blog post is created and posted on the site. The Twitter account and the Facebook page will automatically pick up the blog post.

Spread the Good News

Last but not least, retweet the announcement on Twitter, share and like the announcement on Facebook, and do whatever else you can and want to announce the release.

Clone repository
  • Addendum
  • Brand_Guidelines
  • Classes_Plugin
  • Code Structure
  • Configuring_SSH_Keys_on_Linux_and_Mac_OS_X
  • Configuring_SSH_Keys_on_Windows
  • Creating a Study Bible for OpenLP
  • Custom Stage Views
  • Development of Icons
  • Development
    • Branching_And_Merging_Standards
    • Coding_Standards
    • Convert from Bazaar to Git
    • Core_API_Framework
    • EasySlides_ _Song_Data_Format
    • EasyWorship_ _Song_Data_Format
View All Pages