Dreamstime

Thursday 12 March 2015

My Checklist When Releasing A New Version Of RavenPlus

Dear ME,

I have noticed that you were struggling with yourself while trying to build the updated release of RavenPlus version 1.0.504 yesterday. RavenPlus version 1.0.503 was released roughly about a year ago, and it is quite obvious that you have forgotten the steps.

To prevent this from happening again, I have taken the liberty to write down and document the steps for you. Confucius say : "the palest ink is better than the best memory". Keep this safe somewhere. I'm sure you will need it - again and again.

The Checklist

  1. Increment the version number in the files "Raven\src\python\setup.py" and "Raven\src\python\zoundry\blogapp\version.py".

  2. Commit the changes to svn by doing these 2 steps:

    - svn commit
    - svn update

  3. Create a new release tag version in svn by executing the following command (remember to set the version number accordingly in the command line):

    svn copy file:///H:/work/svnRepository/repos/RavenPlus/trunk \
    file:///H:/work/svnRepository/repos/RavenPlus/tags/Version-X.X.XXX \
    -m "Version X.X.XXX"


  4. Checkout this new release tag version from svn to the directory "NewVersion":

    svn checkout file:///H:/work/svnRepository/repos/RavenPlus/tags/Version-X.X.XXX NewVersion

  5. Generate the py2exe Windows executable and run-time dependent files by executing the Windows Batch file "Raven\src\python\d.bat". This will take about 2 minutes to complete.

  6. Rename the newly generated file (from Step 5) "raven.exe" to "ravenPlus.exe", found in the directory "Raven\src\python\dist".

  7. Unzip the previous version of RavenPlus into a directory. Replace the OLD files (from this unzip-ed file), "ravenPlus.exe" and "library.zip" in the directory "bin", with the newer version that we have just generated and renamed from Step 5 and Step 6, respectively - files are located in the directory "Raven\src\python\dist".

  8. Zip the files, from Step 7, back again and call this new zip file "RavenPlus_vX_X_XXX.zip" - where "X_X_XXX" is the updated version number.

  9. Test out this zip file "RavenPlus_vX_X_XXX.zip" by unzipping it into another directory (different from Step 7). Execute/run "ravenPlus.exe". Verify that the version number is correct and all the new features/bug-fixes are as expected.

  10. Perform an anti-virus scan on the file "RavenPlus_vX_X_XXX.zip" . Upload this zip file to Google Drive only when the anti-virus scan says it is clean.

  11. Work out the direct link from Google Drive so that your blog readers can download it directly to their computer. The direct link URL is of the format:

    https://drive.google.com/uc?export=download&id=FILE_ID

    The FILE_ID can be obtained from the URL of the file hosted on Google drive, which is of the format:

    https://drive.google.com/file/d/FILE_ID/edit?usp=sharing

  12. Create and publish the blog post about the updated version of RavenPlus. Remember to share the direct link from Step 11.

Hope this helps.

Warmest Regards,
ME.

2 comments:

  1. :-) If it helps: this has happened to me more than once and I've used the same solution.

    ReplyDelete
    Replies
    1. It's comforting to know that I am on the right track. Thanks for sharing.

      Delete