blog/content/post/release-of-1.22.0-rc1.md

date	authors	title	tags	draft
2024-04-28T22:49:00+08:00	lunny	Gitea 1.22.0 Release Candidate	release	false

The Gitea 1.22 second Release Candidate (RC) is available today on the download page! Gitea 1.22 is packed with new features and improvements. Getting the RC (release candidate) allows you to experiment with it early, try it on your workloads, and report any issues before the final release. Here are some notable changes and features in Gitea 1.22; for the full list, refer to the full release notes.

Note: Since 1.22-rc0 has many bugs which have been merged into main branch, it's more simple and stable to rebranch the v1.22 from main branch but not continue the old one. The 1.22-rc1 and later won't be able to downgrade to 1.22-rc0 and they shouldn't because many bugs are only fixed in 1.22-rc1. There will be no impact to end users who are using 1.22-rc0, they could safely upgrade to 1.22-rc1 and get more bug fixes and new enhancements.

Major Breaking changes

• Require MySQL 8.0, PostgreSQL 12, MSSQL 2012 (#27337) and Recommend/convert to use case-sensitive collation for MySQL/MSSQL (#28662).

  Support for MySQL 5.7, PostgreSQL 10 and 11, and MSSQL 2008 is dropped. You are encouraged to upgrade to supported versions. And for MySQL/MSSQL which is default case insensitive, it caused some bugs when searching. So moving to a case-sensitive collation is recommanded.

  • Ref: https://endoflife.date/mysql
  • Ref: https://endoflife.date/postgresql
  • Ref: https://endoflife.date/mssqlserver

• Breaking summary for template refactoring (#29395) The template system have been refactored, some template functions maybe changed or removed.

  • Safe is renamed to SafeHTML, and in most cases it shouldn't be used.
  • Escape is renamed to HTMLEscape, and in most cases it shouldn't be used. The template should escape most variables automatically.
  • Str2html is renamed to SanitizeHTML, only use it when necessary, it only "sanitizes" the input by pre-defined rules, but it doesn't "render" or "convert" the content.
  • Use HTMLFormat instead of printf when processing HTML related contents.

  If you are using custom templates (including "mail" templates and "website" templates), after you upgrade to Gitea 1.22, you should extract the templates from Gitea like before.

• Rename the default themes to gitea-light, gitea-dark, gitea-auto (#27419)

• Support storage base path as prefix (#27827)

• Always enable caches (#28527)

Major features

End-User features

From this version, Gitea introduced tailwind & HTMLX

• Renamed the default themes and improved dark theme (#27419) colorblindness-friendly theme
• Add support for sha256 repositories (#23894)
• Implement contributors graph (#27882)
• Implement code frequency graph (#29191)
• Add Profile Readme for Organisations (#27955)
• Add user blocking (#29028)
• Add alert blocks in markdown (#29121)
• Support repo code search without setting up an indexer (#29998)
• Render embedded code preview by permlink in markdown (#30234)
• Customizable "Open with" applications for repository clone (#29320)
• Use raw Wiki links for non-renderable Wiki files (#30273)
• Retarget depending pulls when the parent branch is deleted (#28686)
• Support pasting URLs over markdown text (#29566)
• Show latest commit for file (#28067)
• Support for forking single branch (#25821)
• Edit file on pull request files directly
• everyone readable/writable wiki,

Actions features

Since v1.19, Gitea introduced Actions. It becomes more and more welcome. We are continue improving Gitea Actions. In this release, you can now use the official runner images https://gitea.com/gitea/runner-images and more features listed below.

• Actions Artifacts v4 backend (#28965)
• Implement actions badge svgs (#28102)
• Add skip ci functionality (#28075)
• Artifact deletion in actions ui (#27172)
• Add API routes to get runner registration token (#27144)

Administration features

• Allow options to disable user deletion from the interface on app.ini (#29275)
• Add global setting how timestamps should be rendered (#28657)
• Allow to sync tags from admin dashboard (#28045)
• Add admin API route for managing user's badges (#23106)

Improved performance

• The loading performance of commit status from repository's default branch
• The branch list page divergence loading improvements for those repositories with over thousands branches
• The issues and pulls page loading performance
• Dashboard loading performance improvements

The full change log can be visit from https://github.com/go-gitea/gitea/releases/tag/v1.22.0-rc1.

Please download the Gitea 1.22 RC and try it! If you notice any problems, please file an issue.