Skip to content

Latest commit

 

History

History
39 lines (28 loc) · 2.32 KB

DEVELOPER.md

File metadata and controls

39 lines (28 loc) · 2.32 KB
Raw

WinSW Developer Information

Build Environment

  • winsw_key.snk should be available in the project's root in order to build the executable
  • You can generate the certificate by running generate-key.ps1
  • The certificate is in .gitignore list. Please do not add it to the repository

Continuous Integration

Project has a continuous integration flow being hosted by AppVeyor (project page). This CI instance automates building and testing of the Release configuration of WinSW. See the appveyor.yml file for more details.

Versions generated by the CI instances are NOT aligned with the release version, they use a rolling version ID instead.

Releasing to GitHub and NuGet

Releases are being performed to 3 locations: GitHub, NuGet, and Jenkins Maven Repository. For all these releases we use binaries being created by the special AppVeyor Job (winsw-release).

Here are the release steps:

  1. Integrate all pull requests you want to release to the master branch.
  2. Update CHANGELOG and push changes to the master.
  3. Wait till the AppVeyor build finishes for the last commit.
  4. Go to the winsw-release job page.
  5. If you are doing a release with a new feature, bump the second digit in the Version setting (e.g. to 2.N.${build}) and change the next build number to 0. In such case the version in assembly info will be 2.N.0
  6. Run the winsw-release build. Once it completes, ensure the version is correct.
  7. Click on the Deploy button for the build. Then deploy changes to GitHub Releases and NuGet using the available publishers.
  8. Go to GitHub Releases, find the published Release, click on Edit release and then uncheck the This is a pre-release checkbox to make the release public.

Releasing to the Maven repository (legacy)

Maven repository is no longer the main source of releases, but some projects still depend on WinSW from the Jenkins Maven repository. Maven Packaging repository can be found here.