19 Release Process

Amphitryon0 edited this page 2024-12-08 20:31:56 -06:00

Table of Contents

• Introduction
• Details

Introduction

Creating a Dolphin Release does require some steps, but if you know what to do it's fairly straightforward.

Releases are versioned as follows: YYMM, where YY is the current year, and MM is the current month. Hotfix releases are versioned as follows: YYMMp, where p is the hotfix letter. For example, 2407 would be a release made in July 2024, and 2407a would be the first hotfix for that release.

Releases can only be created by core developers.

Details

1. Perform a translation sync with Transifex if creating a major release.
2. Create a new branch named release-prep-YYMMp: git checkout -b release-prep-YYMMp <commit or tag>
   • If creating a major release, use the commit that the release should be based on.
   • If creating a hotfix release, use the tag of the last release.
3. Cherry pick any necessary commits.
4. Update the version constants in CMake/ScmRevGen.cmake, and commit the result.
   • Set DOLPHIN_VERSION_MAJOR to YYMM.
   • Set DOLPHIN_VERSION_MINOR to the patch number. If creating a hotfix release, use the number corresponding to the patch letter (for example, a is 1, b is 2, etc). Otherwise, set to 0.
     • This field must be set to a number as CPack does not support non-numerical values in the minor or patch version fields.
5. Push the branch to GitHub: git push -u origin release-prep-YYMMp.
6. Smoke test the produced builds.
   • The builds can be downloaded at https://dolphin-emu.org/download/list/release-prep-YYMM/1/.
   • Now is the time to fix any last-minute issues. Additional builds can be created by pushing new commits to GitHub.
7. Create an annotated tag: git tag -a YYMMp -m "Release for some date"
8. Push the tag to GitHub: git push origin YYMMp.
9. The release builds will automatically show up on the normal download page.
10. Publish the corresponding Progress Report, if any.
    • After publishing, post the link to the Progress Report onto Twitter, Mastodon, Bluesky, etc.
11. Push the new release to those on the beta auto-update track through the Update Tracks interface on the dolphin-emu.org admin panel.
12. Merge the release branch back into master: git checkout master, git merge --no-ff release-prep-YYMMp.

Dolphin GitHub Wiki

• Building

  • Linux
  • Windows
  • macOS
  • OpenBSD

• Feature explanations

  • FIFO Player Overview
  • Running Unit Tests
  • IOS Overview
  • Post Processing Shaders
  • Sys and User Folders

• Dolphin Infrastructure

  • About Dolphin's CI Bot
  • Buildbot Overview
  • Release Process
  • Auto Update Internals
  • Who Can Access What?

• Reference

  • Zelda Microcode
  • GameCube Action Replay Code Types
  • GameCube Action Replay Code Types (Simple Version)

Homepage | Project Site | Forums | Wiki | Issue Tracker | Coding Style | Transifex Page