Release Procedure

2021-04-12

1. Update to the latest tools

   • Python
   • Python packages:
     • wheel
     • sphinx
     • gpxpy
     • lxml
     • mypy
     • PySimpleGUI
     • seaborn
       • this installs:
       • python-dateutil
       • pillow
       • numpy
       • kiwisolver
       • cycler
       • scipy
       • pandas
       • matplotlib

2. Edit GPXAnalyzer.py to update the version string.

3. Edit GPXAnalyzerVersion.txt with a Unicode aware editor (such as Notepad++):

   • Change the Copyright year if needed.
   • Change the filevers and prodvers tuples.
   • Change the FileVersion, ProductVersion, and Assembly Version strings.

4. Edit the license file

   • Update the date
   • Make any changes if needed.

5. Edit Readme.md.

   • Update the version and date
   • If needed, update the screenshot.
   • If needed, update the text.

6. Build an exe file, from the command line, run

       MakeExe.bat
   

   This takes 2 to 3 minutes to run. It will build an application for the version of the OS you are running (for example, Windows 10 64-bit). To build for 32-bit or for a different OS, you must run that OS and build it there.

7. Run Inno setup Script compiler and compile GPXAnalyzer.iss. This will create dsit\GPXAnalzyer_setup_x_y_z.exe This will take 1-2 minutes.

8. Update the wiki documentation as needed.

9. Use fsum to create a .sha256 file with same name as the binary file.

       fsum -sha256 GPXAnalyzer_setup_x_y_z.exe >GPXAnalyzer_setup_x_y_z.sha256
   

10. Edit the sha256 file to remove extraneous comments.

11. Copy the setup file and sha256 file to ReleasedVersions.

12. Commit all changes.

13. Tag the head of both the app repo and the wiki repo with the version number such as "v1.1.0".

14. Push changes including tags to github, for both the app and the wiki.

15. Check that the documentation on github is rendered correctly.

16. Create a release at github

    • If using noscript, disable no-script for your browser tab to get the uploads to work.
    • On Releases page, draft a new release.
    • Enter the version number (the tag name), such as "v1.1"
    • Enter the title such as "GPXAnalyzer v1.1".
    • Leave description blank.
    • Add the setup exe file and the checksum file
    • Wait for the upload to complete.
    • Click Publish release

17. Check that download link in the readme on GitHub works correctly.