Skip to content

Latest commit

 

History

History
119 lines (86 loc) · 4.19 KB

MAINTAINING.md

File metadata and controls

119 lines (86 loc) · 4.19 KB
Raw

Create a Release

  • Update po template and wait for weblate to apply it
  • Update the German translation and commit/push in the weblate interface
  • Merge the translation PR
  • Let the Github Action update the "Chinese Traditional" translation from "Chinese Simplified"
  • Reset the weblate repo
  • Run cargo update and update dependencies in flatpak dev Yaml manifest
  • Update the flatpak dev Json manifest from Yaml
  • Commit the changes and push
  • Release commit: Update the changelog in the appdata file, replace all version numbers in the project and build, install and run all tests:
    • meson install -C _mesonbuild
    • meson compile ui-cargo-clippy -C _mesonbuild
    • meson compile cli-cargo-clippy -C _mesonbuild
    • meson compile cargo-test -C _mesonbuild
    • meson test -C _mesonbuild
  • Wait for CI to run successfully
  • Create a release with tag vX.Y.Z on Github - the installer and tarball will be created by Github Actions CD
  • For Flathub: create a new release branch, update the Flathub flatpak manifest with the new tarball download Url and update the dependencies. Create a PR, and wait for completion of the Flathub builder CI.
  • For Flathub: create the new beta PR as well by copying the updated manifest from the new release branch
  • For Flathub: Merge both beta and release PR's. Optionally publish the builds on Flathub's runner web interface manually for a faster release

Create a Tarball Manually

Create a tarball by running meson dist. Add the --no-tests flag to skip tests and building when it has been made sure that it would build successfully.

meson dist -C _mesonbuild

or

meson dist --no-tests -C _mesonbuild

The source tarball and checksum file should now be in _mesonbuild/meson-dist/.

Create a Beta Release for Flathub

  • Do the same first steps as for a regular release
  • Add the suffix -beta.<x> to the app version suffix in meson and commit this to main.
  • Checkout and rebase/merge the beta branch with main.
  • Make a beta release on Github just like a regular one, but with -beta.<x> appended to the tag.
  • In the Flathub app repo, all releases need to be made with a PR, so checkout a new branch from beta and update the flatpak manifest.
  • Then create a PR on Github against beta and merge it as soon as the flathub runner runs successfully.

Install a Previous Version Flatpak

To view all released flatpak versions:

flatpak remote-info --log flathub com.github.flxzt.rnote

To roll back and pin/unpin:

sudo flatpak update --commit=<version-hash> com.github.flxzt.rnote 
flatpak mask com.github.flxzt.rnote
flatpak mask --remove com.github.flxzt.rnote

Flatpak Devel Manifest

A manifest .json is maintained in addition to the .yaml, because Gnome Builder currently only supports Json Flatpak manifests. To update the Json from Yaml automatically, yq is used. Run:

yq -o=json build-aux/com.github.flxzt.rnote.Devel.yaml > build-aux/com.github.flxzt.rnote.Devel.json

Translations

To regenerate the .pot, run:

meson compile rnote-pot -C _mesonbuild

The PO files can then be updated with:

meson compile rnote-update-po -C _mesonbuild

Usually Weblate updates them automatically, so this is not really needed unless one would want to reset and overwrite the translation files on Weblate.

Before merging the weblate translation PR, the Weblate repository should be locked. Then merge the PR, reset and then unlock the weblate repo to resynchronize with upstream.

Update the "Chinese Traditional" Translation (zh_Hant.po) Manually

The package providing the opencc tool (opencc-tools on Fedora) needs to be installed to regenerate the translation.

To autogenerate chinese traditional translation (zh_Hant) from chinese simplified (zh_Hans), use opencc:

./build-aux/update-translations.sh

discussed in issue 220

Check outdated dependencies

Install cargo-edit

Show outdated dependencies with:

cargo upgrade --dry-run --verbose

With this output, update the dependencies manually in Cargo.toml where it makes sense.